Skip to content

Appendix Final #89

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ben merged 27 commits into from
Oct 21, 2014
Merged

Appendix Final #89

Changes from 1 commit
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
d44c85e
add small section on git difftool
schacon Oct 8, 2014
e8224cb
log, stash and tag
schacon Oct 9, 2014
4a33d46
plumbing section and flesh out the rest of the commands
schacon Oct 9, 2014
0c0da3e
manual remerge link
schacon Oct 9, 2014
2671a49
fetch and pull
schacon Oct 9, 2014
e86fc25
Embedding: intro edits
ben Oct 13, 2014
beccdc4
JGit: setup and plumbing
ben Oct 13, 2014
652bccb
forgot to add these xlinks
schacon Oct 13, 2014
2fb691d
push, remote and submodule
schacon Oct 13, 2014
0cce6a4
inspection and comparison
schacon Oct 13, 2014
a5033d3
debug and started on patching
schacon Oct 13, 2014
ea4fa23
rebase
schacon Oct 13, 2014
e65216b
revert
schacon Oct 13, 2014
8215864
am, format-patch, send-email and request-pull
schacon Oct 13, 2014
38a302d
svn, import
schacon Oct 13, 2014
c460106
rest of the commands
schacon Oct 13, 2014
57eb252
add git to the subsections
schacon Oct 13, 2014
96ba7db
Merge remote-tracking branch 'origin/master' into appendix-final
schacon Oct 13, 2014
45cc896
Porcelain
ben Oct 14, 2014
a923fcf
Further reading
ben Oct 17, 2014
f66e5d5
Tweaks
ben Oct 17, 2014
645ea37
Expand Libgit2 content
ben Oct 19, 2014
25b2ad0
Extended Rugged example
ben Oct 19, 2014
87a3648
ODB backends part I
ben Oct 20, 2014
659ef40
Feedback
ben Oct 20, 2014
d9db713
More custom ODB backend content
ben Oct 21, 2014
d3e1176
Libgit2 tweaks
ben Oct 21, 2014
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
ODB backends part I
  • Loading branch information
@ben
ben committed Oct 20, 2014
commit 87a3648393acce816ff8bfea08a5857b117f4553
33 changes: 32 additions & 1 deletion book/B-embedding-git/sections/libgit2.asc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,10 +106,41 @@ commit = repo.lookup(commit_id) # <8>
<7> Rugged (and Libgit2) can optionally update a reference when making a commit.
<8> The return value is the SHA-1 hash of a new commit object, which you can then use to get a `Commit` object.

The Ruby code is pretty clean, but since Libgit2 is doing the heavy lifting, this code will run pretty fast, too.


==== Advanced Functionality

// TODO: backend, remote
Libgit2 has a couple of capabilities that are outside the scope of core Git.
One example is pluggability: Libgit2 allows you to provide custom ``backends'' for several types of operation, so you can store things in a different way than stock Git does.
Libgit2 allows custom backends for configuration, ref storage, and the object database, among other things.

Let's take a look at how this works.
The code below is borrowed from the set of backend examples provided by the Libgit2 team (which can be found at https://github.com/libgit2/libgit2-backends[]).
Here's how a custom backend for the object database is set up.

[source,c]
----
git_odb *odb;
int error = git_odb_new(&odb); // <1>

git_repository *repo;
error = git_repository_wrap_odb(&repo, odb); // <2>

git_odb_backend *my_backend;
error = git_odb_backend_mine(&my_backend, repo, …); // <3>

error = git_odb_add_backendodb, my_backend, 1); // <4>
----

_Note that error handling has been elided for this example. You should know better._

<1> Initialize an empty object database (ODB) ``frontend,'' which will act as a handle to the real ODB.
<2> Construct a `git_repository` around the empty ODB.
<3> Initialize a custom ODB backend.
<4> Set the repository to use the custom backend for its ODB.

// TODO

==== What Libgit2 Can't Do

Expand Down