6hg%SSKJr SSKrSSKJrJr SSKJr SSKJ r J r J r J r J r SSKJr \\/(de\ R \ R"\ R$\ R&1rSrS rS r"S S 5r/rS \S'Sr"SS\5r"SS\5r\"SS\55r\"SS\55r\"SS\55r \"SS\55r!\"SS\55r"\"SS\55r#\"S S!\55r$\"S"S#\55r%\"S$S%\55r&\"S&S'\55r'\"S(S)\55r(\"S*S+\55r)S,\ RT;=(aA \ RTS,RW5=(a \ RTS,RY5r-\"S-S.\55r.\"S/S0\55r/S1r0S2r1/r2S3r3"S4S5\5r4\3"S6S7\455r5\3"S8S9\455r6\3"S:S;\455r7\3"S<S=\455r8S>r9S?r:"S@SA5r;"SBSC\;5rSFr?SGr@SHrASIrBSJrCSKrDg)L) annotationsN)ListType)_)error localrepo requirementsrevlogutil) compressionc^[R[R1nXR-$N)r SHARED_REQUIREMENTNARROW_REQUIREMENT)repo preserveds A/usr/lib/python3/dist-packages/mercurial/upgrade_utils/actions.pypreservedrequirementsr+s,''''I (( ((s deficiencys optimizationcL\rSrSrSrSrSrSrSrSr Sr Sr Sr Sr SrSrSrSrSrg) improvement7zARepresents an improvement that can be made as part of an upgrade.NTF)__name__ __module__ __qualname____firstlineno____doc__typename descriptionupgrademessagedefaultpostupgrademessagepostdowngrademessagetouches_filelogstouches_manifeststouches_changelogtouches_requirementstouches_dirstatecompatible_with_share__static_attributes__rrrrr7shK D D KNG   "rrzList[Type[formatvariant]]allformatvariantc0[RU5 U$r)r.append)clss rregisterformatvariantr2tsC Jrc<\rSrSrSr\r\S5r\S5r Sr g) formatvariantyz6an improvement subclass dedicated to repository formatc[5e)z.current value of the variant in the repositoryNotImplementedErrorrs rfromrepoformatvariant.fromrepo~ "##rc[5e)z1current value of the variant in the configurationr7r9s r fromconfigformatvariant.fromconfigr<rrN) rrrrrFORMAT_VARIANTr staticmethodr:r>r-rrrr4r4ys0@ D$$$$rr4cL\rSrSrSrSr\S5r\S5r \S5r Sr g)requirementformatvariantzformatvariant based on a 'requirement' name. Many format variant are controlled by a 'requirement'. We define a small subclass to factor the code. NcX[R"U[R"U55$r)r newreporequirementsdefaultcreateopts)uis r_newreporequirements-requirementformatvariant._newreporequirementss%,,  ++B/  rcRURceURUR;$r) _requirementr r1rs rr:!requirementformatvariant.fromrepos++++4#4#444rcpURceURURUR5;$r)rLrIrHrMs rr>#requirementformatvariant.fromconfigs4+++3#;#;DGG#DDDrr) rrrrrrLrArI classmethodr:r>r-rrrrCrCsJL  55EErrCcT\rSrSrSr\R rSr\ "S5r \ "S5r Sr g)fncachesfncacheTsYlong and reserved filenames may not work correctly; repository performance is sub-optimalssrepository will be more resilient to storing certain paths and performance of certain operations should be improvedrN) rrrrr!r FNCACHE_REQUIREMENTrLr$rr"r#r-rrrrSrSs7 D33LG 1K  )NrrScl\rSrSrSr\R rSr\ "S5r \ "S5r Sr Sr SrSrSrSrSrg) dirstatev2s dirstate-v2Fsversion 1 of the dirstate file format requires reading and parsing it all at once. Version 2 has a better structure,better information and lighter update mechanisms"hg status" will be fasterTrN)rrrrr!r DIRSTATE_V2_REQUIREMENTrLr$rr"r#r'r(r)r*r+r,r-rrrrWrWsW D77LG ;K45N rrWcl\rSrSrSr\R rSr\ "S5r \ "S5r Sr Sr SrSrSrSrSrg) dirstatetrackedkeys tracked-hintFsDAdd a small file to help external tooling that watch the tracked setsHexternal tools will be informated of potential change in the tracked setTrN)rrrrr!r DIRSTATE_TRACKED_HINT_V1rLr$rr"r#r'r(r)r*r+r,r-rrrr[r[sY D88LGOKSN rr[cT\rSrSrSr\R rSr\ "S5r \ "S5r Sr g) dotencodes dotencodeTsLstorage of filenames beginning with a period or space may not work correctlysNrepository will be better able to store files beginning with a space or periodrN) rrrrr!r DOTENCODE_REQUIREMENTrLr$rr"r#r-rrrr_r_s7 D55LG (K  ,Nrr_cT\rSrSrSr\R rSr\ "S5r \ "S5r Sr g) generaldeltas generaldeltaTsdeltas within internal storage are unable to choose optimal revisions; repository is larger and slower than it could be; interaction with other repositories may require extra network and CPU resources, making "hg push" and "hg pull" slowersrepository storage will be able to create optimal deltas; new repository data will be smaller and read times should decrease; interacting with other repositories using this storage model should require less network and CPU resources, making "hg push" and "hg pull" fasterrN) rrrrr!r GENERALDELTA_REQUIREMENTrLr$rr"r#r-rrrrcrcs7 D88LG <K Nrrcc\rSrSrSr\R rSr\ "S5r \ "S5r \ "S5r \ "S5r SrSrSrSrS rg ) sharesafeis share-safeTsold shared repositories do not share source repository requirements and config. This leads to various problems when the source repository format is upgraded or some new extensions are enabled.swUpgrades a repository to share-safe format so that future shares of this repository share its requirements and configs.shrepository downgraded to not use share safe mode, existing shares will not work and need to be reshared.srepository upgraded to share safe mode, existing shares will still work in old non-safe mode. Re-share existing shares to use them in safe mode New shares will be created in safe mode.FrN)rrrrr!r SHARESAFE_REQUIREMENTrLr$rr"r#r&r%r'r(r)r*r-rrrrgrgsw D55LG #K IN  B  5rrgcT\rSrSrSr\R rSr\ "S5r \ "S5r Sr g) sparserevlogi;s sparserevlogTsXin order to limit disk reading and memory usage on older version, the span of a delta chain from its root to its end is limited, whatever the relevant data in this span. This can severly limit Mercurial ability to build good chain of delta resulting is much more storage space being taken and limit reusability of on disk delta during exchange.sRevlog supports delta chain with more unused data between payload. These gaps will be skipped at read time. This allows for better delta chains, making a better compression and faster exchange with server.rN) rrrrr!r SPARSEREVLOG_REQUIREMENTrLr$rr"r#r-rrrrjrj;s7 D88LG K ?NrrjcT\rSrSrSr\R rSr\ "S5r \ "S5r Sr g)persistentnodemapiUspersistent-nodemapFs9persist the node -> rev mapping on disk to speedup lookups#Speedup revision lookup by node id.rN) rrrrr!r NODEMAP_REQUIREMENTrLr$rr"r#r-rrrrmrmUs1 D33LGDK=>Nrrmc\\rSrSrSr\R rSr\ "S5r \ "S5r Sr Sr Srg) copiessdcids copies-sdcFs/Stores copies information alongside changesets.sAAllows to use more efficient algorithm to deal with copy tracing.rN)rrrrr!r COPIESSDC_REQUIREMENTrLr$rr"r#r'r(r-rrrrprpds= D55LGFGKLNrrpcT\rSrSrSr\R rSr\ "S5r \ "S5r Sr g)revlogv2ivs revlog-v2FsVersion 2 of the revlog.svery experimentalrN) rrrrr!r REVLOGV2_REQUIREMENTrLr$rr"r#r-rrrrsrsvs- D44LG/0K+,Nrrsc\\rSrSrSr\R rSr\ "S5r \ "S5r Sr Sr Srg) changelogv2is changelog-v2Fs7An iteration of the revlog focussed on changelog needs.squite experimentalrN)rrrrr!r CHANGELOGV2_REQUIREMENTrLr$rr"r#r'r(r-rrrrvrvs9 D77LGNOK,-Nrrvc\\rSrSrSrSr\"S5r\"S5r\ S5r \ S5r Sr g ) removecldeltachainisplain-cl-deltaTschangelog storage is using deltas instead of raw entries; changelog reading and any operation relying on changelog data are slower than they could beszchangelog storage will be reformated to store raw entries; changelog reading will be faster; changelog size may be reducedc F^UR5Rn[U5S::a [U5nOF[ [ S5Vs1sH&n[ R"S[U5S- 5iM( sn5nURm[U4SjU55$s snf)Nirc38># UHoT"U5:Hv M g7frr).0rev chainbases r .removecldeltachain.fromrepo..s=HS)C.(Hs) unfiltered changeloglenlistsortedrangerandomrandintrall)rclsome_revxrs @rr:removecldeltachain.fromrepos__  ( ( r7d?BxH9>tEA3r7Q;/EHLL =H===Fs -BcgNTrr9s rr>removecldeltachain.fromconfigsrrN) rrrrr!r$rr"r#rAr:r>r-rrrryrysT DG K 1N  > >rryzstdcp\rSrSrSr\(aSrOSr\"S5r\"S5r \ S5r \ S5r S r g ) compressionenginei compressionrzlibsMCompresion algorithm used to compress data. Some engine are faster than others;revlog content will be recompressed with the new algorithm.cSnURH@nURnU"S5(dU"S5(dM+URSS5SnMB U$)Nrsrevlog-compression-sexp-compression--r)r startswithsplit)r1rr reqprefixs rr:compressionengine.fromreposV  $$C^^F,--8K1L1L!iia03 %rc URRSS5nUH\nU[R;dM[RUnUR 5(dMCUR 5(dMZUs $ SR U5$)Nsformatsrevlog-compression,)rH configlistr compengines available revlogheaderjoin)r1rrcompes rr>compressionengine.fromconfigsngg((4IJ Dt'''$$T*;;==Q^^%5%5K  yy%%rrN)rrrrr! _has_zstdr$rr"r#rQr:r>r-rrrrrsZ D -K FN   & &rrc\\rSrSrSrSr\"S5r\"S5r\ S5r \ S5r Sr g ) compressionleveliscompression-leveldefaultscompression levels#revlog content will be recompressedc[RU5nSnUS:XaURRSS5nO"US:XaURRSS5nUcgSU-$Nrsstoragesrevlog.zlib.levelrsrevlog.zstd.levelrs%d)rr:rH configintr1rrlevels rr:compressionlevel.fromrepose ))$/ 7?GG%%j2FGE W_GG%%j2FGE =u}rc[RU5nSnUS:XaURRSS5nO"US:XaURRSS5nUcgSU-$r)rr>rHrrs rr>compressionlevel.fromconfigse ++D1 7?GG%%j2FGE W_GG%%j2FGE =u}rrN) rrrrr!r$rr"r#rQr:r>r-rrrrrsH DG()K=>N    rrcv/n[H,nURU5(aMURU5 M. U$)zBreturns a list of format upgrades which can be perform on the repo)r.r:r0)rupgradesfvs rfind_format_upgradesr s5H {{4  OOB  Orc4/n[HnURS:Xa7URU5URU5:waUR U5 MJURU5(dMbURU5(aMzUR U5 M U$)zrreturns a list of format downgrades which will be performed on the repo because of disabled config option for themr)r.r!r:r>r0)r downgradesrs rfind_format_downgradesrsJ 77n ${{4 BMM$$77!!"%  ;;t  R]]4%8%8   b ! rc0[RU5 U$r)ALL_OPTIMISATIONSr0)objs rregister_optimizationr1sS! Jrc\rSrSrSr\rSrg) optimizationi6z2an improvement subclass dedicated to optimizationsrN)rrrrr OPTIMISATIONr r-rrrrr6s < Drrc<\rSrSrSr\r\"S5r\"S5r Sr g)redeltaparentsi<re-delta-parents]deltas within internal storage will be recalculated to choose an optimal base revision where this was not already done; the size of the repository may shrink and various operations may become faster; the first time this optimization is performed could slow down upgrade execution considerably; subsequent invocations should not run noticeably slowersHdeltas within internal storage will choose a new base revision if neededrN rrrrr!rr rr"r#r-rrrrr<s, D D %K #Nrrc<\rSrSrSr\r\"S5r\"S5r Sr g)redeltamultibaseiRre-delta-multibasesdeltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of mergessdeltas within internal storage will choose an optimal delta by computing deltas against multiple parents; may slow down execution time significantlyrNrrrrrrRs, D D ) K Nrrc<\rSrSrSr\r\"S5r\"S5r Sr g) redeltaallil re-delta-allsdeltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not neededsndeltas within internal storage will be fully recomputed; this will likely drastically slow down execution timerNrrrrrrls, D D 0K Nrrc<\rSrSrSr\r\"S5r\"S5r Sr g)redeltafulladdire-delta-fulladdsevery revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.seach revision will be added as new content to the internal storage; this will likely drastically slow down execution time, but some extensions might need itrNrrrrrrs, D D 0K Nrrc [[5$)z8Determine optimisation that could be used during upgrade)rrr9s rfindoptimizationsrs ! ""rc^/mUH>n[US5(a URnOSnUbXd;aM-TRU5 M@ TRU4Sj[ USS955 T$)aDetermine upgrade actions that will be performed. Given a list of improvements as returned by ``find_format_upgrades`` and ``findoptimizations``, determine the list of upgrade actions that will be performed. The role of this function is to filter improvements if needed, apply recommended optimizations from the improvements list that make sense, etc. Returns a list of action names. rLNc38># UHnUT;dM Uv M g7frr)r}o newactionss rr,determine_upgrade_actions..s">A J  >s  cUR$rr!)rs r+determine_upgrade_actions..saffrkey)hasattrrLr0extendr)rformat_upgrades optimizations sourcereqsdestreqsdr!rs @rdetermine_upgrade_actionsrszJ  1n % %>>DD   4 ! ,<> rc\rSrSrSrSrSrg) BaseOperationizbase class that contains the minimum for an upgrade to work (this might need to be extended as the usage for subclass alternative to UpgradeOperation extends) cXlX lgr)new_requirements backup_store)selfrrs r__init__BaseOperation.__init__s !1(r)rrN)rrrrrrr-rrrrrs  )rrc^\rSrSrSrU4Sjr\S5r\S5r\S5r \S5r \S5r \S 5r \S 5r SS jrS rS rSrSrSrSrSrSrU=r$)UpgradeOperationiz/represent the work to be done during an upgradec >[T U]UU5 XlX0lX@lXPlX`lURUR- UlURUR- Ul URUR-Ul [S5nUV s/sHoUR;dMU PM sn Ul URn [RRUlSU ;a [RR"UlOqSU ;a [RR$UlOKSU ;a [RR$UlO%SU ;a[RR&UlSU ;Ulgs sn f)Nrrrr)superrrHcurrent_requirementsupgrade_actionsremoved_actionsrevlogs_to_processr_added_requirements_removed_requirements_preserved_requirementsrunused_optimizationsupgrade_actions_namesr DELTAREUSEALWAYSdelta_reuse_modeDELTAREUSENEVERDELTAREUSESAMEREVSDELTAREUSEFULLADDforce_re_delta_both_parents) rrHrrrrrrall_optimizationsir __class__s rrUpgradeOperation.__init__sj    $8!.."4  ! !D$=$= =   % %(=(= = "  % %(=(= = $ .d3(% (!T5I5I,IA(% ! !% : : & > > 3 3$*MM$A$AD ! #8 8$*MM$D$DD ! "&; ;$*MM$D$DD ! $9 9$*MM$C$CD ! "%: : (#% s F 0F cXURVs1sHoRiM sn$s snfr)rr!ras rr&UpgradeOperation.upgrade_actions_namess$ $ 4 45 41 4555s'cUR=(aY UR(+=(aA UR(+=(a) UR(+=(a UR(+$r)r*r'r(r)r+rs rrequirements_only"UpgradeOperation.requirements_onlysZ  % % *))) **** **** *)))  rcURH,nUR[:Xa gUR(dM, g URHnUR(dM g gNTF)rr rr'rrs rr'!UpgradeOperation.touches_filelogs"sV%%Avv%### & %%A!!!&rcURH,nUR[:Xa gUR(dM, g URHnUR(dM g gr )rr rr(rrs rr("UpgradeOperation.touches_manifests/V%%Avv%$$$ & %%A"""&rcURH,nUR[:Xa gUR(dM, g URHnUR(dM g gr )rr rr)rrs rr)"UpgradeOperation.touches_changelog<rrcURH,nUR[:XaMUR(dM, g URHnUR(dM g gr)rr rr*rrs rr*%UpgradeOperation.touches_requirementsIsS%%Avv%''' &%%A%%%&rcURH,nUR[:XaMUR(dM, g URHnUR(dM g gr )rr rr+rrs rr+!UpgradeOperation.touches_dirstateVsV%%Avv%### & %%A!!!&rcSn[U5H@nU(dURRS5 URRXBS9 SnMB g)z; Utility function to aid writing of a list under one label T, )labelFN)rrHwrite)rlrfirstrs r_write_labeledUpgradeOperation._write_labeleddsAA e$ GGMM!M )E rcURR[S55 URR[S55 URURS5 URR S5 UR (a[URR[S55 URUR S5 URR S5 UR(a[URR[S55 URURS5 URR S5 URRS5 g) Ns requirements s preserved: s"upgrade-repo.requirement.preserved s removed: s upgrade-repo.requirement.removeds added: supgrade-repo.requirement.added)rHrrrr writenoi18nrrrs rprint_requirements#UpgradeOperation.print_requirementsos  a)*+  a)*+   ( (*O  E"  % % GGMM!O, -   **,O  GG   &  # # GGMM!M* +   ((*K  GG   &  ercURVs/sHoR[:XdMUPM nnURSS9 U(alURR [ S55 URUVs/sHoRPM snS5 URR S5 ggs snfs snf)NcUR$rr)rs rr6UpgradeOperation.print_optimisations..srrsoptimisations: s#upgrade-repo.optimisation.performeds ) rr rsortrHrrrr!)rr optimisationss rprint_optimisations$UpgradeOperation.print_optimisationss++ +!vv/EA+   /0  GGMM!./ 0   !./A/6  GGMM' "   0sB6B6<B;cURH7nURRSURUR4-5 M9 gNs %s %s )rrHstatusr!r#rs rprint_upgrade_actions&UpgradeOperation.print_upgrade_actionss7%%A GGNN+qvvq7G7G.HH I&rc>UR(dURRS5 OUURRS5 [UR5H!nURRSU-5 M# URRS5 g)Nsno revlogs to process sprocessed revlogs: s - %s r!)rrHr"r)rrs rprint_affected_revlogs'UpgradeOperation.print_affected_revlogssn&& GG   : ; GG   7 8D334##K!O45 E"rcURH@nURR[S5URUR 4-5 MB gr-)rrHr.rr!r")rrs rprint_unused_optimizations+UpgradeOperation.print_unused_optimizationss:**A GGNN1-.!&&!--1HH I+rcXR;$)zcannot upgrade repository; share repository without share-safes-check :hg:`help config.format.use-share-safe`)hintN) rMr rCrrrrrIrErrh) rrequired missingreqsrLblocking blockingreqsm bad_sharehs rcheck_source_requirementsrWs **+)$/H...KEFjj !45 kk#+,,&t,H///L N Ozz&"67 kk!*++ ''4+<+<< H  . .d6G6G G O P > ?kk!$$rc >[R[R[R[R[R [R [R[R[R1 n[RHn[RUnUR5(dM-UR5(dMDURSU-5 UR5S:XdMnURS5 M U$)zObtain requirements that can be removed during an upgrade. If an upgrade were to create a repository that dropped a requirement, the dropped requirement must appear in the returned set for the upgrade to be allowed. exp-compression-%srrevlog-compression-zstd)r rkrqrnrhrtrwrGr]rYr rrraddr!r supportedr!engines rsupportremovedrequirementsr_s --**((**)),,))--,, I''((.     &"5"5"7"7 MM/$6 7{{}' 89 ( rc[R[R[R[R[R [R [R[R[R[R[R[R[R[R[R[R 1n["R$Hn["R$UnUR'5(dM-UR)5(dMDUR+SU-5 UR-5S:XdMnUR+S5 M U$)zObtain requirements that upgrade supports in the destination. If the result of the upgrade would have requirements not in this set, the upgrade is disallowed. Extensions should monkeypatch this to add their custom requirements. rYrrZ)r rwrqr]rYrarUrernrGrtrrhrkrBTREEMANIFEST_REQUIREMENTrr rrrr[r!r\s rsupporteddestrequirementsrbs ,,**--,,**((--(())))''**--&&--''!I$''((.     &"5"5"7"7 MM/$6 7{{}' 89 ( rc [R[R[R[R[R [R [R[R[R[R[R[R1 n[RHn[RUnUR5(dM-UR!5(dMDUR#SU-5 UR%5S:XdMnUR#S5 M U$)awObtain requirements that can be added to a repository during upgrade. This is used to disallow proposed requirements from being added when they weren't present before. We use a list of allowed requirement additions instead of a list of known bad additions because the whitelist approach is safer and will prevent future, unknown requirements from accidentally being added. rYrrZ)r rarUrerkrqrnrhrGrtrwr]rYr rrrr[r!r\s rallowednewrequirementsrd5s **((----**((**)))),,--,, I''((.     &"5"5"7"7 MM/$6 7{{}' 89 ( rcDURn[UR5 [U5nX!- U- nU(a=[S5nSR [ U55n[ R"XT-5e[U5nX- U- nU(a=[S5nSR [ U55n[ R"X-5e[U5n X- n U (a=[S5nSR [ U 55n [ R"XZ-5eg)Ns;cannot upgrade repository; requirement would be removed: %srs>cannot upgrade repository; do not support adding requirement: sEcannot upgrade repository; do not support destination requirement: %s) r rMr_rrrrrIrdrb) rnew_reqsold_reqssupport_removalno_remove_reqsrLsupport_addition no_add_reqsrTr]unsupported_reqss rcheck_requirements_changesrmVs  H**+06O(?:NNOF>$:;kk#.//-d3%(88K O Pjj !45 kk!/**)$/I+  !::f-=&>?kk#011 r)E __future__rrtypingrri18nrrr r r r utilsr rerkrtrwRECLONES_REQUIREMENTSrr@rrr.__annotations__r2r4rCrSrWr[r_rcrgrjrmrprsrvryrrrrrrrrrrrrrrrrrrrrCrErMrWr_rbrdrmrrrrush#    ))))%%(( ) 7"7"t/1+0 $K $ E}E6&&!)!!.!1!!,($+4" (" " J+2 ?0 ? ?("-'--*$$$P t1 !++-1 !..0 )& )&)&X}B , ; \*|2&\*#'T))"U?}U?v  %@6 FB2r