summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/api-objects.rst1
-rw-r--r--docs/gl_objects/licenses.py8
-rw-r--r--docs/gl_objects/licenses.rst21
3 files changed, 30 insertions, 0 deletions
diff --git a/docs/api-objects.rst b/docs/api-objects.rst
index 788fff2..bf1a4a6 100644
--- a/docs/api-objects.rst
+++ b/docs/api-objects.rst
@@ -13,6 +13,7 @@ API objects manipulation
gl_objects/groups
gl_objects/issues
gl_objects/labels
+ gl_objects/licenses
gl_objects/namespaces
gl_objects/projects
gl_objects/runners
diff --git a/docs/gl_objects/licenses.py b/docs/gl_objects/licenses.py
new file mode 100644
index 0000000..425a9a4
--- /dev/null
+++ b/docs/gl_objects/licenses.py
@@ -0,0 +1,8 @@
+# list
+licenses = gl.licenses.list()
+# end list
+
+# get
+license = gl.licenses.get('apache-2.0', project='foobar', fullname='John Doe')
+print(license.content)
+# end get
diff --git a/docs/gl_objects/licenses.rst b/docs/gl_objects/licenses.rst
new file mode 100644
index 0000000..2b82379
--- /dev/null
+++ b/docs/gl_objects/licenses.rst
@@ -0,0 +1,21 @@
+########
+Licenses
+########
+
+Use :class:`~gitlab.objects.License` objects to manipulate licenses. The
+:attr:`gitlab.Gitlab.licenses` manager object provides helper functions.
+
+Examples
+--------
+
+List known licenses:
+
+.. literalinclude:: licenses.py
+ :start-after: # list
+ :end-before: # end list
+
+Generate a license content for a project:
+
+.. literalinclude:: licenses.py
+ :start-after: # get
+ :end-before: # end get