| Index: third_party/google/protobuf/symbol_database.py
|
| diff --git a/third_party/google/protobuf/symbol_database.py b/third_party/google/protobuf/symbol_database.py
|
| deleted file mode 100644
|
| index 7466fec5062f0b131fc55f5b9d93c3f9e1f646fc..0000000000000000000000000000000000000000
|
| --- a/third_party/google/protobuf/symbol_database.py
|
| +++ /dev/null
|
| @@ -1,185 +0,0 @@
|
| -# Protocol Buffers - Google's data interchange format
|
| -# Copyright 2008 Google Inc. All rights reserved.
|
| -# http://code.google.com/p/protobuf/
|
| -#
|
| -# Redistribution and use in source and binary forms, with or without
|
| -# modification, are permitted provided that the following conditions are
|
| -# met:
|
| -#
|
| -# * Redistributions of source code must retain the above copyright
|
| -# notice, this list of conditions and the following disclaimer.
|
| -# * Redistributions in binary form must reproduce the above
|
| -# copyright notice, this list of conditions and the following disclaimer
|
| -# in the documentation and/or other materials provided with the
|
| -# distribution.
|
| -# * Neither the name of Google Inc. nor the names of its
|
| -# contributors may be used to endorse or promote products derived from
|
| -# this software without specific prior written permission.
|
| -#
|
| -# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
| -# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
| -# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
| -# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
| -# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
| -# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
| -# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
| -# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
| -# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
| -# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
| -# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| -
|
| -"""A database of Python protocol buffer generated symbols.
|
| -
|
| -SymbolDatabase makes it easy to create new instances of a registered type, given
|
| -only the type's protocol buffer symbol name. Once all symbols are registered,
|
| -they can be accessed using either the MessageFactory interface which
|
| -SymbolDatabase exposes, or the DescriptorPool interface of the underlying
|
| -pool.
|
| -
|
| -Example usage:
|
| -
|
| - db = symbol_database.SymbolDatabase()
|
| -
|
| - # Register symbols of interest, from one or multiple files.
|
| - db.RegisterFileDescriptor(my_proto_pb2.DESCRIPTOR)
|
| - db.RegisterMessage(my_proto_pb2.MyMessage)
|
| - db.RegisterEnumDescriptor(my_proto_pb2.MyEnum.DESCRIPTOR)
|
| -
|
| - # The database can be used as a MessageFactory, to generate types based on
|
| - # their name:
|
| - types = db.GetMessages(['my_proto.proto'])
|
| - my_message_instance = types['MyMessage']()
|
| -
|
| - # The database's underlying descriptor pool can be queried, so it's not
|
| - # necessary to know a type's filename to be able to generate it:
|
| - filename = db.pool.FindFileContainingSymbol('MyMessage')
|
| - my_message_instance = db.GetMessages([filename])['MyMessage']()
|
| -
|
| - # This functionality is also provided directly via a convenience method:
|
| - my_message_instance = db.GetSymbol('MyMessage')()
|
| -"""
|
| -
|
| -
|
| -from google.protobuf import descriptor_pool
|
| -
|
| -
|
| -class SymbolDatabase(object):
|
| - """A database of Python generated symbols.
|
| -
|
| - SymbolDatabase also models message_factory.MessageFactory.
|
| -
|
| - The symbol database can be used to keep a global registry of all protocol
|
| - buffer types used within a program.
|
| - """
|
| -
|
| - def __init__(self):
|
| - """Constructor."""
|
| -
|
| - self._symbols = {}
|
| - self._symbols_by_file = {}
|
| - self.pool = descriptor_pool.DescriptorPool()
|
| -
|
| - def RegisterMessage(self, message):
|
| - """Registers the given message type in the local database.
|
| -
|
| - Args:
|
| - message: a message.Message, to be registered.
|
| -
|
| - Returns:
|
| - The provided message.
|
| - """
|
| -
|
| - desc = message.DESCRIPTOR
|
| - self._symbols[desc.full_name] = message
|
| - if desc.file.name not in self._symbols_by_file:
|
| - self._symbols_by_file[desc.file.name] = {}
|
| - self._symbols_by_file[desc.file.name][desc.full_name] = message
|
| - self.pool.AddDescriptor(desc)
|
| - return message
|
| -
|
| - def RegisterEnumDescriptor(self, enum_descriptor):
|
| - """Registers the given enum descriptor in the local database.
|
| -
|
| - Args:
|
| - enum_descriptor: a descriptor.EnumDescriptor.
|
| -
|
| - Returns:
|
| - The provided descriptor.
|
| - """
|
| - self.pool.AddEnumDescriptor(enum_descriptor)
|
| - return enum_descriptor
|
| -
|
| - def RegisterFileDescriptor(self, file_descriptor):
|
| - """Registers the given file descriptor in the local database.
|
| -
|
| - Args:
|
| - file_descriptor: a descriptor.FileDescriptor.
|
| -
|
| - Returns:
|
| - The provided descriptor.
|
| - """
|
| - self.pool.AddFileDescriptor(file_descriptor)
|
| -
|
| - def GetSymbol(self, symbol):
|
| - """Tries to find a symbol in the local database.
|
| -
|
| - Currently, this method only returns message.Message instances, however, if
|
| - may be extended in future to support other symbol types.
|
| -
|
| - Args:
|
| - symbol: A str, a protocol buffer symbol.
|
| -
|
| - Returns:
|
| - A Python class corresponding to the symbol.
|
| -
|
| - Raises:
|
| - KeyError: if the symbol could not be found.
|
| - """
|
| -
|
| - return self._symbols[symbol]
|
| -
|
| - def GetPrototype(self, descriptor):
|
| - """Builds a proto2 message class based on the passed in descriptor.
|
| -
|
| - Passing a descriptor with a fully qualified name matching a previous
|
| - invocation will cause the same class to be returned.
|
| -
|
| - Args:
|
| - descriptor: The descriptor to build from.
|
| -
|
| - Returns:
|
| - A class describing the passed in descriptor.
|
| - """
|
| -
|
| - return self.GetSymbol(descriptor.full_name)
|
| -
|
| - def GetMessages(self, files):
|
| - """Gets all the messages from a specified file.
|
| -
|
| - This will find and resolve dependencies, failing if they are not registered
|
| - in the symbol database.
|
| -
|
| -
|
| - Args:
|
| - files: The file names to extract messages from.
|
| -
|
| - Returns:
|
| - A dictionary mapping proto names to the message classes. This will include
|
| - any dependent messages as well as any messages defined in the same file as
|
| - a specified message.
|
| -
|
| - Raises:
|
| - KeyError: if a file could not be found.
|
| - """
|
| -
|
| - result = {}
|
| - for f in files:
|
| - result.update(self._symbols_by_file[f])
|
| - return result
|
| -
|
| -_DEFAULT = SymbolDatabase()
|
| -
|
| -
|
| -def Default():
|
| - """Returns the default SymbolDatabase."""
|
| - return _DEFAULT
|
|
|