o tBha@sddlmZmZmZddlZddlZddlZddlmZddlm Z zddl Z dZ Wn e y5dZ Ynwzddl Z dZWn e yIdZYnwejdkrVdd lmZnddlZeZ Gd d d eZGd d d eZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGdddeZGd d!d!eZGd"d#d#eZ Gd$d%d%eZ!Gd&d'd'eZ"Gd(d)d)e#Z$d*d+Z%dS),)divisionabsolute_importprint_functionN)util) exceptionsTF)r)abcc@sReZdZdZefddZddZdddZdd d Zd d Z dddZ ddZ dS)TemplateaNA value template for configuration fields. The template works like a type and instructs Confuse about how to interpret a deserialized YAML value. This includes type conversions, providing a default value, and validating for errors. For example, a filepath type might expand tildes and check that the file exists. cCs ||_dS)zCreate a template with a given default value. If `default` is the sentinel `REQUIRED` (as it is by default), then an error will be raised when a value is missing. Otherwise, missing values will instead return `default`. Ndefault)selfr rh/var/www/html/riverr-enterprise-integrations-main/venv/lib/python3.10/site-packages/confuse/templates.py__init__*s zTemplate.__init__cCs |||S)z_Invoking a template on a view gets the view's value according to the template. valuer viewrrr__call__3s zTemplate.__call__NcCs<z |\}}|||WStjyYnw||jS)zGet the value for a `ConfigView`. May raise a `NotFoundError` if the value is missing (and the template requires it) or a `ConfigValueError` for invalid values. )firstconvertr NotFoundErrorget_default_valuenamer rtemplater_rrrr9s  zTemplate.valuer cCs*t|dr |jturtd||jS)zGet the default value to return when the value is missing. May raise a `NotFoundError` if the value is required. r {} not found)hasattrr REQUIREDrrformat)r key_namerrrrHszTemplate.get_default_valuecCs|S)zConvert the YAML-deserialized value to a value of the desired type. Subclasses should override this to provide useful conversions. May raise a `ConfigValueError` when the configuration is wrong. rr rrrrrrSszTemplate.convertFcCs"|rtjntj}|d|j|)zRaise an exception indicating that a value cannot be accepted. `type_error` indicates whether the error is due to a type mismatch rather than a malformed value. In this case, a more specific exception is raised. z{0}: {1})rConfigTypeErrorConfigValueErrorr!r)r messager type_error exc_classrrrfail]s z Template.failcCs(dt|j|jturdSt|jS)Nz{0}({1}))r!type__name__r r reprr rrr__repr__js  zTemplate.__repr__Nr )F) r, __module__ __qualname____doc__r rrrrrr)r/rrrrr "s    r c@eZdZdZddZdS)Integerz-An integer configuration value template. cCs2t|tr|St|trt|S|d|ddS)z@Check that the value is an integer. Floats are rounded. zmust be a numberTN) isinstanceintfloatr)r#rrrrts  zInteger.convertNr,r1r2r3rrrrrr5q r5c@r4)NumberzBA numeric type: either an integer or a floating-point number. cCs.t|tjr|S|dt|j|ddS)z3Check that the value is an int or a float. zmust be numeric, not {0}TN)r6r NUMERIC_TYPESr)r!r+r,r#rrrrs zNumber.convertNr9rrrrr;r:r;c@*eZdZdZddZd ddZddZdS) MappingTemplatezA template that uses a dictionary to specify other types for the values for a set of keys and produce a validated `AttrDict`. cCs,i}|D] \}}t|||<q||_dS)zCreate a template according to a dict (mapping). The mapping's values should themselves either be Types or convertible to Types. N)items as_template subtemplates)r mappingrAkeytyprrrrs zMappingTemplate.__init__NcCs2t}|jD]\}}||||||<q|S)zqGet a dict with the same keys as the template and values validated according to the value types. )AttrDictrAr?r)r rroutrCrDrrrrszMappingTemplate.valuecCdt|jS)NzMappingTemplate({0}))r!r-rAr.rrrr/zMappingTemplate.__repr__r0r,r1r2r3rrr/rrrrr>s  r>c@r=) SequencezZA template used to validate lists of similar items, based on a given subtemplate. cCt||_dS)zZCreate a template for a list with items validated on a given subtemplate. Nr@ subtemplater rMrrrrzSequence.__init__NcCs*g}|D] }||j||q|S)z sz"Choice.convert..) SUPPORTS_ENUMr6rjr+ issubclassenumEnum ValueErrorr)r!listr Mappingr#rrrrs.      zChoice.convertcCs d|jS)Nz Choice({0!r}))r!rjr.rrrr/2 zChoice.__repr__) r,r1r2r3r rrr/rgrrr\rrhs  rhcs@eZdZdZeffdd ZddZfddZdd ZZ S) OneOfzLA template that permits values complying to one of the given templates. cstt||t||_dSr0)rVrvrrsallowed)r rwr r\rrr9szOneOf.__init__cCsLg}|jdur|dt|j|jtur|t|jdd|S)Nzallowed=z OneOf({0})r^)rwrQr-r r r!r_r`rrrr/=s   zOneOf.__repr__cs||_tt|||Sr0)rrVrvr)r rrr\rrrHsz OneOf.valuec Cst|jt}|jD]Y}z5|r9t|tr&|jr&|||j}t||j|j <nt|j |i}|j ||j WS| |WSt j yIt jyRYq tyb}zt |d}~ww|dt|jt||dS)z=Ensure that the value follows at least one template. Nzmust be one of {0}, not {1})r6rr>rwFilename relative_totemplate_with_relativesr@rArCparentgetrConfigTemplateError ConfigErrorrrr)r!r-)r rr is_mapping candidate next_templateexcrrrrLs>    z OneOf.convert) r,r1r2r3r rr/rrrgrrr\rrv6s  rvcs6eZdZdZdeffdd ZddZddZZS) StrSeqzA template for values that are lists of strings. Validates both actual YAML string lists and single strings. Strings can optionally be split on whitespace. Tcri)zCreate a new template. `split` indicates whether, when the underlying value is a single string, it should be split on whitespace. Otherwise, the resulting value is a list containing a single string. N)rVrrsplit)r rr r\rrrys zStrSeq.__init__cCs8t|tjr|St|tr|ddS|d|ddS)Nutf-8ignorezmust be a list of stringsT)r6rSTRINGbytesdecoder))r xrrrr_convert_values   zStrSeq._convert_valuecs|t|tr |dd}t|tjrjr|}n|g}nzt|}Wnty3ddYnwfdd|DS)Nrrz/must be a whitespace-separated string or a listTcsg|]}|qSr)r)rkvrrrrmsz"StrSeq.convert..) r6rrrrrrs TypeErrorr)r#rrrrs      zStrSeq.convert) r,r1r2r3r rrrrgrrr\rrss  rcs.eZdZdZdfdd ZfddZZS)PairsaA template for ordered key-value pairs. This can either be given with the same syntax as for `StrSeq` (i.e. without values), or as a list of strings and/or single-element mappings such as:: - key: value - [key, value] - key The result is a list of two-element tuples. If no value is provided, the `default_value` will be returned as the second element. Ncstt|jdd||_dS)zCreate a new template. `default` is the dictionary value returned for items that are not a mapping, but a single string. T)rN)rVrr default_value)r rr\rrrs zPairs.__init__csz tt||||jfWStjyit|tjr2t |dkr(| d|dt | \}}n#t|tjrJt |dkrE| d|d|\}}n | dt||dtt|||tt|||fYSw)Nrz must be a single-element mappingTzmust be a two-element listz+must be a single string, mapping, or a list)rVrrrrr$r6r rtlenr)r iter_firstr?rJstr)r rrkrr\rrrs,     zPairs._convert_valuer0)r,r1r2r3rrrgrrr\rrs  rcsFeZdZdZeddddffdd ZddZdd Zd d d ZZ S) rxaA template that validates strings as filenames. Filenames are returned as absolute, tilde-free paths. Relative paths are relative to the template's `cwd` argument when it is specified. Otherwise, if the paths come from a file, they will be relative to the configuration directory (see the `config_dir` method) by default or to the base directory of the config file if either the source has `base_for_paths` set to True or the template has `in_source_dir` set to True. Paths from sources without a file are relative to the current working directory. This helps attain the expected behavior when using command-line options. NFcs,tt||||_||_||_||_dS)a`relative_to` is the name of a sibling value that is being validated at the same time. `in_app_dir` indicates whether the path should be resolved inside the application's config directory (even when the setting does not come from a file). `in_source_dir` indicates whether the path should be resolved relative to the directory containing the source file, if there is one, taking precedence over the application's config directory. N)rVrxrcwdry in_app_dir in_source_dir)r r rryrrr\rrrs   zFilename.__init__cCsg}|jtur|t|j|jdur|dt|j|jdur-|dt|j|jr5|d|jr=|ddd |S)Nzcwd=z relative_to=zin_app_dir=Truezin_source_dir=Truez Filename({0})r^) r r rQr-rryrrr!r_r`rrrr/s     zFilename.__repr__c Cst|tjtfs td|j|jkrtd|j |j|j vr.| d|j|i}| |jti}|j}|durwz||}Wn"tyj||jvr_td|j |jtd|j|j w||j|<|j}|dusA|j ||jS)Nz:relative_to may only be used when getting multiple values.z{0} is relative to itselfz1needs sibling value "{0}" to expand relative pathz${0} and {1} are recursively relativez=missing template for {0}, needed to expand {1}'srelative path)r6r rtr>rr}ryrCr!rr{keysr)updaterApopKeyErrorr|)r rr old_templater next_relativerel_to_templaterrrresolve_relative_tosH        zFilename.resolve_relative_tocCsz|\}}Wntjy||jYSwt|tjs,|d t |j |dt j t|}t j |s|jdurIt j |j|}n;|jdurZt j ||||}n*|jr`|jsf|jrs|jsst j t j |j|}n|jsy|jrt j ||}t j |S)Nzmust be a filename, not {0}T)rrrrrr6rrbr)r!r+r,rdre expanduserrisabsrr_ryrfilenamerbase_for_pathsrdirnameroot config_dirabspath)r rrresourcerrrr3s:        zFilename.valuer0) r,r1r2r3r rr/rrrgrrr\rrxs 3rxcs"eZdZdZdfdd ZZS)PathaA template that validates strings as `pathlib.Path` objects. Filenames are parsed equivalent to the `Filename` template and then converted to `pathlib.Path` objects. For Python 2 it returns the original path as returned by the `Filename` template. Ncs0tt|||}|durdSddl}||S)Nr)rVrrpathlib)r rrrrr\rrras  z Path.valuer0)r,r1r2r3rrgrrr\rrXsrc@s,eZdZdZd ddZd ddZdd ZdS) Optionala_A template that makes a subtemplate optional. If the value is present and not null, it must validate against the subtemplate. However, if the value is null or missing, the template will still validate, returning a default value. If `allow_missing` is False, the template will not allow missing values while still permitting null. NTcCsFt||_|durz|j}Wn tjyYnw||_||_dSr0)r@rMrrrr allow_missing)r rMr rrrrrrs  zOptional.__init__cCs`z|\}}Wntjy!|jr|jYStd|jw|dur)|jS|j||S)Nr) rrrrr r!rrMrrrrrr~s zOptional.valuecCsdt|jt|j|jS)Nz%Optional({0}, {1}, allow_missing={2}))r!r-rMr rr.rrrr/s zOptional.__repr__)NTr0rIrrrrris   rcs,eZdZdZeffdd ZddZZS) TypeTemplatez\A simple template that checks that a value is an instance of a desired Python type. cri)zVCreate a template that checks that the value is an instance of `typ`. N)rVrrrD)r rDr r\rrrs zTypeTemplate.__init__cCs0t||js|d|jjt|j|d|S)Nzmust be a {0}, not {1}T)r6rDr)r!r,r+r#rrrrs zTypeTemplate.convert)r,r1r2r3r rrrgrrr\rrsrc@s eZdZdZddZddZdS)rEz^A `dict` subclass that can be accessed via attributes (dot notation) for convenience. cCs||vr||St|r0)AttributeError)r rCrrr __getattr__szAttrDict.__getattr__cCs |||<dSr0r)r rCrrrr __setattr__ruzAttrDict.__setattr__N)r,r1r2r3rrrrrrrEs rEcCsVt|tr|St|tjrt|S|turtSt|tr!t|St|tr/t|t j r/t St|t j r9t |St|t rDt t|StrUt|trUt|tjrUt |St|tr^t|S|turetSt|trnt|Strzt|tjrzt|S|durtdS|turtS|turttjS|turttjSt|trt|Std|)z?Convert a simple "shorthand" Python value to a `Template`. Nz!cannot convert to template: {0!r})r6r r rtr>r7r5r+rorrbrUsetrhrsrnrprqrvr8r;SUPPORTS_PATHLIBrPurePathrr dictrrJrrr!rrrrr@sJ            r@)& __future__rrrrdrYsysr*rrrprn ImportErrorrr version_info collectionsr objectr r r5r;r>rJrTrUrhrvrrrxrrrrrEr@rrrrsR     O*1=*.,