U
|
£ý°diñ ã @ s d Z dZddlZddlZddlZddlZddlZddlm Z ddlm
|
Z
|
ddl m Z ddl m Z dd d
|
d d d dgZe
|
¡ e
|
¡ e
|
¡ e
|
¡ fZe dej¡Ze dej¡ZedZdZG dd deZ G dd de Z G dd de Z dQddZ dd Z!d d Z"dRd d
|
Z#dSd d Z$dTd d Z%d!d" Z&d#Z'd$Z(G d%d& d&e Z)dUd'd Z*dVd(d Z+dWd)d*Z,dXd+d,Z-G d-d. d.e Z.d/d0 Z/d1d2 Z0d3d4 Z1d5d6 Z2G d7d8 d8e Z3e3Z4d9d: Z5d;d< Z6d=d> Z7d?d@ Z8dAdB Z9dCdD Z:dYdEdFZ;dZdGdHZ<dIdJ Z=dKdL Z>dMdN Z?dOdP Z@dS )[ac 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())
|
z kenton@google.com (Kenton Varda)é N)Údecoder)Ú type_checkers)Ú
|
descriptor)Ú text_encodingÚMessageToStringÚParseÚ PrintMessageÚ
|
PrintFieldÚPrintFieldValueÚMergeÚMessageToBytesz-?inf(?:inity)?f?$znanf?$)ú'ú"zgoogle.protobuf.Anyc @ s e Zd ZdZdS )ÚErrorz'Top-level module error for text_format.N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__© r r úRd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\google/protobuf/text_format.pyr G s r c s2 e Zd ZdZd fdd Zdd Zdd Z ZS )
|
Ú
|
ParseErrorz3Thrown in case of text parsing or tokenizing error.Nc sr |d k r:|d k r:t |}|d k r.|d |¡7 }d ||¡}|d k rTtt| |¡ ntt| ¡ || _|| _d S )Nz:{0}z {0} : {1})ÚstrÚformatÚsuperr Ú__init__Ú_lineÚ_column)ÚselfÚmessageÚlineÚcolumnÚloc©Ú __class__r r r N s zParseError.__init__c C s | j S ©N)r ©r r r r ÚGetLine[ s zParseError.GetLinec C s | j S r$ )r r% r r r Ú GetColumn^ s zParseError.GetColumn)NNN)r r r r r r& r' Ú __classcell__r r r" r r K s r c @ s, e Zd Zdd Zdd Zdd Zdd Zd S )
|
Ú
|
TextWriterc C s t ¡ | _d S r$ )ÚioÚStringIOÚ_writer)r Úas_utf8r r r r d s zTextWriter.__init__c C s | j |¡S r$ )r, Úwrite)r Úvalr r r r. g s zTextWriter.writec C s
|
| j ¡ S r$ )r, Úcloser% r r r r0 j s zTextWriter.closec C s
|
| j ¡ S r$ )r, Úgetvaluer% r r r r1 m s zTextWriter.getvalueN)r r r r r. r0 r1 r r r r r) b s r) Fc C sV t |}t||
|
||||||||| | | | d}| | ¡ | ¡ }| ¡ |rR| ¡ S |S )aT Convert protobuf message to text format.
|
|
Double values can be formatted compactly with 15 digits of
|
precision (which is the most that IEEE 754 "double" can guarantee)
|
using double_format='.15g'. To ensure that converting to text and back to a
|
proto will result in an identical value, double_format='.17g' should be used.
|
|
Args:
|
message: The protocol buffers message.
|
as_utf8: Return unescaped Unicode for non-ASCII characters.
|
In Python 3 actual Unicode characters may appear as is in strings.
|
In Python 2 the return value will be valid UTF-8 rather than only ASCII.
|
as_one_line: Don't introduce newlines between fields.
|
use_short_repeated_primitives: Use short repeated format for primitives.
|
pointy_brackets: If True, use angle brackets instead of curly braces for
|
nesting.
|
use_index_order: If True, fields of a proto message will be printed using
|
the order defined in source code instead of the field number, extensions
|
will be printed at the end of the message and their relative order is
|
determined by the extension number. By default, use the field number
|
order.
|
float_format (str): If set, use this to specify float field formatting
|
(per the "Format Specification Mini-Language"); otherwise, shortest float
|
that has same value in wire will be printed. Also affect double field
|
if double_format is not set but float_format is set.
|
double_format (str): If set, use this to specify double field formatting
|
(per the "Format Specification Mini-Language"); if it is not set but
|
float_format is set, use float_format. Otherwise, use ``str()``
|
use_field_number: If True, print field numbers instead of names.
|
descriptor_pool (DescriptorPool): Descriptor pool used to resolve Any types.
|
indent (int): The initial indent level, in terms of spaces, for pretty
|
print.
|
message_formatter (function(message, indent, as_one_line) -> unicode|None):
|
Custom formatter for selected sub-messages (usually based on message
|
type). Use to pretty print parts of the protobuf for easier diffing.
|
print_unknown_fields: If True, unknown fields will be printed.
|
force_colon: If set, a colon will be added after the field name even if the
|
field is a proto message.
|
|
Returns:
|
str: A string of the text formatted protocol buffer message.
|
)Úprint_unknown_fieldsÚ force_colon)r) Ú_Printerr r1 r0 Úrstrip)r r- Ú as_one_lineÚ use_short_repeated_primitivesÚpointy_bracketsÚuse_index_orderÚ float_formatÚ double_formatÚuse_field_numberÚdescriptor_poolÚindentÚmessage_formatterr2 r3 ÚoutÚprinterÚresultr r r r q s. :ò
|
c K s6 t | f|}t|tr|S | d¡r(dnd}| |¡S )zFConvert protobuf message to encoded text format. See MessageToString.r- úutf-8Úascii)r Ú
|
isinstanceÚbytesÚgetÚencode)r ÚkwargsÚtextÚcodecr r r r à s
|
|
c C s" | j tjjko | jjo | j ¡ jS r$ )Útyper ÚFieldDescriptorÚ TYPE_MESSAGEÚ message_typeZ has_optionsÚ
|
GetOptionsZ map_entry)Úfieldr r r Ú _IsMapEntryÍ s
|
ÿ
|
þrR c C s2 t ||||||||| |
|
| | | |d}| | ¡ d S )N©r@ r> r- r6 r7 r8 r9 r: r; r< r= r? r2 r3 )r4 r )r r@ r> r- r6 r7 r8 r9 r: r; r< r= r? r2 r3 rA r r r r Ó s" ô c C s0 t |||||||| |
|
| | | d }| | |¡ dS )ú%Print a single field name/value pair.©r? r2 r3 N)r4 r ©rQ Úvaluer@ r> r- r6 r7 r8 r9 r: r; r? r2 r3 rA r r r r ò s
|
ûc C s0 t |||||||| |
|
| | | d }| | |¡ dS )z0Print a single field value (not including name).rU N)r4 r
|
rV r r r r
|
|
s
|
ûc C sf |dkr ddl m} | ¡ }ddl m} | ¡ }z| | ¡}W n tk
|
rT Y dS X | |¡}| S )a! 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.
|
Nr )r= )Úsymbol_database)Úgoogle.protobufr= ZDefaultrX ZFindMessageTypeByNameÚKeyErrorZ GetPrototype)Z type_namer= Zpool_modrX ZdatabaseÚmessage_descriptorrO r r r Ú_BuildMessageFromTypeName" s
|
r\ é é c @ sb e Zd ZdZdddZdd Zd d
|
Zd d Zd d Zdd Z dd Z
|
dd Z dd Z dd Z dS )r4 z)Text format printer for protocol message.r FNc C sh || _ || _|| _|| _|| _|| _|| _|| _| dk r@| | _n|| _|
|
| _ | | _
|
| | _ | | _ || _ dS )af Initialize the Printer.
|
|
Double values can be formatted compactly with 15 digits of precision
|
(which is the most that IEEE 754 "double" can guarantee) using
|
double_format='.15g'. To ensure that converting to text and back to a proto
|
will result in an identical value, double_format='.17g' should be used.
|
|
Args:
|
out: To record the text format result.
|
indent: The initial indent level for pretty print.
|
as_utf8: Return unescaped Unicode for non-ASCII characters.
|
In Python 3 actual Unicode characters may appear as is in strings.
|
In Python 2 the return value will be valid UTF-8 rather than ASCII.
|
as_one_line: Don't introduce newlines between fields.
|
use_short_repeated_primitives: Use short repeated format for primitives.
|
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 float field formatting
|
(per the "Format Specification Mini-Language"); otherwise, shortest
|
float that has same value in wire will be printed. Also affect double
|
field if double_format is not set but float_format is set.
|
double_format: If set, use this to specify double field formatting
|
(per the "Format Specification Mini-Language"); if it is not set but
|
float_format is set, use float_format. 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.
|
print_unknown_fields: If True, unknown fields will be printed.
|
force_colon: If set, a colon will be added after the field name even if
|
the field is a proto message.
|
NrS )r r@ r> r- r6 r7 r8 r9 r: r; r< r= r? r2 r3 r r r r C s 4z_Printer.__init__c C s d|j krdS t| ¡ | j}|r~| |j¡ | jr8dnd}| j d| j d |j |f ¡ |
|
|¡ | j | j rtdnd¡ dS dS d S )
|
z5Serializes if message is a google.protobuf.Any field.ú/Fú:Ú z %s[%s]%s ú Ú
|
TN) Ztype_urlr\ ZTypeNamer= ZMergeFromStringrW r3 r@ r. r> Ú_PrintMessageFieldValuer6 )r r Zpacked_messageÚcolonr r r Ú_TryPrintAsAnyMessage s
|
ÿ
|
z _Printer._TryPrintAsAnyMessagec C sV | || j| j¡}|d kr dS | j}| d| j ¡ | |¡ | | jrLdnd¡ dS )NFrb rc T)r? r> r6 r@ r. )r r Ú formattedr@ r r r Ú_TryCustomFormatMessage s
|
z _Printer._TryCustomFormatMessagec C s | j r| |¡rdS |jjtkr.| |¡r.dS | ¡ }| jrL|jdd d |D ]¢\}}t |rt
|
|D ]$}| ¡ ||| d}| ||¡ qhqP|j tjjkræ| jrÎ|jtjjkrÎ|jtjjkrÎ| ||¡ qò|D ]}| ||¡ qÒqP| ||¡ qP| jr
|
| | ¡ ¡ dS )zeConvert protobuf message to text format.
|
|
Args:
|
message: The protocol buffers message.
|
Nc S s | d j r| d jS | d jS ©Nr )Ú is_extensionÚnumberÚindex)Úxr r r Ú<lambda>² ó z'_Printer.PrintMessage.<locals>.<lambda>)Úkey)rp rW )r? rh Ú
|
DESCRIPTORÚ full_nameÚ_ANY_FULL_TYPE_NAMErf Z
|
ListFieldsr9 ÚsortrR ÚsortedÚ GetEntryClassr Úlabelr rM ÚLABEL_REPEATEDr7 Úcpp_typeÚCPPTYPE_MESSAGEÚCPPTYPE_STRINGÚ"_PrintShortRepeatedPrimitivesValuer2 Ú_PrintUnknownFieldsZ UnknownFields)r r ÚfieldsrQ rW rp Z entry_submsgÚelementr r r r ¤ s8 ÿÿ ÿ þz_Printer.PrintMessagec C sØ | j }|D ]Æ}| d| j ¡ | t|j¡ |jtkr¦| jrL| d¡ n| d¡ | jd7 _| |j ¡ | jr| d¡ n"| jd8 _| d| j d ¡ q
|
|jt
|
kr¢z"t t |j dt|j ¡\}}W n tk
|
rì d}Y nX |t|j krl| jr| d¡ n| d¡ | jd7 _| |¡ | jrH| d¡ n"| jd8 _| d| j d ¡ n4| d¡ | t |j d ¡¡ | | jrd
|
nd ¡ q
|
| d ¡ | t|j ¡ | | jrÌdnd ¡ q
|
dS )zPrint unknown fields.rb z { z {
|
r] z} z}
|
r z: "Fz" z"
|
z: rc N)r@ r. r> r Z field_numberZ wire_typeÚWIRETYPE_START_GROUPr6 r} ÚdataÚWIRETYPE_LENGTH_DELIMITEDr Z_DecodeUnknownFieldSetÚ
|
memoryviewÚlenÚ Exceptionr ÚCEscape)r Zunknown_fieldsr@ rQ Zembedded_unknown_messageÚposr r r r} Ë sN
|
|
|
ÿ
|
|
|
|
|
z _Printer._PrintUnknownFieldsc C sÚ | j }| d| j ¡ | jr.| t|j¡ n|jr| d¡ |j ¡ j rv|j
|
t j j krv|jt j jkrv| |jj¡ n | |j¡ | d¡ n*|j
|
t j jkr¬| |jj¡ n | |j¡ | jsÌ|jt j jkrÖ| d¡ dS )zPrint field name.rb ú[ú]r` N)r@ r. r> r< r rk rj Úcontaining_typerP Zmessage_set_wire_formatrL r rM rN rw ZLABEL_OPTIONALrO rr Ú
|
TYPE_GROUPÚnamer3 ry rz )r rQ r@ r r r Ú_PrintFieldName s*
|
ÿ þ ÿz_Printer._PrintFieldNamec C s< | |¡ | j d¡ | ||¡ | j | jr2dnd¡ dS )rT rb rc N)r r@ r. r
|
r6 )r rQ rW r r r r s
|
z_Printer.PrintFieldc C s~ | |¡ | j d¡ tt|d D ] }| ||| ¡ | j d¡ q&| ||d ¡ | j d¡ | j | jrtdnd¡ dS ) z("Prints short repeated primitives value.z [é z, éÿÿÿÿr rb rc N)r r@ r. Úranger r
|
r6 )r rQ rW Úir r r r| & s
|
z+_Printer._PrintShortRepeatedPrimitivesValuec C s | j rd}d}nd}d}| jrF| j d| ¡ | |¡ | j |¡ nL| j d| ¡ | jd7 _| |¡ | jd8 _| j d| j | ¡ d S ) Nú<ú>Ú{Ú}z%s z%s
|
r] rb )r8 r6 r@ r. r r> )r rW ZopenbZclosebr r r rd 2 s
|
|
z _Printer._PrintMessageFieldValuec C s¬ | j }|jtjjkr"| |¡ n|jtjjkrh|jj |d¡}|dk rV|
|
|j ¡ n|
|
t |¡ n@|jtjj krØ|
|
d¡ t|t r| js| d¡}n|}|jtjjkr´d}n| j}|
|
t ||¡¡ |
|
d¡ nÐ|jtjjkr|rø|
|
d¡ n
|
|
|
d¡ n¤|jtjjkrh| jdk r6|
|
d | j|¡¡ n0t |¡rR|
|
t |¡ n|
|
t t |¡¡ n@|jtjj kr| j dk r|
|
d | j |¡¡ n|
|
t |¡ dS )zÝ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.
|
Nr rC FÚtrueÚfalsez{1:{0}}) r@ ry r rM rz rd Z CPPTYPE_ENUMÚ enum_typeÚvalues_by_numberrG r. r r r{ rE r- rH rL Ú
|
TYPE_BYTESr r Z CPPTYPE_BOOLZ CPPTYPE_FLOATr: r ÚmathÚisnanr ZToShortestFloatZCPPTYPE_DOUBLEr; )r rQ rW r@ Ú
|
enum_valueZ out_valueZ out_as_utf8r r r r
|
E sB
|
ÿz_Printer.PrintFieldValue) r FFFFFNNFNNFF)r r r r r rf rh r r} r r r| rd r
|
r r r r r4 @ s0 ñ
|
F '7 r4 c C s( t | t| trdnd¡|||||dS )a 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.
|
If text contains a field already set in message, the value is appended if the
|
field is repeated. Otherwise, an error is raised.
|
|
Example::
|
|
a = MyProto()
|
a.repeated_field.append('test')
|
b = MyProto()
|
|
# Repeated fields are combined
|
text_format.Parse(repr(a), b)
|
text_format.Parse(repr(a), b) # repeated_field contains ["test", "test"]
|
|
# Non-repeated fields cannot be overwritten
|
a.singular_field = 1
|
b.singular_field = 2
|
text_format.Parse(repr(a), b) # ParseError
|
|
# Binary version:
|
b.ParseFromString(a.SerializeToString()) # repeated_field is now "test"
|
|
Caller is responsible for clearing the message as needed.
|
|
Args:
|
text (str): Message text representation.
|
message (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 (DescriptorPool): Descriptor pool used to resolve Any types.
|
allow_unknown_field: if True, skip over unknown field and keep
|
parsing. Avoid to use this option if possible. It may hide some
|
errors (e.g. spelling error on field name)
|
|
Returns:
|
Message: The same message passed as argument.
|
|
Raises:
|
ParseError: On text parsing problems.
|
ó
|
rc ©r= Úallow_unknown_field)Ú
|
ParseLinesÚsplitrE rF ©rJ r Úallow_unknown_extensionÚallow_field_numberr= r r r r r x s 2ûc C s( t | t| trdnd¡|||||dS )a¡ 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. This means any non-repeated, top-level fields specified in text
|
replace those in the message.
|
|
Args:
|
text (str): Message text representation.
|
message (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 (DescriptorPool): Descriptor pool used to resolve Any types.
|
allow_unknown_field: if True, skip over unknown field and keep
|
parsing. Avoid to use this option if possible. It may hide some
|
errors (e.g. spelling error on field name)
|
|
Returns:
|
Message: The same message passed as argument.
|
|
Raises:
|
ParseError: On text parsing problems.
|
r rc r )Ú
|
MergeLinesr¢ rE rF r£ r r r r ² s úc C s t ||||d}| | |¡S )aò Parses a text representation of a protocol message into a message.
|
|
See Parse() for caveats.
|
|
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.
|
allow_unknown_field: if True, skip over unknown field and keep
|
parsing. Avoid to use this option if possible. It may hide some
|
errors (e.g. spelling error on field name)
|
|
Returns:
|
The same message passed as argument.
|
|
Raises:
|
ParseError: On text parsing problems.
|
r )Ú_Parserr¡ ©Úlinesr r¤ r¥ r= r Úparserr r r r¡ Ø s ýr¡ c C s t ||||d}| | |¡S )a÷ Parses a text representation of a protocol message into a message.
|
|
See Merge() for more details.
|
|
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.
|
allow_unknown_field: if True, skip over unknown field and keep
|
parsing. Avoid to use this option if possible. It may hide some
|
errors (e.g. spelling error on field name)
|
|
Returns:
|
The same message passed as argument.
|
|
Raises:
|
ParseError: On text parsing problems.
|
r )r§ r¦ r¨ r r r r¦ ú s ýr¦ c @ s^ e Zd ZdZdddZdd Zdd Zd
|
d Zd d Zdd Z dd Z
|
e dd Z dd Z dS )r§ z(Text format parser for protocol message.FNc C s || _ || _|| _|| _d S r$ )r¤ r¥ r= r )r r¤ r¥ r= r r r r r s z_Parser.__init__c C s d| _ | ||¡ |S )zBParses a text representation of a protocol message into a message.F©Ú_allow_multiple_scalarsÚ _ParseOrMerge©r r© r r r r r¡ ) s z_Parser.ParseLinesc C s d| _ | ||¡ |S )zBMerges a text representation of a protocol message into a message.Tr« r® r r r r¦ / s z_Parser.MergeLinesc C s0 dd |D }t |}| ¡ s,| ||¡ qdS )zü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.
|
c s s& | ] }t |tr|n| d ¡V qdS )rC N)rE r Údecode)Ú.0r r r r Ú <genexpr>@ s ÿz(_Parser._ParseOrMerge.<locals>.<genexpr>N)Ú TokenizerÚAtEndÚ _MergeField)r r© r Z str_linesÚ tokenizerr r r r 5 s þz_Parser._ParseOrMergec C sh |j }|jtkr¾| d¡r¾| |¡\}}| d¡ | d¡ | d¡rLd}n| d¡ d}t|| j}|svtd| | |¡s¦| ¡ r|
|
d |f ¡| ||¡ qvd
|
}|j |||d d S | d¡rl| ¡ g} | d ¡rî| | ¡ ¡ qÔd | ¡} |js|
|
d|j ¡|j | ¡}
|
|
|
s@| jr0d }
|
n|
|
d| ¡n ||
|
jkr`|
|
d| |jf ¡| d¡ nÚ| ¡ } | jr¼| ¡ r¼t| dd} |j | d ¡}
|
|
|
s$|jr$|j | ¡}
|
nh|j | d ¡}
|
|
|
sü|j | ¡ d ¡}
|
|
|
rü|
|
j t j j!krüd }
|
|
|
r$|
|
j t j j!kr$|
|
j"j#| kr$d }
|
|
|
sF| j$sF|
|
d|j| f ¡|
|
r2| j%s|
|
j&r| '|
|
j&j#¡} | d k r| |
|
j#kr|
|
d|
|
j#| |
|
j&j#|jf ¡|
|
j(t j j)krÀ| d¡ | j*} n| d¡ | j+} |
|
j,t j j-kr$| d¡r$| d¡s0| |||
|
| d¡rq0| d¡ qøn | |||
|
n | jsF| j$sFt.t/| | d¡sd| d¡ d S )zþ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.
|
r r r` r r r r z$Type %s not found in descriptor poolúExpected "%s".F)Útype_url_prefixÚ deterministicNÚ.z+Message type "%s" does not have extensions.zþ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 wellz1Extension "%s" does not extend message type "%s".Tz*Message type "%s" has no field named "%s".zbField "%s" is specified along with field "%s", another member of oneof "%s" for message type "%s".ú,ú;)0rq rr rs Ú
|
TryConsumeÚ_ConsumeAnyTypeUrlÚConsumer\ r= r r³ ÚParseErrorPreviousTokenr´ ZPackÚConsumeIdentifierÚappendÚjoinZ is_extendableÚ
|
ExtensionsZ_FindExtensionByNamer¤ r ÚConsumeIdentifierOrNumberr¥ ÚisdigitÚ ParseIntegerZfields_by_numberrG Z_FindExtensionByNumberÚfields_by_nameÚlowerrL r rM r rO r r r¬ Zcontaining_oneofZ
|
WhichOneofry rz Ú_MergeMessageFieldÚ_MergeScalarFieldrw rx ÚAssertionErrorÚ_SkipFieldContents)r rµ r r[ r· Zpacked_type_nameZexpanded_any_end_tokenZexpanded_any_sub_messager¸ r rQ rk Z which_oneofZmergerr r r r´ G sÖ
|
|
ÿ
|
|
|
|
ÿÿ
|
ÿþ
|
|
|
ÿÿ üÿ ÿÿ
|
ÿÿÿ ÿþÿ
|
|
ÿ z_Parser._MergeFieldc C s| | ¡ g}| d¡ | | ¡ ¡ | d¡ | | ¡ ¡ | d¡ | ¡ g}| d¡rh| | ¡ ¡ qNd |¡d |¡fS )zBConsumes a google.protobuf.Any type URL and returns the type name.r¹ r_ )rÀ r¾ rÁ r¼ r )r rµ Úprefixr r r r r½ Ó s
|
|
|
|
|
|
z_Parser._ConsumeAnyTypeUrlc C sz t |}| d¡rd}n| d¡ d}|jtjjkrt|jrJ|j| ¡ }qì|rbt
|
||j ¡ }qìt
|
||j ¡ }nx|jr®| j s¢| |¡r¢| d|jj|jf ¡|j| }n6| j sØ| |j ¡rØ| d|jj|j f ¡t
|
||j }| ¡ | |¡s | ¡ r| d|f ¡| ||¡ qì|rv|jjd j}|tjjkrbt
|
||j |j }| |j ¡ n|j t
|
||j |j< d S )
|
a" Merges a single scalar field into a message.
|
|
Args:
|
tokenizer: A tokenizer to parse the field value.
|
message: The message of which field is a member.
|
field: The descriptor of the field to be merged.
|
|
Raises:
|
ParseError: In case of text parsing problems.
|
r r r r ú;Message type "%s" should not have multiple "%s" extensions.ú7Message type "%s" should not have multiple "%s" fields.r¶ rW N) rR r¼ r¾ rw r rM rx rj rà ÚaddÚgetattrr rv r¬ Ú HasExtensionr¿ rq rr ÚHasFieldZ SetInParentr³ r´ rO rÇ ry rz rp ZCopyFromrW ) r rµ r rQ Z is_map_entryZ end_tokenZ sub_messageZ value_cpptyperW r r r rÉ â sR
|
|
ÿ ÿÿ
|
ÿ ÿÿ
|
z_Parser._MergeMessageFieldc C s | j }t|do|jdkS )NÚsyntaxÚproto3)rq ÚhasattrrÔ )r r[ r r r Ú_IsProto3Syntax s
|
ÿz_Parser._IsProto3Syntaxc C s | j }d}|jtjjtjjtjjfkr0t|}nø|jtjjtjj tjj
|
fkrVt |}nÒ|jtjj tjj fkrvt|}n²|jtjjtjjfkrt|}n|jtjjtjjfkr¶| ¡ }nr|jtjjkrÎ| ¡ }nZ|jtjjkræ| ¡ }nB|jtjjkrþ| ¡ }n*|jtjjkr| |¡}nt d|j |j tjj krf|j rR|j!| "|¡ nt#||j$ "|¡ n²|j r´| j%s¨| &|¡s¨| '|¡r¨| (d|j)j*|j*f ¡n
|
||j!|< ndd}| j%sê| &|¡rÞt+t#||j$}n | ,|j$¡}|r
|
| (d|j)j*|j$f ¡nt-||j$| dS )aH Merges a single scalar field into a message.
|
|
Args:
|
tokenizer: A tokenizer to parse the field value.
|
message: A protocol message to record the data.
|
field: The descriptor of the field to be merged.
|
|
Raises:
|
ParseError: In case of text parsing problems.
|
RuntimeError: On runtime errors.
|
NzUnknown field type %drÎ FrÏ ).r¤ rL r rM Z
|
TYPE_INT32Z TYPE_SINT32Z TYPE_SFIXED32Ú _ConsumeInt32Z
|
TYPE_INT64Z TYPE_SINT64Z TYPE_SFIXED64Ú _ConsumeInt64Z TYPE_UINT32Z TYPE_FIXED32Ú_ConsumeUint32Z TYPE_UINT64Z TYPE_FIXED64Ú_ConsumeUint64Z
|
TYPE_FLOATZ TYPE_DOUBLEÚ ConsumeFloatZ TYPE_BOOLÚ ConsumeBoolZ TYPE_STRINGÚ ConsumeStringr ÚConsumeByteStringZ TYPE_ENUMÚ ConsumeEnumÚ RuntimeErrorrw rx rj rà rÁ rÑ r r¬ r× rÒ r¿ rq rr ÚboolrÓ Úsetattr)r rµ r rQ Ú_rW Zduplicate_errorr r r rÊ " sz
|
þ
|
|
þ
|
|
ÿ
|
|
ÿ
|
|
ÿ
|
|
|
|
ÿþ ÿÿ ÿÿz_Parser._MergeScalarField)FFNF)r r r r r r¡ r¦ r r´ r½ rÉ Ú staticmethodr× rÊ r r r r r§ s ü
|
|
:
|
r§ c C s4 | d¡r(| d¡s(| d¡s(t| nt| dS )z}Skips over contents (value or message) of a field.
|
|
Args:
|
tokenizer: A tokenizer to parse the field name and values.
|
r` r r N)r¼ Ú LookingAtÚ_SkipFieldValueÚ_SkipFieldMessage©rµ r r r rÌ n s ÿÿ
|
rÌ c C sZ | d¡r2| ¡ | d¡r&| ¡ q| d¡ n| ¡ t| | d¡sV| d¡ dS )zSkips over a complete field (name and value/message).
|
|
Args:
|
tokenizer: A tokenizer to parse the field name and values.
|
r r¹ r rº r» N)r¼ rÀ r¾ rÄ rÌ ré r r r Ú
|
_SkipField s
|
|
|
|
rê c C sJ | d¡rd}n| d¡ d}| d¡s<| d¡s<t| q | |¡ dS )zfSkips over a field message.
|
|
Args:
|
tokenizer: A tokenizer to parse the field name and values.
|
r r r r N)r¼ r¾ ræ rê )rµ Ú delimiterr r r rè s
|
|
|
rè c C sH | ¡ r| ¡ rqdS | ¡ sDt| sDt| sD| ¡ sDtd| j dS )z¨Skips over a field value.
|
|
Args:
|
tokenizer: A tokenizer to parse the field name and values.
|
|
Raises:
|
ParseError: In case an invalid field value is found.
|
NzInvalid field value: )ÚTryConsumeByteStringÚTryConsumeIdentifierÚ_TryConsumeInt64Ú_TryConsumeUint64ÚTryConsumeFloatr Útokenré r r r rç « s ÿÿþrç c @ sF e Zd ZdZe d¡Ze dej¡Ze dej¡Z e d
|
ddgdd e D ¡¡Z e d
|
¡Z e d ¡ZdDd dZdd Zdd Zdd Zdd Zdd Zdd Zdd Zd d Zd d Zd!d" Zd#d$ Zd%d& Zd'd( Z d)d* Z d+d, Z d-d. Z d/d0 Z d1d2 Z!d3d4 Z"d5d6 Z#d7d8 Z$d9d: Z%d;d< Z&d=d> Z'd?d@ Z(dAdB Z)dCS )Er² zÍProtocol buffer text representation tokenizer.
|
|
This class handles the lower level string parsing by splitting it into
|
meaningful tokens.
|
|
It was directly ported from the Java protocol buffer API.
|
z\s+z (\s*#.*$)z (\s|(#.*$))+ú|z[a-zA-Z_][0-9a-zA-Z_+-]*z#([0-9+-]|(\.[0-9]))[0-9a-zA-Z_.+-]*c C s g | ]}d j |dqS )z0{qt}[^{qt}\n\\]*((\\.)+[^{qt}\n\\]*)*({qt}|\\?$))Zqt)r )r° Úmarkr r r Ú
|
<listcomp>Ð s ÿzTokenizer.<listcomp>z
|
[^\d\W]\w*z\w+Tc C sl d| _ d| _d| _d | _d| _t|| _d| _d| _d| _ d| _
|
|| _ |rP| j pT| j | _| ¡ | ¡ d S )Nr r ra T)Ú _positionr r Z _token_startrñ ÚiterÚ_linesÚ _current_lineÚ_previous_lineÚ_previous_columnÚ _more_linesÚ_skip_commentsÚ_WHITESPACE_OR_COMMENTÚ _WHITESPACEÚ_whitespace_patternÚ_SkipWhitespaceÚ NextToken)r r© Z skip_commentsr r r r Ù s
|
|
ÿzTokenizer.__init__c C s
|
| j |kS r$ ©rñ ©r rñ r r r ræ ê s zTokenizer.LookingAtc C s | j S )z^Checks the end of the text was reached.
|
|
Returns:
|
True iff the end was reached.
|
r r% r r r r³ í s zTokenizer.AtEndc C s^ t | j| jkrZzt| j| _W n" tk
|
rB d| _d| _Y d S X | jd7 _d| _q d S )Nra Fr r )r rø r Únextr÷ Ú StopIterationrû r r% r r r Ú_PopLineõ s zTokenizer._PopLinec C sB | ¡ | j | j| j¡}|s q>t| d¡}| j|7 _q d S ri )r rÿ Úmatchrø r r Úgroup)r r Úlengthr r r r s zTokenizer._SkipWhitespacec C s | j |kr| ¡ dS dS )zTries to consume a given piece of text.
|
|
Args:
|
token: Text to consume.
|
|
Returns:
|
True iff the text was consumed.
|
TF)rñ r r r r r r¼
|
s
|
zTokenizer.TryConsumec C s | |¡s| d| ¡dS )zConsumes a piece of text.
|
|
Args:
|
token: Text to consume.
|
|
Raises:
|
ParseError: If the text couldn't be consumed.
|
r¶ N)r¼ r r r r r r¾ s
|
zTokenizer.Consumec C s( | j }| j |¡s | d¡| ¡ |S )NzExpected comment.)rñ Ú_COMMENTr r r ©r rB r r r ÚConsumeComment$ s
|
|
zTokenizer.ConsumeCommentc C s: | j dko| jdk}| j}| ¡ }| j|ko0| }||fS )zCConsumes a comment, returns a 2-tuple (trailing bool, comment str).r )r r rù r )r Z just_startedZbefore_parsingÚcommentZtrailingr r r Ú ConsumeCommentOrTrailingComment+ s
|
ÿz)Tokenizer.ConsumeCommentOrTrailingCommentc C s* z| ¡ W dS tk
|
r$ Y dS X d S ©NTF)rÀ r r% r r r rí ; s
|
z Tokenizer.TryConsumeIdentifierc C s( | j }| j |¡s | d¡| ¡ |S )úConsumes protocol message field identifier.
|
|
Returns:
|
Identifier string.
|
|
Raises:
|
ParseError: If an identifier couldn't be consumed.
|
zExpected identifier.)rñ Ú _IDENTIFIERr r r r r r r rÀ B s
|
|
zTokenizer.ConsumeIdentifierc C s* z| ¡ W dS tk
|
r$ Y dS X d S r )rÄ r r% r r r Ú TryConsumeIdentifierOrNumberQ s
|
z&Tokenizer.TryConsumeIdentifierOrNumberc C s, | j }| j |¡s | d| ¡| ¡ |S )r z&Expected identifier or number, got %s.)rñ Ú_IDENTIFIER_OR_NUMBERr r r r r r r rÄ X s
|
z#Tokenizer.ConsumeIdentifierOrNumberc C s* z| ¡ W dS tk
|
r$ Y dS X d S r )ÚConsumeIntegerr r% r r r ÚTryConsumeIntegerg s
|
zTokenizer.TryConsumeIntegerc
|
C sL zt | j}W n0 tk
|
r> } z| t|¡W 5 d}~X Y nX | ¡ |S )zConsumes an integer number.
|
|
Returns:
|
The integer parsed.
|
|
Raises:
|
ParseError: If an integer couldn't be consumed.
|
N)Ú_ParseAbstractIntegerrñ Ú
|
ValueErrorr r r ©r rB Úer r r r n s zTokenizer.ConsumeIntegerc C s* z| ¡ W dS tk
|
r$ Y dS X d S r )rÜ r r% r r r rð ~ s
|
zTokenizer.TryConsumeFloatc
|
C sL zt | j}W n0 tk
|
r> } z| t|¡W 5 d}~X Y nX | ¡ |S )zConsumes an floating point number.
|
|
Returns:
|
The number parsed.
|
|
Raises:
|
ParseError: If a floating point number couldn't be consumed.
|
N)Ú
|
ParseFloatrñ r r r r r r r r rÜ
s zTokenizer.ConsumeFloatc
|
C sL zt | j}W n0 tk
|
r> } z| t|¡W 5 d}~X Y nX | ¡ |S )zConsumes a boolean value.
|
|
Returns:
|
The bool parsed.
|
|
Raises:
|
ParseError: If a boolean value couldn't be consumed.
|
N)Ú ParseBoolrñ r r r r r r r r rÝ s zTokenizer.ConsumeBoolc C s* z| ¡ W dS tk
|
r$ Y dS X d S r )rß r r% r r r rì ¥ s
|
z Tokenizer.TryConsumeByteStringc
|
C sF | ¡ }z t|dW S tk
|
r@ } z| |¡W 5 d}~X Y nX dS )zConsumes a string value.
|
|
Returns:
|
The string parsed.
|
|
Raises:
|
ParseError: If a string value couldn't be consumed.
|
rC N)rß r ÚUnicodeDecodeErrorÚ_StringParseError)r Z the_bytesr r r r rÞ ¬ s
|
zTokenizer.ConsumeStringc C s8 | ¡ g}| jr.| jd tkr.| | ¡ ¡ q
|
d |¡S )z Consumes a byte array value.
|
|
Returns:
|
The array parsed (as a string).
|
|
Raises:
|
ParseError: If a byte array value couldn't be consumed.
|
r ro )Ú_ConsumeSingleByteStringrñ Ú_QUOTESrÁ r )r Zthe_listr r r rß » s
|
zTokenizer.ConsumeByteStringc
|
C s® | j }t|dk s |d tkr.| d|f ¡t|dk sJ|d |d krZ| d|f ¡zt |dd
¡}W n0 tk
|
r } z| t|¡W 5 d}~X Y nX | ¡ |S )aO Consume one token of a string literal.
|
|
String literals (whether bytes or text) can come in multiple adjacent
|
tokens which are automatically concatenated, like in C or Python. This
|
method only consumes one token.
|
|
Returns:
|
The token parsed.
|
Raises:
|
ParseError: When the wrong format data is found.
|
r r z Expected string but found: %rr] r z String missing ending quote: %rN) rñ r r r r Z CUnescaper r r )r rJ rB r r r r r É s z"Tokenizer._ConsumeSingleByteStringc
|
C sN zt || j}W n0 tk
|
r@ } z| t|¡W 5 d }~X Y nX | ¡ |S r$ )Ú ParseEnumrñ r r r r )r rQ rB r r r r rà ã s zTokenizer.ConsumeEnumc C s t || jd | jd S )z¯Creates and *returns* a ParseError for the previously read token.
|
|
Args:
|
message: A message to set for the exception.
|
|
Returns:
|
A ParseError instance.
|
r )r rù rú ©r r r r r r¿ ë s ÿz!Tokenizer.ParseErrorPreviousTokenc C s& t d| j d | | jd | jd S )z9Creates and *returns* a ParseError for the current token.r z': r )r rø r r r! r r r r ÷ s ÿzTokenizer.ParseErrorc C s | dt| ¡S )NzCouldn't parse string: )r r )r r r r r r ü s zTokenizer._StringParseErrorc C s | j | _| j| _| jt| j7 _| ¡ | js<d| _dS | j | j
|
| j¡}|sj| j sj| j | j
|
| j¡}|r| d¡}|| _n| j
|
| j | _dS )z Reads the next meaningful token.ra Nr )r rù r rú r rñ r rû Ú_TOKENr rø rü r
|
r )r r rñ r r r r ÿ s
|
|
zTokenizer.NextTokenN)T)*r r r r ÚreÚcompilerþ Ú MULTILINEr
|
rý r r r" r r r ræ r³ r r r¼ r¾ r r rí rÀ r rÄ r r rð rÜ rÝ rì rÞ rß r rà r¿ r r r r r r r r² Á sR
|
þýý
|
|
|
r² c C s t | dddS )úæConsumes a signed 32bit integer number from tokenizer.
|
|
Args:
|
tokenizer: A tokenizer used to parse the number.
|
|
Returns:
|
The integer parsed.
|
|
Raises:
|
ParseError: If a signed 32bit integer couldn't be consumed.
|
TF©Ú is_signedÚis_long©Ú_ConsumeIntegerré r r r rØ s rØ c C s t | dddS )zìConsumes an unsigned 32bit integer number from tokenizer.
|
|
Args:
|
tokenizer: A tokenizer used to parse the number.
|
|
Returns:
|
The integer parsed.
|
|
Raises:
|
ParseError: If an unsigned 32bit integer couldn't be consumed.
|
Fr' r* ré r r r rÚ ( s rÚ c C s* zt | W dS tk
|
r$ Y dS X d S r )rÙ r ré r r r rî 7 s
|
rî c C s t | dddS )r& Tr' r* ré r r r rÙ ? s rÙ c C s* zt | W dS tk
|
r$ Y dS X d S r )rÛ r ré r r r rï N s
|
rï c C s t | dddS )zìConsumes an unsigned 64bit integer number from tokenizer.
|
|
Args:
|
tokenizer: A tokenizer used to parse the number.
|
|
Returns:
|
The integer parsed.
|
|
Raises:
|
ParseError: If an unsigned 64bit integer couldn't be consumed.
|
FTr' r* ré r r r rÛ V s rÛ c
|
C sR zt | j||d}W n0 tk
|
rD } z| t|¡W 5 d}~X Y nX | ¡ |S )aU Consumes an integer number from tokenizer.
|
|
Args:
|
tokenizer: A tokenizer used to parse the number.
|
is_signed: True if a signed integer must be parsed.
|
is_long: True if a long integer must be parsed.
|
|
Returns:
|
The integer parsed.
|
|
Raises:
|
ParseError: If an integer with given characteristics couldn't be consumed.
|
r' N)rÆ rñ r r r r )rµ r( r) rB r r r r r+ e s r+ c C s. t | }tdt| t| }| |¡ |S )a Parses an integer.
|
|
Args:
|
text: The text to parse.
|
is_signed: True if a signed integer must be parsed.
|
is_long: True if a long integer must be parsed.
|
|
Returns:
|
The integer value.
|
|
Raises:
|
ValueError: Thrown Iff the text is not a valid integer.
|
r] )r Ú_INTEGER_CHECKERSÚintZ
|
CheckValue)rJ r( r) rB Úcheckerr r r rÆ { s
|
rÆ c C s^ | }t d| ¡}|r,| d¡d | d¡ } z t| dW S tk
|
rX td| Y nX dS )zÆParses an integer without checking size/signedness.
|
|
Args:
|
text: The text to parse.
|
|
Returns:
|
The integer value.
|
|
Raises:
|
ValueError: Thrown Iff the text is not a valid integer.
|
z (-?)0(\d+)$r Z0or] r zCouldn't parse integer: %sN)r# r r r- r )rJ Ú orig_textZ c_octal_matchr r r r s r c C s z
|
t | W S tk
|
r t | ¡rJ| d dkr<t d Y S t d Y S nLt | ¡r`t d Y S zt | d¡W Y S tk
|
r td| Y nX Y nX dS ) z°Parse a floating point number.
|
|
Args:
|
text: Text to parse.
|
|
Returns:
|
The number parsed.
|
|
Raises:
|
ValueError: If a floating point number couldn't be parsed.
|
r ú-z-infÚinfÚnanÚfzCouldn't parse float: %sN)Úfloatr Ú_FLOAT_INFINITYr Ú
|
_FLOAT_NANr5 ©rJ r r r r « s
|
|
|
r c C s$ | dkr dS | dkrdS t ddS )zParse a boolean value.
|
|
Args:
|
text: Text to parse.
|
|
Returns:
|
Boolean values parsed
|
|
Raises:
|
ValueError: If text is not a valid boolean.
|
)r ÚtÚ1ÚTrueT)r r3 Ú0ÚFalseFzExpected "true" or "false".N)r r7 r r r r Ë s
|
r c C s | j }zt|d}W n< tk
|
rP |j |d¡}|dkrLtd|j|f Y nFX t| jdrn| jjdkrn|S |j |d¡}|dkrtd|j|f |j
|
S )a& 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.
|
r Nz%Enum type "%s" has no value named %s.rÔ rÕ z+Enum type "%s" has no value with number %d.) r r- r Zvalues_by_namerG rr rÖ ÚfilerÔ r rk )rQ rW Zenum_descriptorrk r r r r r ß s$ ÿ ÿr ) FFFFFNNFNr NFF) r FFFFFNNFNNFF) r FFFFFNNNFF) r FFFFFNNNFF)FFNF)FFNF)FFNF)FFNF)FF)FF)Ar Ú
|
__author__Z encodings.raw_unicode_escapeÚ encodingsZencodings.unicode_escaper* r r# Zgoogle.protobuf.internalr r rY r r Ú__all__ZUint32ValueCheckerZInt32ValueCheckerZUint64ValueCheckerZInt64ValueCheckerr, r$ Ú
|
IGNORECASEr5 r6 Ú frozensetr rs r
r r Úobjectr) r r rR r r r
|
r\ r r r4 r r r¡ r¦ r§ rÌ rê rè rç r² Z
|
_TokenizerrØ rÚ rî rÙ rï rÛ r+ rÆ r r r r r r r r Ú<module> s ÿý ò
|
R
|
ò
|
" ó
|
ó
|
< û
|
< û
|
( û
|
$ û
|
" T W
|
|
|
