pygit2 1.18.2__tar.gz → 1.19.0__tar.gz

{pygit2-1.18.2 → pygit2-1.19.0}/AUTHORS.md

@@ -15,6 +15,7 @@ Authors:
     Daniel Rodríguez Troitiño
     Peter Rowlands
     Richo Healey
+    Brendan Doherty
     Christian Boos
     Julien Miotte
     Nick Hynes
@@ -50,7 +51,7 @@ Authors:
     Mathieu Parent
     Michał Kępień
     Nicolas Dandrimont
-    Raphael Medaer (Escaux)
+    Raphael Medaer
     Yaroslav Halchenko
     Anatoly Techtonik
     Andrew Olsen
@@ -64,6 +65,7 @@ Authors:
     Santiago Perez De Rosso
     Sebastian Thiel
     Thom Wiggers
+    WANG Xuerui
     William Manley
     Alexander Linne
     Alok Singhal
@@ -89,7 +91,6 @@ Authors:
     Sukhman Bhuller
     Thomas Kluyver
     Tyler Cipriani
-    WANG Xuerui
     Alex Chamberlain
     Alexander Bayandin
     Amit Bakshi
@@ -98,6 +99,7 @@ Authors:
     Ben Davis
     CJ Steiner
     Colin Watson
+    Craig de Stigter
     Dan Yeaw
     Dustin Raimondi
     Eric Schrijver
@@ -156,7 +158,6 @@ Authors:
     Chris Rebert
     Christopher Hunt
     Claudio Jolowicz
-    Craig de Stigter
     Cristian Hotea
     Cyril Jouve
     Dan Cecile

{pygit2-1.18.2 → pygit2-1.19.0}/CHANGELOG.md

@@ -1,3 +1,38 @@
+# 1.19.0 (2025-10-23)
+
+- Add support for Python 3.14 and drop 3.10
+
+- Support threaded builds (experimental)
+  [#1430](https://github.com/libgit2/pygit2/pull/1430)
+  [#1435](https://github.com/libgit2/pygit2/pull/1435)
+
+- Add Linux musl wheels for AArch64
+
+- Add Windows wheels for AArch64;
+  CI: build Windows wheels with cibuildwheel on GitHub
+  [#1423](https://github.com/libgit2/pygit2/pull/1423)
+
+- New `Repository.transaction()` context manager, returns new `ReferenceTransaction`
+  [#1420](https://github.com/libgit2/pygit2/pull/1420)
+
+- CI: add GitHub releases and other improvements
+  [#1433](https://github.com/libgit2/pygit2/pull/1433)
+  [#1432](https://github.com/libgit2/pygit2/pull/1432)
+  [#1425](https://github.com/libgit2/pygit2/pull/1425)
+  [#1431](https://github.com/libgit2/pygit2/pull/1431)
+
+- Documentation improvements and other changes
+  [#1426](https://github.com/libgit2/pygit2/pull/1426)
+  [#1424](https://github.com/libgit2/pygit2/pull/1424)
+
+Breaking changes:
+
+- Remove deprecated `IndexEntry.hex`, use `str(entry.id)` instead of `entry.hex`
+
+Deprecations:
+
+- Deprecate `IndexEntry.oid`, use `entry.id` instead of `entry.oid`
+
 # 1.18.2 (2025-08-16)
 
 - Add support for almost all global options
@@ -298,31 +333,39 @@ Deprecations:
 
 # 1.14.0 (2024-01-26)
 
--   Drop support for Python 3.8
--   Add Linux wheels for musl on x86\_64
-    [#1266](https://github.com/libgit2/pygit2/pull/1266)
--   New `Repository.submodules` namespace
-    [#1250](https://github.com/libgit2/pygit2/pull/1250)
--   New `Repository.listall_mergeheads()`, `Repository.message`,
-    `Repository.raw_message` and `Repository.remove_message()`
-    [#1261](https://github.com/libgit2/pygit2/pull/1261)
--   New `pygit2.enums` supersedes the `GIT_` constants
-    [#1251](https://github.com/libgit2/pygit2/pull/1251)
--   Now `Repository.status()`, `Repository.status_file()`,
-    `Repository.merge_analysis()`, `DiffFile.flags`, `DiffFile.mode`,
-    `DiffDelta.flags` and `DiffDelta.status` return enums
-    [#1263](https://github.com/libgit2/pygit2/pull/1263)
--   Now repository\'s `merge()`, `merge_commits()` and `merge_trees()`
-    take enums/flags for their `favor`, `flags` and `file_flags` arguments.
-    [#1271](https://github.com/libgit2/pygit2/pull/1271)
-    [#1272](https://github.com/libgit2/pygit2/pull/1272)
--   Fix crash in filter cleanup
-    [#1259](https://github.com/libgit2/pygit2/pull/1259)
--   Documentation fixes
-    [#1255](https://github.com/libgit2/pygit2/pull/1255)
-    [#1258](https://github.com/libgit2/pygit2/pull/1258)
-    [#1268](https://github.com/libgit2/pygit2/pull/1268)
-    [#1270](https://github.com/libgit2/pygit2/pull/1270)
+- Drop support for Python 3.8
+
+- Add Linux wheels for musl on x86\_64
+  [#1266](https://github.com/libgit2/pygit2/pull/1266)
+
+- New `Repository.submodules` namespace
+  [#1250](https://github.com/libgit2/pygit2/pull/1250)
+
+- New `Repository.listall_mergeheads()`, `Repository.message`,
+  `Repository.raw_message` and `Repository.remove_message()`
+  [#1261](https://github.com/libgit2/pygit2/pull/1261)
+
+- New `pygit2.enums` supersedes the `GIT_` constants
+  [#1251](https://github.com/libgit2/pygit2/pull/1251)
+
+- Now `Repository.status()`, `Repository.status_file()`,
+  `Repository.merge_analysis()`, `DiffFile.flags`, `DiffFile.mode`,
+  `DiffDelta.flags` and `DiffDelta.status` return enums
+  [#1263](https://github.com/libgit2/pygit2/pull/1263)
+
+- Now repository\'s `merge()`, `merge_commits()` and `merge_trees()`
+  take enums/flags for their `favor`, `flags` and `file_flags` arguments.
+  [#1271](https://github.com/libgit2/pygit2/pull/1271)
+  [#1272](https://github.com/libgit2/pygit2/pull/1272)
+
+- Fix crash in filter cleanup
+  [#1259](https://github.com/libgit2/pygit2/pull/1259)
+
+- Documentation fixes
+  [#1255](https://github.com/libgit2/pygit2/pull/1255)
+  [#1258](https://github.com/libgit2/pygit2/pull/1258)
+  [#1268](https://github.com/libgit2/pygit2/pull/1268)
+  [#1270](https://github.com/libgit2/pygit2/pull/1270)
 
 Breaking changes:
 

{pygit2-1.18.2 → pygit2-1.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygit2
-Version: 1.18.2
+Version: 1.19.0
 Summary: Python bindings for libgit2.
 Home-page: https://github.com/libgit2/pygit2
 Maintainer: J. David Ibáñez
@@ -14,19 +14,19 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Version Control
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: COPYING
 License-File: AUTHORS.md
-Requires-Dist: cffi>=1.17.0
+Requires-Dist: cffi>=2.0
 Dynamic: classifier
 Dynamic: description
 Dynamic: description-content-type
@@ -44,20 +44,24 @@ Dynamic: summary
 # pygit2 - libgit2 bindings in Python
 
 Bindings to the libgit2 shared library, implements Git plumbing.
-Supports Python 3.10 to 3.13 and PyPy3 7.3+
+Supports Python 3.11 to 3.14 and PyPy3 7.3+
 
-[![image](https://github.com/libgit2/pygit2/actions/workflows/tests.yml/badge.svg)](https://github.com/libgit2/pygit2/actions/workflows/tests.yml)
+[![test-ci-badge][test-ci-badge]][test-ci-link]
+[![deploy-ci-badge][deploy-ci-badge]][deploy-ci-link]
 
-[![image](https://ci.appveyor.com/api/projects/status/edmwc0dctk5nacx0/branch/master?svg=true)](https://ci.appveyor.com/project/jdavid/pygit2/branch/master)
+[deploy-ci-badge]: https://github.com/libgit2/pygit2/actions/workflows/wheels.yml/badge.svg
+[deploy-ci-link]: https://github.com/libgit2/pygit2/actions/workflows/wheels.yml
+[test-ci-badge]: https://github.com/libgit2/pygit2/actions/workflows/tests.yml/badge.svg
+[test-ci-link]: https://github.com/libgit2/pygit2/actions/workflows/tests.yml
 
 ## Links
 
--   Documentation - <https://www.pygit2.org/>
--   Install - <https://www.pygit2.org/install.html>
--   Download - <https://pypi.org/project/pygit2/>
--   Source code and issue tracker - <https://github.com/libgit2/pygit2>
--   Changelog - <https://github.com/libgit2/pygit2/blob/master/CHANGELOG.md>
--   Authors - <https://github.com/libgit2/pygit2/blob/master/AUTHORS.md>
+- Documentation - <https://www.pygit2.org/>
+- Install - <https://www.pygit2.org/install.html>
+- Download - <https://pypi.org/project/pygit2/>
+- Source code and issue tracker - <https://github.com/libgit2/pygit2>
+- Changelog - <https://github.com/libgit2/pygit2/blob/master/CHANGELOG.md>
+- Authors - <https://github.com/libgit2/pygit2/blob/master/AUTHORS.md>
 
 ## Sponsors
 

{pygit2-1.18.2 → pygit2-1.19.0}/README.md

@@ -1,20 +1,24 @@
 # pygit2 - libgit2 bindings in Python
 
 Bindings to the libgit2 shared library, implements Git plumbing.
-Supports Python 3.10 to 3.13 and PyPy3 7.3+
+Supports Python 3.11 to 3.14 and PyPy3 7.3+
 
-[![image](https://github.com/libgit2/pygit2/actions/workflows/tests.yml/badge.svg)](https://github.com/libgit2/pygit2/actions/workflows/tests.yml)
+[![test-ci-badge][test-ci-badge]][test-ci-link]
+[![deploy-ci-badge][deploy-ci-badge]][deploy-ci-link]
 
-[![image](https://ci.appveyor.com/api/projects/status/edmwc0dctk5nacx0/branch/master?svg=true)](https://ci.appveyor.com/project/jdavid/pygit2/branch/master)
+[deploy-ci-badge]: https://github.com/libgit2/pygit2/actions/workflows/wheels.yml/badge.svg
+[deploy-ci-link]: https://github.com/libgit2/pygit2/actions/workflows/wheels.yml
+[test-ci-badge]: https://github.com/libgit2/pygit2/actions/workflows/tests.yml/badge.svg
+[test-ci-link]: https://github.com/libgit2/pygit2/actions/workflows/tests.yml
 
 ## Links
 
--   Documentation - <https://www.pygit2.org/>
--   Install - <https://www.pygit2.org/install.html>
--   Download - <https://pypi.org/project/pygit2/>
--   Source code and issue tracker - <https://github.com/libgit2/pygit2>
--   Changelog - <https://github.com/libgit2/pygit2/blob/master/CHANGELOG.md>
--   Authors - <https://github.com/libgit2/pygit2/blob/master/AUTHORS.md>
+- Documentation - <https://www.pygit2.org/>
+- Install - <https://www.pygit2.org/install.html>
+- Download - <https://pypi.org/project/pygit2/>
+- Source code and issue tracker - <https://github.com/libgit2/pygit2>
+- Changelog - <https://github.com/libgit2/pygit2/blob/master/CHANGELOG.md>
+- Authors - <https://github.com/libgit2/pygit2/blob/master/AUTHORS.md>
 
 ## Sponsors
 

pygit2-1.19.0/build.ps1

@@ -0,0 +1,21 @@
+if (!(Test-Path -Path "build")) {
+    # in case the pygit2 package build/ workspace has not been created by cibuildwheel yet
+    mkdir build
+}
+if (Test-Path -Path "$env:LIBGIT2_SRC") {
+    Set-Location "$env:LIBGIT2_SRC"
+    # for local runs, reuse build/libgit_src if it exists
+    if (Test-Path -Path build) {
+        # purge previous build env (likely for a different arch type)
+        Remove-Item -Recurse -Force build
+    }
+    # ensure we are checked out to the right version
+    git fetch --depth=1 --tags
+    git checkout "v$env:LIBGIT2_VERSION"
+} else {
+    # from a fresh run (like in CI)
+    git clone --depth=1 -b "v$env:LIBGIT2_VERSION" https://github.com/libgit2/libgit2.git $env:LIBGIT2_SRC
+    Set-Location "$env:LIBGIT2_SRC"
+}
+cmake -B build -S . -DBUILD_TESTS=OFF
+cmake --build build/ --config=Release --target install

{pygit2-1.18.2 → pygit2-1.19.0}/build.sh

@@ -134,7 +134,7 @@ if [ -n "$OPENSSL_VERSION" ]; then
         # Linux
         tar xf $FILENAME.tar.gz
         cd $FILENAME
-        ./Configure shared --prefix=$PREFIX --libdir=$PREFIX/lib
+        ./Configure shared no-apps no-docs no-tests --prefix=$PREFIX --libdir=$PREFIX/lib
         make
         make install
         OPENSSL_PREFIX=$(pwd)

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/__init__.py

@@ -366,6 +366,7 @@ from .remotes import Remote
 from .repository import Repository
 from .settings import Settings
 from .submodules import Submodule
+from .transaction import ReferenceTransaction
 from .utils import to_bytes, to_str
 
 # Features
@@ -971,6 +972,8 @@ __all__ = (
     'Settings',
     'submodules',
     'Submodule',
+    'transaction',
+    'ReferenceTransaction',
     'utils',
     'to_bytes',
     'to_str',

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/_build.py

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

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/_libgit2/ffi.pyi

@@ -239,12 +239,17 @@ class GitRemoteC:
 class GitReferenceC:
     pass
 
+class GitTransactionC:
+    pass
+
 def string(a: char_pointer) -> bytes: ...
 @overload
 def new(a: Literal['git_repository **']) -> _Pointer[GitRepositoryC]: ...
 @overload
 def new(a: Literal['git_remote **']) -> _Pointer[GitRemoteC]: ...
 @overload
+def new(a: Literal['git_transaction **']) -> _Pointer[GitTransactionC]: ...
+@overload
 def new(a: Literal['git_repository_init_options *']) -> GitRepositoryInitOptionsC: ...
 @overload
 def new(a: Literal['git_submodule_update_options *']) -> GitSubmoduleUpdateOptionsC: ...

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/_run.py

@@ -81,6 +81,7 @@ h_files = [
     'revert.h',
     'stash.h',
     'submodule.h',
+    'transaction.h',
     'options.h',
     'callbacks.h',  # Bridge from libgit2 to Python
 ]

pygit2-1.19.0/pygit2/decl/transaction.h

@@ -0,0 +1,8 @@
+int git_transaction_new(git_transaction **out, git_repository *repo);
+int git_transaction_lock_ref(git_transaction *tx, const char *refname);
+int git_transaction_set_target(git_transaction *tx, const char *refname, const git_oid *target, const git_signature *sig, const char *msg);
+int git_transaction_set_symbolic_target(git_transaction *tx, const char *refname, const char *target, const git_signature *sig, const char *msg);
+int git_transaction_set_reflog(git_transaction *tx, const char *refname, const git_reflog *reflog);
+int git_transaction_remove(git_transaction *tx, const char *refname);
+int git_transaction_commit(git_transaction *tx);
+void git_transaction_free(git_transaction *tx);

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/decl/types.h

@@ -12,6 +12,8 @@ typedef struct git_submodule git_submodule;
 typedef struct git_transport git_transport;
 typedef struct git_tree git_tree;
 typedef struct git_packbuilder git_packbuilder;
+typedef struct git_transaction git_transaction;
+typedef struct git_reflog git_reflog;
 
 typedef int64_t git_off_t;
 typedef int64_t git_time_t;

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/index.py

@@ -446,15 +446,9 @@ class IndexEntry:
 
     @property
     def oid(self):
-        # For backwards compatibility
+        warnings.warn('Use entry.id', DeprecationWarning)
         return self.id
 
-    @property
-    def hex(self):
-        """The id of the referenced object as a hex string"""
-        warnings.warn('Use str(entry.id)', DeprecationWarning)
-        return str(self.id)
-
     def __str__(self):
         return f'<path={self.path} id={self.id} mode={self.mode}>'
 

{pygit2-1.18.2 → pygit2-1.19.0}/pygit2/repository.py

@@ -78,6 +78,7 @@ from .packbuilder import PackBuilder
 from .references import References
 from .remotes import RemoteCollection
 from .submodules import SubmoduleCollection
+from .transaction import ReferenceTransaction
 from .utils import StrArray, to_bytes
 
 if TYPE_CHECKING:
@@ -120,6 +121,7 @@ class BaseRepository(_Repository):
         self.references = References(self)
         self.remotes = RemoteCollection(self)
         self.submodules = SubmoduleCollection(self)
+        self._active_transaction = None
 
         # Get the pointer as the contents of a buffer and store it for
         # later access
@@ -359,6 +361,22 @@ class BaseRepository(_Repository):
 
         return (commit, reference)  # type: ignore
 
+    def transaction(self) -> ReferenceTransaction:
+        """Create a new reference transaction.
+
+        Returns a context manager that commits all reference updates atomically
+        when the context exits successfully, or performs no updates if an exception
+        is raised.
+
+        Example::
+
+            with repo.transaction() as txn:
+                txn.lock_ref('refs/heads/master')
+                txn.set_target('refs/heads/master', new_oid, message='Update')
+        """
+        txn = ReferenceTransaction(self)
+        return txn
+
     #
     # Checkout
     #

pygit2-1.19.0/pygit2/transaction.py

@@ -0,0 +1,199 @@
+# Copyright 2010-2025 The pygit2 contributors
+#
+# This file is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License, version 2,
+# as published by the Free Software Foundation.
+#
+# In addition to the permissions in the GNU General Public License,
+# the authors give you unlimited permission to link the compiled
+# version of this file into combinations with other programs,
+# and to distribute those combinations without any restriction
+# coming from the use of this file.  (The General Public License
+# restrictions do apply in other respects; for example, they cover
+# modification of the file, and distribution when not linked into
+# a combined executable.)
+#
+# This file is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; see the file COPYING.  If not, write to
+# the Free Software Foundation, 51 Franklin Street, Fifth Floor,
+# Boston, MA 02110-1301, USA.
+
+from __future__ import annotations
+
+import threading
+from typing import TYPE_CHECKING
+
+from .errors import check_error
+from .ffi import C, ffi
+from .utils import to_bytes
+
+if TYPE_CHECKING:
+    from ._pygit2 import Oid, Signature
+    from .repository import BaseRepository
+
+
+class ReferenceTransaction:
+    """Context manager for transactional reference updates.
+
+    A transaction allows multiple reference updates to be performed atomically.
+    All updates are applied when the transaction is committed, or none are applied
+    if the transaction is rolled back.
+
+    Example:
+        with repo.transaction() as txn:
+            txn.lock_ref('refs/heads/master')
+            txn.set_target('refs/heads/master', new_oid, message='Update master')
+            # Changes committed automatically on context exit
+    """
+
+    def __init__(self, repository: BaseRepository) -> None:
+        self._repository = repository
+        self._transaction = ffi.new('git_transaction **')
+        self._tx = None
+        self._thread_id = threading.get_ident()
+
+        err = C.git_transaction_new(self._transaction, repository._repo)
+        check_error(err)
+        self._tx = self._transaction[0]
+
+    def _check_thread(self) -> None:
+        """Verify transaction is being used from the same thread that created it."""
+        current_thread = threading.get_ident()
+        if current_thread != self._thread_id:
+            raise RuntimeError(
+                f'Transaction created in thread {self._thread_id} '
+                f'but used in thread {current_thread}. '
+                'Transactions must be used from the thread that created them.'
+            )
+
+    def lock_ref(self, refname: str) -> None:
+        """Lock a reference in preparation for updating it.
+
+        Args:
+            refname: Name of the reference to lock (e.g., 'refs/heads/master')
+        """
+        self._check_thread()
+        if self._tx is None:
+            raise ValueError('Transaction already closed')
+
+        c_refname = ffi.new('char[]', to_bytes(refname))
+        err = C.git_transaction_lock_ref(self._tx, c_refname)
+        check_error(err)
+
+    def set_target(
+        self,
+        refname: str,
+        target: Oid | str,
+        signature: Signature | None = None,
+        message: str | None = None,
+    ) -> None:
+        """Set the target of a direct reference.
+
+        The reference must be locked first via lock_ref().
+
+        Args:
+            refname: Name of the reference to update
+            target: Target OID or hex string
+            signature: Signature for the reflog (None to use repo identity)
+            message: Message for the reflog
+        """
+        self._check_thread()
+        if self._tx is None:
+            raise ValueError('Transaction already closed')
+
+        from ._pygit2 import Oid
+
+        c_refname = ffi.new('char[]', to_bytes(refname))
+
+        # Convert target to OID
+        if isinstance(target, str):
+            target = Oid(hex=target)
+
+        c_oid = ffi.new('git_oid *')
+        ffi.buffer(c_oid)[:] = target.raw
+
+        c_sig = signature._pointer if signature else ffi.NULL
+        c_msg = ffi.new('char[]', to_bytes(message)) if message else ffi.NULL
+
+        err = C.git_transaction_set_target(self._tx, c_refname, c_oid, c_sig, c_msg)
+        check_error(err)
+
+    def set_symbolic_target(
+        self,
+        refname: str,
+        target: str,
+        signature: Signature | None = None,
+        message: str | None = None,
+    ) -> None:
+        """Set the target of a symbolic reference.
+
+        The reference must be locked first via lock_ref().
+
+        Args:
+            refname: Name of the reference to update
+            target: Target reference name (e.g., 'refs/heads/master')
+            signature: Signature for the reflog (None to use repo identity)
+            message: Message for the reflog
+        """
+        self._check_thread()
+        if self._tx is None:
+            raise ValueError('Transaction already closed')
+
+        c_refname = ffi.new('char[]', to_bytes(refname))
+        c_target = ffi.new('char[]', to_bytes(target))
+        c_sig = signature._pointer if signature else ffi.NULL
+        c_msg = ffi.new('char[]', to_bytes(message)) if message else ffi.NULL
+
+        err = C.git_transaction_set_symbolic_target(
+            self._tx, c_refname, c_target, c_sig, c_msg
+        )
+        check_error(err)
+
+    def remove(self, refname: str) -> None:
+        """Remove a reference.
+
+        The reference must be locked first via lock_ref().
+
+        Args:
+            refname: Name of the reference to remove
+        """
+        self._check_thread()
+        if self._tx is None:
+            raise ValueError('Transaction already closed')
+
+        c_refname = ffi.new('char[]', to_bytes(refname))
+        err = C.git_transaction_remove(self._tx, c_refname)
+        check_error(err)
+
+    def commit(self) -> None:
+        """Commit the transaction, applying all queued updates."""
+        self._check_thread()
+        if self._tx is None:
+            raise ValueError('Transaction already closed')
+
+        err = C.git_transaction_commit(self._tx)
+        check_error(err)
+
+    def __enter__(self) -> ReferenceTransaction:
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb) -> None:
+        self._check_thread()
+        # Only commit if no exception occurred
+        if exc_type is None and self._tx is not None:
+            self.commit()
+
+        # Always free the transaction
+        if self._tx is not None:
+            C.git_transaction_free(self._tx)
+            self._tx = None
+
+    def __del__(self) -> None:
+        if self._tx is not None:
+            C.git_transaction_free(self._tx)
+            self._tx = None