SLjc
@ 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 kenton@google.com (Kenton Varda)iN( 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 rd } qn | 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 qn | 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(| rt | | 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 rt | | 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