!\i XSrSSKJrJr SSKJr SSKrSSKrSSK r SSK r SSK r SSK r SSK JrJrJrJrJrJr SSKJr SSKJrJrJr SSKJrJr "S S \ R:5r\"5r\R>"\ 5r!"S S 5r"S r#Sr$Sr%Sr&Sr'Sr("SS5r)Sr*Sr+Sr,Sr-\ R\"SS9\"SS555r/S(Sjr0S\Rb;a\"5Re5r3\3(a\!RiS\35 \"S\35 Od\"5RkS 5(a\!RiS!5 O7\"5Rm5r3\3(a\"S\35 \!RiS"\35 S#\Rb;a\RbS#r3\"\35 gS$\Rb;a\RbS$r3\"\35 g\"5Re5(a0\"5Re5r3\!RiS%\35 \"\35 g\"5Ro5(a\!RiS&5 g\"5Rm5r3\3(a\!RiS'\35 \"\35 gg))zRasterio's GDAL/AWS environment)wrapstotal_ordering)getfullargspecN)GDALEnvget_gdal_configset_gdal_configGDALDataFinderPROJDataFinderset_proj_data_search_path) gdal_version)EnvErrorGDALVersionErrorRasterioDeprecationWarning)Session DummySessionc\rSrSrSrSrg) ThreadEnvc SUlSUlgN)_env_discovered_optionsselfs O/var/www/html/kml_chatgpt/mouzaenv/lib/python3.13/site-packages/rasterio/env.py__init__ThreadEnv.__init__s 2$( )rrN)__name__ __module__ __qualname____firstlineno__r__static_attributes__rrrrs(rrc\rSrSrSr\S5rSSS\R4Sjr \S5r Sr S r S r S rS rS rSSjrSrg)Env=aAbstraction for GDAL and AWS configuration The GDAL library is stateful: it has a registry of format drivers, an error stack, and dozens of configuration options. Rasterio's approach to working with GDAL is to wrap all the state up using a Python context manager (see PEP 343, https://www.python.org/dev/peps/pep-0343/). When the context is entered GDAL drivers are registered, error handlers are configured, and configuration options are set. When the context is exited, drivers are removed from the registry and other configurations are removed. Example ------- .. code-block:: python with rasterio.Env(GDAL_CACHEMAX=128000000) as env: # All drivers are registered, GDAL's raster block cache # size is set to 128 MB. # Commence processing... ... # End of processing. # At this point, configuration options are set to their # previous (possible unset) values. A boto3 session or boto3 session constructor arguments `aws_access_key_id`, `aws_secret_access_key`, `aws_session_token` may be passed to Env's constructor. In the latter case, a session will be created as soon as needed. AWS credentials are configured for GDAL as needed. c SSS.$)zPDefault configuration options Parameters ---------- None Returns ------- dict FT)GTIFF_IMPLICIT_JPEG_OVR RASTERIO_ENVr$clss rdefault_optionsEnv.default_options`s(-   rNFc URSS5nU(a[R"S[5 URSS5nURSS5nURSS5n SU;dSU;a [ S 5eU(aK[ U[ 5(d/[R"S [5 [ R"US 9nXlOU(dU(dU(a[ R"UUUU UUS 9UlOYS[R;a6S[R;a"[ R"5UlS Ul O[5UlUR5Ul0Ulg)aCreate a new GDAL/AWS environment. Note: this class is a context manager. GDAL isn't configured until the context is entered via `with rasterio.Env():` Parameters ---------- session : optional A Session object. aws_unsigned : bool, optional Do not sign cloud requests. profile_name : str, optional A shared credentials profile name, as per boto3. session_class : Session, optional A sub-class of Session. **options : optional A mapping of GDAL configuration options, e.g., `CPL_DEBUG=True, CHECK_WITH_INVERT_PROJ=False`. Returns ------- Env Notes ----- We raise EnvError if the GDAL config options AWS_ACCESS_KEY_ID or AWS_SECRET_ACCESS_KEY are given. AWS credentials are handled exclusively by boto3. Examples -------- >>> with Env(CPL_DEBUG=True, CPL_CURL_VERBOSE=True): ... with rasterio.open("https://example.com/a.tif") as src: ... print(src.profile) For access to secured cloud resources, a Rasterio Session or a foreign session object may be passed to the constructor. >>> import boto3 >>> from rasterio.session import AWSSession >>> boto3_session = boto3.Session(...) >>> with Env(AWSSession(boto3_session)): ... with rasterio.open("s3://mybucket/a.tif") as src: ... print(src.profile) aws_access_key_idNzdPassing abstract session keyword arguments is deprecated. Pass a Rasterio AWSSession object instead.aws_secret_access_keyaws_session_token region_nameAWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEYzdGDAL's AWS config options can not be directly set. AWS credentials are handled exclusively by boto3.zQPassing a boto3 session is deprecated. Pass a Rasterio AWSSession object instead.session)r0r1r2r3 profile_name aws_unsignedT)popwarningswarnrr isinstancer aws_or_dummyr7osenviron from_environ_session_from_environrcopyoptionscontext_options) rr7r9r8 session_classrDr0r1r2r3s rr Env.__init__qsGb$KK(;TB  MM=*  !( ,CT J#KK(;TBkk-6 7 *'72DE E gw// 1. "..w?"L ,,"//"3&;"3')) +DL!BJJ .3Jbjj3X"//1DL)-D &(>DL||~ !rcd[R5nUR"S0UD6 [U0UD6$)a Create an environment with default config options Parameters ---------- args : optional Positional arguments for Env() kwargs : optional Keyword arguments for Env() Returns ------- Env Notes ----- The items in kwargs will be overlaid on the default values. r$)r&r-update)r,argskwargsrDs r from_defaultsEnv.from_defaultss1(%%'  D$G$$rcURR5VVs0sHupURS5(dMX_M! snn$s snnf)NAWS_)rEitems startswith)rkvs raws_creds_from_context_options"Env.aws_creds_from_context_optionss<!%!5!5!;!;!=V!=fAU!=VVVs AAc*URR5nURR"S0UD6 [ S0UD6 [ USS5(a@UR 5nU(dgURR"S0UD6 [ S0UD6 gg)zGet credentials and configure GDAL Note well: this method is a no-op if the GDAL environment already has credentials, unless session is not None. Returns ------- None rBFNr$)r7get_credential_optionsrDrIsetenvgetattrrT)r cred_optsparent_context_credss r credentializeEnv.credentializesLL779  (i( 40% 8 8$(#F#F#H ' LL   7"6 7  *) * 9rc>[RR5$)z'Return a mapping of registered drivers.)localrdriversrs rr` Env.drivers szz!!##rc>[RR5$)zTWrites descriptions of open datasets to stderr For debugging and testing purposes. )r_r_dump_open_datasetsrs rrcEnv._dump_open_datasets s zz--//rc>[RR5$)zCReturns contents of /vsimem/. For debugging and testing purposes. )r_r _dump_vsimemrs rrfEnv._dump_vsimems zz&&((rc@[RSU5 [Rc[RS5 SUl0[lUR R5Vs1sH oS:wdM UiM nnUH%n[USS9nUcMU[R U'M' [S0UR D6 0Ul O+SUl[5Ul [S0UR D6 UR5 [RSU5 U$s snf) NzEntering env context: %rzStarting outermost envFr* normalizeTzEntered env context: %rr$)logdebugr_r_has_parent_envrrDkeysrdefenvrEgetenvrXr\)rrR probe_envkeyvals r __enter__ Env.__enter__s ,d3 ::  II. /#(D )+E %$(LL$5$5$7O$7q;N$7IO %cU;?58E--c2!  "T\\ "#%D #'D #)8D  "T\\ "  +T2 !Ps + D8Dc[RSU5 [5 UR(a [ 5 [ S0UR D6 Ov[RS5 [R(aA[RR5upE[XESS9 [R(aMAS[l[RSU5 g)NzExiting env context: %rzExiting outermost envFrizExited env context: %rr$) rkrldelenvrmrorXrEr_rpopitemr)rexc_typeexc_valexc_tbrrrss r__exit__ Env.__exit__7s +T2    H  *T)) * II- .++ 44<<>E:+++)-E % *D1r)rmrBrErDr7)NNN)rr r!r"__doc__ classmethodr-rr>rrLrTr\r`rcrfrtr|r#r$rrr&r&=sm D  $%d&33c"J%%.W+0$0)82rr&c [R(a%[RS[R5 Ol[RS5 [ 5[l[RR "S0UD6 [RS[R5 [RR 5 g)z*Create a default environment if necessary.zGDAL environment exists: %rNo GDAL environment existszNew GDAL environment %r createdNr$)r_rrkrlrupdate_config_optionsstartrDs rroroHsl zz /< ./Y  ((373 -uzz ; JJrc[R(d [S5e[R S[R5 [RR R 5$)z!Get a mapping of current options.rz$Got a copy of environment %r options)r_rr rkrlrDrCr$rrrprpUsA ::344 8%**Ezz!!&&((rc4[[R5$r)boolr_rr$rrhasenvr^s  rc [R(d [S5e[RR"S0UD6 g)z(Set options in the existing environment.rNr$)r_rr rrs rrXrXbs* ::344 ((373rc[R"S[5 [RSL=(a [ SS55$)Nz)Please use Env.session.hascreds() insteadc3b# UH%o[RR5;v M' g7fr)r_rget_config_options).0rrs r hascreds..ls.*L]KUX1N1N1P*P]Ks-/)r4r5)r;r<rr_rallr$rrhascredsrjsE MM=?YZ ::T ! Lc*L]K*L'LLrc[R(d [S5e[RR5 [R S[R5 [RR 5 S[lg)z+Delete options in the existing environment.rzCleared existing %r optionsN)r_rr clear_config_optionsrkrlstopr$rrrwrwosM ::344 '') /< JJOOEJrc&\rSrSrSrSrSrSrg)NullContextManagerizcgrr$rs rrNullContextManager.__init__| rcU$rr$rs rrtNullContextManager.__enter__s rcgrr$)rrJs rr|NullContextManager.__exit__rrr$N)rr r!r"rrtr|r#r$rrrrzs  rrch[R(a [5$[R 5$)zZReturn an Env if one does not exist Returns ------- Env or a do-nothing context manager )r_rrr&rLr$rrenv_ctx_if_neededrs# zz!##  ""rc0^[T5U4Sj5nU$)zTA decorator that ensures an env exists before a function calls any GDAL C functions.c>[R(aT"U0UD6$[R5 T"U0UD6sSSS5 $!,(df  g=fr)r_rr&rL)rJkwdsfs rwrapperensure_env..wrappers? ::d#d# #""$$'$'%$$s A Arrrs` r ensure_envrs" 1X(( NrcN[R"S[5 [U5$)z0DEPRECATED alias for ensure_env_with_credentialsz.Please use ensure_env_with_credentials instead)r;r<rensure_env_with_credentials)rs rensure_env_credentialledrs MMBD^_ &q ))rc0^[T5U4Sj5nU$)a)Ensures a config environment exists and is credentialized Parameters ---------- f : function A function. Returns ------- A function wrapper. Notes ----- The function wrapper checks the first argument of f and credentializes the environment if the first argument is a URI with scheme "s3". c>[R(a[nO[RnUR SS5=(d USn[ U[ 5(aW[R"U5n[R(a$UR[55(a[nU"5nO [5nU"US9 T"U0UD6sSSS5 $!,(df  g=f)Nfprr6) r_rr&rLgetr=strr cls_from_pathrrpr)rJrenv_ctorfp_arg session_clsr7rs rr,ensure_env_with_credentials..wrappers ::H((H$%0a fc " "!//7Kzzk2268<<* !mG#nG g &d#d#' & &s C C(rrs` rrrs"& 1X$$, NrT)slotsc\rSrSrSr\R "S\RR\ 5S9r \R "S\RR\ 5S9r Sr Sr SrSr\S 5r\S 5rS rS rg ) GDALVersionizConvenience class for obtaining GDAL major and minor version components and comparing between versions. This is highly simplistic and assumes a very normal numbering scheme for versions and ignores everything except the major and minor components.r)default validatorctURUR4[URUR5:H$rmajorminortuplerothers r__eq__GDALVersion.__eq__s) DJJ'5ekk+JJJrctURUR4[URUR5:$rrrs r__lt__GDALVersion.__lt__s) DJJ'% U[[*IIIrc<SURSURS3$)NzGDALVersion(major=z, minor=)rrrs r__repr__GDALVersion.__repr__s#DJJ.sE,DqCFF,Dsrrz5GDALVersion can only be parsed from a string or tuple) r=rrresearch ValueErrorformatgroupsplit TypeError)r,inputmatchrrs rparseGDALVersion.parses e ! !L eU # #;  s # #IIlE2E !!'00FEKKM,?,?,DELEU0 0OPPrc4UR[55$)z*Return GDALVersion of current GDAL runtime)rr r+s rruntimeGDALVersion.runtime syy((rc@URRU5nX:$r) __class__rrs rat_leastGDALVersion.at_leasts$$U+}rr$N)rr r!r"r~attrib validators instance_ofrrrrrrrrrrrr#r$rrrrs' GGA)D)DS)I JE GGA)D)DS)I JEKJF,QQ>))rrc&^^^^^^^Tb9Tc [S5e[T[[[45(d [S5e[ R T5m[ R5mTT:aSOSmT(aST3OTmUUUUUUU4SjnU$)a1A decorator that ensures the called function or parameters are supported by the runtime version of GDAL. Raises GDALVersionError if conditions are not met. Examples -------- .. code-block:: python @require_gdal_version('2.2') def some_func(): calling `some_func` with a runtime version of GDAL that is < 2.2 raises a GDALVersionErorr. .. code-block:: python @require_gdal_version('2.2', param='foo') def some_func(foo='bar'): calling `some_func` with parameter `foo` of any value on GDAL < 2.2 raises a GDALVersionError. .. code-block:: python @require_gdal_version('2.2', param='foo', values=('bar',)) def some_func(foo=None): calling `some_func` with parameter `foo` and value `bar` on GDAL < 2.2 raises a GDALVersionError. Parameters ------------ version: tuple, string, or GDALVersion param: string (optional, default: None) If `values` are absent, then all use of this parameter with a value other than default value requires at least GDAL `version`. values: tuple, list, or set (optional, default: None) contains values that require at least GDAL `version`. `param` is required for `values`. is_max_version: bool (optional, default: False) if `True` indicates that the version provided is the maximum version allowed, instead of requiring at least that version. reason: string (optional: default: '') custom error message presented to user in addition to message about GDAL version. Use this to provide an explanation of what changed if necessary context to the user. Returns --------- wrapped function z8require_gdal_version: param must be provided with valuesz:require_gdal_version: values must be a tuple, list, or setz>=z<= c @>^[T5UUUUUUUU4Sj5nU$)Nc >T T :aT(aT(GaGT T :Ga@Tc%[SRT[T 5T 55e[T5nUR 5nUR (a:UR [[UR S[U5U555 UR(a<[[[UR 5[UR555nO0nTU;a]T c0TU;d UTUT:wa[SRTTT T 55eO*UTT ;a![SRTUTTT T 55eT"U0UD6$)NzGDAL version must be {} {}{}z-usage of parameter "{}" requires GDAL {} {}{}z'parameter "{}={}" requires GDAL {} {}{}) rrr getargspecrCrJrIdictziplendefaultsreversed) rJrargspec full_kwdsrr inequalityis_max_versionparamreasonrvaluesversions rr8require_gdal_version..decorator..wrapper\sb7">#'(9=*6==&G f>?? %Q- IIK <<$$T#gll:CI.F*M%NO###C .9I9I0J%L MH "HI%~ 0 )% 0HUO C"2!//5v$):w0"#!D#5)V3.++16 %y'7Wf,d#d# #rr) rrrrrrrrrs ` r decorator'require_gdal_version..decorator[s& q) $) $ ) $Vr)rr=rlistsetrrr)rrrrrrrrs````` @@rrequire_gdal_versionrsp =JL L&5$"455LN N(G!!#G 7*J$r&]&F--^ r GDAL_DATAz$GDAL data found in package: path=%r.z gdalvrt.xsdz0GDAL data files are available at built-in paths.z,GDAL data found in other locations: path=%r. PROJ_DATAPROJ_LIBz$PROJ data found in package: path=%r.z0PROJ data files are available at built-in paths.z,PROJ data found in other locations: path=%r.)NNF)8r~ functoolsrrinspectrrloggingr?r threadingr;r rasterio._envrrrr r r rasterio._versionr rasterio.errorsr rrrasterio.sessionrrr_r getLoggerrrkr&rorprrXrrwrrrrrsrrr@ search_wheelpathrl find_filerhas_datar$rrrsF%+0  +RR2( (<   !H2H2V )4L     # * *Zd<<<~KP "utbjj   ( ( *D  8$? T*   # #M 2 2 DE&&(  K . IIDd K"** ::k "Dd#2:: ::j !Dd#""$$   ( ( *DII4d;d#  II@A   " " $D  @$G!$' r