Bases: object + Mark that at most one option from a Case can be suplied. + Represents a list of possible configuration options in a given scope, where at most one can actually be provided. + Note

It should be used together with a link:#patroni.validator.Case[`+Case+`] object.
+
\\__init\\__(_*args:  https://docs.python.org/3/library/stdtypes.html#str[str]_) →  https://docs.python.org/3/library/constants.html#None[None] https://github.com/zalando/patroni/blob/9d231aeecdd69f4d06c75a702755fa70d8c2b5f6/patroni/validator.py#L441-L458[View on GitHub]link:#patroni.validator.AtMostOne.\\__init\\__[];;
  Create a :class`AtMostOne` object.
  +

BINARIES – list of executable files that should exist directly under a given Postgres binary directory. +

+

Check if the expected executables can be found under name binary directory. +

+

Create a Directory object. +

Check that all executables from contains_executable list exist within the given directory or within PATH. +

Check if the expected paths and executables can be found under name directory. +

+

Create an EnumValidator object with given allowed values. +

+

Create an IntValidator object with the given rules. +

+

Create an Optional object. +

Create an Or object. +

+

Create a Result object based on the given arguments. + Note

`+error+` attribute is only set if _status_ is failed.
+
Parameters:::

validator –
validator of the configuration schema. Can be any of these: +

Create a Schema object. + Note

This class is expected to be initially instantiated with a  https://docs.python.org/3/library/stdtypes.html#dict[`+dict+`] based _validator_ argument. The idea is that dict represents the full YAML tree of configuration options. The link:#patroni.validator.Schema.validate[`+validate()+`] method will then walk recursively through the configuration tree, creating new instances of link:#patroni.validator.Schema[`+Schema+`] with the new “base path”, to validate the structure and the leaf values of the tree. The recursion stops on leaf nodes, when it performs checks of the actual setting values.
+
Parameters:::
  *validator* –
  +
  validator of the configuration schema. Can be any of these:
  +
  The first 3 items in the above list are here referenced as “base validators”, which cause the recursion to stop.
  +
  If _validator_ is a  https://docs.python.org/3/library/stdtypes.html#dict[`+dict+`], then you should follow these rules:
  +
  * For the keys it can be either:
  +
  \\__\\__
  \\__\\__
  * For the values it can be either:
  +
  \\__\\__
  \\__\\__
Example:::

Schema({
    "application_name": str,
    "bind": {
        "host": validate_host,
        "port": int,
    },
    "aliases": [str],
    Optional("data_directory"): "/var/lib/myapp",
    Or("log_to_file", "log_to_db"): Case({
        "log_to_file": bool,
        "log_to_db": bool,
    }),
    "version": Or(int, float),
})

Map a key from the validator dictionary to the corresponding key(s) in the data dictionary. +

Iterate over validator, if it is an iterable object, to validate the corresponding entries in data. + Only dict, list, Directory and Or objects are considered iterable objects. +

Iterate over a dict based validator to validate the corresponding entries in data. +

Perform all validations defined in an Or object for a given configuration option. + This method can be only called against leaf nodes in the configuration tree. Or objects defined in the validator keys will be handled by iter_dict() method. +

Perform all validations from the schema against the given configuration. + It first checks that data argument type is compliant with the type of validator attribute. +

python_type – Python type which user friendly name should be taken.

User friendly name of the given Python type.

string – comma-separated list of host and port items.

True if all items in the CSV string are valid.

data_dir – path to the PostgreSQL data directory to be checked.

True if the data directory is empty.

bin_name – a key to be retrieved from postgresql.bin_name configuration.

value of postgresql.bin_name[*bin_name*], if present, otherwise bin_name.

ip – the IP to be checked.

True if the IP is an IPv4 address.

ConfigParseError: if ip is not a valid IPv4 address.

ip – the IP to be checked.

True if the IP is an IPv6 address.

ConfigParseError: if ip is not a valid IPv6 address.

bin_name – the value of the postgresql.bin_name[*bin_name*]

True if the conditions are true

address – address to be validated in the format host:ip.

True if the address is valid.

data_dir – the value of postgresql.data_dir configuration option.

True if the PostgreSQL data directory is valid.

listen – if the address is expected to be available for binding. False means it expects to connect to that address, and True that it expects to bind to that address. + multiple_hosts – if host_port can contain multiple hosts.

True if the host(s) and port are valid.

value – list of host(s) and port items to be validated.

True if all items are valid.

host_port – the host and port to be validated. Must be in the format host:ip.

True if the host and port are valid and available for binding.

host_port – + the host(s) and port to be validated. It can be in either of these formats

True if the host(s) and port are valid and available for binding.

field – A log field to be validated.

True if the field is either a string or a dictionary with exactly one key that has string value, False otherwise.

logformat – A log format to be validated.

True if the log format is either a string or a list of valid log fields.

value – value of watchdog.mode to be validated.