MG SrSSKrSSKrSSKJr SSKJr SSKJr SSKJ r SSK J r Sr S r S R\ \ S 9rS \-rS \-r"SS\5rSrSrSrSrSrSrSrSr"SS\5r"SS\5rSSjrg)zUtilities for deriving services and configs from paths. Paths are typically given as positional params, like `gcloud app deploy ...`. N)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) Service2a3Represents 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__Es OK$ Oc.URR$r)rmodulers r service_idService.service_idKs    # ##rc.URR$r)rfilers rpath Service.pathOs    ! !!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)clsrstager path_matchersappyamlmatcherservices rFromPathService.FromPathSs) !g.g ! r)rrrrN) __name__ __module__ __qualname____firstlineno____doc__rpropertyrr classmethodr)__static_attributes__r"rrr r 2sH$!  $ $ " "rr c[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)osrisfilejoinsplitextexistsdirnamerServiceYamlInfoFromFileStageruntimerr ) rr$r&r_extapp_dirr staging_dirs rServiceYamlMatcherrCjs4ww~~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-jarr4N)r5rr8r9abspathr7pardirr=rSTANDARDrr;r<r ) jar_pathr$r&r?r@rArrB yaml_pathrs r JarMatcherrJs, 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-projectr4Nr5rr6r7basenamer9r:r=rrGrr;r<r rr$r&rfilenamerArBrIrs r PomXmlMatcherrPs2ww~~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-projectr4NrLrNs rBuildGradleMatcherrRs2ww~~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-xmlr4)r5rr7sependswithlenr6rReadFileContentsrwarningr=rrGrr;r<r ) rr$r&suffixrArxml_filerBrIrs 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 )rr$r&rrBs 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)r5risdirrerror NO_YAML_ERROR)rr$r&s rUnidentifiedDirMatcherrbBs+ 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. )rCr[rJrPrRr]rbr"rrGetPathMatchersrdSs!-z=02H rc.\rSrSrSrSSjrSrSrSrg) Servicesi`z"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__cs1!,,.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)rjgetrrDuplicateServiceErrorr)rr(existings rrk Services.Addrs]~~!!'"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. )listrjvaluesrs rGetAllServices.GetAlls %%' ((r)rjr r+r,r-r.r/rrkrwr2r"rrrfrf`s*  1)rrfc*\rSrSrSrSrSrSrSrg)ConfigsizCollection of config files.c8[R"5Ulgr)rhri_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)configr}rprDuplicateConfigErrorr)rr config_typerrs rrk 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. )rur}rvrs rrwConfigs.GetAlls  $$& ''r)r}Nryr"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)r5rrEr{rfrVrMultiDeployErrorr9FileNotFoundErrorformatrConfigYamlInfor<rkr r)UnknownSourceErrorrw) argsr$r%r&argpathsconfigsrlrrr(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)r/rhr5googlecloudsdk.api_lib.apprrgooglecloudsdk.command_lib.apprgooglecloudsdk.corergooglecloudsdk.core.utilr_STANDARD_APP_YAML_URL_FLEXIBLE_APP_YAML_URLrAPP_YAML_INSTRUCTIONSFINGERPRINTING_WARNINGraobjectr rCrJrPrRr[r]rbrdrfr{rr"rrrs *35#*JJI&$*@&A ;G 5f5p$ND"J#L+A\," ')v')T(f(>?-r