o ﯪg)@sdZddgZddlmZmZddlmZddlmZddl m Z dd l m Z dd l mZmZmZmZdd lmZmZerNdd lmZdd lmZddlmZdedefddZGddde ZGddde ZdS)zcSome ref-based objects. Note the distinction between the :class:`HEAD` and :class:`Head` classes. HEADHead)GitConfigParserSectionConstraint)GitCommandError) join_path) Reference)SymbolicReference)AnySequence TYPE_CHECKINGUnion) Commit_ishPathLike)CommitRemoteReference)RepostringreturncCs$|dr|dr|ddS|S)N"r) startswithendswith)rrI/var/www/html/chatdoc2/venv/lib/python3.10/site-packages/git/refs/head.py strip_quotes s rc seZdZUdZdZdZdZded<efddded d ffd d Z d e fd dZ   dde e e efdedede eeed fded df ddZZS)rzqSpecial case of a :class:`~git.refs.symbolic.SymbolicReference` representing the repository's HEAD reference. ORIG_HEADrrcommitreporpathrNcs.||jkrtd|j|ft||dS)Nz&HEAD instance must point to %r, got %r) _HEAD_NAME ValueErrorsuper__init__)selfr r! __class__rrr%2s z HEAD.__init__cCst|j|jS)z :return: :class:`~git.refs.symbolic.SymbolicReference` pointing at the ORIG_HEAD, which is maintained to contain the previous value of HEAD. )r r _ORIG_HEAD_NAMEr&rrr orig_head7szHEAD.orig_headTFindex working_treepathskwargsc Ks~d}|r d}|r d}|rd}|stdz|jjj||d|fi|W|Sty>}z |jdkr3WYd}~|Sd}~ww)a.Reset our HEAD to the given commit optionally synchronizing the index and working tree. The reference we refer to will be set to commit as well. :param commit: :class:`~git.objects.commit.Commit`, :class:`~git.refs.reference.Reference`, or string identifying a revision we should reset HEAD to. :param index: If ``True``, the index will be set to match the given commit. Otherwise it will not be touched. :param working_tree: If ``True``, the working tree will be forcefully adjusted to match the given commit, possibly overwriting uncommitted changes without warning. If `working_tree` is ``True``, `index` must be ``True`` as well. :param paths: Single path or list of paths relative to the git root directory that are to be reset. This allows to partially reset individual files. :param kwargs: Additional arguments passed to :manpage:`git-reset(1)`. :return: self z--softz--mixedNz--hardz?Cannot reset the working tree if the index is not reset as wellz--r)r#r gitresetrstatus)r&rr,r-r.r/modeerrrr1?s&#  z HEAD.reset)rTFN)__name__ __module__ __qualname____doc__r"r) __slots____annotations__rr%r r+rrstrboolr r r1 __classcell__rrr'rr&s2   c @seZdZdZdZdZdZeddddd d d ed e d df ddZ de dd dfddZ d e dfddZ d$ded ed dfddZd$d ed e d e dfddZded eefddZd eefd d!Zd eefd"d#ZdS)%raA Head is a named reference to a :class:`~git.objects.commit.Commit`. Every Head instance contains a name and a :class:`~git.objects.commit.Commit` object. Examples:: >>> repo = Repo("/path/to/repo") >>> head = repo.heads[0] >>> head.name 'master' >>> head.commit >>> head.commit.hexsha '1c09f116cbc2cb4100fb6935bb162daa4723f455' z refs/headsremotemergeF)forcer rheadszUnion[Head, str]r@r/rNcOs$d}|rd}|jj|g|RdS)zDelete the given heads. :param force: If ``True``, the heads will be deleted even if they are not yet merged into the main development stream. Default ``False``. z-dz-DN)r0branch)clsr r@rAr/flagrrrdeletesz Head.deleteremote_reference)rNcCsddlm}|durt||std||A}|dur7||j||jt| dkr6| n| |j|j | |jt |jWd|SWd|S1s]wY|S)aConfigure this branch to track the given remote reference. This will alter this branch's configuration accordingly. :param remote_reference: The remote reference to track or None to untrack any references. :return: self rrNzIncorrect parameter type: %rr)r>r isinstancer# config_writer remove_optionk_config_remotek_config_remote_reflenoptionsremove_section set_value remote_namer to_full_path remote_head)r&rFrwriterrrrset_tracking_branchs,           zHead.set_tracking_branchcCstddlm}|}||jr8||jr8t|jtt | |j}|t | |j|j }||j|SdS)z :return: The remote reference we are tracking, or ``None`` if we are not a tracking branch. rrN) r>r config_reader has_optionrJrKrr rQr get_valuername)r&rreaderrefremote_refpathrrrtracking_branchs  zHead.tracking_branchnew_pathcCs2d}|rd}|jj|||d|j|f|_|S)aRename self to a new path. :param new_path: Either a simple name or a path, e.g. ``new_name`` or ``features/new_name``. The prefix ``refs/heads`` is implied. :param force: If ``True``, the rename will succeed even if a head with the target name already exists. :return: self :note: Respects the ref log, as git commands are used. z-mz-Mz%s/%s)r r0rB_common_path_defaultr!)r&r]r@rDrrrrenames z Head.rename)rrcKsN||d<|ddur|d|jjj|fi||jjjr#|jjS|jjS)aCheck out this head by setting the HEAD to this reference, by updating the index to reflect the tree we point to and by updating the working tree to reflect the latest index. The command will fail if changed working tree files would be overwritten. :param force: If ``True``, changes to the index and the working tree will be discarded. If ``False``, :exc:`~git.exc.GitCommandError` will be raised in that situation. :param kwargs: Additional keyword arguments to be passed to git checkout, e.g. ``b="new_branch"`` to create a new branch at the given spot. :return: The active branch after the checkout operation, usually self unless a new branch has been created. If there is no active branch, as the HEAD is now detached, the HEAD reference will be returned instead. :note: By default it is only allowed to checkout heads - everything else will leave the HEAD detached which is allowed and possible, but remains a special state that some tools might not be able to handle. fF)popr r0checkouthead is_detached active_branch)r&r@r/rrrrbs   z Head.checkout read_onlycCs*|r|j}n|j}t|d|jS)Nz branch "%s")r rUrHrrX)r&rfparserrrr_config_parsers  zHead._config_parsercC |jddS)z :return: A configuration parser instance constrained to only read this instance's values. Trfrhr*rrrrU  zHead.config_readercCri)z :return: A configuration writer instance with read-and write access to options of this head. Frjrkr*rrrrH(rlzHead.config_writer)F)r5r6r7r8r^rJrK classmethodr<r rErrTr\rr_rbrrrhrUrHrrrrrs& & N)r8__all__ git.configrrgit.excrgit.utilr referencer symbolicr typingr r r r git.typesrr git.objectsrgit.refsrgit.reporr;rrrrrrrs        Z