.Ph%(ddgZddlmZddlmZddlmZddl m Z m Z m Z m Z ddlmZddlmZmZmZdd lmZmZmZer$dd lmZdd lmZdd lmZdd lmZddl m!Z!ddl"m#Z#edZ$Gdde Z%Gdde%Z&dS)Object IndexObjectN)WorkTreeRepositoryUnsupported) LazyMixin bin_to_hexjoin_path_native stream_copy)get_object_type_by_name)Any TYPE_CHECKINGUnion) AnyGitObjectGitObjectTypeStringPathLike)OStream) Reference)Repo)Blob) Submodule)Tree)rrrc~eZdZUdZdZdZejejej ej fZ dZ dZ eedfed< ddd ed dffd Zeddd eed fd efdZeddded efdZded dffd Zded efdZded efdZd efdZd efdZd efdZ e!d efdZ"e!ddZ#ddZ$xZ%S) rarBase class for classes representing git object types. The following four leaf classes represent specific kinds of git objects: * :class:`Blob ` * :class:`Tree ` * :class:`Commit ` * :class:`TagObject ` See :manpage:`gitglossary(7)` on: * "object": https://git-scm.com/docs/gitglossary#def_object * "object type": https://git-scm.com/docs/gitglossary#def_object_type * "blob": https://git-scm.com/docs/gitglossary#def_blob_object * "tree object": https://git-scm.com/docs/gitglossary#def_tree_object * "commit object": https://git-scm.com/docs/gitglossary#def_commit_object * "tag object": https://git-scm.com/docs/gitglossary#def_tag_object :note: See the :class:`~git.types.AnyGitObject` union type of the four leaf subclasses that represent actual git object types. :note: :class:`~git.objects.submodule.base.Submodule` is defined under the hierarchy rooted at this :class:`Object` class, even though submodules are not really a type of git object. (This also applies to its :class:`~git.objects.submodule.root.RootModule` subclass.) :note: This :class:`Object` class should not be confused with :class:`object` (the root of the class hierarchy in Python). (0000000000000000000000000000000000000000s)repobinshasizeNtyperrrreturnct||_||_t |dksJd|t |fzdS)zInitialize an object by identifying it by its binary sha. All keyword arguments will be set on demand if ``None``. :param repo: Repository this object is located in. :param binsha: 20 byte SHA1 z,Require 20 byte binary sha, got %r, len = %iN)super__init__rrlen)selfrr __class__s P/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/git/objects/base.pyr"zObject.__init__dsf   6{{b   "P  KKT #      idrcF|t|S)a" :return: New :class:`Object` instance of a type appropriate to the object type behind `id`. The id of the newly created object will be a binsha even though the input id may have been a `~git.refs.reference.Reference` or rev-spec. :param id: :class:`~git.refs.reference.Reference`, rev-spec, or hexsha. :note: This cannot be a ``__new__`` method as it would always call :meth:`__init__` with the input id which is not necessarily a binsha. ) rev_parsestr)clsrr(s r&newz Object.newws~~c"gg&&&r'sha1c||jkrtd||S|j|}t|j||j}|j|_|S)z :return: New object instance of a type appropriate to represent the given binary sha1 :param sha1: 20 byte binary sha1. scommit) NULL_BIN_SHAr odbinforrr)r,rr.oinfoinsts r& new_from_shazObject.new_from_shasl 3# # #5*955dDAA A d##2&uz224FFJ  r'attrc|dkr2|jj|j}|j|_dSt |dS)zRetrieve object information.rN)rr1r2rrr! _set_cache_)r$r6r3r%s r&r8zObject._set_cache_sP 6>>IM&&t{33E DIII GG   % % % % %r'othercFt|dsdS|j|jkS)z3:return: ``True`` if the objects have the same SHA1rFhasattrrr$r9s r&__eq__z Object.__eq__s(uh'' 5{el**r'cFt|dsdS|j|jkS)z::return: ``True`` if the objects do not have the same SHA1rTr;r=s r&__ne__z Object.__ne__s(uh'' 4{el**r'c*t|jS)zE:return: Hash of our id allowing objects to be used in dicts and sets)hashrr$s r&__hash__zObject.__hash__sDK   r'c|jS)z=:return: String of our SHA1 as understood by all git commands)hexsharCs r&__str__zObject.__str__s {r'c2d|jjd|jdS)z::return: String with pythonic representation of our objectz)r%__name__rFrCs r&__repr__zObject.__repr__s "&."9"9"94;;;GGr'cPt|jdS)z6:return: 40 byte hex version of our 20 byte binary shaascii)rrdecoderCs r&rFz Object.hexshas"$+&&--g666r'rcJ|jj|jS)z :return: File-object compatible stream to the uncompressed raw data of the object :note: Returned streams must be read in order. )rr1streamrrCs r& data_streamzObject.data_streamsy}##DK000r'ostreamcn|jj|j}t |||S)zWrite our data directly to the given output stream. :param ostream: File-object compatible stream object. :return: self )rr1rOrr )r$rQistreams r& stream_datazObject.stream_datas2)-&&t{33GW%%% r')rr)rQrrr)&rI __module__ __qualname____doc__ NULL_HEX_SHAr0dbtyp str_blob_type str_tree_typestr_commit_type str_tag_typeTYPES __slots__rrr__annotations__bytesr" classmethodr+rr-r5r8r boolr>r@intrDrGrJpropertyrFrPrT __classcell__r%s@r&rr&sHBLL      E+I-1D%#T) *111  V U t      &'v'5k)9#:'|'''[' e ["&&&&&&&&+C+D++++ +C+D++++ !#!!!!H#HHHH7777X7 111X1        r'c eZdZdZdZdZ ddddededefdede fd df fd Z d efd Z d e d dffd Z ed e fdZed e fdZxZS)ra|Base for all objects that can be part of the index file. The classes representing git object types that can be part of the index file are :class:`~git.objects.tree.Tree and :class:`~git.objects.blob.Blob`. In addition, :class:`~git.objects.submodule.base.Submodule`, which is not really a git object type but can be part of an index file, is also a subclass. )pathmoderiNrrrrjrctt|||||_| ||_dSdS)aInitialize a newly instanced :class:`IndexObject`. :param repo: The :class:`~git.repo.base.Repo` we are located in. :param binsha: 20 byte sha1. :param mode: The stat-compatible file mode as :class:`int`. Use the :mod:`stat` module to evaluate the information. :param path: The path to the file in the file system, relative to the git repository root, like ``file.ext`` or ``folder/other.ext``. :note: Path may not be set if the index object has been created directly, as it cannot be retrieved without knowing the parent tree. N)r!r"rjri)r$rrrjrir%s r&r"zIndexObject.__init__sE6 v&&&  DI  DIII  r'c*t|jS)z :return: Hash of our path as index items are uniquely identifiable by path, not by their data! )rBrirCs r&rDzIndexObject.__hash__s DIr'r6c|tjvr(td|dt|jdt |dS)Nz Attribute 'z<' unset: path and mode attributes must have been set during z object creation)rr_AttributeErrorrrIr!r8)r$r6r%s r&r8zIndexObject._set_cache_sb ;( ( ( .44d,,,.  GG   % % % % %r'c4tj|jS)zA:return: Name portion of the path, effectively being the basename)ospbasenamerirCs r&namezIndexObject.names|DI&&&r'cv|jjt|jj|jSt d)a& :return: Absolute path to this index object in the file system (as opposed to the :attr:`path` field which is a path relative to the git repository). The returned path will be native to the system and contains ``\`` on Windows. Nz"working_tree_dir was None or empty)rworking_tree_dirrrirrCs r&abspathzIndexObject.abspath s5 9 % 1#DI$> JJ J/0TUU Ur')NN)rIrUrVrWr__id_attribute_rarrdrr"rDr+r8rerrrurfrgs@r&rrsC!IN "&&* D#I  D(N#   B#&&&&&&&&'c'''X' V V V VX V V V V Vr')'__all__os.pathrirp gitdb.typtyprYgit.excrgit.utilrrrr utilr typingr r r git.typesrrr gitdb.basergit.refs.referencergit.reporblobrsubmodule.basertreer IndexObjUnionrrr'r&rs ] #111111IIIIIIIIIIII))))))-,,,,,,,,,AAAAAAAAAA"""""",,,,,,))))))12 pppppYpppfTVTVTVTVTV&TVTVTVTVTVr'