Add commit_raw
and commit_as_raw
methods for creating commits without reference updates
#2168
+141
−4
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR adds two new methods to
Repository
that allow creating commit objects without automatically updating references:Repository::commit_raw()
- Creates a commit using author/committer from configurationRepository::commit_as_raw()
- Creates a commit with explicitly specified author/committerProblem
The existing
Repository::commit()
andRepository::commit_as()
methods always update the specified reference (like HEAD) after creating the commit object. This coupling makes it difficult to:Solution
The new methods return a
gix_object::Commit
that can be written to the object database separately usingRepository::write_object()
. This allows users to:Key Features
reference
parametercommit::Error
type for consistencyImplementation Details
The implementation extracts the commit object creation logic from the existing
commit_as_inner()
method, removing the reference update portion. This ensures:Use Cases
This enables several advanced Git workflows:
The methods maintain full compatibility with existing code while providing the flexibility needed for advanced Git operations.
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.