Introduce dynamic scope_path regexps
Instead of relying on scope_path's being "one slash deep", we should
instead allow for either:
1. scope_paths that have a pre-defined depth
2. scope_paths that can be arbitrarily deep
We achieve 1 by setting an entities scope_logic to another logic
module. We then recursively call getScopeDepth until we get to the
topmost entity (that is, an unscoped entity).
A little different is the solution to 2, since some entities can have
an arbitrarily deep scope (such as Documents), we need to have some
way of signaling this to getScopePattern. A clean solution is to
return None, rather than a number. If None is returned, the
SCOPE_PATH_ARG_PATTERN is returned as regexp instead, which will
match an arbitrarily deeply nested scope.
The solution for 2 requires that we return None somewhere in the
scope_logic chain, the most straight forward method to do so is to
override getScopeDepth anywhere such a scope is needed and make it
return None. A more elegant solution however, is to set the
scope_logic to that module in all entities that require it.
Patch by: Sverre Rabbelier
#!/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 thrown by apiproxy.MakeSyncCall.
"""
class Error(Exception):
"""Base APIProxy error type."""
class RPCFailedError(Error):
"""Raised by APIProxy calls when the RPC to the application server fails."""
class CallNotFoundError(Error):
"""Raised by APIProxy calls when the requested method cannot be found."""
class ArgumentError(Error):
"""Raised by APIProxy calls if there is an error parsing the arguments."""
class DeadlineExceededError(Error):
"""Raised by APIProxy calls if the call took too long to respond."""
class CancelledError(Error):
"""Raised by APIProxy calls if the call was cancelled, such as when
the user's request is exiting."""
class ApplicationError(Error):
"""Raised by APIProxy in the event of an application-level error."""
def __init__(self, application_error, error_detail=''):
self.application_error = application_error
self.error_detail = error_detail
def __str__(self):
return 'ApplicationError: %d %s' % (self.application_error,
self.error_detail)
class OverQuotaError(Error):
"""Raised by APIProxy calls when they have been blocked due to a lack of
available quota."""
class RequestTooLargeError(Error):
"""Raised by APIProxy calls if the request was too large."""
class CapabilityDisabledError(Error):
"""Raised by APIProxy when API calls are temporarily disabled."""
class InterruptedError(Error):
"""Raised by APIProxy.Wait() when the wait is interrupted by an uncaught
exception from some callback, not necessarily associated with the RPC in
question."""
def __init__(self, exception, rpc):
self.args = ("The Wait() request was interrupted by an exception from "
"another callback:", exception)
self.__rpc = rpc
self.__exception = exception
@property
def rpc(self):
return self.__rpc
@property
def exception(self):
return self.__exception