File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/__pycache__/schema.cpython-310.pyc
Back
o ;j�� � @ s d Z ddlZddlZddlmZ ddlZdZdZG dd� d�Z e � Z dd � Z e e �e _ [ G d d � d e�ZG d d � d e�ZG dd� ded�ZG dd� ded�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d e�ZG d d � d e�ZG d!d"� d"e�ZG d#d$� d$e�ZG d%d&� d&e�Z G d'd(� d(e�Z G d)d*� d*e�Z G d+d,� d,e �Z G d-d.� d.e�Z G d/d0� d0e�Z!G d1d2� d2e�Z"G d3d4� d4e�Z#G d5d6� d6e#�Z$G d7d8� d8e#�Z%G d9d:� d:e�Z&G d;d<� d<e �Z'G d=d>� d>e�Z(G d?d@� d@e�Z)dS )Aa, :codeauthor: Pedro Algarvio (pedro@algarvio.me) :codeauthor: Alexandru Bleotu (alexandru.bleotu@morganstanley.com) salt.utils.schema ~~~~~~~~~~~~~~~~~ Object Oriented Configuration - JSON Schema compatible generator This code was inspired by `jsl`__, "A Python DSL for describing JSON schemas". .. __: https://jsl.readthedocs.io/ A configuration document or configuration document section is defined using the py:class:`Schema`, the configuration items are defined by any of the subclasses of py:class:`BaseSchemaItem` as attributes of a subclass of py:class:`Schema` class. A more complex configuration document (containing a defininitions section) is defined using the py:class:`DefinitionsSchema`. This type of schema supports having complex configuration items as attributes (defined extending the py:class:`ComplexSchemaItem`). These items have other configuration items (complex or not) as attributes, allowing to verify more complex JSON data structures As an example: .. code-block:: python class HostConfig(Schema): title = 'Host Configuration' description = 'This is the host configuration' host = StringItem( 'Host', 'The looong host description', default=None, minimum=1 ) port = NumberItem( description='The port number', default=80, required=False, minimum=0, inclusiveMinimum=False, maximum=65535 ) The serialized version of the above configuration definition is: .. code-block:: python >>> print(HostConfig.serialize()) OrderedDict([ ('$schema', 'http://json-schema.org/draft-04/schema#'), ('title', 'Host Configuration'), ('description', 'This is the host configuration'), ('type', 'object'), ('properties', OrderedDict([ ('host', {'minimum': 1, 'type': 'string', 'description': 'The looong host description', 'title': 'Host'}), ('port', {'description': 'The port number', 'default': 80, 'inclusiveMinimum': False, 'maximum': 65535, 'minimum': 0, 'type': 'number'}) ])), ('required', ['host']), ('x-ordering', ['host', 'port']), ('additionalProperties', True)] ) >>> print(salt.utils.json.dumps(HostConfig.serialize(), indent=2)) { "$schema": "http://json-schema.org/draft-04/schema#", "title": "Host Configuration", "description": "This is the host configuration", "type": "object", "properties": { "host": { "minimum": 1, "type": "string", "description": "The looong host description", "title": "Host" }, "port": { "description": "The port number", "default": 80, "inclusiveMinimum": false, "maximum": 65535, "minimum": 0, "type": "number" } }, "required": [ "host" ], "x-ordering": [ "host", "port" ], "additionalProperties": false } The serialized version of the configuration block can be used to validate a configuration dictionary using the `python jsonschema library`__. .. __: https://pypi.python.org/pypi/jsonschema .. code-block:: python >>> import jsonschema >>> jsonschema.validate({'host': 'localhost', 'port': 80}, HostConfig.serialize()) >>> jsonschema.validate({'host': 'localhost', 'port': -1}, HostConfig.serialize()) Traceback (most recent call last): File "<stdin>", line 1, in <module> File "/usr/lib/python2.7/site-packages/jsonschema/validators.py", line 478, in validate cls(schema, *args, **kwargs).validate(instance) File "/usr/lib/python2.7/site-packages/jsonschema/validators.py", line 123, in validate raise error jsonschema.exceptions.ValidationError: -1 is less than the minimum of 0 Failed validating 'minimum' in schema['properties']['port']: {'default': 80, 'description': 'The port number', 'inclusiveMinimum': False, 'maximum': 65535, 'minimum': 0, 'type': 'number'} On instance['port']: -1 >>> A configuration document can even be split into configuration sections. Let's reuse the above ``HostConfig`` class and include it in a configuration block: .. code-block:: python class LoggingConfig(Schema): title = 'Logging Configuration' description = 'This is the logging configuration' log_level = StringItem( 'Logging Level', 'The logging level', default='debug', minimum=1 ) class MyConfig(Schema): title = 'My Config' description = 'This my configuration' hostconfig = HostConfig() logconfig = LoggingConfig() The JSON Schema string version of the above is: .. code-block:: python >>> print salt.utils.json.dumps(MyConfig.serialize(), indent=4) { "$schema": "http://json-schema.org/draft-04/schema#", "title": "My Config", "description": "This my configuration", "type": "object", "properties": { "hostconfig": { "id": "https://non-existing.saltstack.com/schemas/hostconfig.json#", "title": "Host Configuration", "description": "This is the host configuration", "type": "object", "properties": { "host": { "minimum": 1, "type": "string", "description": "The looong host description", "title": "Host" }, "port": { "description": "The port number", "default": 80, "inclusiveMinimum": false, "maximum": 65535, "minimum": 0, "type": "number" } }, "required": [ "host" ], "x-ordering": [ "host", "port" ], "additionalProperties": false }, "logconfig": { "id": "https://non-existing.saltstack.com/schemas/logconfig.json#", "title": "Logging Configuration", "description": "This is the logging configuration", "type": "object", "properties": { "log_level": { "default": "debug", "minimum": 1, "type": "string", "description": "The logging level", "title": "Logging Level" } }, "required": [ "log_level" ], "x-ordering": [ "log_level" ], "additionalProperties": false } }, "additionalProperties": false } >>> import jsonschema >>> jsonschema.validate( {'hostconfig': {'host': 'localhost', 'port': 80}, 'logconfig': {'log_level': 'debug'}}, MyConfig.serialize()) >>> jsonschema.validate( {'hostconfig': {'host': 'localhost', 'port': -1}, 'logconfig': {'log_level': 'debug'}}, MyConfig.serialize()) Traceback (most recent call last): File "<stdin>", line 1, in <module> File "/usr/lib/python2.7/site-packages/jsonschema/validators.py", line 478, in validate cls(schema, *args, **kwargs).validate(instance) File "/usr/lib/python2.7/site-packages/jsonschema/validators.py", line 123, in validate raise error jsonschema.exceptions.ValidationError: -1 is less than the minimum of 0 Failed validating 'minimum' in schema['properties']['hostconfig']['properties']['port']: {'default': 80, 'description': 'The port number', 'inclusiveMinimum': False, 'maximum': 65535, 'minimum': 0, 'type': 'number'} On instance['hostconfig']['port']: -1 >>> If however, you just want to use the configuration blocks for readability and do not desire the nested dictionaries serialization, you can pass ``flatten=True`` when defining a configuration section as a configuration subclass attribute: .. code-block:: python class MyConfig(Schema): title = 'My Config' description = 'This my configuration' hostconfig = HostConfig(flatten=True) logconfig = LoggingConfig(flatten=True) The JSON Schema string version of the above is: .. code-block:: python >>> print(salt.utils.json.dumps(MyConfig, indent=4)) { "$schema": "http://json-schema.org/draft-04/schema#", "title": "My Config", "description": "This my configuration", "type": "object", "properties": { "host": { "minimum": 1, "type": "string", "description": "The looong host description", "title": "Host" }, "port": { "description": "The port number", "default": 80, "inclusiveMinimum": false, "maximum": 65535, "minimum": 0, "type": "number" }, "log_level": { "default": "debug", "minimum": 1, "type": "string", "description": "The logging level", "title": "Logging Level" } }, "x-ordering": [ "host", "port", "log_level" ], "additionalProperties": false } � N�� OrderedDictz*https://non-existing.saltstack.com/schemas�P c @ s e Zd ZdZdd� ZeZdS )� NullSentinelzt A class which instance represents a null value. Allows specifying fields with a default value of null. c C s dS )NF� ��selfr r �E/opt/saltstack/salt/lib/python3.10/site-packages/salt/utils/schema.py�__bool__T s zNullSentinel.__bool__N)�__name__� __module__� __qualname__�__doc__r Z __nonzero__r r r r r N s r c O s t d��)Nz*Can't create another NullSentinel instance)� TypeError)�args�kwargsr r r � _failing_newb s r c @ s* e Zd Zedd� �Zdd� Zd dd�ZdS ) � SchemaMetac C � t � S �Nr ��mcs�name�basesr r r � __prepare__k � zSchemaMeta.__prepare__c C s$ d|d< d|d< d |d< i }i }g }t |�D ]#}t|d�r#|�|j� t|d�r.|�|j� t|d�r9|�|j� q|�� D ]?\}} d } t| d �sOt| d�sOq>t| d �rjt| d �ra| jd u ra|| _| j pe|} | || < t| d�rx| j ps|} | || < |� | � q>||d< ||d< ||d< t � | |||�S ) NTZ __config__F� __flatten__�__config_name__�_items� _sections�_order�__item__�title)�reversed�hasattr�updater r �extendr �itemsr" � __item_name__r �append�type�__new__) r r r �attrsr' Zsections�order�base�key�valueZ entry_namer r r r+ o s> � zSchemaMeta.__new__Fc K sH t �| �}|�dd �|_|du rd|_|du rd|_|jdi |�� |S )Nr Tr )�objectr+ �popr r �__allow_additional_items__�__init__)�cls�flattenZallow_additional_itemsr �instancer r r �__call__� s zSchemaMeta.__call__N)FF)r r r � classmethodr r+ r8 r r r r r j s *r c @ s, e Zd ZdZedd� �Zdd� Zdd� ZdS ) �BaseSchemaItemMetazJ Config item metaclass to "tag" the class as a configuration item c C r r r r r r r r � r z BaseSchemaItemMeta.__prepare__c C s� d|d< d |d< g }t |�D ]9}z.t|dg �}|r |�|� tjj�|j�jD ]}|dks1||v r2q'|dkr7q'|�|� q'W q t yG Y qw ||d< t � | |||�S )NTr! r( � _attributesr r ) r# �getattrr& �salt�utilsr Zget_function_argspecr4 r) r r* r+ )r r r r, Z attributesr. Zbase_attributes�argnamer r r r+ � s( � �zBaseSchemaItemMeta.__new__c O s� t �| �}|r td��|�� D ]}|dkr |�|�|_q||jvr'|j�|� q|j|i |�� t t � | ��D ]}t |dd �}|rN|j jj|jurN|� |� q7|� � |S )NzRPlease pass all arguments as named arguments. Un-named arguments are not supportedr �__validate_attributes__)r1 r+ � RuntimeError�copyr2 r( r; r) r4 r# �inspectZgetmror< r@ �__func__�__code__)r5 r r r7 r/ r. Zvalidate_attributesr r r r8 � s. � � � �zBaseSchemaItemMeta.__call__N)r r r r r9 r r+ r8 r r r r r: � s r: c @ sR e Zd ZdZdZdZd Z ZZdZ dZ e d dd��Z e dd� �Z e dd � �ZdS ) �Schemaz( Configuration definition class NFc C sv t � }|d urt� d|� d�|d< nd|d< | jd ur | j|d< | jd ur;| j| jkr6t�| j��� |d< n| j|d< g }g }d|d < t � }g | _| j D ]�}d }d }|| j v r�| j | } | � | j d u red n|�} | j d u r�|� | d � d | v r|�| d � d| v r�|�| d � t| d�r�| j�| j� d }n| ||< || jv r�| j| } | jp�|}| j d u r�| � � } | j�| � d }n| � � ||< | jr�|�|� |d u r�|d ur�||vr�|�|� qL||vr�|�|� qL|r�||d < | j�r&i } | jD ]$}|�� D ] \}}|| v �rt| | t��r| | �|� q�|| |< q�q�| �r&| � |� | }|�r-||d< |�r4||d < | j|d< |S )N�/z.json#�idz'http://json-schema.org/draft-04/schema#z$schemar" � descriptionr1 r* FT� propertiesz x-ordering�required�after_items_update�additionalProperties)r �BASE_SCHEMA_URLr" rI r �textwrap�dedent�striprL r r � serializer r% r& r$ r r( r) rK r' � isinstance�listr3 )r5 �id_� serializedrK ZorderingrJ r Z skip_orderZ item_name�sectionZserialized_section�configZserialized_configrL �entry�datar r r rR � s� � � � � � zSchema.serializec C sx | � � }i }|d �� D ]-\}}d|v r|d ||< q d|v r9|d �� D ]\}}d|v r7|d |�|i �|< q%q q |S )NrJ �default)rR r' � setdefault)r5 rV �defaultsr �detailsZsnameZsdetailsr r r r] ^ s ��zSchema.defaultsc C s> | � � }|�dg �}|d D ] }||vr|�|� qt|d�S )NrK rJ )� requirements)rR �getr) �RequirementsItem)r5 Zserialized_schemarK r r r r �as_requirements_itemm s � zSchema.as_requirements_itemr )r r r r r" rI r r r r r3 r9 rR r] rb r r r r rF � s ` rF )� metaclassc @ sJ e Zd ZdZdZdZdZdZdZdZ d dd�Z dd� Z dd � Z d d � Z dS ) � SchemaItem�R Base configuration items class. All configurations must subclass it NFc K s |dur|| _ || _dS )z` :param required: If the configuration item is required. Defaults to ``False``. N)rK �extra)r rK rf r r r r4 � s zSchemaItem.__init__c C s | j dvr td��dS )a Run any validation check you need the instance attributes. ATTENTION: Don't call the parent class when overriding this method because it will just duplicate the executions. This class'es metaclass will take care of that. )TFz!'required' can only be True/FalseN)rK rA r r r r r@ � s �z"SchemaItem.__validate_attributes__c C st t | d|� d�d�}|durt|�r|� }|du r t | |d�}|du r-t | d|� d�d�}|du r8| j�|d�}|S )zP Return the argname value looking up on all possible attributes Z__get_�__N)r< �callablerf r` )r r? �argvaluer r r �_get_argname_value� s z SchemaItem._get_argname_valuec C s t �)�C Return a serializable form of the config instance )�NotImplementedErrorr r r r rR � s zSchemaItem.serializer )r r r r �__type__� __format__r; r �__serialize_attr_aliases__rK r4 r@ rj rR r r r r rd � s rd c sX e Zd ZdZdZdZdZdZdZ d � fdd� Z dd� Z dd� Z d d � Z � Z S ) �BaseSchemaItemre Nc �\ |dur|| _ |dur|| _|dur|| _|dur || _|dur#|| _t� jdi |�� dS )aA :param required: If the configuration item is required. Defaults to ``False``. :param title: A short explanation about the purpose of the data described by this item. :param description: A detailed explanation about the purpose of the data described by this item. :param default: The default value for this configuration item. May be :data:`.Null` (a special value to set the default value to null). :param enum: A list(list, tuple, set) of valid choices. Nr )r" rI r[ �enum� enumNames�superr4 )r r" rI r[ rr rs r �� __class__r r r4 � s zBaseSchemaItem.__init__c C s� | j d ur t| j tttf�std��t| j t�s t| j �| _ | jd urLt| jtttf�s0td��t| j �t| j�kr>td��t| jt�sNt| j�| _d S d S d S )NzLOnly the 'list', 'tuple' and 'set' python types can be used to define 'enum'zQOnly the 'list', 'tuple' and 'set' python types can be used to define 'enumNames'z5The size of 'enumNames' must match the size of 'enum')rr rS rT �tuple�setrA rs �lenr r r r r@ � s( � �� � z&BaseSchemaItem.__validate_attributes__c C sd d| j i}| jD ]'}|dkrq| �|�}|dur/|tu r d}| jr+|| jv r+| j| }|||< q|S )rk r* rK N)rm r; rj �Nullro )r rV r? ri r r r rR s � �zBaseSchemaItem.serializec C s0 | j d ur| j | jkrt�| j ��� S | j S d S r )rI r rO rP rQ r r r r �__get_description__, s �z"BaseSchemaItem.__get_description__�NNNNN)r r r r rI r" r[ rr rs r4 r@ rR r{ � __classcell__r r ru r rp � s �"rp c @ � e Zd ZdZdS )�NullItem�nullN�r r r rm r r r r r R � r c @ r~ )� BooleanItemZbooleanNr� r r r r r� W � r� c sP e Zd ZdZdZddd�ZdZdZdZdZ d � fdd� Z d d � Z � Z S ) � StringItemz& A string configuration field �stringZ minLengthZ maxLength)� min_length� max_lengthNc sN |dur|| _ |dur|| _|dur|| _|dur || _t� jdi |�� dS )a� :param required: If the configuration item is required. Defaults to ``False``. :param title: A short explanation about the purpose of the data described by this item. :param description: A detailed explanation about the purpose of the data described by this item. :param default: The default value for this configuration item. May be :data:`.Null` (a special value to set the default value to null). :param enum: A list(list, tuple, set) of valid choices. :param format: A semantic format of the string (for example, ``"date-time"``, ``"email"``, or ``"uri"``). :param pattern: A regular expression (ECMA 262) that a string value must match. :param min_length: The minimum length :param max_length: The maximum length Nr )�format�patternr� r� rt r4 )r r� r� r� r� r ru r r r4 i s zStringItem.__init__c C s( | j d u r| jd ur| j| _ d S d S d S r )r� rn r r r r r@ � s �z"StringItem.__validate_attributes__)NNNN) r r r r rm ro r� r� r� r� r4 r@ r} r r ru r r� [ s �'r� c @ � e Zd ZdZdZdS )� EMailItemzt An internet email address, see `RFC 5322, section 3.4.1`__. .. __: http://tools.ietf.org/html/rfc5322 �emailN�r r r r rn r r r r r� � � r� c @ r� )�IPv4Itemz� An IPv4 address configuration field, according to dotted-quad ABNF syntax as defined in `RFC 2673, section 3.2`__. .. __: http://tools.ietf.org/html/rfc2673 Zipv4Nr� r r r r r� � s r� c @ r� )�IPv6Itemz� An IPv6 address configuration field, as defined in `RFC 2373, section 2.2`__. .. __: http://tools.ietf.org/html/rfc2373 Zipv6Nr� r r r r r� � r� r� c @ r� )� HostnameItemz� An Internet host name configuration field, see `RFC 1034, section 3.1`__. .. __: http://tools.ietf.org/html/rfc1034 �hostnameNr� r r r r r� � r� r� c @ r� )� DateTimeItemz� An ISO 8601 formatted date-time configuration field, as defined by `RFC 3339, section 5.6`__. .. __: http://tools.ietf.org/html/rfc3339 z date-timeNr� r r r r r� � r� r� c @ r� )�UriItemz� A universal resource identifier (URI) configuration field, according to `RFC3986`__. .. __: http://tools.ietf.org/html/rfc3986 ZuriNr� r r r r r� � r� r� c @ r� )� SecretItemza A string configuration field containing a secret, for example, passwords, API keys, etc ZsecretNr� r r r r r� � s r� c sL e Zd ZdZdddd�ZdZdZdZdZdZ d � fdd� Z � Z S ) � NumberItem�numberZ multipleOfZexclusiveMinimumZexclusiveMaximum)� multiple_of�exclusive_minimum�exclusive_maximumNc rq )a� :param required: If the configuration item is required. Defaults to ``False``. :param title: A short explanation about the purpose of the data described by this item. :param description: A detailed explanation about the purpose of the data described by this item. :param default: The default value for this configuration item. May be :data:`.Null` (a special value to set the default value to null). :param enum: A list(list, tuple, set) of valid choices. :param multiple_of: A value must be a multiple of this factor. :param minimum: The minimum allowed value :param exclusive_minimum: Whether a value is allowed to be exactly equal to the minimum :param maximum: The maximum allowed value :param exclusive_maximum: Whether a value is allowed to be exactly equal to the maximum Nr )r� �minimumr� �maximumr� rt r4 )r r� r� r� r� r� r ru r r r4 � s zNumberItem.__init__r| ) r r r rm ro r� r� r� r� r� r4 r} r r ru r r� � s" ��r� c @ r~ )� IntegerItem�integerNr� r r r r r� r� r� c s^ e Zd ZdZddddd�ZdZdZdZdZdZ d� fdd � Z d d � Z d d � Z � Z S )� ArrayItem�arrayZminItemsZmaxItemsZ uniqueItemsZadditionalItems)� min_items� max_items� unique_items�additional_itemsNc rq )a� :param required: If the configuration item is required. Defaults to ``False``. :param title: A short explanation about the purpose of the data described by this item. :param description: A detailed explanation about the purpose of the data described by this item. :param default: The default value for this configuration item. May be :data:`.Null` (a special value to set the default value to null). :param enum: A list(list, tuple, set) of valid choices. :param items: Either of the following: * :class:`BaseSchemaItem` -- all items of the array must match the field schema; * a list or a tuple of :class:`fields <.BaseSchemaItem>` -- all items of the array must be valid according to the field schema at the corresponding index (tuple typing); :param min_items: Minimum length of the array :param max_items: Maximum length of the array :param unique_items: Whether all the values in the array must be distinct. :param additional_items: If the value of ``items`` is a list or a tuple, and the array length is larger than the number of fields in ``items``, then the additional items are described by the :class:`.BaseField` passed using this argument. :type additional_items: bool or :class:`.BaseSchemaItem` Nr )r' r� r� r� r� rt r4 )r r' r� r� r� r� r ru r r r4 + s &zArrayItem.__init__c C s� | j s | js td��| j d urAt| j ttf�r/| j D ]}t|ttf�s,td�t |����qd S t| j ttf�sCtd�t | j ����d S d S )Nz0One of items or additional_items must be passed.zsAll items passed in the item argument tuple/list must be a subclass of Schema, SchemaItem or BaseSchemaItem, not {}z\The items argument passed must be a subclass of Schema, SchemaItem or BaseSchemaItem, not {}) r' r� rA rS rT rw rF rd r� r* �r �itemr r r r@ ] s& ��� �� z!ArrayItem.__validate_attributes__c C sP t | jttf�r | j�� S t | jttf�r&g }| jD ] }|�|�� � q|S d S r )rS r' rF rd rR rw rT r) )r r' r� r r r � __get_items__p s �zArrayItem.__get_items__r| )r r r rm ro r' r� r� r� r� r4 r@ r� r} r r ru r r� s( ��2r� c s� e Zd ZdZddddd�ZdZdZdZdZdZ d� fdd � Z d d � Z d d � Z dd� Z dd� Zddd�Z� fdd�Z� ZS )�DictItemr1 Z minPropertiesZ maxPropertiesZpatternPropertiesrM )�min_properties�max_properties�pattern_properties�additional_propertiesNc rq )a~ :param required: If the configuration item is required. Defaults to ``False``. :type required: boolean :param title: A short explanation about the purpose of the data described by this item. :type title: str :param description: A detailed explanation about the purpose of the data described by this item. :param default: The default value for this configuration item. May be :data:`.Null` (a special value to set the default value to null). :param enum: A list(list, tuple, set) of valid choices. :param properties: A dictionary containing fields :param pattern_properties: A dictionary whose keys are regular expressions (ECMA 262). Properties match against these regular expressions, and for any that match, the property is described by the corresponding field schema. :type pattern_properties: dict[str -> :class:`.Schema` or :class:`.SchemaItem` or :class:`.BaseSchemaItem`] :param additional_properties: Describes properties that are not described by the ``properties`` or ``pattern_properties``. :type additional_properties: bool or :class:`.Schema` or :class:`.SchemaItem` or :class:`.BaseSchemaItem` :param min_properties: A minimum number of properties. :type min_properties: int :param max_properties: A maximum number of properties :type max_properties: int Nr )rJ r� r� r� r� rt r4 )r rJ r� r� r� r� r ru r r r4 � s ,zDictItem.__init__c C s" | j s | js | js td��| j d urEt| j ttf�s$td�t| j ����t| j t�sE| j � � D ]\}}t|tt f�sDtd�|t|����q/| jd urut| jt�sZtd�t| j����| j� � D ]\}}t|tt f�sttd�|t|����q_| jd ur�t| jt tt f�s�td�t| j����d S d S )NzMOne of properties, pattern_properties or additional_properties must be passedzDThe passed properties must be passed as a dict or a Schema not '{}'zdThe passed property who's key is '{}' must be of type Schema, SchemaItem or BaseSchemaItem, not '{}'z?The passed pattern_properties must be passed as a dict not '{}'zlThe passed pattern_property who's key is '{}' must be of type Schema, SchemaItem or BaseSchemaItem, not '{}'zeThe passed additional_properties must be of type bool, Schema, SchemaItem or BaseSchemaItem, not '{}') rJ r� r� rA rS rF �dictr� r* r' rd �bool)r r/ �propr r r r@ � s\ ���� � �� � �� ���z DictItem.__validate_attributes__c C sR | j d u rd S t| j t�r| j �� d S t� }| j �� D ] \}}|�� ||< q |S )NrJ )rJ rS rF rR r r' )r rJ r/ r� r r r �__get_properties__� s zDictItem.__get_properties__c C s8 | j d u rd S t� }| j �� D ] \}}|�� ||< q|S r )r� r r' rR )r r� r/ r� r r r �__get_pattern_properties__� s z#DictItem.__get_pattern_properties__c C s* | j d u rd S t| j t�r| j S | j �� S r )r� rS r� rR r r r r � __get_additional_properties__ s z&DictItem.__get_additional_properties__Fc C � || _ | S r �r �r r6 r r r r8 � zDictItem.__call__c sz t � �� }g }| jd ur5t| jt�r#| j�� }d|v r"|�|d � n| j�� D ] \}}|jr4|�|� q(|r;||d< |S �NrK ) rt rR rJ rS rF r& r' rK r) )r �resultrK rV r/ r� ru r r rR s � �zDictItem.serializer| �F)r r r rm ro rJ r� r� r� r� r4 r@ r� r� r� r8 rR r} r r ru r r� | s0 ��8. r� c �6 e Zd ZdZdZd � fdd� Zdd� Zdd� Z� ZS ) ra r1 Nc � |d ur|| _ t� �� d S r )r_ rt r4 )r r_ ru r r r4 & � zRequirementsItem.__init__c C s� | j d u r td��t| j ttttf�std�| j ���t| j t�sIt| j t�s-t| j �| _ t| j �D ]\}}t|t ftf�sHtd�|t |����q2d S d S )Nz)The passed requirements must not be emptyzcThe passed requirements must be passed as a list, tuple, set SchemaItem or BaseSchemaItem, not '{}'zRThe passed requirement at the {} index must be of type str or SchemaItem, not '{}') r_ rA rS rd rT rw rx r� � enumerate�strr* �r �idxr� r r r r@ + s& � ���z(RequirementsItem.__validate_attributes__c C sZ t | jt�r| j�� }d|iS g }| jD ]}t |t�r#|�|�� � q|�|� qd|iS r� )rS r_ rd rR r) )r r_ Z requirementr r r rR ? s � zRequirementsItem.serializer ) r r r rm r_ r4 r@ rR r} r r ru r ra ! s ra c s@ e Zd ZdZdZd � fdd� Zdd� Zd dd �Zd d � Z� Z S )� OneOfItemZoneOfNc s |d ur|| _ t� j|d� d S )N�rK )r' rt r4 )r r' rK ru r r r4 R s zOneOfItem.__init__c C s� | j std��t| j ttf�std�t| j ����t| j �D ]\}}t|tt f�s3td�|t|����q t| j t�sBt| j �| _ d S d S )Nz"The passed items must not be emptyz8The passed items must be passed as a list/tuple not '{}'z^The passed item at the {} index must be of type Schema, SchemaItem or BaseSchemaItem, not '{}') r' rA rS rT rw r� r* r� rF rd r� r r r r@ W s$ �� �� �z!OneOfItem.__validate_attributes__Fc C r� r r� r� r r r r8 j r� zOneOfItem.__call__c C s | j dd� | jD �iS )Nc S s g | ]}|� � �qS r )rR )�.0�ir r r � <listcomp>o s z'OneOfItem.serialize.<locals>.<listcomp>)rm r' r r r r rR n s zOneOfItem.serialize�NNr� ) r r r rm r' r4 r@ r8 rR r} r r ru r r� L s r� c @ r~ )� AnyOfItemZanyOfNr� r r r r r� r r� r� c @ r~ )� AllOfItemZallOfNr� r r r r r� w r� r� c r� ) �NotItem�notNc r� r )r� rt r4 r� ru r r r4 � r� zNotItem.__init__c C s6 | j std��t| j ttf�std�t| j ����d S )NzAn item must be passedzIThe passed item be of type Schema, SchemaItem or BaseSchemaItem, not '{}')r� rA rS rF rd r� r* r r r r r@ � s ��z NotItem.__validate_attributes__c C s | j | j�� iS r )rm r� rR r r r r rR � s zNotItem.serializer ) r r r rm r� r4 r@ rR r} r r ru r r� | s r� c @ r� )�PortItemr i�� N)r r r r� r� r r r r r� � s r� c sZ e Zd ZdZg ZdZd� fdd� Zdd� Zedd� �Z d d � Z � fd d �Z d d� Z � Z S )�ComplexSchemaItemz> .. versionadded:: 2016.11.0 Complex Schema Item Nc s2 t � j|d� d| _|r|n| jj| _| �� d S )Nr� r1 )rt r4 rm rv r �_definition_name� _add_missing_schema_attributes)r �definition_namerK ru r r r4 � s � zComplexSchemaItem.__init__c C sL dd� t | �D �D ]}t| |�}tt| |�t�r#|| jvr#| j�|� q dS )z� Adds any missed schema attributes to the _attributes list The attributes can be class attributes and they won't be included in the _attributes list automatically c S s g | ] }|� d �s|�qS )rg )� startswith)r� �attrr r r r� � s zDComplexSchemaItem._add_missing_schema_attributes.<locals>.<listcomp>N)�dirr< rS rd r; r) )r r� Zattr_valr r r r� � s � ��z0ComplexSchemaItem._add_missing_schema_attributesc C s | j S r )r� r r r r r� � r z!ComplexSchemaItem.definition_namec C s dd| j � �iS )zc The serialization of the complex item is a pointer to the item definition z$refz#/definitions/)r� r r r r rR � s zComplexSchemaItem.serializec s� t � �� }|d= | j|d< i }g }| jD ]&}t| |�}|r:t|t�r:||= |�� ||< |j|| d< |jr:|� |� q|� d�du rFi |d< |d � |� |rS||d< |S )z*Returns the definition of the complex itemr� r" r* rJ NrK ) rt rR r� r; r< rS rp rm rK r) r` r% )r rV rJ Zrequired_attr_names� attr_namer� ru r r �get_definition� s( �z ComplexSchemaItem.get_definitionc s � fdd�� j D �S )z.Returns a dictionary of the complex attributesc s& g | ]}t t� |�t�rt� |��qS r )rS r< r� )r� r� r r r r� � s ��z7ComplexSchemaItem.get_complex_attrs.<locals>.<listcomp>)r; r r r r �get_complex_attrs� s �z#ComplexSchemaItem.get_complex_attrsr� )r r r r r; r� r4 r� �propertyr� rR r� r� r} r r ru r r� � s r� c s& e Zd ZdZed� fdd� �Z� ZS )�DefinitionsSchemaa .. versionadded:: 2016.11.0 JSON schema class that supports ComplexSchemaItem objects by adding a definitions section to the JSON schema, containing the item definitions. All references to ComplexSchemaItems are built using schema inline dereferencing. Nc s� t � �|�}g }| j�� }t|�}|rb|�d�}t|t�r)|�|� |� |� � � t|t �r5|� |j � n+t|t �rA|�|j � n t|t�r`|jrQ|� |j�� � |jr`t|jt�r`|�|j� |st� }|D ]}t|t�ru|�� ||j< qg||d< |S )Nr � definitions)rt rR r �valuesrT r2 rS r� r) r& r� r� r' r� r� rJ r� rd r r� r� )r5 rU rV Z complex_itemsZ aux_itemsr� r� rX ru r r rR � s8 � � �zDefinitionsSchema.serializer )r r r r r9 rR r} r r ru r r� � s r� )*r rC rO � collectionsr Zsalt.utils.argsr= rN Z#RENDER_COMMENT_YAML_MAX_LINE_LENGTHr rz r � staticmethodr+ r* r r: rF rd rp r r� r� r� r� r� r� r� r� r� r� r� r� r� ra r� r� r� r� r� r� r� r r r r �<module> sZ C @G @ : =a &+&W
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings