Differences

This shows you the differences between two versions of the page.

--- gitlab:tips:api [2016/01/26 22:33] – cedric
+++ gitlab:tips:api [2016/01/27 07:35] (current) – cedric
@@ Line 1: / Line 1: @@
-GitLab provides [[http://doc.gitlab.com/ce/api/ | a powerful API]] that lets you interact programmatically with a GitLab instance and automate a lot of things.
+GitLab provides [[http://doc.gitlab.com/ce/api/ | a powerful API]] that lets you interact programmatically with a GitLab instance in order to automate a lot of things.
-This tutorial presents how to use this API with Python.
+This tutorial presents how to use the API of GitLab with [[https://www.python.org | Python]]. Of course you can use your favorite language.
-For the examples below we will use the instance *https://gitlab.example.org*. Of course you can use *https://gitlab.com*.
+> For the examples below we will use the instance https://gitlab.example.org. Of course you can use https://gitlab.com.
 ====== Get the list of users registered in GitLab ======
-This first example is fairly easy and uses the [[http://doc.gitlab.com/ce/api/users.html | Users resource]].
+This first example is fairly easy and takes advantage of the [[http://doc.gitlab.com/ce/api/users.html | Users resource]].
 <code python>
@@ Line 28: / Line 28: @@
         print user["username"], user["email"]
 </code>
+The //requests// library is used to query the API and the //json// library is used to parse the result received from the server. Here the result is simply a list of users.
 ====== Send an email to the members of a GitLab group ======
-Again, this is pretty easy. We will need to use the resources [[http://doc.gitlab.com/ce/api/groups.html | Groups]] and [[http://doc.gitlab.com/ce/api/users.html | Users]].
+Again, this is pretty easy. We will need the [[http://doc.gitlab.com/ce/api/groups.html | Groups]] resource and the [[http://doc.gitlab.com/ce/api/users.html | Users]] resource.
-In order to send the email to the members of the GitLab group, we will use the [[http://www.mutt.org/ | Mutt] email client.
+In order to send the email, we will simply use the [[http://www.mutt.org/ | Mutt]] email client.
 The Mutt command will look like this:
@@ Line 43: / Line 46: @@
 As you can see, Mutt needs three parameters:
   * the subject of the email. Will be given in parameter;
-  * the message to be sent. Will be given through a Unix pipeline;
+  * the message to be sent. Will be given through a Unix pipeline (//message.txt//);
-  * the list of recipients (members of the GitLab groups). Will be given in parameter as the result of a Python script.
+  * the list of recipients (members of the GitLab group). Will be given in parameter as the result of a Python script.
-As you can expect the Python script will use the API of GitLab in order to get the required list of recipients.
+As you can expect, the Python script will use the API of GitLab in order to get the list of recipients.
-Below you will find a script you can use:
+Below you will find a working script:
 <code python>
@@ Line 71: / Line 74: @@
         if r.status_code == 200:
             user = json.loads(r.content)
-            EMAILS.append(user["email"])
+            if user["state"] == "active":
+                EMAILS.append(user["email"])
 </code>
+A first request to the //Groups// resource returns the list of members in the group. The ''for'' loop iterates through these members in order to get their email.
+Only active users (//user["state"] == "active"//) will receive the email.