o ]")format __class____name__selfrrr__repr__GszNoValue.__repr__N)r& __module__ __qualname__r)rrrrr#Es r#c @sxeZdZdZejZeZdZ e Z gdZ dddDZ dZided ed ed ed d ddddddddddddddddddddd d!Zgd"Zd#Zd$d%d&d'd(ed)eeed* Zgd+Zd,Zd-d-d-d-d.d/d0d1d2Zd3d4gZd5Zd6d7d8d9d:d;dZd?Zd@dAZdBedCfdDdEZdFdGZedCfdHdIZ efdJdKZ!edLfdMdNZ"efdOdPZ#efdQdRZ$efdSdTZ%efdUdVZ&dBefdWdXZ'dBefdYdZZ(e)efd[d\Z)efd]d^Z*eedBfd_d`Z+e+Z,eedBfdadbZ-e-Z.eedBfdcddZ/e/Z0eedBfdedfZ1efdgdhZ2dBedCfdidjZ3e4dkdlZ5e4dwdmdnZ6e4dwdodpZ7e4dwdqdrZ8e4dwdsdtZ9e4dxdudvZ:dBS)yEnva3Provide scheme-based lookups of environment variables so that each caller doesn't have to pass in ``cast`` and ``default`` parameters. Usage::: import environ import os env = environ.Env( # set casting, default value MAIL_ENABLED=(bool, False), SMTP_LOGIN=(str, 'DEFAULT') ) # Set the project base directory BASE_DIR = os.path.dirname( os.path.dirname(os.path.abspath(__file__)) ) # Take environment variables from .env file environ.Env.read_env(os.path.join(BASE_DIR, '.env')) # False if not in os.environ due to casting above MAIL_ENABLED = env('MAIL_ENABLED') # 'DEFAULT' if not in os.environ due to casting above SMTP_LOGIN = env('SMTP_LOGIN') )trueonokyyes1)postgres postgresqlpsqlpgsqlpostgiscCsg|]}d|qS) elasticsearchr.0xrrr ozEnv.)257 DATABASE_URLr3r4r5r6r7z&django.contrib.gis.db.backends.postgismysqlzdjango.db.backends.mysqlmysql2zmysql-connectorzmysql.connector.djangomysqlgisz$django.contrib.gis.db.backends.mysqlmssqlzsql_server.pyodbcoraclezdjango.db.backends.oraclepyodbcredshiftdjango_redshift_backend spatialitez)django.contrib.gis.db.backends.spatialitesqlitezdjango.db.backends.sqlite3ldapzldapdb.backends.ldap) CONN_MAX_AGEATOMIC_REQUESTS AUTOCOMMITDISABLE_SERVER_SIDE_CURSORS CACHE_URLz+django.core.cache.backends.db.DatabaseCachez+django.core.cache.backends.dummy.DummyCachez3django.core.cache.backends.filebased.FileBasedCachez-django.core.cache.backends.locmem.LocMemCachez3django.core.cache.backends.memcached.MemcachedCachez1django.core.cache.backends.memcached.PyLibMCCache) dbcache dummycache filecache locmemcachememcache pymemcachepylibmc rediscacheredisrediss)TIMEOUT KEY_PREFIXVERSION KEY_FUNCTIONBINARY EMAIL_URLz+django.core.mail.backends.smtp.EmailBackendz.django.core.mail.backends.console.EmailBackendz0django.core.mail.backends.filebased.EmailBackendz-django.core.mail.backends.locmem.EmailBackendz,django.core.mail.backends.dummy.EmailBackend)smtpsmtpssmtp+tlssmtp+ssl consolemailfilemail memorymail dummymail EMAIL_USE_TLS EMAIL_USE_SSL SEARCH_URLzAhaystack.backends.elasticsearch_backend.ElasticsearchSearchEnginezChaystack.backends.elasticsearch2_backend.Elasticsearch2SearchEnginezChaystack.backends.elasticsearch5_backend.Elasticsearch5SearchEnginezChaystack.backends.elasticsearch7_backend.Elasticsearch7SearchEnginez)haystack.backends.solr_backend.SolrEnginez-haystack.backends.whoosh_backend.WhooshEnginez-haystack.backends.xapian_backend.XapianEnginez-haystack.backends.simple_backend.SimpleEngine)r8elasticsearch2elasticsearch5elasticsearch7solrwhooshxapiansimplecloudsqlcKsd|_d|_d|_||_dS)NTFr>) smart_cast escape_proxyprefixscheme)r(ryrrr__init__s z Env.__init__NFcCs|j||||dS)Ncastdefault parse_default get_value)r(varr|r}r~rrr__call__s z Env.__call__cCs ||jvSr)ENVIRON)r(rrrr __contains__ zEnv.__contains__cCs&|j|t|d}|rtdd|S|S)z :rtype: str r|r}z (\\r)?\\nz\n)rr!resub)r(rr} multilinerrrrr!szEnv.strcCs0tjd|jj|jjftdd|j|t|dS)z3Helper for python2 :rtype: unicode z0`%s.unicode` is deprecated, use `%s.str` instead stacklevelr)warningswarnr%r&DeprecationWarningrr!r(rr}rrrunicodes z Env.unicodeutf8cCs(|j|t|d}t|dr||S|S)z :rtype: bytes rencode)rr!rr)r(rr}encodingrrrrbytess  z Env.bytescC|j|t|dS)z :rtype: bool r)rboolrrrrrzEnv.boolcCr)z :rtype: int r)rrrrrrrrzEnv.intcCr)z :rtype: float r)rfloatrrrrrrz Env.floatcCs|j|tj|dS)z' :returns: Json parsed r)rr loadsrrrrr szEnv.jsoncCs |j||s t|dS|g|dS)z :rtype: list r)rlistr(rr|r}rrrr zEnv.listcCs |j||s t|dS|f|dS)z :rtype: tuple r)rtuplerrrrrrz Env.tuplecCs|j|||dS)z :rtype: dict rrrrrrdictrzEnv.dictcCs|j|t|ddS)z2 :rtype: urllib.parse.ParseResult Tr{)rrrrrrurl$s zEnv.urlcC|j|j||d|dS)zReturns a config dictionary, defaulting to DATABASE_URL. The db method is an alias for db_url. :rtype: dict r}engine) db_url_configrr(rr}rrrrdb_url/ z Env.db_urlcCr)zReturns a config dictionary, defaulting to CACHE_URL. The cache method is an alias for cache_url. :rtype: dict rbackend)cache_url_configrr(rr}rrrr cache_url=rz Env.cache_urlcCr)zReturns a config dictionary, defaulting to EMAIL_URL. The email method is an alias for email_url. :rtype: dict rr)email_url_configrrrrr email_urlKrz Env.email_urlcCr)zUReturns a config dictionary, defaulting to SEARCH_URL. :rtype: dict rr)search_url_configrrrrr search_urlYs zEnv.search_urlcKst|j||dfi|S)z :rtype: Path r)Pathr)r(rr}kwargsrrrpathcszEnv.pathc Cstd|||d|j|}||jvrQ|j|}zt|dk}Wn ty.d}Ynw|rM|s7|d}||jurLz|d}WntyKYnwn|sQ|}z|j |}Wn#t y{} z||jurod|} t | | |}WYd} ~ nd} ~ wwt |t rd nd } t |t rd nd } t|d r|| r|| }|j|||d}|jrt|dr|| | }|jr|dur|durt |tst|}|dur|dkrdn|}||ks|r|r|||}|S)aReturn value for given environment variable. :param str var: Name of variable. :param collections.abc.Callable or None cast: Type to cast return value as. :param default: If var not present in environ, return this instead. :param bool parse_default: Force to parse default. :returns: Value from environment or default (if set). :rtype: typing.IO[typing.Any] z)get '{}' casted as '{}' with default '{}'z{}{}rFrrzSet the {} environment variableN$$s\$z\$ startswithrreplacer>)loggerdebugr$rxrylen TypeErrorNOTSET IndexErrorrKeyErrorr r rrrlstriprrwrrvr#type parse_value) r(rr|r}r~var_namevar_info has_defaultrexc error_msgrxescaperrrris`            z Env.get_valuecs|dur|S|tur%z t|dk}W|Sty$|jv}Y|Swt|tr=tt|ddd|dD}|St|t r]| d dd}t t|ddd|D}|St|t r| d t | d t | d t t tfd d dd|dD}|S|t urt dd|dD}|S|turdd|dD}|S|t ur| d dd}t dd|D}|S|turtdd|}td|}t|dkr|d}ndd|dd|d}t|}|S||}|S)zParse and cast provided value :param value: Stringed value. :param cast: Type to cast return value as. :returns: Casted value NrcSg|]}|r|qSrrr9rrrr<r=z#Env.parse_value..,()cSrrrr9rrrr<r=keyrr|cs(|d|d|dfS)Nrr)rget)kvclskey_cast value_castvalue_cast_by_keyrrs z!Env.parse_value..cSg|] }|r|dqS=splitr:valrrrr<;cSrrrrrrrr<rcSrrrr9rrrr<r=cSrrrr9rrrr<r=z[^\d,.-]r>z[,.]rz{}.{})rrrlowerBOOLEAN_TRUE_STRINGSr rmaprrstriprrr!rrrrr$join)rrr|r float_strpartsrrrrs\ * ( "& #     zEnv.parse_valuec Cst||js|dkr|jdddSt|}i}|jdd}t|ddd }|jdkrA|d kr4d}|jrAt j d |jd d |jdkr[dj |j|j d}|j r[|dj |j d7}|jdd}|j|jvrd|dvrttjdd|ddD}d|d }t|dkrdtd|dnd }n|j }|j }||pd t|jpd t|jpd |pd t|pd d|j|jvr|ds|j|vr|dr|dd\|d<|d<|jdkr|d kr|d|d<d |d<|jdkr|ds|d=nt|d|d<|jr?i} t|j D]'\} } | !|j"vr.|| !t#| d iq| | t| d iq| |d<|rG||d<n|j|d<|dt$jvr]t$j|d|d<|%dd snt d! |iS|S)"afParse an arbitrary database URL. Supports the following URL schemas: * PostgreSQL: ``postgres[ql]?://`` or ``p[g]?sql://`` * PostGIS: ``postgis://`` * MySQL: ``mysql://`` or ``mysql2://`` * MySQL (GIS): ``mysqlgis://`` * MySQL Connector Python from Oracle: ``mysql-connector://`` * SQLite: ``sqlite://`` * SQLite with SpatiaLite for GeoDjango: ``spatialite://`` * Oracle: ``oracle://`` * Microsoft SQL Server: ``mssql://`` * PyODBC: ``pyodbc://`` * Amazon Redshift: ``redshift://`` * LDAP: ``ldap://`` :param urllib.parse.ParseResult or str url: Database URL to parse. :param str or None engine: If None, the database engine is evaluates from the ``url``. :return: Parsed database URL. :rtype: dict zsqlite://:memory:rLz:memory:)ENGINENAMErN?rrr>z9SQLite URL contains host component %r, it will be ignoredrrMz{scheme}://{hostname})ryhostnamez:{port})port@rrcss|] }|ddVqdS):rN)rsplit)r:hostrrr /s  z$Env.db_url_config..)rUSERPASSWORDHOSTPORT/rrrGrOPTIONSrFz"Engine not recognized from url: {})&r URL_CLASS DB_SCHEMESrrrrrynetlocrrr$rrrPOSTGRES_FAMILYr itertools zip_longestrrfilterupdater"usernamepasswordrrCLOUDSQLr!queryritemsupper_DB_BASE_OPTIONSrr,r) rrrconfigr user_hosthinforrconfig_optionskrrrrrs    &        zEnv.db_url_configc st|jss iStj|jvrtdjjd}t |dkr,|d}|jj|d}jdkrE| djj ijsXjdvrX| dd j in2j d rj rijd d nd fddjdD}t |dkr|d|d<n||d<jri}tjD] \}}|t|di} ||jvr| | q| | q||d<|r||d<|S)aParse an arbitrary cache URL. :param urllib.parse.ParseResult or str url: Cache URL to parse. :param str or None backend: If None, the backend is evaluates from the ``url``. :return: Parsed cache URL. :rtype: dict zInvalid cache schema {}rrr)BACKENDLOCATIONrUr )rWrXzunix:r[cacher>unixcsg|] }d|jqS)z://r)r:locryrrrr<sz(Env.cache_url_config..rr )r rrry CACHE_SCHEMESr r$rrrrrrrrrrrrr_CACHE_BASE_OPTIONS) rrrlocationr locationsr r roptrrrrlsV                zEnv.cache_url_configc Cs8i}t||js t|n|}|jdd}t|ddd}||t|jt|j |j t |j d|r;||d<n|j |jvrHtd|j |j |jvrV|j|j |d<|j d vr`d |d <n |j d krid |d <|jri}t|jD] \}}|t |di}||jvr||qu||qu||d<|S)aParse an arbitrary email URL. :param urllib.parse.ParseResult or str url: Email URL to parse. :param str or None backend: If None, the backend is evaluates from the ``url``. :return: Parsed email URL. :rtype: dict rNrrr)EMAIL_FILE_PATHEMAIL_HOST_USEREMAIL_HOST_PASSWORD EMAIL_HOST EMAIL_PORT EMAIL_BACKENDzInvalid email schema %s)rdreTrkrfrlr)r rrrrrrr"rrrrrry EMAIL_SCHEMESr rrrr_EMAIL_BASE_OPTIONS) rrrrrr r rrrrrrs<         zEnv.email_url_configcCsi}t||js t|n|}|jdd}t|ddd}|j|jvr,td|j|j|j|d<i}|j rst |j }d| vrO|ddd |d<d | vra| |d dt |d <d | vrs| |d dt|d <|jd krz|S|jd g|jvrd| vr|dd|d<|dr|dd}|jd krtd|dd|fd|d<d| vr| |ddt|d<|S|j|jvr|dd}t|dkrd|dd}|d}nd}|d}td|dd|fd|d<d| vr| |ddt|d<||d<|Sd||d<|jdkrFd| vr2|dd|d<d| vrE| |ddt|d<n|jdkr[d| vr[|dd|d<|rb||d<|S)aParse an arbitrary search URL. :param urllib.parse.ParseResult or str url: Search URL to parse. :param str or None engine: If None, the engine is evaluates from the ``url``. :return: Parsed search URL. :rtype: dict rNrrrzInvalid search schema %srEXCLUDED_INDEXESrINCLUDE_SPELLING BATCH_SIZErtrqKWARGSrr)http)r>r>r>URLr]r> INDEX_NAMEPATHrrSTORAGE POST_LIMITrsFLAGS)r rrrrrrySEARCH_SCHEMESr rrkeysrrrELASTICSEARCH_FAMILYendswithrrrr)rrrrrparamsrindexrrrrs                     zEnv.search_url_configc s|dur%t}tjtj|jjjd}tj |s%t d|dSz8t |t rFtt| }|}Wdn1s@wYn| }|}Wdn1sWwYWntynt d|YdSwt d|dd}|D]I}td|} | r| d | d } } td | } | r| d } td | } | rtd || d } t| || <q|r|drqt d|qfdd}||j}|D] \} }|| |qdS)a+Read a .env file into os.environ. If not given a path to a dotenv path, does filthy magic stack backtracking to find the dotenv in the same directory as the file that called ``read_env``. Existing environment variables take precedent and are NOT overwritten by the file content. ``overwrite=True`` will force an overwrite of existing environment variables. Refs: * https://wellfire.co/learn/easier-12-factor-django :param env_file: The path to the ``.env`` file your application should use. If a path is not provided, `read_env` will attempt to import the Django settings module from the Django project root. :param overwrite: ``overwrite=True`` will force an overwrite of existing environment variables. :param \**overrides: Any additional keyword arguments provided directly to read_env will be added to the environment. If the key matches an existing environment variable, the value will be overridden. Nz.envzU%s doesn't exist - if you're not configuring your environment separately, create one.zQ%s not found - if you're not configuring your environment separately, check this.z#Read environment variables from: {}cSs|d}|dvr d|S|S)z+Keep escaped newline/tabs in quoted stringsrrnt\)group)match escaped_charrrr_keep_escaped_format_characterss z5Env.read_env.._keep_escaped_format_charactersz$\A(?:export )?([A-Za-z_0-9]+)=(.*)\Zrrz \A'(.*)'\Zz \A"(.*)"\Zz\\(.)#zInvalid line: %scsrfddSfddS)zgReturn lambda to set environ. Use setdefault unless overwrite is specified. cs|t|iSr)rr!r renvvalrrrsz3Env.read_env..set_environ..cs|t|Sr) setdefaultr!r8r9rrrsrr9 overwriter9r set_environs  z!Env.read_env..set_environ)sys _getframeosrrdirnamef_backf_code co_filenameexistsrinfor Openableopenr!readOSErrorrr$ splitlinesrr4r3rrwarningrr)renv_filer= overridesframefcontentr6linem1rrm2m3r>setenvrrr<rread_envPsl             z Env.read_envr)NF);r&r*r+__doc__rAenvironrr#rrrrrr-DEFAULT_DATABASE_ENVr rrDEFAULT_CACHE_ENVr r rrDEFAULT_EMAIL_ENVrrDEFAULT_SEARCH_ENVr+rrzrrr!rrrrrr rrrrrdbrrremailrrr classmethodrrrrrrXrrrrr,Ks                  K 8 ~ K 4 br,c@seZdZdZeZdS) FileAwareEnva  First look for environment variables with ``_FILE`` appended. If found, their contents will be read from the file system and used instead. Use as a drop-in replacement for the standard ``environ.Env``: .. code-block:: python python env = environ.FileAwareEnv() For example, if a ``SECRET_KEY_FILE`` environment variable was set, ``env("SECRET_KEY")`` would find the related variable, returning the file contents rather than ever looking up a ``SECRET_KEY`` environment variable. N)r&r*r+rYrrrrrrrbs rbcseZdZdZddZddZeddZd)fd d Zd d Z d dZ ddZ ddZ ddZ ddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zed'd(ZZS)*rz?Inspired to Django Two-scoops, handling File Paths in Settings.cO|j|jg|Ri|S)zCreate new Path based on self.root and provided paths. :param paths: List of sub paths :param kwargs: required=False :rtype: Path )r%__root__r(pathsrrrrrsz Path.pathcOst||g|Ri|S)zOpen a file. :param str name: Filename appended to :py:attr:`~root` :param \*args: ``*args`` passed to :py:func:`open` :param \**kwargs: ``**kwargs`` passed to :py:func:`open` :rtype: typing.IO[typing.Any] )rI)r(nameargsrrrrfilesz Path.filecC|jS)zCurrent directory for this Pathrdr'rrrrootsz Path.rootr>cs@t|ddrtj|}|j|g|Ri||_dS)Nis_fileF)superrzrrArrB_absolute_joinrd)r(startrfrr%rrrzs   z Path.__init__cOrc)zRetrieve the absolute path, with appended paths :param paths: List of sub path of self.root :param kwargs: required=False )rordrerrrrsz Path.__call__cCs t|tr |j|jkS|j|kSrr rrdr(otherrrr__eq__s   z Path.__eq__cCs || Sr)rursrrr__ne__ z Path.__ne__cCs$t|ts t|j|St|j|jSrrrrsrrr__add__s  z Path.__add__cCsXt|tr |d|St|tr|j|rt|j|Stdj t |t |d)Nz../zkunsupported operand type(s) for -: '{self}' and '{other}' unless value of {self} ends with value of {other}rs) r rrr!rdr.rrstriprr$rrsrrr__sub__s    z Path.__sub__cCs |dS)Nz..rr'rrr __invert__rzPath.__invert__cCs,|j}t|dkrtj|d}|j|S)Nrr>)rdrrArrr)r(item base_pathrrrrs  zPath.__contains__cCs d|jS)Nz )r$rdr'rrrr)rwz Path.__repr__cCrjrrkr'rrr__str__sz Path.__str__cC|Srr~r'rrr __unicode__zPath.__unicode__cO|j|i|Sr)r~ __getitem__r(rhrrrrrzPath.__getitem__cCrrrr'rrr __fspath__rzPath.__fspath__cOrr)r~rfindrrrrrrz Path.rfindcOrr)r~findrrrrr rz Path.findcOsFtjtjj|g|R}|ddr!tj|s!td||S)NrequiredFzCreate required path: {})rArabspathrrrFr r$)baserfr absolute_pathrrrro#s zPath._absolute_join)r>)r&r*r+rYrripropertyrlrzrrurvrxrzr{rr)r~rrrrr staticmethodro __classcell__rrrqrrs.    rcCs,ttD]}|drtt||qdS)Nuses_)dir urlparselibrgetattrappend)rymethodrrrregister_scheme,s  rcCs|D]}t|qdSr)r)schemesryrrrregister_schemes2s r)0rYrrloggingrArr? urllib.parseparserrrrrrrrcompatr r r r r fileaware_mappingrr ImportErrorpathlibrr!rH getLoggerr&rrrr"r#r,rbrrrrr,rr+rrrrrsL      hm