| Current File : //lib/python2.7/site-packages/cloudinit/config/schema.pyc |
�
oB�]c @ s� d Z d d l m Z d d l m Z d d l m Z m Z d d l Z d d l m
Z
d d l m Z d d l
Z
d d l Z d d l Z d d l Z d d l Z i d e 6d e 6d
d 6Z d Z d Z d
Z d Z d Z d Z d e f d � � YZ e d � Z d � Z e d � Z d � Z! d � Z" d d � Z# d d � Z$ d � Z% d a& d � Z' d � Z( d d � Z) d � Z* d! � Z+ e, d" k r�e j- e+ � � n d S(# sF schema.py: Set of module functions for processing cloud-config schema.i����( t print_function( t importer( t find_modulest load_fileN( t defaultdict( t deepcopyt truet falset nullt UNDEFINEDs
#cloud-configs�
{name}
{title_underbar}
**Summary:** {title}
{description}
**Internal name:** ``{id}``
**Module frequency:** {frequency}
**Supported distros:** {distros}
**Config schema**:
{property_doc}
{examples}
s/ {prefix}**{prop_name}:** ({type}) {description}s
**Examples**::
s
# --- Example{0} ---t SchemaValidationErrorc B s e Z d Z d d � Z RS( s< Raised when validating a cloud-config file against a schema.c C sf | | _ g | D] \ } } d j | | � ^ q } d j d j | � � } t t | � j | � d S( s� Init the exception an n-tuple of schema errors.
@param schema_errors: An n-tuple of the format:
((flat.config.key, msg),)
s {0}: {1}s Cloud config schema errors: {0}s , N( t
schema_errorst formatt joint superR
t __init__( t selfR t
config_keyt messaget error_messages( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyR . s (( ( t __name__t
__module__t __doc__R ( ( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyR
+ s c
C s' y d d l m } m } Wn t k
r; t j d � d SX| | d | � �} d } xg t | j | � d d � �D]G } d j g | j D] } t
| � ^ q� � } | | | j f f 7} qv W| r#| r� t | � � q#g | D] \ }
} d j
|
| � ^ q� } t j d
d j | � � n d S(
s� Validate provided config meets the schema definition.
@param config: Dict of cloud configuration settings validated against
schema.
@param schema: jsonschema dict describing the supported schema definition
for the cloud config module (config.cc_*).
@param strict: Boolean, when True raise SchemaValidationErrors instead of
logging warnings.
@raises: SchemaValidationError when provided config does not validate
against the provided schema.
i����( t Draft4Validatort
FormatCheckers< Ignoring schema validation. python-jsonschema is not presentNt format_checkert keyc S s | j S( N( t path( t e( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt <lambda>R s t .s {0}: {1}s Invalid config:
%ss
( ( t
jsonschemaR R t ImportErrort loggingt debugt sortedt iter_errorsR
R t strR R
R t warning(
t configt schemat strictR R t validatort errorst errort pR t kt msgt messages( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt validate_cloudconfig_schema= s
%++c C s� | s
| Si } | r( t | | � } n t t � } d } g } g } x� | D]� \ } } t j d | � }
|
r� |
j � \ } } | t | � j | � n d } | | | j | � | d k r� d j d | d | d | � } n | j d j | | � � | d 7} qM W| j
� j d � }
d } x� t |
� D]� \ } } | | d } | r�d j
g t d
t | � � D] } d j | | � ^ qp� } | t | � 7} | j | d | � q4| j | � q4W| j d
j d j
| � � � d j
| � S( s| 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 schema_errors: List of tuples from a JSONSchemaValidationError. The
tuples consist of (schemapath, error_message).
i s& format-l(?P<line>\d+)\.c(?P<col>\d+).*s Line {line} column {col}: {msg}t linet colR/ s # E{0}: {1}s
t ,i s E{0}s # s # Errors: -------------
{0}
N( t _schemapath_for_cloudconfigR t listt ret matcht groupst intt appendt NoneR t decodet splitt enumerateR
t ranget len( t cloudconfigt original_contentR t schemapathst errors_by_linet error_countt error_footert annotated_contentR R/ R8 R2 R3 t linest line_numberR+ t countt error_label( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt annotated_cloudconfig_file] sH 5c C s t j j | � s* t d j | � � � n t | d t �} | j t � s� d d j | t j � � f f } t
| � } | r� t t i | | j
� � n | � n y t j | � } Wnt j k
r�} d } } d
}
t | d � r t | d � r t | d � }
n0 t | d � r;t | d � r;t | d � }
n |
r^|
j d } |
j d } n d j d | d
| � d j | t | � � f f } t
| � } | r�t t i | | j
� � n | � n Xy t | | d t �Wn8 t
k
r} | rt t | | | j
� � n � n Xd
S( s� Validate cloudconfig file adheres to a specific jsonschema.
@param config_path: Path to the yaml cloud-config file to parse.
@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.
s Configfile {0} does not existR= s format-l1.c1s" File {0} needs to begin with "{1}"i t context_markt problem_marks format-l{line}.c{col}R2 R3 s File {0} is not valid yaml. {1}R) N( t osR t existst RuntimeErrorR R t Falset
startswitht CLOUD_CONFIG_HEADERR= R
t printRM R t yamlt safe_loadt YAMLErrorR< t hasattrt getattrR2 t columnR% R1 t True( t config_pathR( t annotatet contentR+ R, RB R R2 R\ t mark( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt validate_cloudconfig_file� sJ
c C s | j � j d � } i } d } d } g } x�t | d � D]�\ } } t t j | | � j � d � } | j � } | s= | j d � r� q= n | r� | d \ }
} n d }
d } | j d � r� t | � } | d }
| d 7} n d } | j d d � \ } }
x7 | |
k rA| r2| j
� \ }
} q d }
d } q W| rY| d
| } n | j | | f � |
r�|
j � }
|
j d � r�| j | d | d
f � xG t d t t
j |
� � � D]$ } | d
t | � } | | | <q�Wq�n | | | <q= W| S( s� Return a dictionary mapping schemapath to original_content line number.
@param config: The yaml.loaded config dictionary of a cloud-config file.
@param original_content: The simple file content of the cloud-config file
s
i s ^(\s*)i t #i����t s - t :R t [i s .0( R= R> R? RA R7 R8 R9 t stripRT R% t popR; R@ RW RX ( R' RC t
content_linest schema_line_numberst
list_indext RE_YAML_INDENTt scopesRJ R2 t indent_deptht previous_deptht path_prefixR t valuet inner_list_indext list_key( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyR5 � sJ "
%c C s | j d t � } | t k r_ | j d � r_ g | d D] } t t j | | � � ^ q8 } n t | t � r� d j | � } n | j d i � } | j d d � } xE | j d i � D]1 } | r� | d 7} n | d t | � d 7} q� W| rd j | | � S| S(
sE Return a string representing a property type from a given jsonschema.t typet enumt /t itemsRd t oneOft (t )s
{0} of {1}( t gett SCHEMA_UNDEFINEDR% t _YAML_MAPt
isinstanceR6 R
t _get_property_typeR ( t
property_dictt
property_typeR. Rw t sub_property_typet sub_item( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyR � s 2
s c
C s� | d } g } x� | j d i � j � D]� \ } } | j d d � } | j t j d | d | d t | � d | j d d � � � d | k r) | j t | d | �� q) q) Wd j | � S(
sD Return restructured text describing the supported schema properties.s t
propertiest descriptionRd t prefixt prop_nameRt s
s
( R{ Rw R; t SCHEMA_PROPERTY_TMPLR R t replacet _get_property_docR
( R( R� t
new_prefixR� t prop_keyt prop_configR� ( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyR� s
% Rd c C s� | j d � } | s d St } x� t | � D]| \ } } | j d � } g | D] } d j | � ^ qN } | t k r� | j d t j | d � � n | d j | � 7} q, W| S( sC Return restructured text describing the schema examples if present.t examplesRd s
s {0}i i ( R{ t SCHEMA_EXAMPLES_HEADERR? R> R t insertt SCHEMA_EXAMPLES_SPACER_TEMPLATER
( R( R� R� t rst_contentRK t exampleRI R2 t indented_lines( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt _get_schema_examples s " c C sm t | � } t | � | d <t | � | d <d j | d � | d <t j d d | d � | d <t j | � S( s� Return reStructured text rendering the provided jsonschema.
@param schema: Dict of jsonschema to render.
@raise KeyError: If schema lacks an expected key.
t property_docR� s , t distrosR t -t namet title_underbar( R R� R� R
R7 t subt SCHEMA_DOC_TMPLR ( R( t schema_copy( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt get_schema_doc) s c C s� t r
t Si d d 6d d 6g d 6} t j j t j j t � � } t | � } xk | j � D]] \ } } t j | d g d g � \ } } | r\ t j
| d � } | d j | j � q\ q\ W| a | S( s> Return jsonschema coalesced from all cc_* cloud-config module.s' http://json-schema.org/draft-04/schema#s $schemas cloud-config-schemat idt allOfs cloudinit.configR( i (
t FULL_SCHEMARP R t dirnamet abspatht __file__R Rw R t find_modulet
import_moduleR; R( ( t full_schemat configs_dirt potential_handlerst _fnamet mod_namet mod_locst _looked_locst mod( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt
get_schema; s c C s$ t | d t j �t j d � d S( Nt filei ( RV t syst stderrt exit( R ( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyR, P s c C s| | s! t j d d d d � } n | j d d d d �| j d d
d d d
t d d �| j d d d d
t d d �| S( s0 Return a parser for supported cmdline arguments.t progs cloudconfig-schemaR� s. Validate cloud-config files or document schemas -cs
--config-filet helps. Path of the cloud-config yaml file to validates -ds --doct actiont
store_truet defaults Print schema documentations
--annotates/ Annotate existing cloud-config file with errors( t argparset ArgumentParsert add_argumentRS ( t parser( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt
get_parserU s c C s | j | j g } t | � s+ t | � r8 t d � n t � } | j r� y t | j | | j � WnQ t k
r� } | j s� t t | � � q� q� t
k
r� } t t | � � q� Xt d j | j � � n | j rx% | d D] } t t
| � � q� Wn d S( s@ Handle provided schema args and perform the appropriate actions.s/ Expected either --config-file argument or --docs Valid cloud-config file {0}R� N( t config_filet doct anyt allR, R� Rb R_ R
R% RR RV R R� ( R� t argst exclusive_argsR� R t subschema( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt handle_schema_argsd s"
c C s t � } t d | j � � d S( sD Tool to validate schema of a cloud-config file or print schema docs.s cloudconfig-schemai ( R� R� t
parse_args( R� ( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt mainz s t __main__(. R t
__future__R t cloudinitR t cloudinit.utilR R R� t collectionsR t copyR R! RP R7 R� RW R] RS R< R} R| RU R� R� R� R� t
ValueErrorR
R1 RM Rb R5 R R� R� R� R� R� R, R� R� R� R R� ( ( ( s; /usr/lib/python2.7/site-packages/cloudinit/config/schema.pyt <module> sF 1 3 1