File manager - Edit - /usr/lib/python3/dist-packages/cloudinit/config/__pycache__/schema.cpython-310.pyc
Back
o �Ad�� � @ sL 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"m#Z# z dd l$m%Z& e&Z%W n e'y e(Z%Y nw e�)e*�Z+d Z,dZ-dddd�Z.dZ/dZ0dZ1dZ2dZ3dZ4dZ5dZ6dZ7er�ddlZdd l8m9Z9m:Z: G d d � d e:�Z;ne<Z;G d d � d e%�Z=G d!d"� d"e�Z>ee> Z?dd#d$�d%e?d&ee@ d'e@d(e@fd)d*�ZAG d+d,� d,eB�ZCd-d.� ZD d�d0e<d(e@fd1d2�ZEe=fdeFd3e<d4e@d5ee( fd6d7�ZGeeGdd8�ZHeeGd9d8�ZIe=fd5ee( fd:d;�ZJe=fd5ee( fd<d=�ZKd>d?� ZLd�d3e<fdAdB�ZM / / @ /d�d0e<d3ee< dCeFdDeFdEeFdFeFf dGdH�ZNG dIdJ� dJ�ZOdddK�dLe<dMePdNe<dOee? dPee? d(ee@ePf f dQdR�ZQd�dSdT�ZRdUdV� ZSdWdX� ZTdYe<dZe@d(ee@ fd[d\�ZUdYe<d]e<d(e@fd^d_�ZVd(e@fd`da�ZWdbe<d]e<fdcdd�ZXdbe<fdedf�ZYdge<d(e@fdhdi�ZZd�d3e<d]e<d(e@fdkdl�Z[dme;d(e@fdndo�Z\dme;d(e@fdpdq�Z]d�dme;d3ee< d(e@fdrds�Z^d(e<fdtdu�Z_dve`d(e@fdwdx�Zad(e@fdydz�Zbd(e<fd{d|�Zcd(e<fd}d~�Zdd�dd��Zed�d�� Zfd�d�� Zge*d�k�r$e�heg� � 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)�Init)�error�get_modules_from_dir� load_file��ValidationErrorz!versions.schema.cloud-config.jsonzschema-cloud-config-v1.json�true�false�null)TFNs #cloud-configz� {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: )� 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+ �9/usr/lib/python3/dist-packages/cloudinit/config/schema.pyr K s r c @ s e Zd ZdS )�SchemaDeprecationErrorN)r% r& r' r+ r+ r+ r, r- Y s r- c @ s, e Zd ZU eed< eed< defdd�ZdS )� SchemaProblem�path�message�returnc C s | j � d| j� �S )N�: )r/ r0 ��selfr+ r+ r, �formata s zSchemaProblem.formatN)r% r& r' r( r) r5 r+ r+ r+ r, r. ] s r. �, ��prefix� separator�schema_problemsr8 r9 r1 c C s( |� tdd� | ��}|r|� |� �}|S )Nc S s | � � S �N)r5 )�pr+ r+ r, �<lambda>n s z)_format_schema_problems.<locals>.<lambda>)�join�map)r: r8 r9 � formattedr+ r+ r, �_format_schema_problemsh s rA 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 sT d}|r |t |dd�7 }|r |r|d7 }|t |dd�7 }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),) � z Cloud config schema errors: )r8 � �"Cloud config schema deprecations: N)rA �super�__init__rC rD )r4 rC rD r0 �� __class__r+ r, rI w s �� z SchemaValidationError.__init__r1 c C s t | j�S r; )�boolrC r3 r+ r+ r, � has_errors� s z SchemaValidationError.has_errors)NN) r% r& r' �__doc__r �SchemaProblemsrI rL rM � __classcell__r+ r+ rJ r, rB t s ��� rB 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)� jsonschemarQ � ImportError� TYPE_CHECKER�is_type� isinstance�bytes)�checker�instancerQ r+ r+ r, �is_schema_byte_string� s �� �r[ 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 ) NrE � _description�_versionz <missing z'_version key, please file a bug report>z in version �. � z *�*)�get� capitalize�strip)r] �key_description�v�msg��annotater\ r+ r, �format_message� s � z:_add_deprecated_changed_or_new_msg.<locals>.format_message)r �changed�newrE r )r( r> r? rc �rstrip)r\ rj � filter_keyrk � filter_keys�changed_new_deprecatedr r+ ri r, �"_add_deprecated_changed_or_new_msg� s � rr �schemaro � 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)rj ro N)rr )� _validatorr � _instancers ro rt rh r+ r+ r, ru � s � ��ru )ro rl 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 r; �rW ��e�rt r+ r, r= � � z_anyOf.<locals>.<lambda>c � t | � �S r; rz r{ r} r+ r, r= � � �.%r is not valid under any of the given schemas��contextN)rS r � enumerate�list�descend�filter�extend) � validator�anyOfrZ �_schemart 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 rw c ry r; rz r{ r} r+ r, r= r~ z_oneOf.<locals>.<lambda>c r r; rz r{ r} r+ r, r= r� r� r� c s g | ] \}}�� � |�r|�qS r+ )�is_valid)�.0�i�s)rZ r� r+ r, � <listcomp>( s z_oneOf.<locals>.<listcomp>r6 c s s � | ]}t |�V qd S r; )�repr)r� rs r+ r+ r, � <genexpr>+ � � z_oneOf.<locals>.<genexpr>z %r is valid under each of %sN) rS r r� r� r� r� r� �appendr> )r� �oneOfrZ r� rt r � subschemasr� r� r� r� r� r� r� � first_valid� more_valid�reprsr+ )rt rZ r� r, �_oneOf s< � �� � �r� c C s� ddl m} m} ddlm} t| j�}d|d< ddi|d d < i }t| d �r2| 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 )rQ � FormatChecker)�createF�additionalProperties�typerR � properties�labelrU � type_checker� default_typesrl 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 r; )rW r- r{ r+ r+ r, r= r s �z<get_jsonschema_validator.<locals>.is_valid.<locals>.<lambda>N)r� � iter_errors�next)r4 rZ r� �__�errorsr+ r+ r, r� l s �z*get_jsonschema_validator.<locals>.is_validr+ r; )rS rQ r� �jsonschema.validatorsr� r � META_SCHEMA�hasattrrU �redefiner[ � DEFAULT_TYPESr( rX �dict� VALIDATORS�_validator_deprecated�DEPRECATED_KEY�_validator_changedr� r� r� ) rQ r� r� �strict_metaschema�validator_kwargsr� �typesr� �cloudinitValidatorr� r+ r+ r, �get_jsonschema_validator3 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+ �r( �r� r< r+ r+ r, r� � � z3validate_cloudconfig_metaschema.<locals>.<listcomp>�rC zGMeta-schema validation failed, attempting to validate config anyway: %sN) �jsonschema.exceptionsr� � check_schemarB r. r> r/ r0 �LOG�warning)r� rs �throwr� �errr+ r+ r, � validate_cloudconfig_metaschema~ s& �������r� �strictr� � 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 r; )r/ r{ r+ r+ r, r= � s z-validate_cloudconfig_schema.<locals>.<lambda>�r] r� c S r� r+ r� r� r+ r+ r, r� � r� z/validate_cloudconfig_schema.<locals>.<listcomp>z"Deprecated cloud-config provided: � r7 z Invalid cloud-config provided: zeInvalid cloud-config provided: Please run 'sudo cloud-init schema --system' to see the schema errors.)� get_schemar� r� rT r� �debug�sortedr� r> r/ r. r0 rW r- rA r� rB )r\ rs r� r� r� r� r� r� r� r� r� � schema_errorr/ �problemr0 �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 r; )� _cloudconfig�_original_content� _schemamarks)r4 r� r� r� r+ r+ r, rI � s z_Annotator.__init__r �contentr1 c C s d� |�}d| � d|� d�S )Nr� �# z: ------------- rF )r> )r r� �bodyr+ r+ r, � _build_footer� s z_Annotator._build_footerr: 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�colrh ) r r� �re�match�groups�intr� r� r5 )r4 r: �errors_by_liner/ rh r� r� r� r+ r+ r, �_build_errors_by_line s ��z _Annotator._build_errors_by_linerE �problems�labels�footerr� � label_prefixc C sB | D ] }|� |� �}|� |� |� d|� d|� �� |d7 }q|S )Nr� r2 � )r� )r� 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 r; )r� ��seqr3 r+ r, r= A r� z._Annotator._annotate_content.<locals>.<lambda>c S s t | d �S )Nr� )rL r� r+ r+ r, r= C r~ �Errors� Deprecations)r� r� r� r> r� r? r� )r4 r� r� r� �annotated_content� error_footer�deprecation_footer� error_index�deprecation_index� line_numberr� r� r� r� r+ r3 r, �_annotate_content! sD �� ���� z _Annotator._annotate_contentrC rD 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�splitrW r� r� r> r� r� r )r4 rC rD r� r� r� r� r+ r+ r, rj M s$ ���� � z_Annotator.annotateN)rE )r% r& r' r� rX rI � staticmethodr( r r� rO r� r� r� r r rj r+ r+ r+ r, r� � sT �� � ������ ���� �,�� �r� �rC rD r� r� r� rC rD 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� rj )r� r� r� rC rD r+ r+ r, �annotated_cloudconfig_fileg s �r c C s� t | dd�}|�t�s*tdd�| t�� ��g}t|�}|r(tti |i |j d�� |�z|r5t � |�\}}nt � |�}i }W nc t jy� } zVd } } d} t|d�r\t|d�r\t|d�} nt|d �rkt|d �rkt|d �} | rw| jd } | jd } td j| | d �d �| t|���g}t|�}|r�tti |i |j d�� ||�d}~ww t|t�s�|s�td ��z t||ddd� W dS ty� } z+|r�tt||||j |jd�� n|jr�t|jddd�} t| � |�� r� W Y d}~dS d}~ww )a 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. @raises SchemaValidationError containing any of schema_errors encountered. @raises RuntimeError when config_path does not exist. F)r z format-l1.c1z"File {0} needs to begin with "{1}"r� r� N� context_mark� problem_markzformat-l{line}.c{col})r� r� z File {0} is not valid yaml. {1}z Cloud-config is not a YAML dict.T)r� r� r rG r6 r7 )r � startswith�CLOUD_CONFIG_HEADERr. r5 r rB �printr rC r �load_with_marks�load�yaml� YAMLErrorr� �getattrr� �columnr( rW r� � RuntimeErrorr� rD rA rM ) � config_pathrs rj r� r� r r� �marksr| r� r �markr0 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 r c c s> � | D ]}t |t�rt |ttf�st|�E d H q|V qd S r; )rW r r( rX �_flatten)�xs�xr+ r+ r, r � s ��r � 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_MAPrc )r� � enum_valuer+ r+ r, r� � s ��z,_collect_subschema_types.<locals>.<listcomp>r� )rc r� r� r� r� r )r# r$ �property_typesr� r+ r+ r, �_collect_subschema_types� s �� � r- �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� s �z&_get_property_type.<locals>.<listcomp>r� r� r� r r� �/�items� UNDEFINEDz of �(�))�_flatten_schema_refsrc rW r� r� r- �len�sortr r> rL r �_get_property_typer� ) r# r. r, � property_typer2 �sub_property_types�prune_undefined�sub_item�sub_type�sub_property_docr+ r+ r, r9 � sB � r9 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� �subr5 )r r8 �list_paragraphr+ r+ r, �_parse_description+ s �rC �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/rE r2 r� r� �allOfN)�pop�replace�updater rc )rD r. � reference� sub_schemar+ r+ r, r6 A s. � ���r6 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. rE N)rF rH )rD � sub_schemasrJ r+ r+ r, �_flatten_schema_all_of[ s �rL � 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 ":". r\ � 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 )�anyr? rc r� rr )r\ rN rO r+ r+ r, �assign_descriptionss s ��� �z6_get_property_description.<locals>.assign_descriptionsr� r� r` ra )r� r� rc r r> )rM rT r� r� rN rO r= r r+ r+ r, �_get_property_descriptionh s$ �� � rU � 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.rV �hiddenTrE c s$ g | ]}d � vs|� d vr|�qS )rW r+ �r� r] �rs r+ r, r� � s �z%_get_property_doc.<locals>.<listcomp>)r� �patternPropertiesc s g | ]}� � |i ��qS r+ )rc rX rY r+ r, r� � s r� )r8 � prop_namer � prop_typer2 r� rZ )r8 r[ )r. r8 r� rF ) rc r2 r6 rL rU r� �SCHEMA_PROPERTY_TMPLr5 rC r9 �SCHEMA_LIST_ITEM_TMPL�_get_property_docr> )rs r. r8 � new_prefixr� � property_keys�property_schemas� prop_schema�prop_keyrM r r� r2 � alt_schemar+ rY r, r_ � s~ � �� �� ����������� 7r_ �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" rE rV r� r r� ) rc �SCHEMA_EXAMPLES_HEADERr� �textwrap�indentr �insert� SCHEMA_EXAMPLES_SPACER_TEMPLATEr5 r> )rf r" � rst_content�count�example�indented_linesr+ r+ r, � _get_examples� s �rp c C s2 | � d�sdS d�dd� | d D ��}d|� d�S )Nr$ rE r6 c s s � | ] }d |� d �V qdS )r( Nr+ r/ r+ r+ r, r� � s � �z3_get_activate_by_schema_keys_doc.<locals>.<genexpr>z**Activate only on keys:** rF )rc r> )rf � schema_keysr+ r+ r, � _get_activate_by_schema_keys_doc� s � rr 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$ rE z(Missing required keys in module meta: {}z3Additional unexpected keys found in module meta: {}�property_header�$defsr )r. � property_docz3Unable to render property_doc due to invalid schemar" r6 r! r� �-r �title_underbarr+ )r� � ValueError�set�keysr5 �KeyErrorr� r rc r r_ �AttributeErrorr� r� �SCHEMA_PROPERTY_HEADERrp r> r� rA rr �SCHEMA_DOC_TMPL) rf rs rz � required_keys� optional_keys� error_message� meta_copyr. �templater+ r+ r, � get_meta_doc� sR � �� � �r� c C s t j�t j�t��} t| �S r; )�osr/ �dirname�abspath�__file__r )� configs_dirr+ r+ r, � get_modules1 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. rE �allz+Invalid --docs value {}. Must be one of: {}r6 T��sys_exit�cloudinit.configrf r ) r� r� �valuesry � differencer r5 r> r � find_module� import_modulerN )r� �docs� all_modules� invalid_docs�mod_name�mod_locs�_�modr+ r+ r, �load_doc6 s* �� ��r� c C s t j�t j�t j�t��d�S )N�schemas)r� r/ r> r� r� r� r+ r+ r+ r, �get_schema_dirQ 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#)rt z$schemarE ) r� r/ r> r� �USERDATA_SCHEMA_FILE�json�loadsr � Exceptionr� r� )� schema_file� full_schemar| r+ r+ r, r� U s$ ����r� c C sV t � } t� �� D ] \}}t�|dgdg�\}}|r(t�|d �}|j| |jd < q| S )z<Return metadata coalesced from all cc_* cloud-config module.r� rf r r )r� r� r2 r r� r� rf )� full_metar� r� r� r� r+ r+ r, �get_metat s ��r� c C s\ | s t jddd�} | jdddd� | jdd d d d � | jd dddd� | jdd d dd � | 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--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_argument��parserr+ r+ r, � get_parser� s: ���� �r� c C s� |j |j|jg}tdd� |D ��dkrtddd� |jr%|jr%tddd� t� }|jr4tt|j�� dS |j r>d |j ff}nRt � � d krJtd dd� t g d �}|j d d� |j �d�}|setddd� dS d |ff}d|j �d�fd|j �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�st| � d#|� �� tt|�| d$ d%� | �|� W Y d}~q�d}~w t�yD } z t| � d#|� �� tt|�| d$ d%� | �|� W Y d}~q�d}~ww |j �rK|n|}t| � d&|� �� q�| �rktd�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 --docsNz user-datar zNUnable to read system userdata or vendordata as non-root user. Try using sudo.)�ds_deps�trust)�existing� 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� rE z!Found cloud-config data types: %sr6 c s s � | ]\}}|V qd S r; r+ )r� �cfg_typer� r+ r+ r, r� � r� z%handle_schema_args.<locals>.<genexpr>z r� r` z at �:zInvalid cloud-config z Error: {} )r� zValid cloud-config: c s s � | ]}|V qd S r; r+ )r� rt r+ r+ r, r� � s � z'Error: Invalid cloud-config schema: {} )� config_filer� �systemr7 r rj r� r r� r� �getuidr �fetch�paths� get_ipathr/ �existsrL r> r� r rB r( r� r )r �args�exclusive_argsr� � config_files�init� 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, �main� s r� �__main__)FN)T)NFFTF)F)rV r; )irN r� r� �loggingr� r� �sysrh � collectionsr �collections.abcr �copyr � functoolsr � itertoolsr r* r r r r r r r r � cloudinitr r �cloudinit.stagesr �cloudinit.utilr r r rS r �_ValidationErrorrT r� � getLoggerr% r� � VERSIONED_USERDATA_SCHEMA_FILEr� r* r r~ r} r] r^ rg rk r� �DEPRECATED_PREFIX�typing_extensionsr r r r� r- r. rO r( rA rx rB r[ rr rL ru r� r� r� r� r� r� r� r� rX r r r r r- r9 rC r6 rL rU r_ rp rr r� r� r� r� r� r� r� r� r� r� �exitr+ r+ r+ r, �<module> s" $ � � ���� � #�� �)���� � � �)� �/K%������ �Qz������ � Z , *H > $X �
| ver. 1.4 |
Github
|
.
| PHP 8.2.28 | Generation time: 0.02 |
proxy
|
phpinfo
|
Settings