octodns.record.dynamic

Classes

DynamicValidator(id[, sets])

Validates the dynamic block of a dynamic record: the pools structure (fallback chains, value types, status flags), the rules list (geo/subnet targeting and pool references), and that no pools are defined but unused.

class octodns.record.dynamic.DynamicValidator(id, sets=None)

Bases: RecordValidator

Validates the dynamic block of a dynamic record: the pools structure (fallback chains, value types, status flags), the rules list (geo/subnet targeting and pool references), and that no pools are defined but unused.

validate(record_cls, name, fqdn, data, disabled=None)

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.

• disabled (dict or None) – The zone’s per-type map of disabled validator ids (record_cls ._type or '*' -> set of ids), as configured via the zone’s validators.record.disable_validators. Most validators can ignore this; it only matters to validators that themselves dispatch to other validators (e.g. value-type bridges, geo and dynamic validators), which must forward it along so the disabled ids are honored down the chain.

Returns:

A list of ValidationReason objects describing validation failures — construct each with ValidationReason(reason, validator_id=self.id). 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. Returning bare str reasons is DEPRECATED — the registry wraps them in ValidationReason and emits a deprecation warning; support will be removed in 2.0.

Return type:

list[ValidationReason]

Notes

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

Third-party validators that predate the disabled parameter and implement validate(self, record_cls, name, fqdn, data) continue to work: the caller detects the TypeError and falls back to calling without it, emitting a deprecation warning. Support for the parameter-less form will be removed in 2.0.

class octodns.record.dynamic._DynamicPool(_id, data, value_type)

Bases: object

log = <Logger _DynamicPool (WARNING)>

__init__(_id, data, value_type)

_data()

__repr__()

Return repr(self).

class octodns.record.dynamic._DynamicRule(i, data)

Bases: object

__init__(i, data)

_data()

__repr__()

Return repr(self).

class octodns.record.dynamic._Dynamic(pools, rules)

Bases: object

__init__(pools, rules)

_data()

__repr__()

Return repr(self).

class octodns.record.dynamic._DynamicMixin(zone, name, data, *args, **kwargs)

Bases: object

VALIDATORS = [<octodns.record.dynamic.DynamicValidator object>]

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

classmethod _schema(value_schema)

JSON Schema fragment describing the dynamic block.

Structural constraints that JSON Schema can express cleanly (shape of pools, values, rules, weight/status ranges) are included. Rule ordering, fallback-loop detection, and cross-references between rules and pools are left to octoDNS’s own validation.

classmethod _validate_pools(pools, disabled=None, validator_id=None)

classmethod _validate_rules(pools, rules, validator_id=None)

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

_data()

changes(other, target)

__repr__()

Return repr(self).