- S r SSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK
J r SSK J
r
SSK Jr SS KJr SSKrS
rS rS rS
r\" S5 \-
rSrSrSrSrS r S r S r S r S r " S S\!5 r"SS jr#g) zFUtilities for handling YAML schemas for gcloud export/import commands. )absolute_import)division)unicode_literalsN)log)resource_projector) yaml_printer)filesz6A gcloud export/import command YAML validation schema.P ( z
description: zz Optional.z Output only.z Required.c [ U [ - -
n[ R " U[ [
U5 5 n[
U5 S:w a SR U5 $ US nU[
U5 [ - -
nUS: a US- US- - [ - $ U$ )a% Returns description: |- text wrapped so it won't exceed _WIDTH at depth.
The YAML representer doesn't seem to take the length of the current tag
into account when deciding whether to inline strings or use |-. In this case
the tag is always "description: ". This function detects when YAML would fail
and adds temporary marker lines to produce the desired output. The marker
lines are removed prior to final output.
Args:
depth: The nested dict depth.
text: The text string to wrap.
Returns:
Text wrapped so it won't exceed _WIDTH at depth.
r )
_WIDTH_INDENTtextwrapwrapmax_MINWRAPlenjoin_DESCRIPTION_INDENT_YAML_WORKAROUND)depthtextwidthlineslinenudges 2lib/googlecloudsdk/command_lib/util/apis/export.py_WrapDescriptionr" 1 s EGO
$%
--c(E 2
3%Z1_ 99U q$
3t9 22
3%
QY $; $'7 77
+ c 4 [ R " U 5 R 5 n[ R " SU5 ( a g[ R " SU5 ( a g[ R " SU5 ( a gUS:X a gUS:X a gUS:X a g US
:X a g U$ ) z6Returns the JSON schema normalized type name for name.z.?int64integerz.?int32z^int\d*$floatnumberdoubleboolbooleanbytesstring)six text_typelowerrematch)namess r! _NormalizeTypeNamer4 O s mmD !!XXj! XXj! XXk1 '\ (] &[ '\
(r# c U R S0 5 R S0 5 R S0 5 R S0 5 R SS5 nUS:H $ )a% Returns whether the field represents a google.protobuf.Struct message.
google.protobuf.Struct is the following message:
message Struct {
// Unordered map of dynamically typed values.
map fields = 1;
}
In apitools, this corresponds to a message with an additionalProperties
field containing a list of AdditionalProperty messages each of which holds a
key/value pair, where the value is a extra_types.JsonValue message.
Args:
field: A message spec field dict.
Returns:
True iff the field is a google.protobuf.Struct.
fieldsadditionalPropertiesvaluetype JsonValue)get)fieldmaybe_map_value_types r! _IsProtobufStructFieldr? c sc $ C
"&&)c' C2 "s b "
,,r# c / n[ R " U 5 H? u p#US nUS:w d M UR [ 5 ( d M. UR U5 MA U$ )zReturns the list of required field names in fields.
Args:
fields: A message spec fields dict.
Returns:
The list of required field names in fields.
descriptionr7 )r- iteritems
startswith _REQUIREDappend)r6 requiredr2 r8 rA s r! _GetRequiredFieldsrG ~ sV (]]6*kd
&K %%+*@*@*K*Kood +
/r# c F [ U5 nU( a [ U5 U S' gg)z Adds required fields to spec.rF N)rG sorted)specr6 rF s r! _AddRequiredFieldsrK s#
'(
h'D r# c @ \ rS rSrSrS S jrS rS rS rS r S r
S
r g) ExportSchemasGenerator z>Recursively generates export JSON schemas for nested messages.Nc : Xl X l [ 5 U l g N)_api
_directoryset
_generated)selfapi directorys r! __init__ ExportSchemasGenerator.__init__ s I OeDOr# c US- $ )z4Returns the schema file name given the message name.z.yaml )rU message_names r! _GetSchemaFileName)ExportSchemasGenerator._GetSchemaFileName s
' !!r# c U R U5 nU R ( a* [ R R U R U5 nU$ )z9Returns the schema file path name given the message name.)r] rR ospathr )rU r\ file_paths r! _GetSchemaFilePath)ExportSchemasGenerator._GetSchemaFilePath s7 '' 5I '',,t :i r# c [ R " 5 nUR S5 [ R " S[
R " 5 US9R U5 [ R " SR [ 5 SUR 5 5 nU R U5 n[ R " SR U5 5 [ R" " U5 nUR U5 SSS5 g! , ( d f g= f)z;Writes the schema in spec to the _GetSchemaFilePath() file.z4$schema: "http://json-schema.org/draft-06/schema#"
yaml)r2 projectoroutz
*{}
r z Generating JSON schema [{}].N)ioStringIOwriter YamlPrinterr IdentityProjectorPrintr0 subformatr getvaluerc r infor
FileWriter)rU r\ rJ tmpcontentrb ws r! _WriteSchema#ExportSchemasGenerator._WriteSchema s
++-CIIFG
$668 tffZ&&'78$ OG'' 5IHH
+
2
29
=> ) $ggg
% $ $s $C??
D
c H US-
n[ [ R " U5 5 GHs u pVUS R 5 nUR [
5 ( a! U[
[
5 S R 5 nO:UR [ 5 ( a U[
[ 5 S R 5 nUR [ 5 ( a M [ R " 5 nXU' [ X5 US' UR S5 ( a6 SUS' [ R " UR S0 5 5 n XS' U nUS-
n[ UR S5 [ 5 n
UR SS5 n UR S 0 5 n U
( a US
:X a: X5 [ R " 5 n
U R XX5 U
( a XU' GM GM [! U5 ( a S US' GM U R# U 5 US ' U R% X5 GM XR& ; a U R# U 5 US ' GM
[) U 5 n U S
:X aQ UR S5 nSUS' [ [ R " U5 VVs/ s H u nnUPM
snn5 US
' GMo XS' GMv gs snnf )zAdds message fields to the YAML spec.
Args:
depth: The nested dict depth.
parent: The parent spec (nested ordered dict to add fields to) of spec.
spec: The nested ordered dict to add fields to.
fields: A message spec fields dict to add to spec.
r rA Nrepeatedarrayr9 itemsr* r6 r7 objectz$refenumchoicesr, )rI r- rB striprC _OPTIONALr rD _OUTPUT_ONLY collections OrderedDictr" r<
isinstancestr
_AddFieldsr? r] GeneraterT r4 )rU r parentrJ r6 r2 r8 rA dr| is_message_field type_name subfields
propertiesr~ n_s r! r !ExportSchemasGenerator._AddFields s<
QJE cmmF 34 -(..0k * *!#i./288: ! !) , ,!#i./288: - -
!
!
#a4j)%=a
: & '' '2(>?'
$EIIf$5s;))FI.i))Hb)i ) )j"..0*
//%J
:
%4L
#E
*
* !F) --i8!F)
--
- '--i8!F)(3)
&
99Y'D AfI cmmD.A B.Ada.A BCAfI!fIm 5h Cs 7J c XR ; a gU R R U5 [ R " 5 nSR U R
R U R
R U5 US' [ US' SUS' [ X25 SUS' [ R " 5 nXCS ' SS
0n[ R " 5 nXdS ' SUS' S US' SUS' [ R " 5 nXvS ' [ R " U5 US
' [ R " U5 US' [ R " U5 US' [ R " U5 US' [ R " U5 US' [ R " 5 nXS' SUS' SUS' XXS' U R SX4U5 U R X5 g)aY Recursively generates export/import YAML schemas for message_spec.
The message and nested messages are generated in separate schema files in
the destination directory. Pre-existing files are silently overwritten.
Args:
message_name: The API message name for message_spec.
message_spec: An arg_utils.GetRecursiveMessageSpec() message spec.
Nz{} {} {} export schematitlerA r} r9 Fr7 r r, COMMENTz-User specified info ignored by gcloud import.z template-idregiondateversionUNKNOWNr{ z+Unknown API fields that cannot be imported.r| r ) rT addr r rp rQ r2 r _SPEC_DESCRIPTIONrK r rw ) rU r\ message_specrJ r type_stringcommentcomment_propertiesunknowns r! r ExportSchemasGenerator.Generate s & OO % " " $D,33 ))<9DM+D DLt*#(D ((*J# 8$K %%'G #y GFO LGM&+G "#$002 .L(3(?(? (L}%#.#:#:;#Gx (3(?(? (L}%!,!8!8!Ev $/$;$;K$Hy! %%'G #y GFO JGM"GOOAt 6l)r# )rQ rR rT rP ) __name__
__module__ __qualname____firstlineno____doc__rX r] rc rw r r __static_attributes__r[ r# r! rM rM s% F
" @"D6*r# rM c 8 [ X5 R X5 g)a Recursively generates export/import YAML schemas for message_spec in api.
The message and nested messages are generated in separate schema files in the
current directory. Pre-existing files are silently overwritten.
Args:
api: An API registry object.
message_name: The API message name for message_spec.
message_spec: An arg_utils.GetRecursiveMessageSpec() message spec.
directory: The path name of the directory to place the generated schemas,
None for the current directory.
N)rM r )rV r\ r rW s r! GenerateExportSchemasr 8 s (11,Mr# rP )$r
__future__r r r r ri r` r0 r googlecloudsdk.corer googlecloudsdk.core.resourcer r googlecloudsdk.core.utilr r- r r r r r r r r r rD r" r4 r? rG rK r} rM r r[ r# r! r s M & ' # ; 5 *
M
/*W4 ' < (-6.(Y*V Y*x
Nr#