B Kkd~Cã@s"dZddlmZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl mZmZmZmZmZddlmZerÈddlmZmZmZmZmZmZmZmZmZdd lm Z eee!ee!fZ"d gZ#e $e%¡Z&Gd d „d e'ƒZ(Gd d„de)ƒZ*Gdd„de)ƒZ+e+ƒZ,Gdd„de)ƒZ-dS)z)Handles all VCS (version control) supporté)Úabsolute_importN)Úparse)Ú BadCommand)Ú display_pathÚ backup_dirÚcall_subprocessÚrmtreeÚask_path_exists)ÚMYPY_CHECK_RUNNING) ÚAnyÚDictÚIterableÚListÚMappingÚOptionalÚTextÚTupleÚType)ÚSpinnerInterfaceÚvcsc@s eZdZdS)ÚRemoteNotFoundErrorN)Ú__name__Ú __module__Ú __qualname__©rrú;/tmp/pip-install-gxxfd9b7/pip/pip/_internal/vcs/__init__.pyr src@sFeZdZdZddd„Zdd„Zedd„ƒZd d „Zd d „Z d d„Z dS)Ú RevOptionsz¢ Encapsulates a VCS-specific revision to install, along with any VCS install options. Instances of this class should be treated as if immutable. NcCs"|dkr g}||_||_||_dS)z¢ Args: vcs: a VersionControl object. rev: the name of the revision to install. extra_args: a list of extra options. N)Ú extra_argsÚrevr)ÚselfrrrrrrÚ__init__-s zRevOptions.__init__cCsd |jj|j¡S)Nz)ÚformatrÚnamer)rrrrÚ__repr__<szRevOptions.__repr__cCs|jdkr|jjS|jS)N)rrÚdefault_arg_rev)rrrrÚarg_rev?s zRevOptions.arg_revcCs0g}|j}|dk r"||j |¡7}||j7}|S)z< Return the VCS-specific command arguments. N)r%rÚget_base_rev_argsr)rÚargsrrrrÚto_argsGs  zRevOptions.to_argscCs|js dSd |j¡S)NÚz (to revision {}))rr!)rrrrÚ to_displayTszRevOptions.to_displaycCs|jj||jdS)z• Make a copy of the current instance, but with a new rev. Args: rev: the name of the revision for the new object. )r)rÚmake_rev_optionsr)rrrrrÚmake_new[szRevOptions.make_new)NN) rrrÚ__doc__r r#Úpropertyr%r(r*r,rrrrr$s   rcs~eZdZiZddddddgZ‡fdd„Zd d „Zed d „ƒZed d„ƒZ edd„ƒZ dd„Z ddd„Z dd„Z dd„Z‡ZS)Ú VcsSupportÚsshÚgitÚhgÚbzrÚsftpÚsvncs:tj |j¡ttddƒr(tj |j¡tt|ƒ ¡dS)NÚ uses_fragment) Ú urllib_parseÚ uses_netlocÚextendÚschemesÚgetattrr6Úsuperr/r )r)Ú __class__rrr js zVcsSupport.__init__cCs |j ¡S)N)Ú _registryÚ__iter__)rrrrr?tszVcsSupport.__iter__cCst|j ¡ƒS)N)Úlistr>Úvalues)rrrrÚbackendswszVcsSupport.backendscCsdd„|jDƒS)NcSsg|] }|j‘qSr)Údirname)Ú.0Úbackendrrrú sz'VcsSupport.dirnames..)rB)rrrrÚdirnames|szVcsSupport.dirnamescCs$g}x|jD]}| |j¡q W|S)N)rBr9r:)rr:rErrrÚ all_schemess zVcsSupport.all_schemescCsFt|dƒst d|j¡dS|j|jkrB||j|j<t d|j¡dS)Nr"zCannot register VCS %szRegistered VCS backend: %s)ÚhasattrÚloggerÚwarningrr"r>Údebug)rÚclsrrrÚregister‰s    zVcsSupport.registerNcCs<||jkr|j|=n$||j ¡kr.|j|j=n t d¡dS)Nz0Cannot unregister because no class or name given)r>rAr"rJrK)rrMr"rrrÚ unregister’s    zVcsSupport.unregistercCs6x0|j ¡D]"}| |¡r t d||j¡|Sq WdS)z— Return the type of the version control backend if found at given location, e.g. vcs.get_backend_type('/path/to/vcs/checkout') zDetermine that %s uses VCS: %sN)r>rAÚcontrols_locationrJrLr")rÚlocationÚvc_typerrrÚget_backend_type›s   zVcsSupport.get_backend_typecCs | ¡}||jkr|j|SdS)N)Úlowerr>)rr"rrrÚ get_backend¨s  zVcsSupport.get_backend)NN)rrrr>r:r r?r.rBrGrHrNrOrSrUÚ __classcell__rr)r=rr/fs      r/cseZdZdZdZdZdZdZdZd4‡fdd„ Z dd„Z d5dd „Z e d d „ƒZ d d „Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zdd„Zd d!„Zd"d#„Zd$d%„Ze d&d'„ƒZe d(d)„ƒZe d*d+„ƒZe d6d.d/„ƒZe d0d1„ƒZe d2d3„ƒZ ‡Z!S)7ÚVersionControlr)rNcs||_tt|ƒj||ŽdS)N)Úurlr<rWr )rrXr'Úkwargs)r=rrr ½szVersionControl.__init__cCst‚dS)z™ Return the base revision arguments for a vcs command. Args: rev: the name of a revision to install. Cannot be None. N)ÚNotImplementedError)rrrrrr&Ász VersionControl.get_base_rev_argscCst|||dS)z Return a RevOptions object. Args: rev: the name of a revision to install. extra_args: a list of extra options. )r)r)rrrrrrr+Ês zVersionControl.make_rev_optionscCs&tj |¡\}}| tjj¡p$t|ƒS)zy posix absolute paths start with os.path.sep, win32 ones start with drive (like c:\folder) )ÚosÚpathÚ splitdriveÚ startswithÚsepÚbool)rMÚrepoÚdriveÚtailrrrÚ_is_local_repositoryÕsz#VersionControl._is_local_repositorycCst‚dS)z Export the repository at the url to the destination location i.e. only download the files, without vcs informations N)rZ)rrQrrrÚexportßszVersionControl.exportcCs|dfS)aZ Parse the repository URL's netloc, and return the new netloc to use along with auth information. Args: netloc: the original repository URL netloc. scheme: the repository URL's scheme without the vcs prefix. This is mainly for the Subversion class to override, so that auth information can be provided via the --username and --password options instead of through the URL. For other subclasses like Git without such an option, auth information must stay in the URL. Returns: (netloc, (username, password)). )NNr)rÚnetlocÚschemerrrÚget_netloc_and_authæsz"VersionControl.get_netloc_and_authc Cs„t |¡\}}}}}d|kr*td |¡ƒ‚| dd¡d}| ||¡\}}d}d|krf| dd¡\}}t ||||df¡}|||fS)z¢ Parse the repository URL to use, and return the URL, revision, and auth info to use. Returns: (url, rev, (username, password)). ú+zvSorry, {!r} is a malformed VCS url. The format is +://, e.g. svn+http://myrepo/svn/MyApp#egg=MyAppéNú@r))r7ÚurlsplitÚ ValueErrorr!ÚsplitrhÚrsplitÚ urlunsplit) rrXrgrfr\ÚqueryÚfragÚ user_passrrrrÚget_url_rev_and_authøsz#VersionControl.get_url_rev_and_authcCsgS)zM Return the RevOptions "extra arguments" to use in obtain(). r)rÚusernameÚpasswordrrrÚ make_rev_argsszVersionControl.make_rev_argscCs:| |¡\}}}|\}}| ||¡}|j||d}||fS)zŒ Return the URL and RevOptions object to use in obtain() and in some cases export(), as a tuple (url, rev_options). )r)rtrwr+)rrXrrsrurvrÚ rev_optionsrrrÚget_url_rev_optionss  z"VersionControl.get_url_rev_optionscCst |¡ d¡S)zi Normalize a URL for comparison by unquoting it and removing any trailing slash. ú/)r7ÚunquoteÚrstrip)rrXrrrÚ normalize_url#szVersionControl.normalize_urlcCs| |¡| |¡kS)zV Compare two repo URLs for identity, ignoring incidental differences. )r})rÚurl1Úurl2rrrÚ compare_urls+szVersionControl.compare_urlscCst‚dS)zð Fetch a revision from a repository, in the case that this is the first fetch from the repository. Args: dest: the directory to fetch the repository to. rev_options: a RevOptions object. N)rZ)rÚdestrXrxrrrÚ fetch_new2s zVersionControl.fetch_newcCst‚dS)z} Switch the repo at ``dest`` to point to ``URL``. Args: rev_options: a RevOptions object. N)rZ)rrrXrxrrrÚswitch=szVersionControl.switchcCst‚dS)zŠ Update an already-existing repo to the given ``rev_options``. Args: rev_options: a RevOptions object. N)rZ)rrrXrxrrrÚupdateFszVersionControl.updatecCst‚dS)z¬ Return whether the id of the current commit equals the given name. Args: dest: the repository directory. name: a string name. N)rZ)rrr"rrrÚis_commit_id_equalOsz!VersionControl.is_commit_id_equalc CsÎ| |j¡\}}tj |¡s.| |||¡dS| ¡}| |¡rÒ| |¡}|  ||¡r²t   d|j   ¡t|ƒ|¡| ||j¡s¤t  dt|ƒ|j |¡| |||¡n t  d¡dSt  d|j|j t|ƒ|¡d}nt  d||j|j ¡d}t  d |j|¡td |d |d ƒ}|d kr$t d¡|dkrXt  dt|ƒ¡t|ƒ| |||¡dS|dkršt|ƒ}t  dt|ƒ|¡t ||¡| |||¡dS|dkrÊt  d|j t|ƒ||¡| |||¡dS)zÊ Install or update in editable mode the package represented by this VersionControl object. Args: dest: the repository directory in which to install or update. Nz)%s in %s exists, and has correct URL (%s)zUpdating %s %s%sz$Skipping because already up-to-date.z%s %s in %s exists with URL %s)z%(s)witch, (i)gnore, (w)ipe, (b)ackup )ÚsÚiÚwÚbz0Directory %s already exists, and is not a %s %s.)z(i)gnore, (w)ipe, (b)ackup )r‡rˆr‰z+The plan is to install the %s repository %szWhat to do? %srrjÚaéÿÿÿÿrˆz Deleting %sr‰zBacking up %s to %sr†zSwitching %s %s to %s%s)ryrXr[r\Úexistsr‚r*Úis_repository_directoryÚget_remote_urlr€rJrLÚ repo_nameÚtitlerr…rÚinfor„rKr"r ÚsysÚexitrrÚshutilÚmoverƒ) rrrXrxÚ rev_displayÚ existing_urlÚpromptÚresponseÚdest_dirrrrÚobtainYs|            zVersionControl.obtaincCs"tj |¡rt|ƒ| |¡dS)zq Clean up current location and download the url repository (and vcs infos) into location N)r[r\rŒrr›)rrQrrrÚunpack¶s zVersionControl.unpackcCst‚dS)zê Return a string representing the requirement needed to redownload the files currently present in location, something like: {repository_url}@{revision}#egg={project_name}-{version_identifier} N)rZ)rMrQÚ project_namerrrÚget_src_requirementÀsz"VersionControl.get_src_requirementcCst‚dS)z– Return the url used at location Raises RemoteNotFoundError if the repository does not have a remote url configured. N)rZ)rMrQrrrrŽÊszVersionControl.get_remote_urlcCst‚dS)zR Return the current commit id of the files at the given location. N)rZ)rMrQrrrÚ get_revisionÔszVersionControl.get_revisionTÚraisec Cst|jg|}yt||||||||j|d Stk rn} z(| jtjkr\td|j|jfƒ‚n‚Wdd} ~ XYnXdS)z« Run a VCS subcommand This is simply a wrapper around call_subprocess that adds the VCS command name, and checks that the VCS is available )Ú on_returncodeÚextra_ok_returncodesÚ command_descÚ extra_environÚ unset_environÚspinnerzCCannot find command %r - do you have %r installed and in your PATH?N)r"rr¥ÚOSErrorÚerrnoÚENOENTr) rMÚcmdÚ show_stdoutÚcwdr¡r¢r£r¤r¦ÚerrrÚ run_commandÛs  zVersionControl.run_commandcCs,t d||j|j¡tj tj ||j¡¡S)zL Return whether a directory path is a repository directory. zChecking in %s for %s (%s)...)rJrLrCr"r[r\rŒÚjoin)rMr\rrrrsz&VersionControl.is_repository_directorycCs | |¡S)a6 Check if a location is controlled by the vcs. It is meant to be overridden to implement smarter detection mechanisms for specific vcs. This can do more than is_repository_directory() alone. For example, the Git override checks that Git is actually available. )r)rMrQrrrrP s z VersionControl.controls_location)N)NN)TNr NNNN)"rrrr"rCrr:r¥r$r r&r+Ú classmethodrdrerhrtrwryr}r€r‚rƒr„r…r›rœržrŽrŸr®rrPrVrr)r=rrW³sH      ]   rW).r-Ú __future__rr¨Úloggingr[r”r’Úpip._vendor.six.moves.urllibrr7Úpip._internal.exceptionsrÚpip._internal.utils.miscrrrrr Úpip._internal.utils.typingr Útypingr r r rrrrrrÚpip._internal.utils.uirÚstrZAuthInfoÚ__all__Ú getLoggerrrJÚ ExceptionrÚobjectrr/rrWrrrrÚs*    ,  BJ