File manager - Edit - /usr/lib/python3/dist-packages/cloudinit/config/__pycache__/schema.cpython-310.pyc
Back
o o@�d � � @ sz d Z ddlZddlZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z ddlmZ ddlmZ ddlmZmZmZmZmZmZmZ ddlZdd lm Z m Z dd l m Z dd l m!Z!m"Z" dd l#m$Z$m%Z%m&Z&m'Z' z dd l(m)Z* e*Z)W n e+y� e,Z)Y nw e�-e.�Z/dZ0dZ1dddd�Z2dZ3dZ4dZ5dZ6dZ7dZ8dZ9dZ:e;d d � e!�<� D ��Z=er�ddlZdd l>m?Z?m@Z@ G d d � d e@�ZAneBZAG d!d"� d"e)�ZCG d#d$� d$e�ZDeeD ZEdd%d&�d'eEd(eeF d)eFd*eFfd+d,�ZGG d-d.� d.eH�ZId/d0� ZJ d�d2eBd*eFfd3d4�ZKeCfdeLd5eBd6eFd7ee, fd8d9�ZMeeMdd:�ZNeeMd;d:�ZOeCfd7ee, fd<d=�ZPeCfd7ee, fd>d?�ZQd@dA� ZRd�d5eBfdCdD�ZS 1 1 B 1d�d2eBd5eeB dEeLdFeLdGeLdHeLf dIdJ�ZTG dKdL� dL�ZUdddM�dNeBdOeVdPeBdQeeE dReeE d*eeFeVf f dSdT�ZW 1 d�dUeFd5eBdVeLdWeFfdXdY�ZXdZd[� ZYd\d]� ZZd^eBd_eFd*eeF fd`da�Z[d^eBdbeBd*eFfdcdd�Z\d*eFfdedf�Z]dgeBdbeBfdhdi�Z^dgeBfdjdk�Z_dleBd*eFfdmdn�Z`d�d5eBdbeBd*eFfdpdq�ZadreAd*eFfdsdt�ZbdreAd*eFfdudv�Zcd�dreAd5eeB d*eFfdwdx�Zdd*eBfdydz�Zed{efd*eFfd|d}�Zgd*eFfd~d�Zhd*eBfd�d��Zid�d�d��Zjd�d�� Zkd�d�� Zle.d�k�r;e�mel� � dS dS )�zFschema.py: Set of module functions for processing cloud-config schema.� N)� defaultdict)�Iterable)�deepcopy)�partial)�chain)� TYPE_CHECKING�List� NamedTuple�Optional�Type�Union�cast)�importer�safeyaml)�read_cfg_paths)�INCLUSION_TYPES_MAP�type_from_starts_with)� decode_binary�error�get_modules_from_dir� load_file��ValidationErrorz!versions.schema.cloud-config.jsonzschema-cloud-config-v1.json�true�false�null)TFNz� {name} {title_underbar} **Summary:** {title} {description} **Internal name:** ``{id}`` **Module frequency:** {frequency} **Supported distros:** {distros} {activate_by_schema_keys}{property_header} {property_doc} {examples} z**Config schema**:z3{prefix}**{prop_name}:** ({prop_type}){description}zH{prefix}Each object in **{prop_name}** list supports the following keys:z**Examples**:: z # --- Example{0} ---� deprecatedz DEPRECATED: c C s g | ] }|d dkr|�qS )r �#� )�.0�tr r �9/usr/lib/python3/dist-packages/cloudinit/config/schema.py� <listcomp>J s r" )� NotRequired� TypedDictc @ sb e Zd ZU eed< eed< eed< eed< eje ed< eje ed< eed< eee ed< d S ) � MetaSchema�name�id�title� description�distros�examples� frequency�activate_by_schema_keysN)�__name__� __module__� __qualname__�str�__annotations__�typingr r# r r r r! r% T s r% c @ s e Zd ZdS )�SchemaDeprecationErrorN)r. r/ r0 r r r r! r4 b s r4 c @ s, e Zd ZU eed< eed< defdd�ZdS )� SchemaProblem�path�message�returnc C s | j � d| j� �S )N�: )r6 r7 ��selfr r r! �formatj s zSchemaProblem.formatN)r. r/ r0 r1 r2 r< r r r r! r5 f s r5 �, ��prefix� separator�schema_problemsr? r@ r8 c C s( |� tdd� | ��}|r|� |� �}|S )Nc S s | � � S �N)r< )�pr r r! �<lambda>w s z)_format_schema_problems.<locals>.<lambda>)�join�map)rA r? r@ � formattedr r r! �_format_schema_problemsq s rH c sF e Zd ZdZ d dee dee f� fdd� Zdefdd �Z� Z S ) �SchemaValidationErrorz<Raised when validating a cloud-config file against a schema.N� schema_errors�schema_deprecationsc s< d� � fdd�}||dd�| _ ||dd�| _t� �� � dS )z�Init the exception an n-tuple of schema errors. @param schema_errors: An n-tuple of the format: ((flat.config.key, msg),) @param schema_deprecations: An n-tuple of the format: ((flat.config.key, msg),) � c s8 | s| S � r � d7 � t tt| ���} � t| |d�7 � | S )N� �r? )�sorted�list�setrH )�problemsr? �r7 r r! �handle_problems� s z7SchemaValidationError.__init__.<locals>.handle_problemsz Cloud config schema errors: rN �"Cloud config schema deprecations: N)rJ rK �super�__init__)r; rJ rK rT �� __class__rS r! rW � s ��z SchemaValidationError.__init__r8 c C s t | j�S rB )�boolrJ r: r r r! � has_errors� s z SchemaValidationError.has_errors)NN) r. r/ r0 �__doc__r �SchemaProblemsrW rZ r[ � __classcell__r r rX r! rI } s ���"rI c C s@ zddl m} W n ty Y dS w |j�|d�p t|tf�S )zWTYPE_CHECKER override allowing bytes for string type For jsonschema v. 3.0.0+ r )�Draft4ValidatorF�string)� jsonschemar_ � ImportError� TYPE_CHECKER�is_type� isinstance�bytes)�checker�instancer_ r r r! �is_schema_byte_string� s �� �ri F�configc sP dt f� �fdd� }|r|ng d�}d�t||��}��dd�}|� |� ��� S )z�combine description with new/changed/deprecated message deprecated/changed/new keys require a _version key (this is verified in a unittest), a _description key is optional �keyc sr �� | � �sdS �� | � d�d�}�� | � d�d| � d��}| �� � d|� d|� �}� r1d|� �S d |�� � d �S ) NrL � _description�_versionz <missing z'_version key, please file a bug report>z in version �. � z *�*)�get� capitalize�strip)rk �key_description�v�msg��annotaterj r r! �format_message� s � z:_add_deprecated_changed_or_new_msg.<locals>.format_message)r �changed�newrL r) )r1 rE rF rq �rstrip)rj rx � filter_keyry � filter_keys�changed_new_deprecatedr) r rw r! �"_add_deprecated_changed_or_new_msg� s � r� �schemar} � error_typec c s( � |rt |d|gd�}||�V dS dS )z�Jsonschema validator for `deprecated` items. It raises a instance of `error_type` if deprecated that must be handled, otherwise the instance is consider faulty. T)rx r} N)r� )� _validatorr � _instancer� r} r� rv r r r! r� � s � ��r� )r} rz c # s� � ddl m} g }g }t|�D ]2\}} t| j|| |d��} tt� fdd�| ��} tt� fdd�| ��} | s<|�| � n|�| � q|d|f |d�V |E d H d S ) z�Jsonschema validator for `anyOf`. It treats occurrences of `error_type` as non-errors, but yield them for external processing. Useful to process schema annotations, as `deprecated`. r r �� schema_pathc � t | � � S rB �re ��e�r� r r! rD � z_anyOf.<locals>.<lambda>c � t | � �S rB r� r� r� r r! rD � �.%r is not valid under any of the given schemas��contextN)ra r � enumeraterP �descend�filter�extend) � validator�anyOfrh �_schemar� r � all_errors�all_deprecations�index� subschema�all_errs�errs� deprecationsr r� r! �_anyOf� s* � �� �r� c # s� � ddl m} t|�}g }g }|D ]4\} } t�j�| | d��} tt� fdd�| ��} tt� fdd�| ��} | s@| }|�| � n|�| � q|d�f |d�V ��fd d �|D �}|rv|�|� d �d d � |D ��}|d�|f �V dS |E dH dS )z�Jsonschema validator for `oneOf`. It treats occurrences of `error_type` as non-errors, but yield them for external processing. Useful to process schema annotations, as `deprecated`. r r r� c r� rB r� r� r� r r! rD ( r� z_oneOf.<locals>.<lambda>c r� rB r� r� r� r r! rD * r� r� r� c s g | ] \}}�� � |�r|�qS r )�is_valid)r �i�s)rh r� r r! r" 7 s z_oneOf.<locals>.<listcomp>r= c s s � | ]}t |�V qd S rB )�repr)r r� r r r! � <genexpr>: � � z_oneOf.<locals>.<genexpr>z %r is valid under each of %sN) ra r r� rP r� r� r� �appendrE )r� �oneOfrh r� r� r � subschemasr� r� r� r� r� r� r� � first_valid� more_valid�reprsr )r� rh r� r! �_oneOf s< � �� � �r� c C s� ddl m} m} ddlm} t| j�}ddi|d d< i }t| d�r2d |d < | j� dt �}d |i}n | j }t t f|d< d |i}t| j�}t|t< t|d < t|d< t|d< |d||dd�|��}ddd�} | |_||fS )z�Get metaschema validator and format checker Older versions of jsonschema require some compatibility changes. @returns: Tuple: (jsonschema.Validator, FormatChecker) @raises: ImportError when jsonschema is not present r )r_ � FormatChecker)�create�typer` � properties�labelrc F�additionalProperties� type_checker� default_typesrz r� r� �draft4)� meta_schema� validators�versionNc [ s$ t dd� | �||��}t|d�du S )zgOverride version of `is_valid`. It does ignore instances of `SchemaDeprecationError`. c S s t | t� S rB )re r4 r� r r r! rD � s �z<get_jsonschema_validator.<locals>.is_valid.<locals>.<lambda>N)r� � iter_errors�next)r; rh r� �__�errorsr r r! r� | s �z*get_jsonschema_validator.<locals>.is_validr rB )ra r_ r� �jsonschema.validatorsr� r � META_SCHEMA�hasattrrc �redefineri � DEFAULT_TYPESr1 rf �dict� VALIDATORS�_validator_deprecated�DEPRECATED_KEY�_validator_changedr� r� r� ) r_ r� r� r� �validator_kwargsr� �typesr� �cloudinitValidatorr� r r r! �get_jsonschema_validatorB s< �� �� r� Tc C s| ddl m} z| �|� W dS |y= } z#|r,ttd�dd� |jD ��|j�gd�|�t� d|� W Y d}~dS d}~ww ) a Validate provided schema meets the metaschema definition. Return strict Validator and FormatChecker for use in validation @param validator: Draft4Validator instance used to validate the schema @param schema: schema to validate @param throw: Sometimes the validator and checker are required, even if the schema is invalid. Toggle for whether to raise SchemaValidationError or log warnings. @raises: ImportError when jsonschema is not present @raises: SchemaValidationError when the schema is invalid r )� SchemaError�.c S � g | ]}t |��qS r �r1 �r rC r r r! r" � � z3validate_cloudconfig_metaschema.<locals>.<listcomp>�rJ zGMeta-schema validation failed, attempting to validate config anyway: %sN) �jsonschema.exceptionsr� � check_schemarI r5 rE r6 r7 �LOG�warning)r� r� �throwr� �errr r r! � validate_cloudconfig_metaschema� s& �������r� �strict�strict_metaschema� log_details�log_deprecationsc C s$ |du rt � }zt� \}}|rt||dd� W n ty& t�d� Y dS w |||� d�}g } g } t|�| �dd� d�D ]"} d �d d � | j D ��} t | | j �f} t | t �r[| | 7 } q=| | 7 } q=|rp| rpt| d d d�}t�|� |r{| sv| r{t| | ��| r�|r�t| dd d�}nd}t�|� dS dS )a Validate provided config meets the schema definition. @param config: Dict of cloud configuration settings validated against schema. Ignored if strict_metaschema=True @param schema: jsonschema dict describing the supported schema definition for the cloud config module (config.cc_*). If None, validate against global schema. @param strict: Boolean, when True raise SchemaValidationErrors instead of logging warnings. @param strict_metaschema: Boolean, when True validates schema using strict metaschema definition at runtime (currently unused) @param log_details: Boolean, when True logs details of validation errors. If there are concerns about logging sensitive userdata, this should be set to False. @param log_deprecations: Controls whether to log deprecations or not. @raises: SchemaValidationError when provided config does not validate against the provided schema. @raises: RuntimeError when provided config sourced from YAML is not a dict. NF)r� z5Ignoring schema validation. jsonschema is not present)�format_checkerc S s | j S rB )r6 r� r r r! rD � s z-validate_cloudconfig_schema.<locals>.<lambda>�rk r� c S r� r r� r� r r r! r" � r� z/validate_cloudconfig_schema.<locals>.<listcomp>z"Deprecated cloud-config provided: � r> z Invalid cloud-config provided: zeInvalid cloud-config provided: Please run 'sudo cloud-init schema --system' to see the schema errors.)� get_schemar� r� rb r� �debugrO r� rE r6 r5 r7 re r4 rH r rI r� )rj r� r� r� r� r� r� r� r� r� r� � schema_errorr6 �problemr7 �detailsr r r! �validate_cloudconfig_schema� s\ �� � �� � ���r� c @ s� e Zd Zdededefdd�Zededee defd d ��Z d e fd d �Z e d dee dee dee de dede f dd��Z dee dededee fdd�Zde d e deeef fd d �Zd S )!� _Annotator� cloudconfig�original_content� schemamarksc C s || _ || _|| _d S rB )� _cloudconfig�_original_content� _schemamarks)r; r� r� r� r r r! rW s z_Annotator.__init__r( �contentr8 c C s d� |�}d| � d|� d�S )Nr� �# z: ------------- rM )rE )r( r� �bodyr r r! � _build_footer s z_Annotator._build_footerrA c C sz t t�}|D ]4\}}t�d|�}|r"|�� \}}|t|� �|� n d }|| j| �|� |d ur:dj|||d�}q|S )Nz&format-l(?P<line>\d+)\.c(?P<col>\d+).*z Line {line} column {col}: {msg})�line�colrv ) r rP �re�match�groups�intr� r� r< )r; rA �errors_by_liner6 rv r� r� r� r r r! �_build_errors_by_line s ��z _Annotator._build_errors_by_linerL rR �labels�footerr� � label_prefixc C sB | D ] }|� |� �}|� |� |� d|� d|� �� |d7 }q|S )Nr� r9 � )r� )rR r� r� r� r� r� r� r r r! � _add_problems$ s z_Annotator._add_problems�linesr� �deprecations_by_linec s� g }g }g }d}d}t |d�D ]8\} } || } || } | s | rBg } � j| | ||dd�}� j| | ||dd�}|�| d d�| � � q|�| � q|�t� fdd�td d� d |fd |ff��� |S ) Nr� �E)r� �Dz # �,c s � j | � S rB )r� ��seqr: r r! rD S r� z._Annotator._annotate_content.<locals>.<lambda>c S s t | d �S )Nr� )rZ r r r r! rD U r� �Errors� Deprecations)r� r� r� rE r� rF r� )r; r� r� r �annotated_content� error_footer�deprecation_footer� error_index�deprecation_index� line_numberr� r� r� r� r r: r! �_annotate_content3 sD �� ���� z _Annotator._annotate_contentrJ rK c C sp |s|s| j S | j �� �d�}t| jt�s"d�|| �ddg�g �S | �|�}| �|�}| � |||�}d�|�S )Nr� r z&# E1: Cloud-config is not a YAML dict.) r� �decode�splitre r� r� rE r� r� r )r; rJ rK r� r� r r r r r! rx _ s$ ���� � z_Annotator.annotateN)rL )r. r/ r0 r� rf rW � staticmethodr1 r r� r] r� r� r� r r rx r r r r! r� sT �� � ������ ���� �,�� �r� �rJ rK r� r� r� rJ rK c C s t | ||��|p g |p g �S )a� Return contents of the cloud-config file annotated with schema errors. @param cloudconfig: YAML-loaded dict from the original_content or empty dict if unparseable. @param original_content: The contents of a cloud-config file @param schemamarks: Dict with schema marks. @param schema_errors: Instance of `SchemaProblems`. @param schema_deprecations: Instance of `SchemaProblems`. @return Annotated schema )r� rx )r� r� r� rJ rK r r r! �annotated_cloudconfig_filey s �r � config_pathrx �instance_data_pathc C s� ddl m}m}m} t| dd�}t|�}d} |s)tt| d| � dd�t �� ��g��|d vr7t d |� d �� d S |d kr|z |t |�| |�� � }W n. |y\ } z tt| d�g�| �d } ~ w |yu } zt t| �dd� W Y d } ~ nd } ~ ww d} t|�}|s�|d t |��d�� } tt| d| � d| � dd�t �� ��g��z|r�t�|�\} } nt�|�} i } W ne tj�y } zWd }}d }t| d�r�t| d�r�t| d�}nt| d�r�t| d�r�t| d�}|r�|jd }|jd }tdj||d�d�| t| ���g}t|�}|�rt ti |i |jd �� || �d } ~ ww t | t ��s#|�s#t d ��z t | |ddd � W d S t�yi } z.|�rHt t| || | j| j d �� n| j �rXt!| j d dd!�}t |� | �"� �r^� W Y d } ~ d S d } ~ ww )"ay Validate cloudconfig file adheres to a specific jsonschema. @param config_path: Path to the yaml cloud-config file to parse, or None to default to system userdata from Paths object. @param schema: Dict describing a valid jsonschema to validate against. @param annotate: Boolean set True to print original config file with error annotations on the offending lines. @param instance_data_path: Path to instance_data JSON, used for text/jinja rendering. @raises SchemaValidationError containing any of schema_errors encountered. @raises RuntimeError when config_path does not exist. r )�JinjaLoadError� NotJinjaError� render_jinja_payload_from_fileF)r z format-l1.c1z(No valid cloud-init user-data header in z$. Expected first line to be one of: r= )ztext/cloud-config� text/jinja2zUser-data type 'z.' not currently evaluated by cloud-init schemaNr zRDetected type '{user_data_type}' from header. But, content is not a jinja templateT��sys_exitz format-l2.c1r� z!Unrecognized user-data header in r9 z). Expected one of the following headers: r� � context_mark� problem_markzformat-l{line}.c{col})r� r� z File {0} is not valid yaml. {1}r� z Cloud-config is not a YAML dict.)r� r� r rU r> )#�!cloudinit.handlers.jinja_templater r r r r rI r5 rE �USERDATA_VALID_HEADERS�printr �encoder r1 �findr �load_with_marks�load�yaml� YAMLErrorr� �getattrr� �columnr< r rJ re r� � RuntimeErrorr� rK rH r[ )r r� rx r r r r r� �user_data_type�schema_positionr� �content_headerr� �marksr� r( �markr� r� r7 r r r! �validate_cloudconfig_file� s� ���� � ������� ������� � �� ���� ��� � ���r/ c C s | dkrdS | dkr dS dS )z�Provide a sorting weight for documentation of property types. Weight values ensure 'array' sorted after 'object' which is sorted after anything else which remains unsorted. �array� �objectr� r r )�valuer r r! �_sort_property_order s r4 c c s> � | D ]}t |t�rt |ttf�st|�E d H q|V qd S rB )re r r1 rf �_flatten)�xs�xr r r! r5 & s ��r5 � property_dict� multi_keyc C sn g }| � |i �D ](}|� t�rq|� d�r$|�dd� |� dg �D �� q|� d�r0|�|d � qtt|��S )N�enumc S � g | ] }d t �||�� d ��qS ��``�� _YAML_MAPrq )r � enum_valuer r r! r" 5 s ��z,_collect_subschema_types.<locals>.<listcomp>r� )rq r� r� r� rP r5 )r8 r9 �property_typesr� r r r! �_collect_subschema_types. s �� � rB �defsc C sn t | |� | �dg �}t|t�s|g}| �d�r"dd� | d D �}n| �d�r0|�t| d�� n | �d�r=|�t| d�� t|�dkrH|d }n |jtd � d � |�}| �d i �}|�dg �}t|t�sg|g}t |�}t |�di �|�di ��D ]}t ||�}|r�|d kr�qx|� |� qx|r�t|�dkr�|� d |d � �S |jtd � dd � |�� d�} |� d | � �S |p�d S )zNReturn a string representing a property type from a given jsonschema. r� r: c S r; r< r> �r �kr r r! r" I s �z&_get_property_type.<locals>.<listcomp>r� r� r� r r� �/�items� UNDEFINEDz of �(�))�_flatten_schema_refsrq re rP r� rB �len�sortr4 rE rZ r �_get_property_typer� ) r8 rC rA � property_typerG �sub_property_types�prune_undefined�sub_item�sub_type�sub_property_docr r r! rN ? sB � rN c C sB |d }t �dd| �} t �dd�|�| �} t �dd�|�| �} | S )a� Parse description from the meta in a format that we can better display in our docs. This parser does three things: - Guarantee that a paragraph will be in a single line - Guarantee that each new paragraph will be aligned with the first paragraph - Proper align lists of items @param description: The original description in the meta. @param prefix: The number of spaces used to align the current description � z (\S)\n(\S)z\1 \2z\n\nz\n\n{}z\n( +)-z\n{}-)r� �subr< )r) r? �list_paragraphr r r! �_parse_descriptionk s �rX �src_cfgc C s d| v r| � d��dd�}| �|| � d| v rUd| d v r2| d � d��dd�}| d �|| � d| d v rU| d d D ]}d|v rT|� d��dd�}|�|| � q>t| �dg �| �dg �| �dg ��D ]}d|v r}|� d��dd�}|�|| � qgdS ) zEFlatten schema: replace $refs in src_cfg with definitions from $defs.z$refz#/$defs/rL rG r� r� �allOfN)�pop�replace�updater rq )rY rC � reference� sub_schemar r r! rK � s. � ���rK c C s, | � dd�}|s dS |D ]}| �|� q dS )z�Flatten schema: Merge allOf. If a schema as allOf, then all of the sub-schemas must hold. Therefore it is safe to merge them. rZ N)r[ r] )rY � sub_schemasr_ r r r! �_flatten_schema_all_of� s �ra � prop_configc C s� dt dtdtfdd�}| �di �}| �di �}g }g }|| ||� t||�D ]}||||� q&d�t||��}|r>d |� �}|S ) aG Return accumulated property description. Account for the following keys: - top-level description key - any description key present in each subitem under anyOf or allOf Order and deprecated property description after active descriptions. Add a trailing stop "." to any description not ending with ":". rj � descriptions�deprecated_descriptionsc S sB t t| jd��r|�t| �� d S | �d�r |�t| �� d S d S )N)�deprecated_version�changed_version� new_versionr) )�anyrF rq r� r� )rj rc rd r r r! �assign_descriptions� s ��� �z6_get_property_description.<locals>.assign_descriptionsr� r� rn ro )r� rP rq r rE )rb ri r� r� rc rd rR r) r r r! �_get_property_description� s$ �� � rj � c s� |d }g }� � d�du rdS � fdd�dD �}� fdd�|D �}|D ]�}|�� D ]�\}} t| |� t| � | � d�du r>q)t| �} | � d |�} |�tj|| t| |�t | |�d �� | � d �} | r�t| |� | � d �sp| � d �r�|�t j|| d�� |d7 }|�t | ||d�� | � dg �D ]$} | � d �s�| � d �r�|�t j|| d�� |d7 }|�t | ||d�� q�d | v s�d | v r�|�t | ||d�� q)q#d� |�S )zDReturn restructured text describing the supported schema properties.rk �hiddenTrL c s$ g | ]}d � vs|� d vr|�qS )rl r �r rk �r� r r! r" � s �z%_get_property_doc.<locals>.<listcomp>)r� �patternPropertiesc s g | ]}� � |i ��qS r )rq rm rn r r! r" � s r� )r? � prop_namer) � prop_typerG r� ro )r? rp )rC r? r� rM ) rq rG rK ra rj r� �SCHEMA_PROPERTY_TMPLr< rX rN �SCHEMA_LIST_ITEM_TMPL�_get_property_docrE )r� rC r? � new_prefixr� � property_keys�property_schemas� prop_schema�prop_keyrb r) r� rG � alt_schemar rn r! rt � s~ � �� �� ����������� 7rt �metac C sj | � d�}|s dS t}t|�D ]#\}}t�|d��d�}|tkr+|�dt�|d �� |d� |�7 }q|S )zAReturn restructured text describing the meta examples if present.r+ rL rk r� r r� ) rq �SCHEMA_EXAMPLES_HEADERr� �textwrap�indentr �insert� SCHEMA_EXAMPLES_SPACER_TEMPLATEr< rE )r{ r+ � rst_content�count�example�indented_linesr r r! � _get_examples s �r� c C s2 | � d�sdS d�dd� | d D ��}d|� d�S )Nr- rL r= c s s � | ] }d |� d �V qdS )r= Nr rD r r r! r� - s � �z3_get_activate_by_schema_keys_doc.<locals>.<genexpr>z**Activate only on keys:** rM )rq rE )r{ � schema_keysr r r! � _get_activate_by_schema_keys_doc* s � r� c C s` |du rt � }| r |std��t| �� �}h d�}dh}d}|| r*d�|| �}n || | r7d�|| �}|r=t|��tt| ��}d|d< |�d i �}|�| d �ra|�| d i �}t t|�}z t ||d �|d < W n t y} t � d � d|d < Y nw |d r�t|d< t| �|d< d�| d �|d< t�dd| d �|d< t| �|d< tjdi |��}|S )z�Return reStructured text rendering the provided metadata. @param meta: Dict of metadata to render. @param schema: Optional module schema, if absent, read global schema. @raise KeyError: If metadata lacks an expected key. Nz"Expected non-empty meta and schema> r' r& r( r* r+ r, r) r- rL z(Missing required keys in module meta: {}z3Additional unexpected keys found in module meta: {}�property_header�$defsr' )rC � property_docz3Unable to render property_doc due to invalid schemar+ r= r* r� �-r& �title_underbarr )r� � ValueErrorrQ �keysr< �KeyErrorr� r rq r rt �AttributeErrorr� r� �SCHEMA_PROPERTY_HEADERr� rE r� rV r� �SCHEMA_DOC_TMPL) r{ r� r� � required_keys� optional_keys� error_message� meta_copyrC �templater r r! � get_meta_doc3 sR � �� � �r� c C s t j�t j�t��} t| �S rB )�osr6 �dirname�abspath�__file__r )� configs_dirr r r! � get_modulesq s r� �requested_modulesc C s� d}t t� �� �dg }t| ��t|��}|r&td�t |�d�|��dd� |D ]%}d| v s2|| v rMt� |dgdg�\}}|rMt� |d �}||j pKd7 }q(|S ) zaLoad module docstrings Docstrings are generated on module load. Reduce, reuse, recycle. rL �allz+Invalid --docs value {}. Must be one of: {}r= Tr zcloudinit.configr{ r ) rP r� �valuesrQ � differencer r< rE r � find_module� import_moduler\ )r� �docs� all_modules� invalid_docs�mod_name�mod_locs�_�modr r r! �load_docv s* �� ��r� c C s t j�t j�t j�t��d�S )N�schemas)r� r6 rE r� r� r� r r r r! �get_schema_dir� s r� c C sz t j�t� t�} d}z t�t| ��}W n ty, } z t � d| |� W Y d}~nd}~ww |s;t � d| � i dg d�}|S )z?Return jsonschema coalesced from all cc_* cloud-config modules.Nz$Cannot parse JSON schema file %s. %szCNo base JSON schema files found at %s. Setting default empty schemaz'http://json-schema.org/draft-04/schema#)r� z$schemarZ ) r� r6 rE r� �USERDATA_SCHEMA_FILE�json�loadsr � Exceptionr� r� )� schema_file� full_schemar� r r r! r� � s$ ����r� c C s| | s t jddd�} | jdddd� | jdd td t� �d �� �d � | jd dddd� | jddddd� | jddddd� | S )z0Return a parser for supported cmdline arguments.�cloudconfig-schemaz.Validate cloud-config files or document schema)�progr) z-cz --config-filez.Path of the cloud-config yaml file to validate)�helpz-iz--instance-datazbPath to instance-data.json file for variable expansion of '##template: jinja' user-data. Default: � instance_data)r� r� z--system� store_trueFz)Validate the system cloud-config userdata)�action�defaultr� z-dz--docs�+zCPrint schema module docs. Choices: all or space-delimited cc_names.)�nargsr� z --annotatez/Annotate existing cloud-config file with errors)�argparse�ArgumentParser� add_argumentr1 r � get_runpath��parserr r r! � get_parser� sJ �� �� �� �r� c C s� |j |j|jg}tdd� |D ��dkrtddd� |jr%|jr%tddd� t� }|jr4tt|j�� dS t d d �}|j r@|j }nt � � d krL|� d �}n|� d �}|j r[d|j ff}nDt � � d krgtddd� |�d�}|svtddd� dS d|ff}d|�d�fd|�d�ff}|D ]\} } | r�t j�| �r�|| | ff7 }q�t j�|d d �s�td|d d � d�ddd� d} tt|�dk�} | r�tdd �d d � |D �� � d } g } t|d�D ]�\}\} }| r�td |� d!| � d"|� d#�� z t|||j|� W nY t�y* } z"|j�s t| � d$|� �� tt|�| d% d&� | �| � W Y d}~q�d}~w t�yT } z t| � d$| � �� tt|�| d% d&� | �| � W Y d}~q�d}~ww |j �r[|n| }t| � d'|� �� q�| �r{td �d(d � | D ��d)dd� dS dS )*z@Handle provided schema args and perform the appropriate actions.c S s g | ]}|r|�qS r r )r �argr r r! r" � r� z&handle_schema_args.<locals>.<listcomp>r� z;Expected one of --config-file, --system or --docs argumentsTr z;Invalid flag combination. Cannot use --annotate with --docsN�trust)�fetch_existing_datasourcer r� �instance_data_sensitivez user-datazNUnable to read system userdata or vendordata as non-root user. Try using sudo.� cloud_configz;Unable to obtain user data file. No instance data availablez vendor-data�vendor_cloud_configz vendor2-data�vendor2_cloud_configz Config file z does not existz Error: {})�fmtr rL z!Found cloud-config data types: %sr= c s s � | ]\}}|V qd S rB r )r �cfg_typer� r r r! r� r� z%handle_schema_args.<locals>.<genexpr>z r� rn z at �:zInvalid cloud-config z Error: {} )r� zValid cloud-config: c s s � | ]}|V qd S rB r )r r� r r r! r� ; s � z'Error: Invalid cloud-config schema: {} )� config_filer� �systemrL r rx r� r r� r r� r� �getuidr� � get_ipathr6 �existsrZ rE r� r/ rI r1 r� r) )r& �args�exclusive_argsr� �pathsr � config_files� userdata_file�vendor_config_filesr� � vendor_file�nested_output_prefix�multi_config_output� error_types�idx�cfg_filer� �cfgr r r! �handle_schema_args� s� � � � � � ���� �� ��� ��r� c C s t � } td| �� � dS )zDTool to validate schema of a cloud-config file or print schema docs.r� r )r� r� � parse_argsr� r r r! �mainA s r� �__main__)FN)T)NFFTF)rk rB )nr\ r� r� �loggingr� r� �sysr} � collectionsr �collections.abcr �copyr � functoolsr � itertoolsr r3 r r r r r r r r% � cloudinitr r �cloudinit.cmd.develr �cloudinit.handlersr r �cloudinit.utilr r r r ra r �_ValidationErrorrb r� � getLoggerr. r� � VERSIONED_USERDATA_SCHEMA_FILEr� r? r� r� rr rs r| r� r� �DEPRECATED_PREFIXrO r� r �typing_extensionsr# r$ r% r� r4 r5 r] r1 rH r� rI ri r� rZ r� r� r� r� r� r� r� r� r� rf r r/ r4 r5 rB rN rX rK ra rj rt r� r� r� r� rP r� r� r� r� r� r� �exitr r r r! �<module> s< $ � �� ���� � )�� �)���� � � �)� �/L%������ �Sz������ ����� � , *H > ._ �
| ver. 1.4 |
Github
|
.
| PHP 8.2.9 | Generation time: 0.01 |
proxy
|
phpinfo
|
Settings