q&fC"dZddlZddlmZddlmZmZmZmZm Z ddl m Z iZ e je Z e ddd d ed fdd d ed fdddedfdddedfdddedfdddedfgedd d dZy)a'chainsaw is a collection of single-minded and dangerous tools. (EXPERIMENTAL) "Don't use a chainsaw to cut your food!" The chainsaw is a collection of commands that are so much geared towards a specific use case in a specific context or environment that they are totally inappropriate and **really dangerous** in other contexts. The help text of each command explicitly summarizes its context of application and the wanted end result. It is recommended to run these commands with the ``HGPLAIN`` environment variable (see :hg:`help scripting`). N)_)cmdutilcommandserror localrepo registrar)urlutilsadmin::chainsaw-updates purge-unknownTsxRemove unversioned files before update. Disabling this can in some cases interfere with the update.See also :hg:`purge`.s purge-ignoreds|Remove ignored files before update. Disable this for instance to reuse previous compiler object files. See also :hg:`purge`.srevsrevision to update tossourcesrepository to clone fromsdests.repository to update to REV (possibly cloning)sinitial-clone-minimalFsPull only the prescribed revision upon initial cloning. This has the side effect of ignoring clone-bundles, which if often slower on the client side and stressful to the server than applying available clone bundles.sHhg admin::chainsaw-update [OPTION] --rev REV --source SOURCE --dest DEST) helpbasicnorepoc 0|d}|d}|d}|stjtd|stjtd|stjtdtj|} t j ||d}d}|jtd |z|jjdr|jtd|jjdr|jtd|j5|j!5|jtd|j#|jtd|z|r|j%dsg}n|g}dd i}|j&j)|d5t+j,dt.j0dd} | |j&|||d} | r| cdddcdddcdddS dddt+j,dt.j0dd} | ||d |j%d|j%dd} | r| cdddcdddS|jtd |zt+j,d!t.j0dd} | |||d "} | r| cdddcdddS|jtd#||j2fzddddddy#tj$r tj||jtd |zn,#t$r |jtd |zYnwxYw|jtd |zt j ||d }d }Y2wxYw#1swYxYw#1swYxYw#1swYyxYw)$apull and update to a given revision, no matter what, (EXPERIMENTAL) Context of application: *some* Continuous Integration (CI) systems, packaging or deployment tools. Wanted end result: local repository at the given REPO_PATH, having the latest changes to the given revision and with a clean working directory updated at the given revision. chainsaw-update pulls from one source, then updates the working directory to the given revision, overcoming anything that would stand in the way. By default, it will: - clone if the local repo does not exist yet, **removing any directory at the given path** that would not be a Mercurial repository. The initial clone is full by default, so that clonebundles can be applied. Use the --initial-clone-minimal flag to avoid this. - break locks if needed, leading to possible corruption if there is a concurrent write access. - perform recovery actions if needed - revert any local modification. - purge unknown and ignored files. - go as far as to reclone if everything else failed (not implemented yet). DO NOT use it for anything else than performing a series of unattended updates, with full exclusive repository access each time and without any other local work than running build scripts. In case the local repository is a share (see :hg:`help share`), exclusive write access to the share source is also mandatory. It is recommended to run these commands with the ``HGPLAIN`` environment variable (see :hg:`scripting`). Motivation: in Continuous Integration and Delivery systems (CI/CD), the occasional remnant or bogus lock are common sources of waste of time (both working time and calendar time). CI/CD scripts tend to grow with counter- measures, often done in urgency. Also, whilst it is neat to keep repositories from one job to the next (especially with large repositories), an exceptional recloning is better than missing a release deadline. revsourcedests$specify a target revision with --revs!specify a pull path with --sourcesspecify a repo path with --destF)createsloaded repository at "%s" s0removed non-repository file or directory at "%s"sno such directory: "%s" screating repository at "%s" Tslockshad to break store lock swlockshad to break working copy lock s1recovering after interrupted transaction, if any spulling from %s initial_clone_minimal)suisquietschainsaw-updatespullr)r remote_hiddenNspurge purge_ignored purge_unknown)dirsallfilesconfirmsupdating to revision '%s' supdate)rcleans=chainsaw-update to revision '%s' for repository at '%s' done )r InputErrorrr urllocalpathrinstancestatus RepoErrorshutilrmtreeFileNotFoundErrorsvfs tryunlinkvfswlocklockrecovergetuiconfigoverriderfindcmdrtableroot) r,optsrr repo_pathrepo repo_created pull_revs overridespullretpurgeupdates :/usr/lib/python3/dist-packages/mercurial/admin/chainsaw.pyr:r:(sL u+C (^FV I q!HIJJ q!EFGG q!CDEE$$Y/I!!"i>  !2Y>?@$ yy7# !012 xx(# !789 . tyy{.  !IJK  !()F23 )@ AII&- WW # #I/A B ??7HNN;A>qAD# C  . . . & (..9!qAR3d3 M. . . P 3 DII   Q. . . / ??  MM) $ II!*+ ! C IIa4y@A B C !4y@AB!!"i= B  . . . . s7M7P BP AO3 P P +A!P P AP5 P )P1P O0N +O0 &N2/O01N22:O0/O03O= 8PP P  P)__doc__r"i18nrrrrrr utilsr cmdtablecommandr:r r;rCs   )  H %     )      )      & '      ) *      ? @    $  H  O2fS s:v w:v r