Returns the result of merging twoAdminConsole objects.

Merges the non-referential state of the providedAppInclude.

That is,builtins andincludes directives are not preserved, but any static objects are copied into an aggregateAppInclude object that preserves the directives of both providedAppInclude objects.

appinclude_one is updated to be the merged result in this process.

• appinclude_one – FirstAppInclude to merge.

• appinclude_two – SecondAppInclude to merge.

AppInclude object that is the result of merging the static directives ofappinclude_one andappinclude_two. An updated version ofappinclude_one is returned.

Merges anapp.yaml file with referenced builtins/includes.

• appyaml – Theapp.yaml file that you want to update withappinclude.

• appinclude – The includes that you want to merge intoappyaml.

An updatedapp.yaml file that includes the directives you specified inappinclude.

Takes the greater of<manual_scaling.instances> from the arguments.

appinclude_one is mutated to be the merged result in this process.

Also, this function must be updated ifManualScaling gets additional fields.

• appinclude_one – The first object to merge. The object must have amanual_scaling field that contains aManualScaling().

• appinclude_two – The second object to merge. The object must have amanual_scaling field that contains aManualScaling().

An object that is the result of mergingappinclude_one.manual_scaling.instances andappinclude_two.manual_scaling.instances; this is returned as a revisedappinclude_one object after the mutations are complete.

Merges twoskip_files directives.

• skip_files_one – The firstskip_files element that you want to merge.

• skip_files_two – The secondskip_files element that you want to merge.

A list of regular expressions that are merged.

Unique identifier for application.

Application’s major version.

Runtime used by application.

Which version of APIs to use.

Optional specification of the source language. For example, you could specifyphp-quercus if this is a Java app that was generated from PHP source using Quercus.

List of URL handlers.

Default time delta to use for cache expiration for all static files, unless they have their own specificexpiration set. See the documentation for theURLMap.expiration field for more information.

A regular expression object. Files that match this regular expression will not be uploaded byappcfg.py. For example:

skip_files:|.svn.*|#.*#

A regular expression object. Files that match this regular expression will not be built into the app. This directive is valid for Go only.

URL root and script or servlet path for enhanced API serving.

Applies settings from the indicated backend to theAppInfoExternal.

Backend entries can contain directives that modify other parts of theapp.yaml file, such as thestart directive, which adds a handler for the start request. This method performs those modifications.

backend_name – The name of a backend that is defined in thebackends directive.

• BackendNotFound – If the indicated backend was not listed in thebackends directive.

• DuplicateBackend – If the backend is found more than once in thebackends directive.

Performs non-regular expression-based validation.

The following are verified:

• At least one URL mapping is provided in the URL mappers.

• The number of URL mappers doesn’t exceedMAX_URL_MAPS.

• The major version does not contain the string-dot-.

• Ifapi_endpoints are defined, anapi_config stanza must be defined.

• If theruntime ispython27 andthreadsafe is set, then no CGI handlers can be used.

• The version name doesn’t start withBUILTIN_NAME_PREFIX.

• Ifredirect_http_response_code exists, it is in the list of valid 300s.

• Module and service aren’t both set. Services were formerly known as modules.

• DuplicateLibrary – Iflibrary_name is specified more than once.

• MissingURLMapping – If noURLMap object is present in the object.

• TooManyURLMappings – If there are too manyURLMap entries.

• MissingApiConfig – Ifapi_endpoints exists without anapi_config.

• MissingThreadsafe – Ifthreadsafe is not set but the runtime requires it.

• ThreadsafeWithCgiHandler – If theruntime ispython27,threadsafe is set and CGI handlers are specified.

• TooManyScalingSettingsError – If more than one scaling settings block is present.

• RuntimeDoesNotSupportLibraries – If the libraries clause is used for a runtime that does not support it, such aspython25.

Returns a list of allLibrary instances active for this configuration.

The list of activeLibrary instances for this configuration. This includes directly-specified libraries as well as any required dependencies.

Returns the app’s runtime, resolving VMs to the underlyingvm_runtime.

The value ofbeta/vm_settings.vm_runtime ifruntime isvm, orruntime otherwise.

The effective runtime

Returns a list of normalizedLibrary instances for this configuration.

The list of activeLibrary instances for this configuration. This includes directly-specified libraries, their required dependencies, and any libraries enabled by default. Any libraries withlatest as their version will be replaced with the latest available version.

Normalizes VM settings.

Sets the runtime while respecting vm runtimes rules for runtime settings.

runtime – The runtime to use.

Merges twoBetaSettings instances.

• beta_settings_one – The firstBetaSettings instance, orNone.

• beta_settings_two – The secondBetaSettings instance, orNone.

The mergedBetaSettings instance, orNone if both input instances areNone or empty.

Bases: dict

Provides a dictionary object that will always claim to have a key.

This dictionary returns a fixed value for anyget operation. The fixed value that you pass in as a constructor parameter should be avalidation.Validated object.

Finds if a builtin is defined in a given list of builtin handler objects.

• builtins_list – A list ofBuiltinHandler objects, typicallyyaml.builtins.

• builtin_name – The name of the built-in that you want to determine whether it is defined.

True ifbuiltin_name is defined by a member ofbuiltins_list; all other results returnFalse.

Converts a list ofBuiltinHandler objects.

builtins_list – A list ofBuildinHandler objects to convert to tuples.

A list of(name, status) that is derived from theBuiltinHandler objects.

Converts aBuiltinHander object to a dictionary.

on/off}` form

A dictionary in `{builtin_handler_name

Verifies that allBuiltinHandler objects are valid and not repeated.

• builtins_list – A list ofBuiltinHandler objects to validate.

• runtime – If you specify this argument, warnings are generated for built-ins that have been deprecated in the given runtime.

• InvalidBuiltinFormat – If the name of aBuiltinHandler object cannot be determined.

• DuplicateBuiltinsSpecified – If aBuiltinHandler name is used more than once in the list.

Determines if the CustomMetric is not valid.

• appinfo_errors.TooManyAutoscalingUtilizationTargetsError – If too many

• scaling targets are set.

• appinfo_errors.NotEnoughAutoscalingUtilizationTargetsError – If no scaling

• targets are set.

Determines if the Endpoints API Service is not valid.

• appinfo_errors.MissingEndpointsConfigId – If the config id is missing when the rollout strategy is unspecified or set to “fixed”.

• appinfo_errors.UnexpectedEndpointsConfigId – If the config id is set when the rollout strategy is “managed”.

Merges twoEnvironmentVariables instances.

If a variable is specified by both instances, the value fromenv_variables_two is used.

• env_variables_one – The firstEnvironmentVariables instance orNone.

• env_variables_two – The secondEnvironmentVariables instance orNone.

The mergedEnvironmentVariables instance, orNone if both input instances areNone or empty.

alias of str

Gets a header value.

header_name – HTTP header name to look for.

A header value that corresponds toheader_name. If more than one such value is inself, one of the values is selected arbitrarily and returned. The selection is not deterministic.

Bases:google.appengine.api.validation.Validator

Ensures that keys inHttpHeadersDict are valid.

HttpHeadersDict contains a list of headers. An instance is used asHttpHeadersDict’sKEY_VALIDATOR.

Bases:google.appengine.api.validation.Validator

Ensures that values inHttpHeadersDict are valid.

An instance is used asHttpHeadersDict’sVALUE_VALIDATOR.

Determines if the library configuration is not valid.

• appinfo_errors.InvalidLibraryName – If the specified library is not supported.

• appinfo_errors.InvalidLibraryVersion – If the specified library version is not supported.

alias of str

Specifies whether a user should be logged in to access a URL. The default value of this argument isoptional.

Sets the restriction on the protocol that can be used to serve this URL or handler. This value can be set toHTTP,HTTPS oreither.

Specifies a regular expression that is used to fully match against the request URLs path. See the “Special cases” section of this document to learn more.

Specifies the handler ID attribute that mapsurl to the appropriate file. You can specify regular expression backreferences to the string matched tourl.

Specifies the regular expression that is used by the application configuration program to determine which files are uploaded as blobs. Because it is difficult to determine this information using just theurl andstatic_files arguments, this attribute must be included. This attribute is required when you define astatic_files mapping. A matching file name must fully match against theupload regular expression, similar to howurl is matched against the request path. Do not begin theupload argument with the^ character or end it with the$ character.

Specifies the handler ID that maps the providedurl to a sub-directory within the application directory. See “Special cases.”

When used withstatic_files andstatic_dir, this argument specifies that the MIME type of the files that are served from those directories must be overridden with this value.

Specifies the handler ID that maps URLs to a script handler within the application directory that will run using CGI.

Used inAppInclude objects to specify whether a handler should be inserted at the beginning of the primary handler list or at the end. Iftail is specified, the handler is inserted at the end; otherwise, the handler is inserted at the beginning. This behavior implies thathead is the effective default.

When used with static files and directories, this argument specifies the time delta to use for cache expiration. This argument should use the following format:4d 5h 30m 15s, where each letter signifies days, hours, minutes, and seconds, respectively. Thes for “seconds” can be omitted. Only one amount must be specified, though combining multiple amounts is optional. The following list contains examples of values that are acceptable:10,1d 6h,1h 30m,7d 7d 7d,5m 30.

Specifies the handler ID that identifies an endpoint as an API endpoint. Calls that terminate here will be handled by the API serving framework.

Makes sure thatself.http_headers is consistent withself.mime_type.

This method assumes thatself is a static handler, eitherself.static_dir orself.static_files. You cannot specifyNone.

appinfo_errors.ContentTypeSpecifiedMultipleTimes – Ifself.http_headers

contains aContent-Type header, andself.mime_type is set. For example, the following configuration would be rejected:

handlers:-url:/staticstatic_dir:staticmime_type:text/htmlhttp_headers:content-type:text/html

As this example shows, a configuration will be rejected whenhttp_headers andmime_type specify a content type, even when they specify the same content type.

Adds additional checking to make sure a handler has correct fields.

In addition to normalValidatedCheck, this method callsGetHandlerType, which validates whether all of the handler fields are configured properly.

• UnknownHandlerType – If none of the handler ID attributes are set.

• UnexpectedHandlerAttribute – If an unexpected attribute is set for the discovered handler type.

• HandlerTypeMissingAttribute – If the handler is missing a required attribute for its handler type.

• ContentTypeSpecifiedMultipleTimes – Ifmime_type is inconsistent withhttp_headers.

Raises an error if position is specified outside of AppInclude objects.

PositionUsedInAppYamlHandler – If theposition attribute is specified for anapp.yaml file instead of aninclude.yaml file.

Forces omittedsecure handler fields to be set to ‘secure: optional’.

The effect is thathandler.secure is never equal to the nominal default.

Gets the handler for a mapping.

The value of the handler, as determined by the handler ID attribute.

Gets the handler type of a mapping.

The handler type as determined by which handler ID attribute is set.

• UnknownHandlerType – If none of the handler ID attributes are set.

• UnexpectedHandlerAttribute – If an unexpected attribute is set for the discovered handler type.

• HandlerTypeMissingAttribute – If the handler is missing a required attribute for its handler type.

• MissingHandlerAttribute – If a URL handler is missing an attribute.

Generates a warning for reserved URLs.

See theversion element documentation to learn which URLs are reserved.

Merges twoVmSettings instances.

If a variable is specified by both instances, the value fromvm_settings_one is used.

• vm_settings_one – The firstVmSettings instance, orNone.

• vm_settings_two – The secondVmSettings instance, orNone.

The mergedVmSettings instance, orNone if both input instances areNone or empty.

alias of str