Synch met tag 2.1.78 van progit/progit-en (#13)

Author: Cpt-xx

B-embedding-git-in-your-applications.asc

@@ -1,14 +1,15 @@
 [[B-embedding-git-in-your-applications]]
 [appendix]
 ////
-Laatst bijgewerkt van progit/progit2 referentie: 7836cfed
+Laatst bijgewerkt van progit/progit2 referentie: 8d8780b1d
 ////
 == Git in je applicaties inbouwen
 
 Als je applicatie bestemd is voor ontwikkelaars, is er een grote kans dat het kan profiteren van integratie met versiebeheer.
 Zelfs applicaties voor niet-ontwikkelaars, zoals document editors, kunnen potentieel profiteren van versiebeheer functionaliteit, en het model van Git werkt erg goed voor vele verschillende scenarios.
 
 Als je Git moet integreren met je applicatie, heb je eigenlijk twee opties: een shell openen en de Git commando-regel tool gebruiken, of Git als library inbedden in je applicatie.
+We zullen hier de integratie van de commandoregel en een aantal van de meest populaire inbedbare Git libraries behandelen.
 
 include::book/B-embedding-git/sections/command-line.asc[]
 
@@ -17,3 +18,5 @@ include::book/B-embedding-git/sections/libgit2.asc[]
 include::book/B-embedding-git/sections/jgit.asc[]
 
 include::book/B-embedding-git/sections/go-git.asc[]
+
+include::book/B-embedding-git/sections/dulwich.asc[]

book/07-git-tools/sections/revision-selection.asc

@@ -1,6 +1,6 @@
 [[_revision_selection]]
 ////
-Laatst bijgewerkt van progit/progit2 referentie: 7836cfed
+Laatst bijgewerkt van progit/progit2 referentie: 8d8780b1d
 ////
 === Revisie Selectie
 
@@ -122,7 +122,7 @@ Je kunt de reflog zien door `git reflog` te gebruiken:
 ----
 $ git reflog
 734713b HEAD@{0}: commit: fixed refs handling, added gc auto, updated
-d921970 HEAD@{1}: merge phedders/rdocs: Merge made by the 'recursive' stategy.
+d921970 HEAD@{1}: merge phedders/rdocs: Merge made by the 'recursive' strategy.
 1c002dd HEAD@{2}: commit: added some blame and merge stuff
 1c36188 HEAD@{3}: rebase -i (squash): updating HEAD
 95df984 HEAD@{4}: commit: # This is a combination of two commits.

book/10-git-internals/sections/objects.asc

@@ -128,7 +128,7 @@ blob
 Het volgende type waar we naar gaan kijken is de tree, wat het probleem oplost van het opslaan van bestandsnamen en je ook in staat stelt om een groep van bestanden bij elkaar op te slaan.
 Git slaat de inhoud op een manier die vergelijkbaar is met een UNIX bestandssysteem, maar wat versimpeld.
 Alle inhoud wordt opgeslagen als tree en blob objecten, waarbij trees overeenkomen met UNIX directory entries en blobs min of meer overeenkomen met inodes of bestandsinhoud.
-Een enkele tree object bevat een of meer tree entries, elk daarvan bevat een SHA-1 verwijzing naar een blob of subtree met de bijbehorende mode, type en bestandsnaam.
+Een enkele tree object bevat een of meer entries, elk daarvan is de SHA-1 hash van een blob of subtree met de bijbehorende mode, type en bestandsnaam.
 Bijvoorbeeld, de meest recente tree in een project kan er ongeveer zo uitzien:
 
 [source,console]

book/B-embedding-git/sections/dulwich.asc

@@ -0,0 +1,47 @@
+////
+Laatst bijgewerkt van progit/progit2 referentie: 8d8780b1d
+////
+=== Dulwich
+
+(((Dulwich)))((("Python")))
+Er is ook een zuivere Python Git implementatie - Dulwich.
+Het project wordt gehost onder https://www.dulwich.io/
+Het doel van het project is om een interface naar git repositories te bieden (zowel lokaal als remote) die geen directe git aanroepen doet, maar daarentegen puur Python gebruikt.
+Het heeft echter een optionele C-extensie, die de prestaties behoorlijk versnelt.
+
+Dulwich volgt het git ontwerp en maakt een scheiding tussen twee basisniveaus wat APIs betreft: binnenwerk en koetswerk (plumbing en porcelain).
+
+Hier is een voorbeeld hoe een lager niveau API te gebruiken om toegang tot het commit-bericht van de laatste commit te benaderen:
+
+[source, python]
+-----
+from dulwich.repo import Repo
+r = Repo('.')
+r.head()
+# '57fbe010446356833a6ad1600059d80b1e731e15'
+
+c = r[r.head()]
+c
+# <Commit 015fc1267258458901a94d228e39f0a378370466>
+
+c.message
+# 'Add note about encoding.\n'
+-----
+
+Om een commit-log af te drukken gebruikmakend van de API van het hogere niveau (porcelein), kan men het volgende doen:
+
+[source, python]
+-----
+from dulwich import porcelain
+porcelain.log('.', max_entries=1)
+
+#commit: 57fbe010446356833a6ad1600059d80b1e731e15
+#Author: Jelmer Vernooij <jelmer@jelmer.uk>
+#Date:   Sat Apr 29 2017 23:57:34 +0000
+-----
+
+
+==== Meer weten
+
+ * De officiële API documentatie is beschikbaar op https://www.dulwich.io/apidocs/dulwich.html[]
+ * De officiële tutorial op https://www.dulwich.io/docs/tutorial[] heeft veel voorbeelden hoe specifieke taken met Dulwich uit te voeren