G0SrSSKJr SSKJr SSKJr SSKrSSKrSSKJr SSKJ r SSK J r SS K J r SS KJr S rS rS R%\\S9rS\-rS\-r"SS\5rSrSrSrSrSrSrSrSr"SS\5r "SS\5r!S Sjr"g)!zUtilities for deriving services and configs from paths. Paths are typically given as positional params, like `gcloud app deploy ...`. )absolute_import)division)unicode_literalsN)env) yaml_parsing) exceptions)log)fileszChttps://cloud.google.com/appengine/docs/standard/reference/app-yamlzChttps://cloud.google.com/appengine/docs/flexible/reference/app-yamlzusing the directions at {flex} (App Engine flexible environment) or {std} (App Engine standard environment) under the tab for your language.)flexstdz4As an alternative, create an app.yaml file yourself zAn app.yaml (or appengine-web.xml) file is required to deploy this directory as an App Engine application. Create an app.yaml file cN\rSrSrSrSr\S5r\S5r\ S5r Sr g) Service5a3Represents data around a deployable service. Attributes: descriptor: str, File path to the original deployment descriptor, which is either a `.yaml` or an `appengine-web.xml`. source: str, Path to the original deployable artifact or directory, which is typically the original source directory, but could also be an artifact such as a fat JAR file. service_info: yaml_parsing.ServiceYamlInfo, Info parsed from the `.yaml` file. Note that service_info.file may point to a file in a staged directory. upload_dir: str, Path to the source directory. If staging is required, this points to the staged directory. service_id: str, the service id. path: str, File path to the staged deployment `.yaml` descriptor or to the original one, if no staging is used. c4XlX lX0lX@lgN) descriptorsource service_info upload_dir)selfrrrrs 1lib/googlecloudsdk/command_lib/app/deployables.py__init__Service.__init__Hs OK$ Oc.URR$r)rmodulers r service_idService.service_idNs    # ##rc.URR$r)rfilers rpath Service.pathRs    ! !!rc>UHnU"XU5nU(dMUs $ g)a9Return a Service from a path using staging if necessary. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will be invoked if there is a runtime and environment match. path_matchers: List[Function], ordered list of functions on the form fn(path, stager), where fn returns a Service or None if no match. appyaml: str or None, the app.yaml location to used for deployment. Returns: Service, if one can be derived, else None. N)clsr"stager path_matchersappyamlmatcherservices rFromPathService.FromPathVs) !g.g ! r)rrrrN) __name__ __module__ __qualname____firstlineno____doc__rpropertyrr" classmethodr,__static_attributes__r%rrrr5sH$!  $ $ " "rrc[RRU5(aUO[RRUS5n[RR U5upE[RR U5(aUS;a{[RR U5n[RRU5nURX6URURU5n[X6Xx=(d U5$g)aGenerate a Service from an .yaml source path. This function is a path matcher that returns if and only if: - `path` points to either a `.yaml` or `` where `/app.yaml` exists. - the yaml-file is a valid .yaml file. If the runtime and environment match an entry in the stager, the service will be staged into a directory. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will be invoked if there is a runtime and environment match. appyaml: str or None, the app.yaml location to used for deployment. Raises: staging.StagingCommandFailedError, staging command failed. Returns: Service, fully populated with entries that respect a potentially staged deployable service, or None if the path does not match the pattern described. app.yaml)z.yamlz.ymlN)osr"isfilejoinsplitextexistsdirnamerServiceYamlInfoFromFileStageruntimerr) r"r'r)r_extapp_dirr staging_dirs rServiceYamlMatcherrFms4ww~~d++td>H2J* 77  J '&!WW^^JC+<$<ggooj)G//88DL,,zL4H4H+//:K : 6LW MM rc[RRU5up4[RRU5(aUS;a[RR [RR U[R 55nUnURXeS[RU5n[RR US5n[RRU5n [XeX5$g)aGenerate a Service from a Java fatjar path. This function is a path matcher that returns if and only if: - `jar_path` points to a jar file . The service will be staged according to the stager as a jar runtime, which is defined in staging.py. Args: jar_path: str, Unsanitized absolute path pointing to a file of jar type. stager: staging.Stager, stager that will be invoked if there is a runtime and environment match. appyaml: str or None, the app.yaml location to used for deployment. Raises: staging.StagingCommandFailedError, staging command failed. Returns: Service, fully populated with entries that respect a staged deployable service, or None if the path does not match the pattern described. )z.jarzjava-jarr7N)r8r"r;r<abspathr:pardirr@rSTANDARDrr>r?r) jar_pathr'r)rBrCrDrrE yaml_pathrs r JarMatcherrMs, 77  H %&!WW^^H#/ggoobggll8RYY?@GJ,,zJ &(K [*5I//88CL : BB rc:[RRU5(aUO[RRUS5n[RR U5n[RR U5(aUS:Xa[RR U5nURX5S[RU5n[RRUS5n[RRU5n[X5X5$g)aGenerate a Service from an Maven project source path. This function is a path matcher that returns true if and only if: - `path` points to either a Maven `pom.xml` or `` where `/pom.xml` exists. If the runtime and environment match an entry in the stager, the service will be staged into a directory. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will be invoked if there is a runtime and environment match. appyaml: str or None, the app.yaml location to used for deployment. Raises: staging.StagingCommandFailedError, staging command failed. Returns: Service, fully populated with entries that respect a potentially staged deployable service, or None if the path does not match the pattern described. zpom.xmlzjava-maven-projectr7Nr8r"r9r:basenamer<r=r@rrJrr>r?r r"r'r)rfilenamerDrErLrs r PomXmlMatcherrSs2ww~~d++tdI1N* WW  j )(WW^^JH $9ggooj)G,,z4H"||W6K [*5I//88CL : BB rc:[RRU5(aUO[RRUS5n[RR U5n[RR U5(aUS:Xa[RR U5nURX5S[RU5n[RRUS5n[RRU5n[X5X5$g)aGenerate a Service from an Gradle project source path. This function is a path matcher that returns true if and only if: - `path` points to either a Gradle `build.gradle` or `` where `/build.gradle` exists. If the runtime and environment match an entry in the stager, the service will be staged into a directory. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will be invoked if there is a runtime and environment match. appyaml: str or None, the app.yaml location to used for deployment. Raises: staging.StagingCommandFailedError, staging command failed. Returns: Service, fully populated with entries that respect a potentially staged deployable service, or None if the path does not match the pattern described. z build.gradlezjava-gradle-projectr7NrOrQs rBuildGradleMatcherrUs2ww~~d++t N2* WW  j )(WW^^JH$>ggooj)G,,z4I"||W6K [*5I//88CL : BB rc[RR[RSS5nUR U5(aUS[ U5*OUn[RRUSS5n[RR U5(dg[R"U5nSU;dSU;a[R"S5 URXTS[RU5nU(dg[RRUS5n[RR!U5n [#XTX5$) aGenerate a Service from an appengine-web.xml source path. This function is a path matcher that returns if and only if: - `path` points to either `.../WEB-INF/appengine-web.xml` or `` where `/WEB-INF/appengine-web.xml` exists. - the xml-file is a valid appengine-web.xml file according to the Java stager. The service will be staged according to the stager as a java-xml runtime, which is defined in staging.py. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will be invoked if there is a runtime and environment match. appyaml: str or None, the app.yaml location to used for deployment. Raises: staging.StagingCommandFailedError, staging command failed. Returns: Service, fully populated with entries that respect a staged deployable service, or None if the path does not match the pattern described. zWEB-INFzappengine-web.xmlNz z zM and elements in `appengine-web.xml` are not respectedzjava-xmlr7)r8r"r:sependswithlenr9r ReadFileContentsr warningr@rrJrr>r?r) r"r'r)suffixrDrxml_filerErLrs rAppengineWebMatcherr^s2 77<< +> ?&#'==#8#8D3v;, d'ww||GY0CD*  # #   # #J /( K8$;KK89 Z*cll$&+  ggll; 3)--66yA, l @@rcU(aI[RRU5nURX SURU5n[ X X45$g)aUse optional app.yaml with a directory or a file the user wants to deploy. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will not be invoked. appyaml: str or None, the app.yaml location to used for deployment. Returns: Service, fully populated with entries that respect a staged deployable service, or None if there is no optional --appyaml flag usage. z generic-copyN)rr>r?r@rr)r"r'r)rrEs rExplicitAppYamlMatcherr`/sJ //88AL,,wnl>N>N&(K 7, << rcAA[RRU5(a[R"[ 5 g)aYPoints out to the user that they need an app.yaml to deploy. Args: path: str, Unsanitized absolute path, may point to a directory or a file of any type. There is no guarantee that it exists. stager: staging.Stager, stager that will not be invoked. appyaml: str or None, the app.yaml location to used for deployment. Returns: None N)r8r"isdirr error NO_YAML_ERROR)r"r'r)s rUnidentifiedDirMatcherreEs+ gWW]]4IIm rcL[[[[[[ [ /$)zGet list of path matchers ordered by descending precedence. Returns: List[Function], ordered list of functions on the form fn(path, stager), where fn returns a Service or None if no match. )rFr^rMrSrUr`rer%rrGetPathMatchersrgVs!-z=02H rc.\rSrSrSrSSjrSrSrSrg) Servicesicz"Collection of deployable services.Nc|[R"5UlU(aUHnURU5 M gg)zInstantiate a set of deployable services. Args: services: List[Service], optional list of services for quick initialization. Raises: DuplicateServiceError: Two or more services have the same service id. N) collections OrderedDict _servicesAdd)rservicesds rrServices.__init__fs1!,,.DN!  rcURRUR5nU(a6[R"UR UR UR5eXRUR'g)zAdd a deployable service to the set. Args: service: Service, to add. Raises: DuplicateServiceError: Two or more services have the same service id. N)rmgetrrDuplicateServiceErrorr")rr+existings rrn Services.Addus]~~!!'"4"45H  , ,X]]GLL-4-?-? AA)0NN7%%&rcH[URR55$)zmRetrieve the service info objects in the order they were added. Returns: List[Service], list of services. )listrmvaluesrs rGetAllServices.GetAlls %%' ((r)rmr r.r/r0r1r2rrnrzr5r%rrrirics*  1)rric*\rSrSrSrSrSrSrSrg)ConfigsizCollection of config files.c8[R"5Ulgr)rkrl_configsrs rrConfigs.__init__s++-DMrcURnURRU5nU(a,[R"UR UR U5eXRU'g)zAdd a ConfigYamlInfo to the set of configs. Args: config: ConfigYamlInfo, the config to add. Raises: exceptions.DuplicateConfigError, the config type is already in the set. N)configrrsrDuplicateConfigErrorr!)rr config_typerus rrn Configs.AddsR--K}}  -H  + +HMM6;;,7 99!'MM+rcH[URR55$)z~Retreive the config file objects in the order they were added. Returns: List[ConfigYamlInfo], list of config file objects. )rxrryrs rrzConfigs.GetAlls  $$& ''r)rNr|r%rrr~r~s#.( (rr~cU(dS/nUVs/sH"n[RRU5PM$ nn[5n[ 5nU(a[ U5S:a[ R"5e[RR[RRU55(d%[ R"SRU55e[RRUS5(d[ R"US5eUHn[RRU5(d[ R"U5e[RRU5n U (aURU 5 Mv[R!XX#5n U (aURU 5 M[ R""U5e UR%5UR%54$s snf)a)Given a list of args, infer the deployable services and configs. Given a deploy command, e.g. `gcloud app deploy ./dir other/service.yaml cron.yaml WEB-INF/appengine-web.xml`, the deployables can be on multiple forms. This method pre-processes and infers yaml descriptors from the various formats accepted. The rules are as following: This function is a context manager, and should be used in conjunction with the `with` keyword. 1. If `args` is an empty list, add the current directory to it. 2. For each arg: - If arg refers to a config file, add it to the configs set. - Else match the arg against the path matchers. The first match will win. The match will be added to the services set. Matchers may run staging. Args: args: List[str], positional args as given on the command-line. stager: staging.Stager, stager that will be invoked on sources that have entries in the stager's registry. path_matchers: List[Function], list of functions on the form fn(path, stager) ordered by descending precedence, where fn returns a Service or None if no match. appyaml: str or None, the app.yaml location to used for deployment. Raises: FileNotFoundError: One or more argument does not point to an existing file or directory. UnknownSourceError: Could not infer a config or service from an arg. DuplicateConfigError: Two or more config files have the same type. DuplicateServiceError: Two or more services have the same service id. Returns: Tuple[List[Service], List[ConfigYamlInfo]], lists of deployable services and configs. .z0File {0} referenced by --appyaml does not exist.r)r8r"rHr~rirYrMultiDeployErrorr<FileNotFoundErrorformatrConfigYamlInfor?rnrr,UnknownSourceErrorrz) argsr'r(r)argpathsconfigsror"rr+s rGetDeployablesrsuJ  5D+/ 04C277??3 4% 0 I' Z(  5zA~  ' ' )) 77>>"''//'2 3 3  ( (*;;A6'? LL 77>>%( # #  ( (q 22d 77>>$    ( ( ..  ( ( 1 1$ 7F  kk&t]DGll7  ' ' --  GNN, ,,1 1s)G?r)#r2 __future__rrrrkr8googlecloudsdk.api_lib.apprrgooglecloudsdk.command_lib.apprgooglecloudsdk.corer googlecloudsdk.core.utilr _STANDARD_APP_YAML_URL_FLEXIBLE_APP_YAML_URLrAPP_YAML_INSTRUCTIONSFINGERPRINTING_WARNINGrdobjectrrFrMrSrUr^r`rergrir~rr%rrrs '' *35#*JJI&$*@&A ;G 5f5p$ND"J#L+A\," ')v')T(f(>?-r