U 楡c@sUddlmZddlmZddlmZddlZddlm Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlmZddlZddlmZmZddlZddlmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+ddl,Z,e*r8dd l-m.Z.dd l/m0Z0dd l1m2Z2m3Z3dd l4m5Z5dd l6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?e'de(dddZ@ddlAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJdddddddddddddd d!d"d#d$gZKe LeMZNeoe jOPd$dZQeoe jOPd%dZRe'd&ZSed'eSfed'eSfd(d)d#ZTejUe;ee;ddfd*d+d,ZVe;dd-d.d"ZWe;dd-d/d0ZXdyeeeYeYd2d3dZZe;e;e;d4d5dZ[ere;e;d-d6d7Z\e;e]d-d8dZ^eK_d7e\Z`ne;e]d-d9dZ^e^Z`e;e;e;d4d:dZadze;ebebd<d=dZce%e]d>d?d@Zdd{e]e#e;e"e]dAdBdCZee#e]e]e]dDdEdFZfegdGdHdId;fegdJefd;fegdKefd;fegdLejhdMdIdfegdNdOdId;ffZie&e&e$e]eebfd'fejdP<e]e]d-dQdRZkegdSZle;e]d-dTdUZmiZnee]e#ebfejdV<e+de7d;dWdXdYZoe+e;ebdWdZdYZoe(de;febdWd[dYZoe]d>d\dZpe(ejqd]fedd^d_d`Zre+d|debddadbdcZse+d}e;ebe]dadddcZsd~e(de;febe#e;dadedcZse%e]e"e]dfdgdhZtGdid d euZvGdjd!d!evZwGdkddeuZxGdlddeuZyGdmddeuZzGdnddeuZ{Gdodde{Z|Gdpdde"e@Z}Gdqdrdre~ZGdsdtdteduZe:Gdvdde9ZGdwdxdxe jZdS))abstractmethodN)is_win)wraps)maxsize)urlsplit urlunsplit)AnyAnyStrBinaryIOCallableDict GeneratorIOIteratorListOptionalPatternSequenceTupleTypeVarUnioncast TYPE_CHECKINGoverload)Remote)Repo)GitConfigParserSectionConstraint)Git) Literal SupportsIndexProtocolruntime_checkablePathLikeHSH_TDTotal_TDFiles_TDHas_id_attribute T_IterableObj) IterableObjr(T)bound covariant) make_shaLockedFDfile_contents_rofile_contents_ro_filepath LazyMixin to_hex_sha to_bin_sha bin_to_hex hex_to_bin stream_copy join_pathto_native_path_linuxjoin_path_nativeStatsIndexFileSHA1Writerr* IterableListBlockingLockFileLockFileActor get_user_idassure_directory_existsRemoteProgressCallableRemoteProgressrmtree unbare_repoHIDE_WINDOWS_KNOWN_ERRORSHIDE_WINDOWS_FREEZE_ERRORST.)funcreturncs2ddlmtdtttdfdd }|S)zcMethods with this decorator raise InvalidGitRepositoryError if they encounter a bare repositoryr)InvalidGitRepositoryErrorr)selfargskwargsrJcs&|jjrdj|f||S)Nz/Method '%s' cannot operate on bare repositories)repoZbare__name__rLrMrNrKrI,/tmp/pip-unpacked-wheel-_pbxsds5/git/util.pywrapperszunbare_repo..wrapper)excrKrr rH)rIrUrSrRrTrEs )new_dirrJc cs.t}t|z |VW5t|XdSN)osgetcwdchdir)rWZold_dirrSrSrTcwds   r\)pathrJcCs"tttdddd}t|d|S)zRemove the given recursively. :note: we use shutil rmtree but adjust its behaviour to see whether files that couldn't be deleted are read-only. Windows will not remove them in that caseN)rIr]exc_inforJc Ssdt|tjz ||WnDtk r^}z&trLddlm}|d||W5d}~XYnXdS)Nr)SkipTestz'FIXME: fails with: PermissionError {}) rYchmodstatS_IWUSR ExceptionrFZunittestr_format)rIr]r^exr_rSrSrTonerrors  zrmtree..onerrorF)r r$strshutilrD)r]rfrSrSrTrDs cCs(t|r$trt|dt|dS)zSEnsure file deleted also on *Windows* where read-only files need special treatment.iN)ospisfilerrYr`remover]rSrSrTrmfiles  rm)source destination chunk_sizerJcCs8d}||}|||t|7}t||krq4q|S)zCopy all data from the source stream into the destination stream in chunks of size chunk_size :return: amount of bytes writtenr)readwritelen)rorprqbrchunkrSrSrTr6s    )aprJcGsht|}|D]V}t|}|sq |dr:||dd7}q |dksL|drV||7}q |d|7}q |S)zhJoin path tokens together similar to osp.join, but always use '/' instead of possibly '' on windows./rN)rg startswithendswith)rwrxr]brSrSrTr7s  cCst|}|ddS)Nry\rgreplacerlrSrSrTto_native_path_windowssrcCst|}|ddS)Nr~ryrrlrSrSrTr8scCst|SrX)rgrlrSrSrTr8scGstt|f|S)z As join path, but makes sure an OS native path is returned. This is only needed to play it safe on my dear windows and to assure nice paths that only use '')to_native_pathr7)rwrxrSrSrTr9sF)r]is_filerJcCs.|rt|}t|s*tj|dddSdS)zAssure that the directory pointed to by path exists. :param is_file: If True, path is assumed to be a file and handled correctly. Otherwise it must be a directory :return: True if the directory was created, False if it already existedT)exist_okF)ridirnameisdirrYmakedirs)r]rrSrSrTrAs   rJcCs8tjdd}|r,tdd|tjDStr4dSdS)NPATHEXTcss|]}|VqdSrX)upper).0rxrSrSrT sz&_get_exe_extensions..)z.BATZCOMz.EXErz)rYenvirongettuplesplitpathsepr)rrSrSrT_get_exe_extensions s(r)programr]rJcstttdfdd }g}|s,tjd}t|tjD]N}|d}|rto.is_exec..)rirjrYaccessX_OKnameanyr) winprog_extsrrTis_execs   $zpy_where..is_execPATH"csg|]}d|fqS)z%s%srS)re)exe_pathrSrT %szpy_where..) rrgboolrYrrrstriprijoinappend)rr]rZprogsfolderfrS)rrrTpy_wheres   r)driver]rJcCstt|r|s|}nL|o,ttt|}t|rL|rB|}q`t|}n|r`d||f}t|}|ddS)Nz/proc/cygdrive/%s/%sr~ry) riisabsnormpath expandvars expandusercygpathlowerrgr)rr]rxZp_strrSrSrT _cygexpath+s  rz*\\\\\?\\UNC\\([^\\]+)\\([^\\]+)(?:\\(.*))?cCsd|||ddfS)Nz //%s/%s/%sr~ry)r)serverZshare rest_pathrSrSrTCrz\\\\\?\\(\w):[/\\](.*)z(\w):[/\\](.*)z file:(.*)cCs|SrXrS)rrSrSrTrHrz (\w{2,}:.*)cCs|SrXrS)urlrSrSrTrIr_cygpath_parserscCsZt|}|dsVtD]4\}}}||}|r||}|rFt|}qVqtd|}|S)zLUse :meth:`git.cmd.Git.polish_url()` instead, that works on any environment.)z /cygdrivez//z/proc/cygdriveN)rgr{rmatchgroupsrr)r]regexparserZrecurserrSrSrTrMs    rz(?:/proc)?/cygdrive/(\w)(/.*)?cCsBt|}t|}|r6|\}}d||p0df}|ddS)Nz%s:%srzryr~)rg_decygpath_regexrrrr)r]mrrrSrSrT decygpathbs   r_is_cygwin_cache)git_executablerJcCsdSrXrSrrSrSrT is_cygwin_gitqsrcCsdSrXrSrrSrSrTrvsc CstrdS|dkrdSt|}t|}|dkrd}zdt|}|s`t|}|r\t|dnd}t|d}tj |gtj dd}| \}}d|k}Wn.t k r}zt d|W5d}~XYnX|t|<|S) NFrrzunameT)stdoutuniversal_newlinesZCYGWINz/Failed checking if running in CYGWIN due to: %r)rrgrrrirrr subprocessPopenPIPE communicaterclogdebug) rZ is_cygwingit_dirresZ uname_cmdprocessZ uname_out_rerSrSrTr{s*     cCsdttfS)zI:return: string identifying the currently active system user as name@nodez%s@%s)getpassgetuserplatformnoderSrSrSrTr@szGit.AutoInterrupt)procrNrJcKs|jf|dS)zSWait for the process (clone, fetch, pull or push) and handle its errors accordinglyN)wait)rrNrSrSrTfinalize_processsr)rx expand_varsrJcCsdSrXrSrxrrSrSrT expand_pathsrcCsdSrXrSrrSrSrTrscCsZt|tjr|Sz*t|}|r.t|}tt|WSt k rTYdSXdSrX) isinstancepathlibPathresolverirrrabspathrcrrSrSrTrs   )cmdlinerJc Csg}t|D]\}}||ztt|}|jdkr@|jdkr@Wq |jdk rb|j|j|jdd}|jdk r|j|j|jdd}t|||<Wq t k rYq Yq Xq |S)a8 Parse any command line argument and if on of the element is an URL with a username and/or password, replace them by stars (in-place). If nothing found just returns the command line as-is. This should be used for every log line that print a command line, as well as exception messages. Nz*****)netloc) enumeraterrpasswordusername_replacerrr ValueError)rZ new_cmdlineindexZto_parserrSrSrTremove_password_if_presents     rc @seZdZUdZdZeed<ddeeD\ ZZ Z Z Z Z ZZZee BZeZdZdZdZed Zed Zd d d dZed dddZeegd fd ddZed dddZ dee!ee"fe!ee"d fed dddZ#d S)rBz Handler providing an interface to parse progress information emitted by git-push and git-fetch and to dispatch callbacks allowing subclasses to react to the progress. _num_op_codescCsg|] }d|>qS)rrS)rxrSrSrTrszRemoteProgress.zdone.z, ) _cur_line _seen_ops error_lines other_linesz%(remote: )?([\w\s]+):\s+()(\d+)()(.*)z2(remote: )?([\w\s]+):\s+(\d+)% \((\d+)/(\d+)\)(.*)NrcCsg|_d|_g|_g|_dSrX)rrrrrLrSrSrT__init__szRemoteProgress.__init__linerJcCs&t|tr|d}n|}||_|jdr>|j|jdSd}tt|D]\}}t |dkrN| d}qN|dk r|d|}| }d\}}|j |}|dkr|j |}|s|||j|dSd} |\} } } }}} | dkr| |jO} n| d kr| |jO} n|| d kr(| |jO} nf| d kr>| |jO} nP| d krT| |jO} n:| d krj| |jO} n$| dkr| |jO} n||dS| |jkr|j| | |jO} | dkrd} | } | |jr| |jO} | dt|j } | |j} | | |ot!||ot!|| dS)a3Parse progress information from the given line as retrieved by git-push or git-fetch. - Lines that do not contain progress info are stored in :attr:`other_lines`. - Lines that seem to contain an error (i.e. start with error: or fatal:) are stored in :attr:`error_lines`.zutf-8)zerror:zfatal:N r)NNrzCounting objectszCompressing objectszWriting objectszReceiving objectszResolving deltaszFinding sourceszChecking out filesrz)"rbytesdecoderr{rrrreversedordrstripre_op_relativerre_op_absolute line_droppedrrCOUNTING COMPRESSINGWRITING RECEIVING RESOLVINGFINDING_SOURCES CHECKING_OUTrBEGINrr| DONE_TOKENENDrtTOKEN_SEPARATORupdatefloat)rLrline_strZlast_valid_indexic cur_count max_countrop_codeZ_remoteZop_nameZ_percentmessagerSrSrT_parse_progress_linesp                                z#RemoteProgress._parse_progress_linecstddfdd }|S)z :return: a progress handler suitable for handle_process_output(), passing lines on to this Progress handler in a suitable formatNrcs|SrX)rr)rrrSrThandlerssz3RemoteProgress.new_message_handler..handler)r )rLrrSrrTnew_message_handlermsz"RemoteProgress.new_message_handlercCsdS)zICalled whenever a line could not be understood and was therefore dropped.NrS)rLrrSrSrTryszRemoteProgress.line_droppedrz)rr r rrJcCsdS)a2Called whenever the progress changes :param op_code: Integer allowing to be compared against Operation IDs and stage IDs. Stage IDs are BEGIN and END. BEGIN will only be set once for each Operation ID as well as END. It may be that BEGIN and END are set at once in case only one progress message was emitted due to the speed of the operation. Between BEGIN and END, none of these flags will be set Operation IDs are all held within the OP_MASK. Only one Operation ID will be active per call. :param cur_count: Current absolute count of items :param max_count: The maximum count of items we expect. It may be None in case there is no maximum number of items or if it is (yet) unknown. :param message: In case of the 'WRITING' operation, it contains the amount of bytes transferred. It may possibly be used for other purposes as well. You may read the contents of the current line in self._cur_lineNrS)rLrr r rrSrSrTr}szRemoteProgress.update)Nrz)$rP __module__ __qualname____doc__rint__annotations__rangerrrrrrrrrZ STAGE_MASKZOP_MASKrr __slots__recompilerrrr rr rgrrrrrrSrSrSrTrBsB    f   cs>eZdZdZdZeddfdd Zeedddd ZZ S) rCz4An implementation forwarding updates to any callable _callableN)fnrJcs||_tt|dSrX)rsuperrCr)rLr __class__rSrTrszCallableRemoteProgress.__init__)rMrNrJcOs|j||dSrX)rrQrSrSrTrszCallableRemoteProgress.update) rPrrrrr rr r __classcell__rSrSrrTrCsc@s eZdZdZedZedZdZdZ dZ dZ dZ d Z d Zeeeed d d dZeedddZeedddZedddZedddZedddZeeddddZed'eeedddd d!Zed(eddd"d#d$Zed)eddd"d%d&Zd S)*r?zActors hold information about a person acting on the repository. They can be committers and authors or anything with a name and an email as mentioned in the git log entries.z<(.*)>z (.*) <(.*?)>ZGIT_AUTHOR_NAMEZGIT_AUTHOR_EMAILZGIT_COMMITTER_NAMEZGIT_COMMITTER_EMAILremailrr"N)rr"rJcCs||_||_dSrXr#)rLrr"rSrSrTrszActor.__init__)otherrJcCs|j|jko|j|jkSrXr#rLr$rSrSrT__eq__sz Actor.__eq__cCs ||k SrXrSr%rSrSrT__ne__sz Actor.__ne__rcCst|j|jfSrX)hashrr"rrSrSrT__hash__szActor.__hash__cCs|jr |jSdS)Nrz)rrrSrSrT__str__sz Actor.__str__cCsd|j|jfS)Nz">r#rrSrSrT__repr__szActor.__repr__)stringrJcCsT|j|}|r&|\}}t||S|j|}|rFt|ddSt|dSdS)zCreate an Actor from a string. :param string: is the string, which is expected to be in regular git format John Doe :return: ActorrN)name_email_regexsearchrr?name_only_regexgroup)clsr,rrr"rSrSrT _from_strings    zActor._from_string)Nrr)env_name env_email config_readerrJc stdd}dtdfdd tdfdd }d||j|fd||jffD]\}}}} ztj|} t||| WqNtk r|dk rz|d |} Wnt k r| } YnXt||| t ||st||| YqNXqN|S) Nrzrcss tSrX)r@rS)user_idrSrT default_emailsz(Actor._main_actor..default_emailcsddS)N@r)rrS)r7rSrT default_namesz'Actor._main_actor..default_namerr"user) r?rg conf_name conf_emailrYrsetattrKeyErrorrrcgetattr) r1r3r4r5Zactorr9attrZevarZcvardefaultvalrS)r7r6rT _main_actors(       zActor._main_actor)r5rJcCs||j|j|S)a :return: Actor instance corresponding to the configured committer. It behaves similar to the git implementation, such that the environment will override configuration values of config_reader. If no value is set at all, it will be generated :param config_reader: ConfigReader to use to retrieve the values from in case they are not set in the environment)rCenv_committer_nameenv_committer_emailr1r5rSrSrT committers zActor.committercCs||j|j|S)zSame as committer(), but defines the main author. It may be specified in the environment, but defaults to the committer)rCenv_author_nameenv_author_emailrFrSrSrTauthorsz Actor.author)N)N)N) rPrrrrrr/r-rHrIrDrEr;r<rrrgrr rr&r'rr)r*r+ classmethodr2rrCrGrJrSrSrSrTr?s<  ' c@sBeZdZdZdZeeeefdddZ e de ddddZ d S) r:a Represents stat information as presented by git at the end of a merge. It is created from the output of a diff operation. ``Example``:: c = Commit( sha1 ) s = c.stats s.total # full-stat-dict s.files # dict( filepath : stat-dict ) ``stat-dict`` A dictionary with the following keys and values:: deletions = number of deleted lines as int insertions = number of inserted lines as int lines = total number of lines changed as int, or deletions + insertions ``full-stat-dict`` In addition to the items in the stat-dict, it features additional information:: files = number of changed files as inttotalfilescCs||_||_dSrXrL)rLrMrNrSrSrTr@szStats.__init__r)rOtextrJc Csdddddid}|D]}|d\}}}|dkr@t|pBd}|dkrTt|pVd} |dd|7<|dd| 7<|dd || 7<|dd d 7<|| || d } | |d |<qt|d|d S) zRCreate a Stat object from output retrieved by git-diff. :return: git.Statr) insertions deletionslinesrNrL -rMrPrQrRrNr)rPrQrR) splitlinesrrrr:) r1rOrOZhshrZraw_insertionsZ raw_deletionsfilenamerPrQZ files_dictrSrSrT_list_from_stringDs"  zStats._list_from_stringN) rPrrrrr&r r$r'rrKrgrWrSrSrSrTr:#s c@s^eZdZdZdZeddddZeeddd Z e d d d Z e d d dZ ed ddZ dS)r;aWrapper around a file-like object that remembers the SHA1 of the data written to it. It will write a sha when the stream is closed or if the asked for explicitly using write_sha. Only useful to the indexfile :note: Based on the dulwich project)rsha1N)rrJcCs||_td|_dS)Nr)rr-rX)rLrrSrSrTrkszIndexFileSHA1Writer.__init__)datarJcCs|j||j|SrX)rXrrrs)rLrYrSrSrTrsos zIndexFileSHA1Writer.writercCs|j}|j||SrX)rXdigestrrsrLsharSrSrT write_shass  zIndexFileSHA1Writer.write_shacCs|}|j|SrX)r]rcloser[rSrSrTr^xs zIndexFileSHA1Writer.closecCs |jSrX)rtellrrSrSrTr_}szIndexFileSHA1Writer.tell)rPrrrrrrr rrsrr]r^r_rSrSrSrTr;_sc@sxeZdZdZdZeddddZdddd Zedd d Z e dd d Z ddddZ ddddZ ddddZdS)r>aProvides methods to obtain, check for, and release a file based lock which should be used to handle concurrent access to the same file. As we are a utility class to be derived from, we only use protected methods. Locks will automatically be released on destruction _file_path _owns_lockN) file_pathrJcCs||_d|_dS)NFr`)rLrcrSrSrTrszLockFile.__init__rcCs |dSrX) _release_lockrrSrSrT__del__szLockFile.__del__cCs d|jS)z:return: Path to lockfilez%s.lock)rarrSrSrT_lock_file_pathszLockFile._lock_file_pathcCs|jS)z:return: True if we have a lock and if the lockfile still exists :raise AssertionError: if our lock-file does not exist)rbrrSrSrT _has_lockszLockFile._has_lockc Cs|r dS|}t|r0td|j|fzscsHeZdZdZdZdefeeeddfdd Z ddfd d Z Z S) r=aThe lock file will block until a lock could be obtained, or fail after a specified timeout. :note: If the directory containing the lock was removed, an exception will be raised during the blocking period, preventing hangs as the lock can never be obtained.)_check_interval_max_block_timeg333333?N)rccheck_interval_smax_block_time_srJcs tt||||_||_dS)aConfigure the instance :param check_interval_s: Period of time to sleep until the lock is checked the next time. By default, it waits a nearly unlimited time :param max_block_time_s: Maximum amount of seconds we may lockN)rr=rrrrs)rLrcrtrurrSrTrs zBlockingLockFile.__init__rc st}|t|j}ztt|Wqtk r}zpt}tt | std| ||f}t||||krd||| f}t||t |j W5d}~XYqXqqdS)zThis method blocks until it obtained the lock, or raises IOError if it ran out of time or if the parent directory was not available anymore. If this method returns, you are guaranteed to own the lockzVDirectory containing the lockfile %r was not readable anymore after waiting %g secondsz Waited %g seconds for lock at %rN) timerrsrr=rqrhrirrrfsleeprr)rLZ starttimeZmaxtimerZcurtimemsgrrSrTrqs(  zBlockingLockFile._obtain_lock) rPrrrrrr$rrrrqr!rSrSrrTr=scseZdZdZdZdeeddfdd Zdeeddd d Zee d d d Z ee d ddZ e eeeefe dddZe eeeefddddZZS)r<as List of iterable objects allowing to query an object by id or by named index:: heads = repo.heads heads.master heads['master'] heads[0] Iterable parent objects = [Commit, SubModule, Reference, FetchInfo, PushInfo] Iterable via inheritance = [Head, TagReference, RemoteReference] ] It requires an id_attribute name to be set which will be queried from its contained items to have a means for comparison. A prefix can be specified which is to be used in case the id returned by the items always contains a prefix that does not matter to the user, so it can be left out._id_attr_prefixrzzIterableList[IterableObj])id_attrprefixrJcstt||SrX)rr<__new__)r1r|r}rrSrTr~szIterableList.__new__NcCs||_||_dSrXry)rLr|r}rSrSrTrszIterableList.__init__)r@rJc Csjzt||}|r|WSWnttfk r2YnXzt|tt|WdSttfk rdYdSXdS)NTF)list __contains__AttributeError TypeErrorr?rrg)rLr@rvalrSrSrTr#s  zIterableList.__contains__cCs8|j|}|D]}t||j|kr|Sqt||SrX)r{r?rzr__getattribute__)rLr@itemrSrSrT __getattr__5s   zIterableList.__getattr__)rrJc Cst|tttfstdt|tr.t||St|trBtdnDz t||WSt k r}zt d|j ||W5d}~XYnXdS)N-Index of IterableList should be an int or strzIndex should be an int or strzNo item found with id %r) rrrgsliceAssertionErrorr __getitem__rr?r IndexErrorr{)rLrrrSrSrTr=s     zIterableList.__getitem__cCst|ttfstdtt|}t|tsvd}|j|}t|D] \}}t||j|kr@|}qbq@|dkrvt d|t ||dS)NrzItem with name %s not found) rrrgrrr{rr?rzrr __delitem__)rLrZdelindexrr rrSrSrTrLs    zIterableList.__delitem__)rz)rz)rPrrrrrgr~robjectrrr)rrr!rrrrr!rSrSrrTr<sc@s$eZdZdZeeeddddZdS)IterableClassWatcherzMetaclass that watchesN)rbasesclsdictrJcCs2|D](}t|tkrtjd|dtddqdS)Nz!GitPython Iterable subclassed by zs. Iterable is deprecated due to naming clash since v3.1.18 and will be removed in 3.1.20, Use IterableObj instead ) stacklevel)typerwarningswarnDeprecationWarning)r1rrrbaserSrSrTrds  zIterableClassWatcher.__init__)rPrrrrgrr rrSrSrSrTrasrc@sHeZdZdZdZdZedeeedddZedeeeddd Z d S) IterablezDefines an interface for iterable items which is to assure a uniform way to retrieve and iterate items within the git repositoryrSz5attribute that most suitably identifies your instancerrOrMrNrJcOs&t|j}||j|f|||S)al Deprecated, use IterableObj instead. Find all items of this type - subclasses can specify args and kwargs differently. If no args are given, subclasses are obliged to return all items if no additional arguments arg given. :note: Favor the iter_items method as it will :return:list(Item,...) list of item instancesr<_id_attribute_extend iter_itemsr1rOrMrNZout_listrSrSrT list_itemsys zIterable.list_itemscOs tddSzbFor more information about the arguments, see list_items :return: iterator yielding ItemszTo be implemented by SubclassNNotImplementedErrorr1rOrMrNrSrSrTrszIterable.iter_itemsN) rPrrrrrrKr rrrSrSrSrTrqsr) metaclassc@sZeZdZUdZdZeed<edeee e dddZ ee deee e ddd Zd S) r*zDefines an interface for iterable items which is to assure a uniform way to retrieve and iterate items within the git repository Subclasses = [Submodule, Commit, Reference, PushInfo, FetchInfo, Remote]rSrrrcOs&t|j}||j|f|||S)a? Find all items of this type - subclasses can specify args and kwargs differently. If no args are given, subclasses are obliged to return all items if no additional arguments arg given. :note: Favor the iter_items method as it will :return:list(Item,...) list of item instancesrrrSrSrTrs zIterableObj.list_itemscOs tddSrrrrSrSrTrszIterableObj.iter_itemsN)rPrrrrrgrrKr r<r)rrrrrSrSrSrTr*s  c@seZdZeddddZdS) NullHandlerN)recordrJcCsdSrXrS)rLrrSrSrTemitszNullHandler.emit)rPrrrrrSrSrSrTrsr)rn)F)N).).)T)abcros.pathr]ricompatr contextlib functoolsrrloggingrYrrrrhrasysrrv urllib.parserrrtypingr r r r r rrrrrrrrrrrrrrZ git.remoterZ git.repo.baserZ git.configrrgitrtypesr r!r"r#r$r%r&r'r(r)Z gitdb.utilr-r.r/r0r1r2r3r4r5__all__ getLoggerrPrrrrFrGrHrEcontextmanagerr\rDrmrr6r7rrgr8rrr9rrArrrrIrrrrrrrr@rrrrrrBrCr?r:r;r>r=r<rrrr*HandlerrrSrSrSrTs     P   , ,    "    #? x<"G>[#