summaryrefslogtreecommitdiffstats
path: root/wiki/src
diff options
context:
space:
mode:
authorintrigeri <intrigeri@boum.org>2020-11-18 09:15:57 +0000
committerintrigeri <intrigeri@boum.org>2020-11-18 09:15:57 +0000
commite0b43f998ce79921af0c30eaa2dfd602a794bb5e (patch)
tree6f06d724549c4a1e1ed90f5ec2fa391ae502775d /wiki/src
parent84b754086a3e61c1b18b077fbb4e5c7c81f04c6a (diff)
Document how to configure python-gitlab
Diffstat (limited to 'wiki/src')
-rw-r--r--wiki/src/contribute/working_together/GitLab.mdwn28
1 files changed, 28 insertions, 0 deletions
diff --git a/wiki/src/contribute/working_together/GitLab.mdwn b/wiki/src/contribute/working_together/GitLab.mdwn
index be98d1b..65851d0 100644
--- a/wiki/src/contribute/working_together/GitLab.mdwn
+++ b/wiki/src/contribute/working_together/GitLab.mdwn
@@ -405,6 +405,34 @@ you can:
See [[!tails_gitlab help/user/project/issues/managing_issues.html#new-issue-via-email desc="New issue via email"]]
in the GitLab documentation.
+<a id="api"></a>
+
+# Scripts that use the GitLab API
+
+We have several scripts query or manipulate data using the GitLab API:
+for example, [[!tails_gitweb bin/generate-changelog]] and [[!tails_gitweb
+bin/generate-report]].
+
+To use them:
+
+* Install the `python3-gitlab` Debian package.
+
+* Configure your `~/.python-gitlab.cfg`.
+
+ You need at least this content:
+
+ [global]
+ ssl_verify = true
+
+ [Tails]
+ url = https://gitlab.tails.boum.org
+ per_page = 100
+ private_token = XXX
+
+ In the `Tails` section, set the value of the `private_token` option to a
+ GitLab API token for your own user. To generate such a token,
+ visit [[!tails_gitlab profile/personal_access_tokens]].
+
<a id="core-work"></a>
# Core teams' work