�
S�Ljc
@ s+ d Z d Z d d l Z d d l Z d d l Z e j rB e Z n d d l m Z d d l
m Z d d l
m Z d d d d
d g Z
e j � e j � e j � e j � f Z e j d e j � Z e j d
e j � Z e e j j e j j g � Z e d d f � Z d Z d e f d � � YZ d e f d � � YZ d e! f d � � YZ" e# e# e# e# e$ e# e$ d e$ d � Z% d � Z& d e# e# e# e# e$ e# e$ e$ d � Z' d e# e# e# e# e$ e$ d � Z( d e# e# e# e# e$ e$ d � Z) d � Z* d e! f d � � YZ+ e# e# e$ d � Z, e# e# e$ d! � Z- e# e# e$ d" � Z. e# e# e$ d# � Z/ d$ e! f d% � � YZ0 d& � Z1 d' � Z2 d( � Z3 d) � Z4 d* e! f d+ � � YZ5 e5 Z6 d, � Z7 d- � Z8 d. � Z9 d/ � Z: d0 � Z; d1 � Z< e# e# d2 � Z= e# e# d3 � Z> e# e# d4 � Z? e# d5 � Z@ d6 � ZA d7 � ZB d8 � ZC d S(9 sb Contains routines for printing protocol messages in text format.
Simple usage example:
# Create a proto object and serialize it to a text proto string.
message = my_proto_pb2.MyMessage(foo='bar')
text_proto = text_format.MessageToString(message)
# Parse a text proto string.
message = text_format.Parse(text_proto, my_proto_pb2.MyMessage())
s [email protected] (Kenton Varda)i����N( t
type_checkers( t
descriptor( t
text_encodingt MessageToStringt PrintMessaget
PrintFieldt PrintFieldValuet Merges -?inf(?:inity)?f?s nanf?t 't "s google.protobuf.Anyt Errorc B s e Z d Z RS( s' Top-level module error for text_format.( t __name__t
__module__t __doc__( ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR
I s t
ParseErrorc B s2 e Z d Z d d d d � Z d � Z d � Z RS( s3 Thrown in case of text parsing or tokenizing error.c C s� | d k r[ | d k r[ t | � } | d k rF | d j | � 7} n d j | | � } n | d k r� t t | � j | � n t t | � j � | | _ | | _ d S( Ns :{0}s {0} : {1}( t Nonet strt formatt superR t __init__t _linet _column( t selft messaget linet columnt loc( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR P s c C s | j S( N( R ( R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt GetLine] s c C s | j S( N( R ( R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt GetColumn` s N( R R R
R R R R ( ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR M s
t
TextWriterc B s, e Z d � Z d � Z d � Z d � Z RS( c C s. t j r t j � | _ n t j � | _ d S( N( t sixt PY2t iot BytesIOt _writert StringIO( R t as_utf8( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR f s c C s@ t j r0 t | t j � r0 | j d � } q0 n | j j | � S( Ns utf-8( R R t
isinstancet text_typet encodeR" t write( R t val( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR( l s c C s
| j j � S( N( R" t close( R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR* r s c C s
| j j � S( N( R" t getvalue( R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR+ u s ( R R R R( R* R+ ( ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR d s i c
C sj t | � }
t |
| | | | | | | | | �
} | j | � |
j � } |
j � | rf | j � S| S( s� Convert protobuf message to text format.
Floating point values can be formatted compactly with 15 digits of
precision (which is the most that IEEE 754 "double" can guarantee)
using float_format='.15g'. To ensure that converting to text and back to a
proto will result in an identical value, float_format='.17g' should be used.
Args:
message: The protocol buffers message.
as_utf8: Produce text output in UTF8 format.
as_one_line: Don't introduce newlines between fields.
pointy_brackets: If True, use angle brackets instead of curly braces for
nesting.
use_index_order: If True, print fields of a proto message using the order
defined in source code instead of the field number. By default, use the
field number order.
float_format: If set, use this to specify floating point number formatting
(per the "Format Specification Mini-Language"); otherwise, str() is used.
use_field_number: If True, print field numbers instead of names.
descriptor_pool: A DescriptorPool used to resolve Any types.
indent: The indent level, in terms of spaces, for pretty print.
message_formatter: A function(message, indent, as_one_line): unicode|None
to custom format selected sub-messages (usually based on message type).
Use to pretty print parts of the protobuf for easier diffing.
Returns:
A string of the text formatted protocol buffer message.
( R t _PrinterR R+ R* t rstrip(
R R$ t as_one_linet pointy_bracketst use_index_ordert float_formatt use_field_numbert descriptor_poolt indentt message_formattert outt printert result( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR y s &
c C s1 | j t j j k o0 | j j o0 | j j � j S( N( t typeR t FieldDescriptort TYPE_MESSAGEt message_typet has_optionst
GetOptionst map_entry( t field( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt _IsMapEntry� s c C s8 t | | | | | | | | | |
�
} | j | � d S( N( R, R ( R R6 R4 R$ R. R/ R0 R1 R2 R3 R5 R7 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s c
C s5 t | | | | | | | | � }
|
j | | � d S( s% Print a single field name/value pair.N( R, R ( R@ t valueR6 R4 R$ R. R/ R0 R1 R5 R7 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s c
C s5 t | | | | | | | | � }
|
j | | � d S( s0 Print a single field value (not including name).N( R, R ( R@ RB R6 R4 R$ R. R/ R0 R1 R5 R7 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s c C s� | d k r+ d d l m } | j � } n d d l m } | j � } y | j | � } Wn t k
rn d SX| j | � } | � S( s! Returns a protobuf message instance.
Args:
type_name: Fully-qualified protobuf message type name string.
descriptor_pool: DescriptorPool instance.
Returns:
A Message instance of type matching type_name, or None if the a Descriptor
wasn't found matching type_name.
i����( R3 ( t symbol_databaseN( R t google.protobufR3 t DefaultRC t FindMessageTypeByNamet KeyErrort GetPrototype( t type_nameR3 t pool_modRC t databaset message_descriptorR< ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt _BuildMessageFromTypeName� s
R, c
B sh e Z d Z d e e e e d e d d d � Z d � Z d � Z d � Z d � Z d � Z
d � Z RS(
s) Text format printer for protocol message.i c C s^ | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ | | _ |
| _ d S( sZ Initialize the Printer.
Floating point values can be formatted compactly with 15 digits of
precision (which is the most that IEEE 754 "double" can guarantee)
using float_format='.15g'. To ensure that converting to text and back to a
proto will result in an identical value, float_format='.17g' should be used.
Args:
out: To record the text format result.
indent: The indent level for pretty print.
as_utf8: Produce text output in UTF8 format.
as_one_line: Don't introduce newlines between fields.
pointy_brackets: If True, use angle brackets instead of curly braces for
nesting.
use_index_order: If True, print fields of a proto message using the order
defined in source code instead of the field number. By default, use the
field number order.
float_format: If set, use this to specify floating point number formatting
(per the "Format Specification Mini-Language"); otherwise, str() is
used.
use_field_number: If True, print field numbers instead of names.
descriptor_pool: A DescriptorPool used to resolve Any types.
message_formatter: A function(message, indent, as_one_line): unicode|None
to custom format selected sub-messages (usually based on message type).
Use to pretty print parts of the protobuf for easier diffing.
N(
R6 R4 R$ R. R/ R0 R1 R2 R3 R5 ( R R6 R4 R$ R. R/ R0 R1 R2 R3 R5 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s % c C s� t | j � | j � } | r� | j | j � | j j d | j d | j f � | j | � | j j | j
rw d n d � t St Sd S( s5 Serializes if message is a google.protobuf.Any field.s %s[%s]t s
N(
RM t TypeNameR3 t MergeFromStringRB R6 R( R4 t type_urlt _PrintMessageFieldValueR. t Truet False( R R t packed_message( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt _TryPrintAsAnyMessage. s $
c C su | j | | j | j � } | d k r+ t S| j } | j d | j � | j | � | j | j rj d n d � t S( NRN s
( R5 R4 R. R RT R6 R( RS ( R R t formattedR6 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt _TryCustomFormatMessage; s
c C s% | j r | j | � r d S| j j t k rA | j | � rA d S| j � } | j rl | j d d � � n x� | D]� \ } } t | � r� x� t
| � D]5 } | j � d | d | | � } | j | | � q� Wqs | j
t j j k r
x1 | D] } | j | | � q� Wqs | j | | � qs Wd S( se Convert protobuf message to text format.
Args:
message: The protocol buffers message.
Nt keyc S s | d j S( Ni ( t index( t x( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt S t RB ( R5 RX t
DESCRIPTORt full_namet _ANY_FULL_TYPE_NAMERV t
ListFieldsR0 t sortRA t sortedt
GetEntryClassR t labelR R: t LABEL_REPEATED( R R t fieldsR@ RB RY t entry_submsgt element( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR F s"
c C sa | j } | j d | j � | j r? | j t | j � � n� | j r� | j d � | j j � j r� | j
t j j
k r� | j t j j k r� | j | j j � n | j | j � | j d � n; | j
t j j k r� | j | j j � n | j | j � | j t j j k r'| j d � n | j | | � | j rP| j d � n
| j d � d S( s% Print a single field name/value pair.RN t [t ]s : s
N( R6 R( R4 R2 R t numbert is_extensiont containing_typeR> t message_set_wire_formatR9 R R: R; Re t LABEL_OPTIONALR< R_ t
TYPE_GROUPt namet cpp_typet CPPTYPE_MESSAGER R. ( R R@ RB R6 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR d s*
c C s� | j r d } d } n d } d } | j ra | j j d | � | j | � | j j | � nZ | j j d | � | j d 7_ | j | � | j d 8_ | j j d | j | � d S( Nt t {t }s %s s %s
i RN ( R/ R. R6 R( R R4 ( R RB t openbt closeb( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyRR � s
c C s� | j } | j t j j k r. | j | � n�| j t j j k r� | j j j | d � } | d k rz | j | j � q�| j t
| � � n'| j t j j k r,| j d � t | t j � r� | j d � } n | } | j t j j k r� t } n | j } | j t j | | � � | j d � n� | j t j j k rg| rW| j d � q�| j d � nP | j t k r�| j d k r�| j d j | j | � � n | j t
| � � d S( s� Print a single field value (not including name).
For repeated fields, the value should be a single element.
Args:
field: The descriptor of the field to be printed.
value: The value of the field.
s "s utf-8t truet falses {1:{0}}N( R6 Rs R R: Rt RR t CPPTYPE_ENUMt enum_typet values_by_numbert getR R( Rr R t CPPTYPE_STRINGR% R R& R' R9 t
TYPE_BYTESRT R$ R t CEscapet CPPTYPE_BOOLt _FLOAT_TYPESR1 R ( R R@ RB R6 t
enum_valuet out_valuet out_as_utf8( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s2
N( R R R
RT R R RV RX R R RR R ( ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR, � s &
! c C s^ t | t � s< t j r* | j d � } q< | j d � } n t | j d � | | | d | �S( s� Parses a text representation of a protocol message into a message.
NOTE: for historical reasons this function does not clear the input
message. This is different from what the binary msg.ParseFrom(...) does.
Example
a = MyProto()
a.repeated_field.append('test')
b = MyProto()
text_format.Parse(repr(a), b)
text_format.Parse(repr(a), b) # repeated_field contains ["test", "test"]
# Binary version:
b.ParseFromString(a.SerializeToString()) # repeated_field is now "test"
Caller is responsible for clearing the message as needed.
Args:
text: Message text representation.
message: A protocol buffer message to merge into.
allow_unknown_extension: if True, skip over missing extensions and keep
parsing
allow_field_number: if True, both field number and field name are allowed.
descriptor_pool: A DescriptorPool used to resolve Any types.
Returns:
The same message passed as argument.
Raises:
ParseError: On text parsing problems.
s utf-8s
R3 ( R% R R t PY3t decodeR' t
ParseLinest split( t textR t allow_unknown_extensiont allow_field_numberR3 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt Parse� s % c C s^ t | t � s< t j r* | j d � } q< | j d � } n t | j d � | | | d | �S( s^ Parses a text representation of a protocol message into a message.
Like Parse(), but allows repeated values for a non-repeated field, and uses
the last one.
Args:
text: Message text representation.
message: A protocol buffer message to merge into.
allow_unknown_extension: if True, skip over missing extensions and keep
parsing
allow_field_number: if True, both field number and field name are allowed.
descriptor_pool: A DescriptorPool used to resolve Any types.
Returns:
The same message passed as argument.
Raises:
ParseError: On text parsing problems.
s utf-8s
R3 ( R% R R R� R� R' t
MergeLinesR� ( R� R R� R� R3 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s c C s% t | | d | �} | j | | � S( s Parses a text representation of a protocol message into a message.
Args:
lines: An iterable of lines of a message's text representation.
message: A protocol buffer message to merge into.
allow_unknown_extension: if True, skip over missing extensions and keep
parsing
allow_field_number: if True, both field number and field name are allowed.
descriptor_pool: A DescriptorPool used to resolve Any types.
Returns:
The same message passed as argument.
Raises:
ParseError: On text parsing problems.
R3 ( t _ParserR� ( t linesR R� R� R3 t parser( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR� s c C s% t | | d | �} | j | | � S( s Parses a text representation of a protocol message into a message.
Args:
lines: An iterable of lines of a message's text representation.
message: A protocol buffer message to merge into.
allow_unknown_extension: if True, skip over missing extensions and keep
parsing
allow_field_number: if True, both field number and field name are allowed.
descriptor_pool: A DescriptorPool used to resolve Any types.
Returns:
The same message passed as argument.
Raises:
ParseError: On text parsing problems.
R3 ( R� R� ( R� R R� R� R3 R� ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR� 3 s R� c B s� e Z d Z e e d d � Z d � Z d � Z d � Z d � Z d � Z
d � Z d � Z d � Z
e d
� � Z d � Z RS(
s( Text format parser for protocol message.c C s | | _ | | _ | | _ d S( N( R� R� R3 ( R R� R� R3 ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR Q s c C s: t | t � s! | j d � } n | j | j d � | � S( sB Parses a text representation of a protocol message into a message.s utf-8s
( R% R R� R� R� ( R R� R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt ParseFromStringY s c C s t | _ | j | | � | S( sB Parses a text representation of a protocol message into a message.( RT t _allow_multiple_scalarst
_ParseOrMerge( R R� R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR� _ s c C s | j | j d � | � S( sB Merges a text representation of a protocol message into a message.s
( t _MergeLinesR� ( R R� R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyRP e s c C s t | _ | j | | � | S( sB Merges a text representation of a protocol message into a message.( RS R� R� ( R R� R ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR� i s c C s3 t | � } x | j � s. | j | | � q Wd S( s� Converts a text representation of a protocol message into a message.
Args:
lines: Lines of a message's text representation.
message: A protocol buffer message to merge into.
Raises:
ParseError: On text parsing problems.
N( t Tokenizert AtEndt _MergeField( R R� R t tokenizer( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR� o s
c C s� | j } | j d � r� | j � g } x& | j d � rO | j | j � � q* Wd j | � } | j s� | j d | j � � n | j j | � } | s� | j
r� d } q� | j d | � � n. | | j k r� | j d | | j f � � n | j
d � n(| j � } | j ro| j � rot | t t � } | j j | d � } | r| j r| j j | � } qn� | j j | d � } | s�| j j | j � d � } | r�| j t j j k r�d } q�n | r| j t j j k r| j j | k rd } n | s'| j d | j | f � � n | r\| j r�| j r�| j | j j � } | d k r�| | j k r�| j d | j | | j j | j f � � q�n | j! t j j" k r�| j d � | j# } n | j
d � | j$ } | j% t j j& k rI| j d � rIxM t rE| | | | � | j d � r5Pn | j
d
� q Wqf| | | | � n
t' | � | j d
� s�| j d � n d S(
s� Merges a single protocol message field into a message.
Args:
tokenizer: A tokenizer to parse the field name and values.
message: A protocol message to record the data.
Raises:
ParseError: In case of text parsing problems.
Rj t .s+ Message type "%s" does not have extensions.s� Extension "%s" not registered. Did you import the _pb2 module which defines it? If you are trying to place the extension in the MessageSet field of another message that is in an Any or MessageSet field, that message's _pb2 module must be imported as wells1 Extension "%s" does not extend message type "%s".Rk s* Message type "%s" has no field named "%s".sb Field "%s" is specified along with field "%s", another member of oneof "%s" for message type "%s".t :t ,t ;N(( R^ t
TryConsumet ConsumeIdentifiert appendt joint
is_extendablet ParseErrorPreviousTokenR_ t
Extensionst _FindExtensionByNameR� R Rn t Consumet ConsumeIdentifierOrNumberR� t isdigitt ParseIntegerRS t fields_by_numberR� t _FindExtensionByNumbert fields_by_namet lowerR9 R R: Rq R< Rr R� t containing_oneoft
WhichOneofRs Rt t _MergeMessageFieldt _MergeScalarFieldRe Rf t _SkipFieldContents( R R� R RL Rr R@ Rl t which_oneoft merger( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR� } s�
c C s� | j � g } | j d � | j | j � � | j d � | j | j � � | j d � | j � g } x& | j d � r� | j | j � � qn Wd j | � d j | � f S( sB Consumes a google.protobuf.Any type URL and returns the type name.R� t /( R� R� R� R� R� ( R R� t prefixRr ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt _ConsumeAnyTypeUrl� s
c C s� t | � } | j d � r$ d } n | j d � d } | j j t k r�| j d � r�| j | � \ } } | j d � | j d � | j d � r� d } n | j d � d } t | | j � } | s� t d | � � n xH | j | � s'| j
� r| j d | f � � n | j | | � q� W| j
t j j k rXt | | j � j � }
n t | | j � }
|
j | d
| �n� | j
t j j k r�| j r�| j | j � } q(| r�t | | j � j � � } q(t | | j � j � } n5 | j r | j | } n t | | j � } | j � xH | j | � sr| j
� r_| j d | f � � n | j | | � q+W| r�| j j d j } | t j j k r�t | | j � | j }
|
j | j � q�| j t | | j � | j RS ( R| R9 R? RT ( RS RT R ( R� ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR � s
c C s� | j } y t | d � } WnN t k
rl | j j | d � } | d k r� t d | j | f � � q� ni Xt | j d � r� | j j d k r� | Sn | j
j | d � } | d k r� t d | j | f � � n | j S( s& Parse an enum value.
The value can be specified by a number (the enum value), or by
a string literal (the enum name).
Args:
field: Enum field descriptor.
value: String value.
Returns:
Enum value number.
Raises:
ValueError: If the enum value could not be parsed.
i s% Enum type "%s" has no value named %s.R� R� s+ Enum type "%s" has no value with number %d.N( R~ R2 R t values_by_nameR� R R_ R� t fileR� R Rl ( R@ RB t enum_descriptorRl R� ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyR( s
(D R
t
__author__R R* R R� R2 R5 t google.protobuf.internalR RD R R t __all__t Uint32ValueCheckert Int32ValueCheckert Uint64ValueCheckert Int64ValueCheckerR1 R+ t
IGNORECASER; R< t frozensetR: t
CPPTYPE_FLOATt CPPTYPE_DOUBLER� R% R` t ExceptionR
R t objectR RT R R RA R R R RM R, R� R R� R� R� R� R� R� R� R� t
_TokenizerR� R� R� R� R� R� R0 R/ R� R R R R( ( ( ( s? /usr/lib/python2.7/site-packages/google/protobuf/text_format.pyt ) s� )
� / # � @ � V