update the B-embedding-git appendix and create some new files

Author: marrinosnis

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

@@ -1,14 +1,19 @@
-[#B-embedding-git]
+[[B-embedding-git-in-your-applications]]
 [appendix]
 == Ενσωμάτωση του Git στις εφαρμογές μας
 
 Εάν η εφαρμογή μας απευθύνεται σε προγραμματιστές, οι πιθανότητες ότι θα επωφεληθούν από την ενοποίηση με τον έλεγχο εκδόσεων του πηγαίου κώδικα είναι πολλές.
 Ακόμη και οι εφαρμογές που δεν αφορούν προγραμματιστές, όπως επεξεργασία εγγράφων, θα μπορούσαν ενδεχομένως να επωφεληθούν από τις λειτουργίες ελέγχου εκδόσεων και το μοντέλο του Git λειτουργεί πολύ καλά για πολλά διαφορετικά σενάρια.
 
-Εάν χρειάζεται να ενσωματώσουμε το Git με την εφαρμογή μας, έχουμε ουσιαστικά τρεις επιλογές: α) εκκίνηση κελύφους και χρήση του εργαλείου γραμμής εντολών Git, β) το Libgit2 και γ) το JGit.
+Εάν χρειάζεται να ενσωματώσουμε το Git με την εφαρμογή μας, έχουμε ουσιαστικά δύο επιλογές: α) εκκίνηση κελύφους και να καλέσουμε το `git` πρόγραμμα γραμμή-εντολής, ή να ενσωματώσουμε μια Git βιβλιοθήκη μέσα σστην εφαρμογή μας.
+Εδώ θα καλύψουμε την ενσωμάτωση γραμμή-εντολής και μερικές από τις πιο γνωστές ενσωματώσιμες βιβλιοθήκες του Git.
 
 include::book/B-embedding-git/sections/command-line.asc[]
 
 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/B-embedding-git/sections/command-line.asc

@@ -6,12 +6,11 @@
 Ωστόσο, αυτή η προσέγγιση έχει κάποια μειονεκτήματα.
 
 Το ένα είναι ότι όλη η έξοδος είναι σε απλό κείμενο.
-Αυτό σημαίνει ότι θα πρέπει να αναλύσουμε την περιστασιακά μεταβαλλόμενη μορφή εξόδου του Git για να διαβάσουμε πληροφορίες σχετικά με την πρόοδο και τα αποτελέσματα, κάτι που μπορεί να είναι αναποτελεσματικό και επιρρεπές σε σφάλματα.
+Αυτό σημαίνει ότι θα πρέπει να αναλύσουμε την περιστασιακά μεταβαλλόμενη μορφή εξόδου του Git για να διαβάσουμε πληροφορίες σχετικά με την πρόοδο και τα αποτελέσματα, κάτι που μπορεί να είναι μη αποτελεσματικό και επιρρεπές σε σφάλματα.
 
 Ένα άλλο είναι η έλλειψη ανάκτησης σφαλμάτων.
-Εάν ένα αποθετήριο είναι παρεφθαρμένο κατά κάποιο τρόπο ή ο χρήστης έχει μια μη-έγκυρη τιμή διαμόρφωσης, το Git απλά θα αρνηθεί να εκτελέσει πολλές λειτουργίες.
+Εάν ένα αποθετήριο είναι παρεφθαρμένο κατά κάποιο τρόπο, ή ο χρήστης έχει μια μη-έγκυρη τιμή διαμόρφωσης, το Git απλά θα αρνηθεί να εκτελέσει πολλές λειτουργίες.
 
 Ένα ακόμα είναι η διαχείριση της διαδικασίας.
 Το Git απαιτεί να διατηρούμε ένα περιβάλλον κελύφους ως ξεχωριστή διαδικασία, κάτι που μπορεί να προσθέσει ανεπιθύμητη πολυπλοκότητα.
 Η προσπάθεια συντονισμού πολλών από αυτές τις διεργασίες (ειδικά όταν δυνητικά έχουμε πρόσβαση στο ίδιο αποθετήριο από διάφορες διεργασίες) μπορεί να είναι μια μεγάλη πρόκληση.
-

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

@@ -0,0 +1,42 @@
+=== Dulwich
+
+(((Dulwich)))(((Python)))
+Υπάρχει επίσης μια καθαρή υλοποίση του Git σε Python - Dulwich.
+Το project φιλοξενείται στο https://www.dulwich.io/[^].
+Στοχεύει στην παροχή μιας διεπαφής με τα Git αποθετήρια (τοπικά και απομακρυσμένα) που δεν καλεί το Git απευθείας αλλά, αντιθέτως, χρησιμοποιεί μόνο Python.
+Έχει προαιρετικές C επεκτάσεις όμως, που βελτιώνουν σημαντικά την απόδοση.
+
+Το Dulwich ακολουθεί το σχεδιασμό του Git και διαχωρίζει δύο βασικά επίπεδα API: τη διοχέτευση (plumbing) και πορσελάνη (porcelain).
+
+Ακολουθεί ένα παράδειγμα που χρησιμοποιεί χαμηλού επιπέδου API για την πρόσβαση στο μήνυμα υποβολής της τελευταίας υποβολής:
+
+[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'
+----
+
+Για να εκτυπώσουμε το log μιας υποβολής χρησιμοποιώντας υψηλού επιπέδου πορσελάνη (porcelain) API, μπορούμε να χρησιμοποιήσουμε:
+
+[source, python]
+----
+from dulwich import porcelain
+porcelain.log('.', max_entries=1)
+
+#commit: 57fbe010446356833a6ad1600059d80b1e731e15
+#Author: Jelmer Vernooij <[email protected]>
+#Date:   Sat Apr 29 2017 23:57:34 +0000
+----
+
+==== Περαιτέρω Ανάγνωση
+
+Η τεκμηρίωση API, μαθήματα (tutorial), και πολλά παραδείγματα για το πως να κάνουμε συγκεκριμένες εργασίες (tasks) με το Dulwich είναι διαθέσιμα στην επίσημη ιστοσελίδα https://www.dulwich.io[^].

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

@@ -0,0 +1,83 @@
+=== go-git
+
+(((go-git)))(((Go)))
+Σε περίπτωση που θέλουμε να ενσωματώσουμε το Git σε μια υπηρεσία γραμμένη σε Golang, υπάρχει επίσης μια καθαρή υλοποίηση βιβλιοθήκης σε Go.
+Αυτή η υλοποίηση δεν έχει εγγενείς εξαρτήσεις και για αυτο δεν είναι επιρρεπής σε χειροκίνητη διαχείριση σφαλμάτων μνήμης.
+Είναι επίσης διαφανής για τα τυπικά εργαλεία ανάλυσης απόδοσης της Golang όπως CPU, προφίλ Μνήμης, ανιχνευτής αγώνα (race detector), κτλ.
+
+Το go-git στοχεύει στην επεκτασιμότητα, συμβατότητα και υποστηρίζει τα περισσότερα APIs διοχέτευσης, που είναι την τεκμηρίωση https://github.com/go-git/go-git/blob/master/COMPATIBILITY.md[^].
+
+Ένα σύνηθες παράδειγμα χρήσης των Go APIs:
+
+[source, go]
+----
+import "github.com/go-git/go-git/v5"
+
+r, err := git.PlainClone("/tmp/foo", false, &git.CloneOptions{
+    URL:      "https://github.com/go-git/go-git",
+    Progress: os.Stdout,
+})
+----
+
+Μόλις έχουμε ένα στιγμιότυπο `Repository`, έχουμε πρόσβαση στις πληροφορίες και να κάνουμε μεταλλάξεις σε αυτό:
+
+[source, go]
+----
+// retrieves the branch pointed by HEAD
+ref, err := r.Head()
+
+// get the commit object, pointed by ref
+commit, err := r.CommitObject(ref.Hash())
+
+// retrieves the commit history
+history, err := commit.History()
+
+// iterates over the commits and print each
+for _, c := range history {
+    fmt.Println(c)
+}
+----
+
+==== Προηγμένη Λειτουργικότητα
+
+Το go-git έχει μερικά αξιοσημείωτα προηγμένα χαρακτηριστικά, ένα από αυτά είναι το συνδεούμενο (pluggable) σύστημα αποθήκευσης, που είναι το ίδιο με την υλοποίηση του Libgit2.
+Η προεπιλεγμένη υλοποίηση είναι εντός-μνήμη αποθήκευση, που είναι πολύ γρήγορη.
+
+[source, go]
+----
+r, err := git.Clone(memory.NewStorage(), nil, &git.CloneOptions{
+    URL: "https://github.com/go-git/go-git",
+})
+----
+
+Το συνδεούμενο (pluggable) σύστημα προσφέρει πολλές ενδιαφέρουσες επιλογές.
+Για παράδειγμα, https://github.com/go-git/go-git/tree/master/_examples/storage[^] μας επιτρέπει να αποθηκεύουμε αναφορές, αντικείμενα, και διαμόρφωση (configuration) σε μια βάση Aerospike.
+
+Ένα άλλο χαρακτηριστικό είναι η ευέλικτη αφαίρεση συστήματος αρχείων (flexible filesystem abstraction).
+Χρησιμοποιώντας https://pkg.go.dev/github.com/go-git/go-billy/v5?tab=doc#Filesystem[^] είναι πολύ εύκολο να αποθηκεύσουμε όλα τα αρχεία με διαφορετικό τρόπο π.χ. πακετάρωντάς τα όλα σε ένα αρχείο στο δίσκο ή κρατώντας τα όλα εντός-μνήμης.
+
+Μια άλλη προηγμένη περίπτωση-χρήσης περιλαμβάνει ένα βελτιστοποιημένο πελάτη HTTP, σαν αυτό που βρίσκεται https://github.com/go-git/go-git/blob/master/_examples/custom_http/main.go[^].
+
+[source, go]
+----
+customClient := &http.Client{
+    Transport: &http.Transport{ // accept any certificate (might be useful for testing)
+        TLSClientConfig: &tls.Config{InsecureSkipVerify: true},
+    },
+    Timeout: 15 * time.Second,  // 15 second timeout
+        CheckRedirect: func(req *http.Request, via []*http.Request) error {
+        return http.ErrUseLastResponse // don't follow redirect
+    },
+}
+
+// Override http(s) default protocol to use our custom client
+client.InstallProtocol("https", githttp.NewClient(customClient))
+
+// Clone repository using the new client if the protocol is https://
+r, err := git.Clone(memory.NewStorage(), nil, &git.CloneOptions{URL: url})
+----
+
+==== Περαιτέρω ανάγνωση
+
+Μια πλήρης διαχείριση των δυνατοτήτων του go-git είναι εκτός θέματος του βιβλίου.
+Αν θέλουμε περισσότερες πληροφορίες για το go-git, υπάρχει μια API τεκμηρίωση εδώ https://pkg.go.dev/github.com/go-git/go-git/v5[^], και ένα σύνολο παραδειγμάτων εδώ https://github.com/go-git/go-git/tree/master/_examples[^].