diff -r 261778de26ff -r 620f9b141567 thirdparty/google_appengine/google/appengine/api/datastore_errors.py --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/thirdparty/google_appengine/google/appengine/api/datastore_errors.py Tue Aug 26 21:49:54 2008 +0000 @@ -0,0 +1,105 @@ +#!/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 datastore API.""" + + + + + + +class Error(Exception): + """Base datastore error type. + """ + +class BadValueError(Error): + """Raised by Entity.__setitem__(), Query.__setitem__(), Get(), and others + when a property value or filter value is invalid. + """ + +class BadPropertyError(Error): + """Raised by Entity.__setitem__() when a property name isn't a string. + """ + +class BadRequestError(Error): + """Raised by datastore calls when the parameter(s) are invalid. + """ + +class EntityNotFoundError(Error): + """DEPRECATED: Raised by Get() when the requested entity is not found. + """ + +class BadArgumentError(Error): + """Raised by Query.Order(), Iterator.Next(), and others when they're + passed an invalid argument. + """ + +class QueryNotFoundError(Error): + """DEPRECATED: Raised by Iterator methods when the Iterator is invalid. This + should not happen during normal usage; it protects against malicious users + and system errors. + """ + +class TransactionNotFoundError(Error): + """DEPRECATED: Raised by RunInTransaction. This is an internal error; you + should not see this. + """ + +class Rollback(Error): + """May be raised by transaction functions when they want to roll back + instead of committing. Note that *any* exception raised by a transaction + function will cause a rollback. This is purely for convenience. See + datastore.RunInTransaction for details. + """ + +class TransactionFailedError(Error): + """Raised by RunInTransaction methods when the transaction could not be + committed, even after retrying. This is usually due to high contention. + """ + +class BadFilterError(Error): + """Raised by Query.__setitem__() and Query.Run() when a filter string is + invalid. + """ + def __init__(self, filter): + self.filter = filter + + def __str__(self): + return (u'BadFilterError: invalid filter: %s.' % self.filter) + +class BadQueryError(Error): + """Raised by Query when a query or query string is invalid. + """ + +class BadKeyError(Error): + """Raised by Key.__str__ when the key is invalid. + """ + +class InternalError(Error): + """An internal datastore error. Please report this to Google. + """ + +class NeedIndexError(Error): + """No matching index was found for a query that requires an index. Check + the Indexes page in the Admin Console and your index.yaml file. + """ + +class Timeout(Error): + """The datastore operation timed out. This can happen when you attempt to + put, get, or delete too many entities or an entity with too many properties, + or if the datastore is overloaded or having trouble. + """