GQp#ddlmZddlmZmZmZmZmZmZddl m Z ejrddl m Z mZejej ej"ej$hZdZdZdZGd d ZgZd ZGd d eZGddeZeGddeZeGddeZeGddeZeGddeZeGddeZ eGddeZ!eGddeZ"eGddeZ#eGd d!eZ$eGd"d#eZ%eGd$d%eZ&eGd&d'eZ'd(ejPvxr<ejPd(jSxrejPd(jUZ+eGd)d*eZ,eGd+d,eZ-d-Z.d.Z/gZ0d/Z1Gd0d1eZ2e1Gd2d3e2Z3e1Gd4d5e2Z4e1Gd6d7e2Z5e1Gd8d9e2Z6d:Z7d;Z8Gd<d=Z9Gd>d?e9Z:d@Z;dAZdDZ?dEZ@dFZAdGZByH)I)_)error localrepopycompat requirementsrevlogutil) compression)ListTypec`tjtjh}||jzSN)rSHARED_REQUIREMENTNARROW_REQUIREMENT)repo preserveds Cusr/lib/python3.12/site-packages/mercurial/upgrade_utils/actions.pypreservedrequirementsr%s.''''I t(( ((s deficiencys optimizationcDeZdZdZdZdZdZdZdZdZ dZ dZ dZ dZ dZdZdZy) improvementzARepresents an improvement that can be made as part of an upgrade.NTF)__name__ __module__ __qualname____doc__typename descriptionupgrademessagedefaultpostupgrademessagepostdowngrademessagetouches_filelogstouches_manifeststouches_changelogtouches_requirementstouches_dirstatecompatible_with_sharerrrr1shK D D KNG   "rrc0tj||Sr)allformatvariantappend)clss rregisterformatvariantr/nsC Jrc4eZdZdZeZedZedZy) formatvariantz6an improvement subclass dedicated to repository formatct)z.current value of the variant in the repositoryNotImplementedErrorrs rfromrepozformatvariant.fromrepox "##rct)z1current value of the variant in the configurationr3r5s r fromconfigzformatvariant.fromconfig}r7rN) rrrrFORMAT_VARIANTr staticmethodr6r9r*rrr1r1ss0@ D$$$$rr1cDeZdZdZdZedZedZedZ y)requirementformatvariantzformatvariant based on a 'requirement' name. Many format variant are controlled by a 'requirement'. We define a small subclass to factor the code. NcTtj|tj|Sr)rnewreporequirementsdefaultcreateopts)uis r_newreporequirementsz-requirementformatvariant._newreporequirementss%,,  ++B/  rcN|jJ|j|jvSr) _requirementrr.rs rr6z!requirementformatvariant.fromrepos++++4#4#444rcl|jJ|j|j|jvSr)rDrBrArEs rr9z#requirementformatvariant.fromconfigs4+++3#;#;DGG#DDDr) rrrrrDr;rB classmethodr6r9r*rrr=r=sJL  55EErr=cLeZdZdZej ZdZedZ edZ y)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 improvedN) rrrrrFNCACHE_REQUIREMENTrDr!rrr r*rrrIrIs7 D33LG 1K  )NrrIcdeZdZdZej ZdZedZ edZ dZ dZ dZ dZdZdZy) 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 fasterTN)rrrrrDIRSTATE_V2_REQUIREMENTrDr!rrr r$r%r&r'r(r)r*rrrLrLsW D77LG ;K45N rrLcdeZdZdZej ZdZedZ edZ dZ dZ dZ dZdZdZy)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 setTN)rrrrrDIRSTATE_TRACKED_HINT_V1rDr!rrr r$r%r&r'r(r)r*rrrOrOsY D88LGOKSN rrOcLeZdZdZej ZdZedZ edZ y) 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 periodN) rrrrrDOTENCODE_REQUIREMENTrDr!rrr r*rrrRrRs7 D55LG (K  ,NrrRcLeZdZdZej ZdZedZ edZ y) 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" fasterN) rrrrrGENERALDELTA_REQUIREMENTrDr!rrr r*rrrUrUs7 D88LG <K NrrUc|eZdZdZej ZdZedZ edZ edZ edZ dZ dZdZdZy) sharesafes 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.sirepository downgraded to not use share safe mode, existing shares will not work and needs 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.FN)rrrrrSHARESAFE_REQUIREMENTrDr!rrr r#r"r$r%r&r'r*rrrXrXsv D55LG #K IN    5rrXcLeZdZdZej ZdZedZ edZ y) sparserevlogs 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.N) rrrrrSPARSEREVLOG_REQUIREMENTrDr!rrr r*rrr[r[6s7 D88LG K ?Nrr[cLeZdZdZej ZdZedZ edZ y)persistentnodemapspersistent-nodemapFs9persist the node -> rev mapping on disk to speedup lookups#Speedup revision lookup by node id.N) rrrrrNODEMAP_REQUIREMENTrDr!rrr r*rrr^r^Ps1 D33LGDK=>Nrr^cTeZdZdZej ZdZedZ edZ dZ dZ y) copiessdcs copies-sdcFs/Stores copies information alongside changesets.sAAllows to use more efficient algorithm to deal with copy tracing.N) rrrrrCOPIESSDC_REQUIREMENTrDr!rrr r$r%r*rrrara_s= D55LGFGKPNrracLeZdZdZej ZdZedZ edZ y)revlogv2s revlog-v2FsVersion 2 of the revlog.svery experimentalN) rrrrrREVLOGV2_REQUIREMENTrDr!rrr r*rrrdrdqs- D44LG/0K+,NrrdcTeZdZdZej ZdZedZ edZ dZ dZ y) changelogv2s changelog-v2Fs7An iteration of the revlog focussed on changelog needs.squite experimentalN) rrrrrCHANGELOGV2_REQUIREMENTrDr!rrr r$r%r*rrrgrgzs9 D77LGNOK,-NrrgcTeZdZdZdZedZedZedZ edZ y)removecldeltachainsplain-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\|j}|jtfd|DS)Nc34K|]}||k(ywrr*).0rev chainbases r z.removecldeltachain.fromrepo..s7BS3)C.(Bs) changelogroall)rclros @rr6zremovecldeltachain.fromrepos(^^LL 7B777rcyNTr*r5s rr9zremovecldeltachain.fromconfigsrN) rrrrr!rrr r;r6r9r*rrrjrjsT DG K 1N 88rrjzstdc^eZdZdZerdZndZedZedZe dZ e dZ y) compressionengine compressionrvzlibsMCompresion algorithm used to compress data. Some engine are faster than others;revlog content will be recompressed with the new algorithm.cd}|jD]4}|j}|ds |ds |jddd}6|S)Nrzsrevlog-compression-sexp-compression--r)r startswithsplit)r.rr reqprefixs rr6zcompressionengine.fromreposP  $$C^^F,-8K1L!iia03 %rc|jjdd}|D]M}|tjvstj|}|j s:|j sK|cSdj |S)Nsformatsrevlog-compression,)rA configlistr compengines available revlogheaderjoin)r.rrcompes rr9zcompressionengine.fromconfigsigg((4IJ Dt'''$$T*;;=Q^^%5K  yy%%rN) rrrr _has_zstdr!rrr rGr6r9r*rrrxrxsZ D -K FN   & &rrxcTeZdZdZdZedZedZedZ edZ y)compressionlevelscompression-leveldefaultscompression levels#revlog content will be recompressedctj|}d}|dk(r|jjdd}n!|dk(r|jjdd}|yt |SNrzsstoragesrevlog.zlib.levelrvsrevlog.zstd.levelr)rxr6rA configintbytesr.rrlevels rr6zcompressionlevel.fromrepose ))$/ 7?GG%%j2FGE W_GG%%j2FGE =U|rctj|}d}|dk(r|jjdd}n!|dk(r|jjdd}|yt |Sr)rxr9rArrrs rr9zcompressionlevel.fromconfigse ++D1 7?GG%%j2FGE W_GG%%j2FGE =U|rN) rrrrr!rrr rGr6r9r*rrrrsH DG()K=>N    rrcfg}tD]%}|j|r|j|'|S)zBreturns a list of format upgrades which can be perform on the repo)r,r6r-)rupgradesfvs rfind_format_upgradesrs2H {{4 OOB  Orcg}tD]{}|jdk(r5|j||j|k7r|j |G|j|sY|j|rk|j |}|S)zvreturns a list of format downgrades which will be performed on the repo because of disabled config option for themry)r,rr6r9r-)r downgradesrs rfind_format_downgradesr s{J 77n ${{4 BMM$$77!!"%  ;;t R]]4%8   b ! rc0tj||Sr)ALL_OPTIMISATIONSr-)objs rregister_optimizationr$sS! JrceZdZdZeZy) optimizationz2an improvement subclass dedicated to optimizationsN)rrrr OPTIMISATIONrr*rrrr)s < Drrc4eZdZdZeZedZedZy)redeltaparentsre-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 neededN rrrrrrrrr r*rrrr/s, D D %K #Nrrc4eZdZdZeZedZedZy)redeltamultibasere-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 significantlyNrr*rrrrEs, D D ) K Nrrc4eZdZdZeZedZedZy) redeltaall 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 timeNrr*rrrr_s, D D 0K Nrrc4eZdZdZeZedZedZy)redeltafulladdre-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 itNrr*rrrrss, D D 0K Nrrc ttS)z8Determine optimisation that could be used during upgrade)listrr5s rfindoptimizationsrs ! ""rcg|D]?}tj|dr |j}nd}|||vr/j|Aj fdt |dDS)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. rDNc3*K|] }|vr| ywrr*)rmo newactionss rrpz,determine_upgrade_actions..s!>A J  >sc|jSrr)xs rz+determine_upgrade_actions..saffrkey)r safehasattrrDr-extendsorted)rformat_upgrades optimizations sourcereqsdestreqsdrrs @rdetermine_upgrade_actionsrsJ    A~ .>>DD  H 4 ! ,<> rceZdZdZdZy) BaseOperationzbase 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) c ||_||_yr)new_requirements backup_store)selfrrs r__init__zBaseOperation.__init__s !1(rN)rrrrrr*rrrrs  )rrceZdZdZfdZedZedZedZedZ edZ edZ ed Z d e fd Zd Zd ZdZdZdZdZdZxZS)UpgradeOperationz/represent the work to be done during an upgradect |||||_||_||_||_||_|j|jz |_|j|jz |_ |j|jz|_ td}|D cgc]} | |jvs| c} |_ |j} tjj|_d| vr tjj"|_nkd| vr tjj$|_nGd| vr tjj$|_n#d| vrtjj&|_d| v|_ycc} w)Nrrrr)superrrAcurrent_requirementsupgrade_actionsremoved_actionsrevlogs_to_processr_added_requirements_removed_requirements_preserved_requirementsrunused_optimizationsupgrade_actions_namesrDELTAREUSEALWAYSdelta_reuse_modeDELTAREUSENEVERDELTAREUSESAMEREVSDELTAREUSEFULLADDforce_re_delta_both_parents) rrArrrrrrall_optimizationsir __class__s rrzUpgradeOperation.__init__sv    $8!.."4  ! !D$=$= =   % %(=(= = "  % %(=(= = $ .d3(% (!AT5I5I,IA(% ! !% : : & > > 3 3$*MM$A$AD ! #8 8$*MM$D$DD ! "&; ;$*MM$D$DD ! $9 9$*MM$C$CD ! "%: : (#% s F2Fcft|jDcgc]}|jc}Scc}wr)setrrras rrz&UpgradeOperation.upgrade_actions_namess+D$8$89$8qAFF$89::9s.c|jxr:|j xr+|j xr|j xr |j Sr)r'r$r%r&r(rs rrequirements_onlyz"UpgradeOperation.requirements_only sZ  % % *))) **** **** *)))  rc|jD]%}|jtk(ry|js%y|jD]}|jsyyNTF)rrrr$rrs rr$z!UpgradeOperation.touches_filelogssP%%Avv%## & %%A!!&rc|jD]%}|jtk(ry|js%y|jD]}|jsyyr)rrrr%rrs rr%z"UpgradeOperation.touches_manifests"P%%Avv%$$ & %%A""&rc|jD]%}|jtk(ry|js%y|jD]}|jsyyr)rrrr&rrs rr&z"UpgradeOperation.touches_changelog/rrc|jD]$}|jtk(r|js$y|jD]}|jsyyru)rrrr'rrs rr'z%UpgradeOperation.touches_requirements<sM%%Avv%'' &%%A%%&rc|jD]$}|jtk(r|js$y|jD]}|jsyyr)rrrr(rrs rr(z!UpgradeOperation.touches_dirstateIsP%%Avv%## & %%A!!&rlabelcd}t|D]>}|s|jjd|jj||d}@y)zK Utility function to aid writing of a list under one label T, )rFN)rrAwrite)rlrfirstrs r_write_labeledzUpgradeOperation._write_labeledWsCA e$ GGMM!5M )E rc|jjtd|jjtd|j|jd|jjd|j r[|jjtd|j|j d|jjd|j r[|jjtd|j|j d|jjd|jjdy) Ns requirements s preserved: s"upgrade-repo.requirement.preserved s removed: s upgrade-repo.requirement.removeds added: supgrade-repo.requirement.added)rArrrrrrrs rprint_requirementsz#UpgradeOperation.print_requirementsbs  a)*+  a)*+   ( (*O   u  % % GGMM!O, -   **,O  GGMM5 "  # # GGMM!M* +   ((*K  GGMM5 "  ercp|jDcgc]}|jtk(s|}}|jd|rj|jj t d|j|Dcgc]}|jc}d|jj dyycc}wcc}w)Nc|jSrr)rs rrz6UpgradeOperation.print_optimisations..{srrsoptimisations: s#upgrade-repo.optimisation.performeds ) rrrsortrArrrr)rr optimisationss rprint_optimisationsz$UpgradeOperation.print_optimisationsws++ +!qvv/EA+   /0  GGMM!./ 0   !./A/6  GGMM' "   0sB.B.6B3c|jD]6}|jjd|j|jfz8yNs %s %s )rrAstatusrr rs rprint_upgrade_actionsz&UpgradeOperation.print_upgrade_actionss7%%A GGNN+qvvq7G7G.HH I&rc0|js|jjdnS|jjdt|jD] }|jjd|z"|jjdy)Nsno revlogs to process sprocessed revlogs: s - %s r)rrArr)rrs rprint_affected_revlogsz'UpgradeOperation.print_affected_revlogssf&& GGMM5 7 GGMM2 4D334 {Q05  urc|jD]?}|jjtd|j|j fzAyr)rrArrrr)rrs rprint_unused_optimizationsz+UpgradeOperation.print_unused_optimizationss:**A GGNN1-.!&&!--1HH I+rc||jvS)zcannot upgrade repository; share repository without share-safes-check :hg:`help config.format.use-share-safe`)hintN) rrrrrrrrrrrY) rrequired missingreqsrblocking blockingreqsm bad_sharehs rcheck_source_requirementsr's**+)$/HT...KEFjj !45 kk# +,,&t,Hd///L N Ozz&"67 kk!l*++ ''4+<+<< H  . .d6G6G G O P > ?kk!!$$rc tjtjtjtjtj tj tjtjtjh }tjD]p}tj|}|js'|js8|jd|z|jdk(s`|jdr|S)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-%srvrevlog-compression-zstd)rr\rbr_rYrerhrrPrMr rrraddrr supportedrengines rsupportremovedrequirementsr/s --**((**)),,))--,, I''((.    &"5"5"7 MM/$6 7{{}' 89 ( rctjtjtjtjtj tj tjtjtjtjtjtjtjtjtjtj h}t"j$D]p}t"j$|}|j's'|j)s8|j+d|z|j-dk(s`|j+dr|S)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. r)rvr*)rrhrbrPrMrSrJrVr_rrerrYr\rTREEMANIFEST_REQUIREMENTrr rrrr+rr,s rsupporteddestrequirementsr2s  ,,**--,,**((--(())))''**--&&--''!I$''((.    &"5"5"7 MM/$6 7{{}' 89 ( rc xtjtjtjtjtj tj tjtjtjtjtjtjh }tjD]p}tj|}|js'|j!s8|j#d|z|j%dk(s`|j#dr|S)aObtain 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. r)rvr*)rrSrJrVr\rbr_rYrrerhrPrMr rrrr+rr,s rallowednewrequirementsr4(s **((----**((**)))),,--,, I''((.    &"5"5"7 MM/$6 7{{}' 89 ( rc,|j}t|jt|}||z |z }|r=td}dj t |}t j||zt|}||z |z }|r=td}dj t |}t j||zt|} || z } | r=td}dj t | } t j|| zy)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) rrr/rrrrrr4r2) rnew_reqsold_reqssupport_removalno_remove_reqsrsupport_addition no_add_reqsr$r-unsupported_reqss rcheck_requirements_changesr=Is  H**+06O(?:NNOF>$:;kk#.//-d3X%(88K O Pjj !45 kk!k/**)$/I)+  !::f-=&>?kk# 0011 rN)Ci18nrrrrrrr utilsr TYPE_CHECKINGtypingr r rVr\rerhRECLONES_REQUIREMENTSrr:rrr,r/r1r=rIrLrOrRrUrXr[r^rardrgrjrrrrrxrrrrrrrrrrrrrrrrrr'r/r2r4r=r*rrrDsL  ))))%%(( ) 7"7"t $K $ E}E6&&!)!!.!1!!,($+4# (# # L+2 ?0 ? ?("-'--*@ t1 !++-1 !..0 )& )&)&X}B , ; \*|2&\*#'T))"U?}U?v  %@6 FB2r