pygit2 1.13.1__tar.gz → 1.13.3__tar.gz

{pygit2-1.13.1 → pygit2-1.13.3}/AUTHORS.rst

@@ -4,41 +4,42 @@ Authors::
   Carlos Martín Nieto
   Nico von Geyso
   Sviatoslav Sydorenko
-  Robert Coup
+  Iliyas Jorio
   Matthias Bartelmeß
+  Robert Coup
   W. Trevor King
-  Iliyas Jorio
   Drew DeVault
   Dave Borowitz
   Brandon Milton
   Daniel Rodríguez Troitiño
+  Peter Rowlands
   Richo Healey
   Christian Boos
   Julien Miotte
   Nick Hynes
   Richard Möhn
   Xu Tao
-  Jose Plana
   Matthew Duggan
   Matthew Gamble
   Jeremy Westwood
+  Jose Plana
   Martin Lenders
-  Petr Hosek
   Sriram Raghu
   Victor Garcia
-  Xavier Delannoy
   Yonggang Luo
   Patrick Steinhardt
+  Petr Hosek
   Tamir Bahar
   Valentin Haenel
+  Xavier Delannoy
   Michael Jones
   Saugat Pachhai
   Bernardo Heynemann
-  Brodie Rao
   John Szakmeister
   Nabijacz Leweli
   Simon Cozens
   Vlad Temian
+  Brodie Rao
   Chad Dombrova
   Lukas Fleischer
   Mathias Leppich
@@ -49,7 +50,6 @@ Authors::
   Dan Sully
   David Versmisse
   Mikhail Yushkovskiy
-  Peter Rowlands
   Robin Stocker
   Rohit Sanjay
   Rémi Duraffort
@@ -119,6 +119,7 @@ Authors::
   Vicent Marti
   Zbigniew Jędrzejewski-Szmek
   Zoran Zaric
+  nikitalita
   Adam Gausmann
   Adam Spiers
   Albin Söderström
@@ -169,6 +170,7 @@ Authors::
   Jiri Benc
   Jonathan Robson
   Josh Bleecher Snyder
+  Julia Evans
   Justin Clift
   Konstantinos Smanis
   Kyriakos Oikonomakos

{pygit2-1.13.1 → pygit2-1.13.3}/CHANGELOG.rst

@@ -1,3 +1,34 @@
+1.13.3 (2023-11-21)
+-------------------------
+
+- New API for filters in Python
+  `#1237 <https://github.com/libgit2/pygit2/pull/1237>`_
+  `#1244 <https://github.com/libgit2/pygit2/pull/1244>`_
+
+- Shallow repositories: New ``depth`` optional argument for
+  ``clone_repository(...)`` and ``Remote.fetch(...)``
+  `#1245 <https://github.com/libgit2/pygit2/pull/1245>`_
+  `#1246 <https://github.com/libgit2/pygit2/pull/1246>`_
+
+- New submodule ``init(...)``, ``update(...)`` and ``reload(...)`` functions
+  `#1248 <https://github.com/libgit2/pygit2/pull/1248>`_
+
+- Release GIL in ``Walker.__next__``
+  `#1249 <https://github.com/libgit2/pygit2/pull/1249>`_
+
+- Type hints for submodule functions in ``Repository``
+  `#1247 <https://github.com/libgit2/pygit2/pull/1247>`_
+
+
+1.13.2 (2023-10-30)
+-------------------------
+
+- Support Python 3.12
+
+- Documentation updates
+  `#1242 <https://github.com/libgit2/pygit2/pull/1242>`_
+
+
 1.13.1 (2023-09-24)
 -------------------------
 

pygit2-1.13.3/Makefile

@@ -0,0 +1,7 @@
+.PHONY: build html
+
+build:
+	OPENSSL_VERSION=3.1.3 LIBSSH2_VERSION=1.11.0 LIBGIT2_VERSION=1.7.1 sh build.sh
+
+html: build
+	make -C docs html

{pygit2-1.13.1 → pygit2-1.13.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pygit2
-Version: 1.13.1
+Version: 1.13.3
 Summary: Python bindings for libgit2.
 Home-page: https://github.com/libgit2/pygit2
 Maintainer: J. David Ibáñez
@@ -18,19 +18,22 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Version Control
 Requires-Python: >=3.8
 License-File: COPYING
 License-File: AUTHORS.rst
+Requires-Dist: cffi>=1.16.0
+Requires-Dist: setuptools; python_version >= "3.12"
 
 ######################################################################
 pygit2 - libgit2 bindings in Python
 ######################################################################
 
 Bindings to the libgit2 shared library, implements Git plumbing.
-Supports Python 3.8 to 3.11 and PyPy3 7.3+
+Supports Python 3.8 to 3.12 and PyPy3 7.3+
 
 .. image:: https://github.com/libgit2/pygit2/actions/workflows/tests.yml/badge.svg
    :target: https://github.com/libgit2/pygit2/actions/workflows/tests.yml

{pygit2-1.13.1 → pygit2-1.13.3}/README.rst

@@ -3,7 +3,7 @@ pygit2 - libgit2 bindings in Python
 ######################################################################
 
 Bindings to the libgit2 shared library, implements Git plumbing.
-Supports Python 3.8 to 3.11 and PyPy3 7.3+
+Supports Python 3.8 to 3.12 and PyPy3 7.3+
 
 .. image:: https://github.com/libgit2/pygit2/actions/workflows/tests.yml/badge.svg
    :target: https://github.com/libgit2/pygit2/actions/workflows/tests.yml

{pygit2-1.13.1 → pygit2-1.13.3}/pygit2/__init__.py

@@ -31,12 +31,15 @@ from ._pygit2 import *
 
 # High level API
 from .blame import Blame, BlameHunk
+from .blob import BlobIO
 from .callbacks import git_clone_options, git_fetch_options, get_credentials
 from .callbacks import Payload, RemoteCallbacks, CheckoutCallbacks, StashApplyCallbacks
 from .config import Config
 from .credentials import *
 from .errors import check_error, Passthrough
+from .enums import SubmoduleIgnore, SubmoduleStatus
 from .ffi import ffi, C
+from .filter import Filter
 from .index import Index, IndexEntry
 from .remote import Remote
 from .repository import Repository
@@ -92,6 +95,8 @@ GIT_ATTR_CHECK_FILE_THEN_INDEX = C.GIT_ATTR_CHECK_FILE_THEN_INDEX
 GIT_ATTR_CHECK_INDEX_THEN_FILE = C.GIT_ATTR_CHECK_INDEX_THEN_FILE
 GIT_ATTR_CHECK_INDEX_ONLY      = C.GIT_ATTR_CHECK_INDEX_ONLY
 GIT_ATTR_CHECK_NO_SYSTEM       = C.GIT_ATTR_CHECK_NO_SYSTEM
+GIT_ATTR_CHECK_INCLUDE_HEAD    = C.GIT_ATTR_CHECK_INCLUDE_HEAD
+GIT_ATTR_CHECK_INCLUDE_COMMIT  = C.GIT_ATTR_CHECK_INCLUDE_COMMIT
 
 # GIT_FETCH_PRUNE
 GIT_FETCH_PRUNE_UNSPECIFIED    = C.GIT_FETCH_PRUNE_UNSPECIFIED
@@ -197,7 +202,7 @@ def init_repository(path, bare=False,
 
 def clone_repository(
         url, path, bare=False, repository=None, remote=None,
-        checkout_branch=None, callbacks=None):
+        checkout_branch=None, callbacks=None, depth=0):
     """
     Clones a new Git repository from *url* in the given *path*.
 
@@ -231,6 +236,12 @@ def clone_repository(
 
         The callbacks should be an object which inherits from
         `pyclass:RemoteCallbacks`.
+    depth : int
+        Number of commits to clone.
+
+        If greater than 0, creates a shallow clone with a history truncated to
+        the specified number of commits.
+        The default is 0 (full commit history).
     """
 
     if callbacks is None:
@@ -244,6 +255,7 @@ def clone_repository(
     with git_clone_options(payload):
         opts = payload.clone_options
         opts.bare = bare
+        opts.fetch_opts.depth = depth
 
         if checkout_branch:
             checkout_branch_ref = ffi.new('char []', to_bytes(checkout_branch))

{pygit2-1.13.1 → pygit2-1.13.3}/pygit2/_build.py

@@ -34,7 +34,7 @@ from pathlib import Path
 #
 # The version number of pygit2
 #
-__version__ = '1.13.1'
+__version__ = '1.13.3'
 
 
 #

{pygit2-1.13.1 → pygit2-1.13.3}/pygit2/_pygit2.pyi

@@ -495,7 +495,6 @@ class Repository:
     def expand_id(self, hex: str) -> Oid: ...
     def free(self) -> None: ...
     def git_object_lookup_prefix(self, oid: _OidArg) -> Object: ...
-    def init_submodules(self, submodules: Optional[list[Submodule]] = None, overwrite = False) -> None: ...
     def list_worktrees(self) -> list[str]: ...
     def listall_branches(self, flag: int = GIT_BRANCH_LOCAL) -> list[str]: ...
     def listall_stashes(self) -> list[Stash]: ...

{pygit2-1.13.1 → pygit2-1.13.3}/pygit2/_run.py

@@ -54,8 +54,8 @@ else:
 # Order matters
 h_files = [
     'types.h',
-    'attr.h',
     'oid.h',
+    'attr.h',
     'blame.h',
     'buffer.h',
     'strarray.h',
@@ -91,14 +91,15 @@ for h_file in h_files:
 
 C_HEADER_SRC = '\n'.join(h_source)
 
+C_PREAMBLE = """\
+#include <git2.h>
+#include <git2/sys/repository.h>
+"""
+
 # ffi
 _, libgit2_kw = get_libgit2_paths()
 ffi = FFI()
-ffi.set_source(
-    "pygit2._libgit2",
-    "#include <git2.h>", # preamble
-    **libgit2_kw
-)
+ffi.set_source("pygit2._libgit2", C_PREAMBLE, **libgit2_kw)
 ffi.cdef(C_HEADER_SRC)
 
 

pygit2-1.13.3/pygit2/blob.py

@@ -0,0 +1,154 @@
+import io
+import threading
+import time
+from contextlib import AbstractContextManager
+from typing import Optional
+from queue import Queue
+
+from ._pygit2 import GIT_BLOB_FILTER_CHECK_FOR_BINARY, Blob, Oid
+
+
+class _BlobIO(io.RawIOBase):
+    """Low-level wrapper for streaming blob content.
+
+    The underlying libgit2 git_writestream filter chain will be run
+    in a separate thread. The GIL will be released while running
+    libgit2 filtering.
+    """
+
+    def __init__(
+        self,
+        blob: Blob,
+        as_path: Optional[str] = None,
+        flags: int = GIT_BLOB_FILTER_CHECK_FOR_BINARY,
+        commit_id: Optional[Oid] = None,
+    ):
+        super().__init__()
+        self._blob = blob
+        self._queue = Queue(maxsize=1)
+        self._ready = threading.Event()
+        self._writer_closed = threading.Event()
+        self._chunk: Optional[bytes] = None
+        self._thread = threading.Thread(
+            target=self._blob._write_to_queue,
+            args=(self._queue, self._ready, self._writer_closed),
+            kwargs={
+                "as_path": as_path,
+                "flags": flags,
+                "commit_id": commit_id,
+            },
+            daemon=True,
+        )
+        self._thread.start()
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.close()
+
+    def isatty():
+        return False
+
+    def readable(self):
+        return True
+
+    def writable(self):
+        return False
+
+    def seekable(self):
+        return False
+
+    def readinto(self, b, /):
+        try:
+            while self._chunk is None:
+                self._ready.wait()
+                if self._queue.empty():
+                    if self._writer_closed.is_set():
+                        # EOF
+                        return 0
+                    self._ready.clear()
+                    time.sleep(0)
+                    continue
+                chunk = self._queue.get()
+                if chunk:
+                    self._chunk = chunk
+
+            if len(self._chunk) <= len(b):
+                bytes_written = len(self._chunk)
+                b[:bytes_written] = self._chunk
+                self._chunk = None
+                return bytes_written
+            bytes_written = len(b)
+            b[:] = self._chunk[:bytes_written]
+            self._chunk = self._chunk[bytes_written:]
+            return bytes_written
+        except KeyboardInterrupt:
+            return 0
+
+    def close(self):
+        try:
+            self._ready.wait()
+            self._writer_closed.wait()
+            while self._queue is not None and not self._queue.empty():
+                self._queue.get()
+            self._thread.join()
+        except KeyboardInterrupt:
+            pass
+        self._queue = None
+
+
+class BlobIO(io.BufferedReader, AbstractContextManager):
+    """Read-only wrapper for streaming blob content.
+
+    Supports reading both raw and filtered blob content.
+    Implements io.BufferedReader.
+
+    Example:
+
+        >>> with BlobIO(blob) as f:
+        ...     while True:
+        ...         # Read blob data in 1KB chunks until EOF is reached
+        ...         chunk = f.read(1024)
+        ...         if not chunk:
+        ...             break
+
+    By default, `BlobIO` will stream the raw contents of the blob, but it
+    can also be used to stream filtered content (i.e. to read the content
+    after applying filters which would be used when checking out the blob
+    to the working directory).
+
+    Example:
+
+        >>> with BlobIO(blob, as_path='my_file.ext') as f:
+        ...     # Read the filtered content which would be returned upon
+        ...     # running 'git checkout -- my_file.txt'
+        ...     filtered_data = f.read()
+    """
+
+    def __init__(
+        self,
+        blob: Blob,
+        as_path: Optional[str] = None,
+        flags: int = GIT_BLOB_FILTER_CHECK_FOR_BINARY,
+        commit_id: Optional[Oid] = None,
+    ):
+        """Wrap the specified blob.
+
+        Parameters:
+            blob: The blob to wrap.
+            as_path: Filter the contents of the blob as if it had the specified
+                path. If `as_path` is None, the raw contents of the blob will
+                be read.
+            flags: GIT_BLOB_FILTER_* bitflags (only applicable when `as_path`
+                is set).
+            commit_oid: Commit to load attributes from when
+                GIT_BLOB_FILTER_ATTRIBUTES_FROM_COMMIT is specified in `flags`
+                (only applicable when `as_path` is set).
+        """
+        raw = _BlobIO(blob, as_path=as_path, flags=flags, commit_id=commit_id)
+        super().__init__(raw)
+
+    def __exit__(self, exc_type, exc_value, traceback):
+        self.close()
+
+
+io.RawIOBase.register(_BlobIO)
+io.BufferedIOBase.register(BlobIO)

pygit2-1.13.3/pygit2/decl/attr.h

@@ -0,0 +1,31 @@
+#define GIT_ATTR_CHECK_FILE_THEN_INDEX	0
+#define GIT_ATTR_CHECK_INDEX_THEN_FILE	1
+#define GIT_ATTR_CHECK_INDEX_ONLY		2
+#define GIT_ATTR_CHECK_NO_SYSTEM        4
+#define GIT_ATTR_CHECK_INCLUDE_HEAD     8
+#define GIT_ATTR_CHECK_INCLUDE_COMMIT   16
+
+#define GIT_ATTR_OPTIONS_VERSION ...
+
+typedef enum {
+	GIT_ATTR_VALUE_UNSPECIFIED = 0, /**< The attribute has been left unspecified */
+	GIT_ATTR_VALUE_TRUE,   /**< The attribute has been set */
+	GIT_ATTR_VALUE_FALSE,  /**< The attribute has been unset */
+	GIT_ATTR_VALUE_STRING  /**< This attribute has a value */
+} git_attr_value_t;
+
+typedef struct {
+	unsigned int version;
+	unsigned int flags;
+	git_oid *commit_id;
+	git_oid attr_commit_id;
+} git_attr_options;
+
+int git_attr_get_ext(
+	const char **value_out,
+	git_repository *repo,
+	git_attr_options *opts,
+	const char *path,
+	const char *name);
+
+git_attr_value_t git_attr_value(const char *attr);

pygit2-1.13.3/pygit2/decl/common.h

@@ -0,0 +1,10 @@
+#define GIT_PATH_MAX ...
+
+typedef enum {
+	GIT_FEATURE_THREADS	= (1 << 0),
+	GIT_FEATURE_HTTPS	= (1 << 1),
+	GIT_FEATURE_SSH		= (1 << 2),
+	GIT_FEATURE_NSEC	= (1 << 3)
+} git_feature_t;
+
+int git_libgit2_features(void);

pygit2-1.13.3/pygit2/decl/errors.h

@@ -0,0 +1,51 @@
+typedef enum {
+	GIT_OK         =  0,		/**< No error */
+
+	GIT_ERROR      = -1,		/**< Generic error */
+	GIT_ENOTFOUND  = -3,		/**< Requested object could not be found */
+	GIT_EEXISTS    = -4,		/**< Object exists preventing operation */
+	GIT_EAMBIGUOUS = -5,		/**< More than one object matches */
+	GIT_EBUFS      = -6,		/**< Output buffer too short to hold data */
+
+	/**
+	 * GIT_EUSER is a special error that is never generated by libgit2
+	 * code.  You can return it from a callback (e.g to stop an iteration)
+	 * to know that it was generated by the callback and not by libgit2.
+	 */
+	GIT_EUSER      = -7,
+
+	GIT_EBAREREPO       =  -8,	/**< Operation not allowed on bare repository */
+	GIT_EUNBORNBRANCH   =  -9,	/**< HEAD refers to branch with no commits */
+	GIT_EUNMERGED       = -10,	/**< Merge in progress prevented operation */
+	GIT_ENONFASTFORWARD = -11,	/**< Reference was not fast-forwardable */
+	GIT_EINVALIDSPEC    = -12,	/**< Name/ref spec was not in a valid format */
+	GIT_ECONFLICT       = -13,	/**< Checkout conflicts prevented operation */
+	GIT_ELOCKED         = -14,	/**< Lock file prevented operation */
+	GIT_EMODIFIED       = -15,	/**< Reference value does not match expected */
+	GIT_EAUTH           = -16,	/**< Authentication error */
+	GIT_ECERTIFICATE    = -17,	/**< Server certificate is invalid */
+	GIT_EAPPLIED        = -18,	/**< Patch/merge has already been applied */
+	GIT_EPEEL           = -19,	/**< The requested peel operation is not possible */
+	GIT_EEOF            = -20,	/**< Unexpected EOF */
+	GIT_EINVALID        = -21,	/**< Invalid operation or input */
+	GIT_EUNCOMMITTED    = -22,	/**< Uncommitted changes in index prevented operation */
+	GIT_EDIRECTORY      = -23,	/**< The operation is not valid for a directory */
+	GIT_EMERGECONFLICT  = -24,	/**< A merge conflict exists and cannot continue */
+
+	GIT_PASSTHROUGH     = -30,	/**< A user-configured callback refused to act */
+	GIT_ITEROVER        = -31,	/**< Signals end of iteration with iterator */
+	GIT_RETRY           = -32,	/**< Internal only */
+	GIT_EMISMATCH       = -33,	/**< Hashsum mismatch in object */
+	GIT_EINDEXDIRTY     = -34,	/**< Unsaved changes in the index would be overwritten */
+	GIT_EAPPLYFAIL      = -35,	/**< Patch application failed */
+	GIT_EOWNER          = -36,	/**< The object is not owned by the current user */
+	GIT_TIMEOUT         = -37	/**< The operation timed out */
+} git_error_code;
+
+typedef struct {
+	char *message;
+	int klass;
+} git_error;
+
+
+const git_error * git_error_last(void);

{pygit2-1.13.1 → pygit2-1.13.3}/pygit2/decl/repository.h

@@ -87,3 +87,6 @@ int git_repository_ident(const char **name, const char **email, const git_reposi
 int git_repository_set_ident(git_repository *repo, const char *name, const char *email);
 int git_repository_index(git_index **out, git_repository *repo);
 git_repository_state_t git_repository_state(git_repository *repo);
+
+int git_repository_submodule_cache_all(git_repository *repo);
+int git_repository_submodule_cache_clear(git_repository *repo);

{pygit2-1.13.1 → pygit2-1.13.3}/pygit2/decl/submodule.h

@@ -30,12 +30,14 @@ int git_submodule_lookup(
 	const char *name);
 
 void git_submodule_free(git_submodule *submodule);
-int git_submodule_open(
-	git_repository **repo,
-	git_submodule *submodule);
+int git_submodule_open(git_repository **repo, git_submodule *submodule);
+int git_submodule_init(git_submodule *submodule, int overwrite);
+int git_submodule_reload(git_submodule *submodule, int force);
 
 const char * git_submodule_name(git_submodule *submodule);
 const char * git_submodule_path(git_submodule *submodule);
 const char * git_submodule_url(git_submodule *submodule);
 const char * git_submodule_branch(git_submodule *submodule);
 const git_oid * git_submodule_head_id(git_submodule *submodule);
+
+int git_submodule_status(unsigned int *status, git_repository *repo, const char *name, git_submodule_ignore_t ignore);

pygit2-1.13.3/pygit2/enums.py

@@ -0,0 +1,64 @@
+from enum import IntEnum, IntFlag
+
+from . import _pygit2
+
+
+class SubmoduleIgnore(IntEnum):
+    UNSPECIFIED = _pygit2.GIT_SUBMODULE_IGNORE_UNSPECIFIED
+    "use the submodule's configuration"
+
+    NONE = _pygit2.GIT_SUBMODULE_IGNORE_NONE
+    "any change or untracked == dirty"
+
+    UNTRACKED = _pygit2.GIT_SUBMODULE_IGNORE_UNTRACKED
+    "dirty if tracked files change"
+
+    DIRTY = _pygit2.GIT_SUBMODULE_IGNORE_DIRTY
+    "only dirty if HEAD moved"
+
+    ALL = _pygit2.GIT_SUBMODULE_IGNORE_ALL
+    "never dirty"
+
+
+class SubmoduleStatus(IntFlag):
+    IN_HEAD = _pygit2.GIT_SUBMODULE_STATUS_IN_HEAD
+    "superproject head contains submodule"
+
+    IN_INDEX = _pygit2.GIT_SUBMODULE_STATUS_IN_INDEX
+    "superproject index contains submodule"
+
+    IN_CONFIG = _pygit2.GIT_SUBMODULE_STATUS_IN_CONFIG
+    "superproject gitmodules has submodule"
+
+    IN_WD = _pygit2.GIT_SUBMODULE_STATUS_IN_WD
+    "superproject workdir has submodule"
+
+    INDEX_ADDED = _pygit2.GIT_SUBMODULE_STATUS_INDEX_ADDED
+    "in index, not in head (flag available if ignore is not ALL)"
+
+    INDEX_DELETED = _pygit2.GIT_SUBMODULE_STATUS_INDEX_DELETED
+    "in head, not in index (flag available if ignore is not ALL)"
+
+    INDEX_MODIFIED = _pygit2.GIT_SUBMODULE_STATUS_INDEX_MODIFIED
+    "index and head don't match (flag available if ignore is not ALL)"
+
+    WD_UNINITIALIZED = _pygit2.GIT_SUBMODULE_STATUS_WD_UNINITIALIZED
+    "workdir contains empty repository (flag available if ignore is not ALL)"
+
+    WD_ADDED = _pygit2.GIT_SUBMODULE_STATUS_WD_ADDED
+    "in workdir, not index (flag available if ignore is not ALL)"
+
+    WD_DELETED = _pygit2.GIT_SUBMODULE_STATUS_WD_DELETED
+    "in index, not workdir (flag available if ignore is not ALL)"
+
+    WD_MODIFIED = _pygit2.GIT_SUBMODULE_STATUS_WD_MODIFIED
+    "index and workdir head don't match (flag available if ignore is not ALL)"
+
+    WD_INDEX_MODIFIED = _pygit2.GIT_SUBMODULE_STATUS_WD_INDEX_MODIFIED
+    "submodule workdir index is dirty (flag available if ignore is NONE or UNTRACKED)"
+
+    WD_WD_MODIFIED = _pygit2.GIT_SUBMODULE_STATUS_WD_WD_MODIFIED
+    "submodule workdir has modified files (flag available if ignore is NONE or UNTRACKED)"
+
+    WD_UNTRACKED = _pygit2.GIT_SUBMODULE_STATUS_WD_UNTRACKED
+    "submodule workdir contains untracked files (flag available if ignore is NONE)"