+0rSrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK r SSK J r SSK J r SSK Jr SS K Jr SS KJr SS KJr SS KJr SSKrS r"SS\ R.5r"SS\5rSrSrSr\R8S5r"SS\5rSr "SS\5r!"SS\5r"g)z/Utilities for gcloud help document differences.)absolute_import)division)unicode_literalsN) exceptions)log) console_io)progress_tracker)files)parallel)text c\rSrSrSrSrg)Error*zErrors for this module.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r0lib/googlecloudsdk/command_lib/meta/help_util.pyrr*srrc\rSrSrSrSrg)HelpUpdateError.zUpdate errors.rNrrrrrr.srrcF[RRU5S:H$)z-Return True if path refers to an OWNERS file.OWNERS)ospathbasename)r!s r IsOwnersFiler#2s   $ 8 ++rc[R"U5nSnX4$![a [R"U5nSnX4$f=f)zReturns the file contents and whether or not the file contains binary data. Args: file: A file path. Returns: A tuple of the file contents and whether or not the file contains binary contents. FT) file_utilsReadFileContents UnicodeErrorReadBinaryFileContents)filecontents is_binarys rGetFileContentsr,7sV**40HI   006HI  s"AAc2[5n[R"[R"U55H^up#nUHRn[R R X%5n[R RX`5nURU5 MT M` U$)zGenerates the set of all files in directory and its children recursively. Args: directory: The directory path name. Returns: A set of all files in directory and its children recursively, relative to the directory. ) setr walksix text_typer!joinrelpathadd) directorydirfilesdirpath_r namer) relative_files rGetDirFilesRecursiver;JsmU(773==#;<g% WW\\' (dggood6mll=!= /rc#(# [R"USS9 [R"5nSv [R"5U- n[RR SR X55 SSS5 g!,(df  g=f7f)z:Context manager to track progress and time blocks of code.T)autotickNz{} took {} seconds)r ProgressTrackertimerstatusPrintformat)messagestart elapsed_times rTimeItrF^s_''$? IIKE 99;&LJJ)00GH @??sBA B8 B B Bc:\rSrSrSrSrSrS SjrSrSr S r g) DiffAccumulatorhz0A module for accumulating DirDiff() differences.cSUlg)Nr_changesselfs r__init__DiffAccumulator.__init__ks DMrcg)Checks if relative_file should be ignored by DirDiff(). Args: relative_file: A relative file path name to be checked. Returns: True if path is to be ignored in the directory differences. Fr)rNr:s rIgnoreDiffAccumulator.Ignoreos rNc.U=RS- slg)aCalled for each file difference. AddChange() can construct the {'add', 'delete', 'edit'} file operations that convert old_dir to match new_dir. Directory differences are ignored. This base implementation counts the number of changes. Args: op: The change operation string; 'add'; relative_file is not in old_dir. 'delete'; relative_file is not in new_dir. 'edit'; relative_file is different in new_dir. relative_file: The old_dir and new_dir relative path name of a file that changed. old_contents: The old file contents. new_contents: The new file contents. Returns: A prune value. If non-zero then DirDiff() returns immediately with that value. NrKrNopr: old_contents new_contentss r AddChangeDiffAccumulator.AddChange{s, MMQM rcUR$)z Returns the accumulated changes.rKrMs r GetChangesDiffAccumulator.GetChangess ==rcg)zCalled for each file for content validation. Args: relative_file: The old_dir and new_dir relative path name of an existing file. contents: The file contents string. Nr)rNr:r*s rValidateDiffAccumulator.Validates rrKNN) rrrrrrOrSr[r^rarrrrrHrHhs8 2 rrHc^^^^[S5 [T5nSSS5 [S5 [T5mSSS5 UUUU4Sjn[R"S5n/nWH>nTR U5(aMUR XG45nUR U5 M@ UHGn U R5nU(dMUuppTRXX5n U (dM<U s sSSS5 $ SSS5 TH@nTR U5(aMUW;dM#TRSU5n U (dM>U s $ g!,(df  GN0=f!,(df  GN#=f!,(df  Ny=f)aCalls diff.AddChange(op, file) on files that changed from old_dir new_dir. diff.AddChange() can construct the {'add', 'delete', 'edit'} file operations that convert old_dir to match new_dir. Directory differences are ignored. Args: old_dir: The old directory path name. new_dir: The new directory path name. diff: A DiffAccumulator instance. Returns: The return value of the first diff.AddChange() call that returns non-zero or None if all diff.AddChange() calls returned zero. zGetDirFilesRecursive new filesNzGetDirFilesRecursive old filesc>[[RRTU55upU(dTR X5 UT;a;[[RRTU55up4XB:XaX1:XagSXU4$SUSU4$)z$Diffs a file in new_dir and old_dir.Neditr4)r,r r!r2ra) r)rZ new_binaryrY old_binarydiffnew_dirold_dir old_filess r _FileDiffDirDiff.._FileDiffs|.rww||GT/JKL  mmD' y!0gt1L!Ml  !l&B T 55 D$ ,,rdelete) rFr;r GetPoolrS ApplyAsyncappendGetr[)rkrjri new_filesrmpoolresultsr)result result_futurerXrYrZprunerls``` @rDirDiffr{s=./$W-I0 ./$W-I0 - -tG T  y'2f nnV  !   "f /5,,rD 5,! d {{4 9nnXt,e   U0///"s5 E E"A!E)E)'E)4E) E E&) E7c@^\rSrSrSrSU4SjjrSrSSjrSrU=r $) HelpAccumulatorzAccumulates help document directory differences. Attributes: _changes: The list of DirDiff() (op, path) difference tuples. _restrict: The set of file path prefixes that the accumulator should be restricted to. c>[[U] 5 /UlU(aHUVs1sH4n[R R URS5SS5iM6 snUlg0Ulgs snf)N.rV) superr}rOrLr sepr2split _restrict)rNrestrictr __class__s rrOHelpAccumulator.__init__s\ /4)+DM!?GGhrvv{{1773<#34hGDN') NGs;A2c[U5(agUR(dgURH1nX:Xd)URU[R-5(dM1 g g)rRTF)r#r startswithr r)rNr:items rrSHelpAccumulator.IgnoresPM""  >>   -":":4"&&="I"I rc<URRX45 g)aGAdds an DirDiff() difference tuple to the list of changes. Args: op: The difference operation, one of {'add', 'delete', 'edit'}. relative_file: The relative path of a file that has changed. old_contents: The old file contents. new_contents: The new file contents. Returns: None which signals DirDiff() to continue. N)rLrsrWs rr[HelpAccumulator.AddChanges MM",- r)rLrNrc) rrrrrrOrSr[r __classcell__)rs@rr}r}s+ $  rr}c<\rSrSrSrS SjrSrS SjrS SjrSr g) HelpUpdateria$Updates the document directory to match the current CLI. Attributes: _cli: The Current CLI. _directory: The help document directory. _generator: The document generator. _hidden: Boolean indicating whether to update hidden commands. _test: Show but do not apply operations if True. c[RRU5(d[SU-5eXlX lX0lXPlX@lg)aYConstructor. Args: cli: The Current CLI. directory: The help document directory. generator: An uninstantiated walker_util document generator. test: Show but do not apply operations if True. hidden: Boolean indicating whether the hidden commands should be used. Raises: HelpUpdateError: If the destination directory does not exist. z,Destination directory [%s] must be absolute.N) r r!isabsr_cli _directory _generator_hidden_test)rNclir5 generatortesthiddens rrOHelpUpdater.__init__sG 77== # #  89 D FFIOOLJrc [R"5n[R"SS9n[ S5 UR UR X#RUS9nSSS5 [R"5nUR5 WRSS9 UR5 [R"5U- n[R"SRU55 [US9n[ S 5 [!UR"X'5 SSS5 [$R&"[(5nS n [ S 5 [+UR-55HfupU S - n UR.(a U [0:a.[R2R5S RX55 XR7U 5 Mh SSS5 UR.(aU (amU [0:a[R2R5S5 [R2R5SRU [8R:"U S555 U sSSS5 $[ S5 SHn XHn [<R>RAUR"U 5n U S;ayU S:Xa<[<R>RCU 5n U (a[RD"U 5 [<R>RAX+5n[FRH"X5 MU S:XdM[<RJ"U 5 M M SSS5 U sSSS5 $!,(df  GN=f!,(df  GN_=f!,(df  GN=f![La GM*f=f!,(df  Na=f!,(df  g=f)zEUpdate() helper method. Returns the number of changed help doc files.zGenerating Help Document Files)labelzCreating walkerrNTrz.Generating Help Document Files took {} secondsDiffingrz Getting diffsrVz{0} {1}z...z{0} help text {1} changedr)zUpdating destination files)r4rfrp)r4rfr4rp)'r%TemporaryDirectoryr ProgressBarrFrr SetProgressr?StartWalkFinishrinforBr}r{r collections defaultdictlistsortedr^rTEST_CHANGES_DISPLAY_MAXr@rArsr Pluralizer r!r2dirnameMakeDirshutilcopyfileremoveOSError)rNrtemp_dirpbwalkerrDrEriopschangesrXr! dest_pathsubdir temp_paths r_UpdateHelpUpdater._Update1s  & & (H  ! !(H Ib # $ IIx(!D %iikehhj kkkiikYY[5(l hh : A A, Oh /d ) 0   # #D )cg / "t01HB Q,'w)AA JJ  Y--b7 8 '..  2 #   0 0 JJ  U # **  6==t~~gv68 9G ) (J . /+Bgd T__d;I_$u3$$V,'',,x6iooi3x )$, 0"m ) ( % $   # ": 0 /K ) (s N/&MBN/9M(/N/?BM:BN/ N/&B:N%N ;N N/ M% N/( M7 2N/: N N/ N NN N N, (N// N=Nc0[RRUR5(d[ SUR-5eUR U5$![ [[4a'n[ S[R"U5-5eSnAff=f)aUpdates the help document directory to match the current CLI. Args: restrict: Restricts the walk to the command/group dotted paths in this list. For example, restrict=['gcloud.alpha.test', 'gcloud.topic'] restricts the walk to the 'gcloud topic' and 'gcloud alpha test' commands/groups. Raises: HelpUpdateError: If the destination directory does not exist. Returns: The number of changed help document files. z8Destination directory [%s] must exist and be searchable.zUpdate failed: %sN) r r!isdirrrrIOErrorr SystemErrorr0r1)rNres rUpdateHelpUpdater.Updateks 77== ) )  D //  D \\( ## Wk *D /#--2BB CCDsAB."BBc([R"5nURURUSUS9nUR SS9 [ US9n[ URX$5 [UR55sSSS5 $!,(df  g=f)zFPrint a list of help text files that are distinct from source, if any.NrTr) r%rrrrr}r{rrr^)rNrrrris r GetDiffFilesHelpUpdater.GetDiffFilessq  & & (H ))Xth8f kkk h /d doox. DOO% & ) ( (s A#B B)rrrrr)FFr) rrrrrrOrrrrrrrrrs,8tD0'rr)#r __future__rrrr contextlibr rr?googlecloudsdk.corerrgooglecloudsdk.core.consolerr googlecloudsdk.core.utilr r%r r r0rrrr#r,r;contextmanagerrFobjectrHr{r}rrrrrs 6&' *#288-)  J   e, &( II8 f8 v9x.o.b{'&{'r