G4dZddlmZddlmZddlmZddlZddlZddlmZddlm Z ddl m Z dd l m Z dd lmZd Zd Zd j%eeZdezZdezZGddeZdZdZdZdZdZdZdZdZGddeZ GddeZ!d dZ"y)!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 cFeZdZdZdZedZedZedZ y)ServiceaQRepresents 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. c<||_||_||_||_yN) descriptorsource service_info upload_dir)selfrrrrs 1lib/googlecloudsdk/command_lib/app/deployables.py__init__zService.__init__Hs DODK$D DOc.|jjSr)rmodulers r service_idzService.service_idNs    # ##rc.|jjSr)rfilers rpathz Service.pathRs    ! !!rc2|D]}||||}|s|cSy)aeReturn 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 rFromPathzService.FromPathVs) !fg.g ! rN) __name__ __module__ __qualname____doc__rpropertyrr classmethodr(r!rrrr5sH$!  $ $ " "rrctjj|r|ntjj|d}tjj |\}}tjj |r}|dvrytjj |}tjj|}|j|||j|j|}t||||xs|Sy)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 rServiceYamlMatcherr?ms4ww~~d+td>H2J* 77  J '&!SWW^^JC+<$<ggooj)G//88DL,,z7L4H4H+//:K :w k6LW MM rctjj|\}}tjj|r|dvrtjj tjj |tj }|}|j||dtj|}tjj |d}tjj|} t||| |Sy)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-jarr0N)r1rr4r5abspathr3pardirr9rSTANDARDrr7r8r) jar_pathr#r%r;r<r=rr> yaml_pathrs r JarMatcherrFs, 77  H %&!SWW^^H#/ggoobggll8RYY?@GJ,,z7J &(K [*5I//88CL :w k BB rc*tjj|r|ntjj|d}tjj |}tjj |r|dk(rtjj |}|j||dtj|}tjj|d}tjj|}t||||Sy)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-projectr0Nr1rr2r3basenamer5r6r9rrCrr7r8r rr#r%rfilenamer=r>rErs r PomXmlMatcherrLs2ww~~d+tdI1N* WW  j )(WW^^JH $9ggooj)G,,z74H"||W6K [*5I//88CL :w k BB rc*tjj|r|ntjj|d}tjj |}tjj |r|dk(rtjj |}|j||dtj|}tjj|d}tjj|}t||||Sy)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-projectr0NrHrJs rBuildGradleMatcherrNs2ww~~d+t N2* WW  j )(WW^^JH$>ggooj)G,,z74I"||W6K [*5I//88CL :w k BB rcptjjtjdd}|j |r|dt | n|}tjj|dd}tjj |sytj|}d|vsd|vrtjd|j||dtj|}|sytjj|d}tjj!|} t#||| |S) 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-xmlr0)r1rr3sependswithlenr2r ReadFileContentsr warningr9rrCrr7r8r) rr#r%suffixr=rxml_filer>rErs rAppengineWebMatcherrWs2 77<< +> ?&#'==#8D3v;, d'ww||GY0CD*  #   # #J /( K8$;KK89 Z*cll$&+  ggll; 3)--66yA, WlK @@rc|rLtjj|}|j||d|j|}t ||||Sy)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)rr7r8r9rr)rr#r%rr>s rExplicitAppYamlMatcherrY/sP //88AL,,wnl>N>N&(K 7D, << rcx~~tjj|rtjt y)aiPoints 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)r1risdirr error NO_YAML_ERROR)rr#r%s rUnidentifiedDirMatcherr^Es( gWW]]4IIm rcLtttttt t gS)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. )r?rWrFrLrNrYr^r!rrGetPathMatchersr`Vs!-z=02H rc$eZdZdZddZdZdZy)Servicesz"Collection of deployable services.Ncltj|_|r|D]}|j|yy)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 rrzServices.__init__fs1!,,.DN!  rc|jj|j}|r5tj|j |j |j||j|j<y)zAdd a deployable service to the set. Args: service: Service, to add. Raises: DuplicateServiceError: Two or more services have the same service id. N)rfgetrrDuplicateServiceErrorr)rr'existings rrgz Services.Addus_~~!!'"4"45H  , ,X]]GLL-4-?-? AA)0DNN7%%&rcHt|jjS)zyRetrieve the service info objects in the order they were added. Returns: List[Service], list of services. )listrfvaluesrs rGetAllzServices.GetAlls %%' ((rrr)r*r+r,rrgrqr!rrrbrbcs*  1)rrbc"eZdZdZdZdZdZy)ConfigszCollection of config files.c6tj|_yr)rdre_configsrs rrzConfigs.__init__s++-DMrc|j}|jj|}|r+tj|j |j |||j|<y)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)configrvrkrDuplicateConfigErrorr)rrx config_typerms rrgz Configs.AddsT--K}}  -H  + +HMM6;;,7 99!'DMM+rcHt|jjS)zRetreive the config file objects in the order they were added. Returns: List[ConfigYamlInfo], list of config file objects. )rorvrprs rrqzConfigs.GetAlls  $$& ''rNrrr!rrrtrts#.( (rrtc|sdg}|Dcgc]!}tjj|#}}t}t }|rt |dkDrt jtjjtjj|s$t jdj|tjj|dst j|d|D]}tjj|st j|tjj|} | r|j| jtj!||||} | r|j| t j"||j%|j%fScc}w)acGiven 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)r1rrArtrbrRrMultiDeployErrorr5FileNotFoundErrorformatrConfigYamlInfor8rgrr(UnknownSourceErrorrq) argsr#r$r%argpathsconfigsrhrrxr's rGetDeployablesrspJ  5D+/ 04C277??3 4% 0 I' Z(  5zA~  ' ' )) 77>>"''//'2 3  ( (*;;A6'? LL 77>>%( #  ( (q 22d 77>>$   ( ( ..  ( ( 1 1$ 7F  kk&tV]GDGll7  ' ' --  GNN, ,,1 1s&Gr)#r, __future__rrrrdr1googlecloudsdk.api_lib.apprrgooglecloudsdk.command_lib.apprgooglecloudsdk.corer googlecloudsdk.core.utilr _STANDARD_APP_YAML_URL_FLEXIBLE_APP_YAML_URLrAPP_YAML_INSTRUCTIONSFINGERPRINTING_WARNINGr]objectrr?rFrLrNrWrYr^r`rbrtrr!rrrs '' *35#*JJI&$*@&A ;G 5f5p$ND"J#L+A\," ')v')T(f(>?-r