Source code for google.appengine.api.appinfo_errors
#!/usr/bin/env python
#
# Copyright 2007 Google Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
"""Errors used in the Python appinfo API, used by app developers."""
[docs]class Error(Exception):
"""Base datastore AppInfo type."""
[docs]class EmptyConfigurationFile(Error):
"""Tried to load empty configuration file"""
[docs]class MultipleConfigurationFile(Error):
"""Tried to load configuration file with multiple AppInfo objects"""
[docs]class MultipleProjectNames(Error):
"""Configuration file had both "application:" and "project:" fields.
A configuration file can specify the project name using either the old-style
"application: name" syntax or the newer "project: name" syntax, but not both.
"""
[docs]class UnknownHandlerType(Error):
"""Raised when it is not possible to determine URL mapping type."""
[docs]class UnexpectedHandlerAttribute(Error):
"""Raised when a handler type has an attribute that it does not use."""
[docs]class MissingHandlerAttribute(Error):
"""Raised when a handler is missing an attribute required by its type."""
[docs]class MissingURLMapping(Error):
"""Raised when there are no URL mappings in external appinfo."""
[docs]class TooManyURLMappings(Error):
"""Raised when there are too many URL mappings in external appinfo."""
[docs]class PositionUsedInAppYamlHandler(Error):
"""Raised when position attribute is used in handler in AppInfoExternal."""
[docs]class MultipleBuiltinsSpecified(Error):
"""Raised when more than one builtin is specified in a single list element."""
[docs]class DuplicateBuiltinsSpecified(Error):
"""Raised when a builtin is specified more than once in the same file."""
[docs]class BackendNotFound(Error):
"""Raised when a Backend is required but not specified."""
[docs]class DuplicateBackend(Error):
"""Raised when a backend is found more than once in 'backends'."""
[docs]class MissingApiConfig(Error):
"""Raised if an api_endpoint handler is configured but no api_config."""
[docs]class RuntimeDoesNotSupportLibraries(Error):
"""Raised when 'libraries' is used in a runtime that does not support it."""
[docs]class DuplicateLibrary(Error):
"""Raised when a library is found more than once in 'libraries'."""
[docs]class InvalidLibraryVersion(Error):
"""Raised when a library uses a version that isn't supported."""
[docs]class InvalidLibraryName(Error):
"""Raised when a library is specified that isn't supported."""
[docs]class ThreadsafeWithCgiHandler(Error):
"""Raised when threadsafe is enabled with a CGI handler specified."""
[docs]class MissingThreadsafe(Error):
"""Raised when the runtime needs a threadsafe declaration and it's missing."""
[docs]class ContentTypeSpecifiedMultipleTimes(Error):
"""Raised when mime_type and http_headers specify a mime type.
N.B. This will be raised even when both fields specify the same content type.
E.g. the following configuration (snippet) will be rejected:
handlers:
- url: /static
static_dir: static
mime_type: text/html
http_headers:
content-type: text/html
This only applies to static handlers i.e. a handler that specifies static_dir
or static_files.
"""
[docs]class TooManyScalingSettingsError(Error):
"""Raised when more than one scaling settings section is present."""
[docs]class TooManyAutoscalingUtilizationTargetsError(Error):
"""Raised when too many custom metric autoscaling targets are present."""
[docs]class NotEnoughAutoscalingUtilizationTargetsError(Error):
"""Raised when not enough custom metric autoscaling targets are present."""
[docs]class MissingRuntimeError(Error):
"""Raised when the "runtime" field is omitted for a non-vm."""
[docs]class MissingEndpointsConfigId(Error):
"""Raised when an Endpoints config id is expected.
An Endpoints config id is expected when the Endpoints rollout strategy is
unspecified or set to "fixed".
"""
[docs]class UnexpectedEndpointsConfigId(Error):
"""Raised when an Endpoints config id is unexpected.
An Endpoints config id is forbidden when the Endpoints rollout strategy is
set to "managed".
"""
