octodns.record.geo

Classes

GeoCodes()
GeoValidator(id[, sets])	Validates the deprecated geo block of a record: each key is a valid continent/country/subdivision code and each list of values passes the record's value-type validation.
GeoValue(geo, values)

class octodns.record.geo.GeoCodes

Bases: object

log = <Logger GeoCodes (WARNING)>

classmethod validate(code, prefix)

Validates an octoDNS geo code making sure that it is a valid and corresponding:

• continent

• continent & country

• continent, country, & province

classmethod parse(code)

classmethod country_to_code(country)

classmethod province_to_code(province)

class octodns.record.geo.GeoValue(geo, values)

Bases: EqualityTupleMixin

geo_re = re.compile('^(?P<continent_code>\\w\\w)(-(?P<country_code>\\w\\w)(-(?P<subdivision_code>\\w\\w))?)?$')

classmethod _validate_geo(code)

__init__(geo, values)

property parents

_equality_tuple()

__repr__()

Return repr(self).

class octodns.record.geo.GeoValidator(id, sets=None)

Bases: RecordValidator

Validates the deprecated geo block of a record: each key is a valid continent/country/subdivision code and each list of values passes the record’s value-type validation.

validate(record_cls, name, fqdn, data)

Validate a record’s non-value attributes.

Parameters:

• record_cls (type) – The concrete Record subclass being validated. Validators that need access to record class-level attributes (e.g. _type, _value_type) should read them from record_cls. Per-instance configuration should live on self, not on record_cls.

• name (str) – The record’s name relative to its zone ('' for the zone root). Already idna_encode’d.

• fqdn (str) – The record’s fully-qualified domain name (name + zone name).

• data (dict) – The raw record config dict (as loaded from YAML/JSON) including ttl, type, value/values, and any type-specific fields like dynamic, geo, or octodns.

Returns:

A list of human-readable reason strings describing validation failures. Must return an empty list when the record is valid. Reasons from multiple validators are concatenated by the caller, so each reason must stand alone without context from the others.

Return type:

list[str]

Notes

Implementations must not raise on invalid input — all failures are reported via the returned list. Reason strings are surfaced verbatim in ValidationError messages, so phrasing and punctuation should be stable across releases.

class octodns.record.geo._GeoMixin(zone, name, data, *args, **kwargs)

Bases: ValuesMixin

Adds GeoDNS support to a record.

Must be included before Record.

VALIDATORS = [<octodns.record.geo.GeoValidator object>]

classmethod _schema(value_schema)

JSON Schema fragment describing the geo block.

Keys are geo codes (continent, continent-country, or continent-country-subdivision); values are lists of record values.

__init__(zone, name, data, *args, **kwargs)

_data()

changes(other, target)

__repr__()

Return repr(self).