Add support for templates API

Add gitlab CI and gitignores APIs

Rework the templates/license API docs

4 files changed, 98 insertions, 29 deletions

diff --git a/docs/gl_objects/licenses.py b/docs/gl_objects/licenses.py
deleted file mode 100644
index 425a9a4..0000000
--- a/docs/gl_objects/licenses.py
+++ /dev/null
@@ -1,8 +0,0 @@
-# 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
deleted file mode 100644
index 2b82379..0000000
--- a/docs/gl_objects/licenses.rst
+++ /dev/null
@@ -1,21 +0,0 @@
-########
-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
diff --git a/docs/gl_objects/templates.py b/docs/gl_objects/templates.py
new file mode 100644
index 0000000..1bc97bb
--- /dev/null
+++ b/docs/gl_objects/templates.py
@@ -0,0 +1,26 @@
+# license list
+licenses = gl.licenses.list()
+# end license list
+
+# license get
+license = gl.licenses.get('apache-2.0', project='foobar', fullname='John Doe')
+print(license.content)
+# end license get
+
+# gitignore list
+gitignores = gl.gitignores.list()
+# end gitignore list
+
+# gitignore get
+gitignore = gl.gitignores.get('Python')
+print(gitignore.content)
+# end gitignore get
+
+# gitlabciyml list
+gitlabciymls = gl.gitlabciymls.list()
+# end gitlabciyml list
+
+# gitlabciyml get
+gitlabciyml = gl.gitlabciymls.get('Pelican')
+print(gitlabciyml.content)
+# end gitlabciyml get
diff --git a/docs/gl_objects/templates.rst b/docs/gl_objects/templates.rst
new file mode 100644
index 0000000..1ce429d
--- /dev/null
+++ b/docs/gl_objects/templates.rst
@@ -0,0 +1,72 @@
+#########
+Templates
+#########
+
+You can request templates for different type of files:
+
+* License files
+* .gitignore files
+* GitLab CI configuration files
+
+License templates
+=================
+
+* Object class: :class:`~gitlab.objects.License`
+* Manager object: :attr:`gitlab.Gitlab.licenses`
+
+Examples
+--------
+
+List known license templates:
+
+.. literalinclude:: templates.py
+   :start-after: # license list
+   :end-before: # end license list
+
+Generate a license content for a project:
+
+.. literalinclude:: templates.py
+   :start-after: # license get
+   :end-before: # end license get
+
+.gitignore templates
+====================
+
+* Object class: :class:`~gitlab.objects.Gitignore`
+* Manager object: :attr:`gitlab.Gitlab.gitognores`
+
+Examples
+--------
+
+List known gitignore templates:
+
+.. literalinclude:: templates.py
+   :start-after: # gitignore list
+   :end-before: # end gitignore list
+
+Get a gitignore template:
+
+.. literalinclude:: templates.py
+   :start-after: # gitignore get
+   :end-before: # end gitignore get
+
+GitLab CI templates
+===================
+
+* Object class: :class:`~gitlab.objects.Gitlabciyml`
+* Manager object: :attr:`gitlab.Gitlab.gitlabciymls`
+
+Examples
+--------
+
+List known GitLab CI templates:
+
+.. literalinclude:: templates.py
+   :start-after: # gitlabciyml list
+   :end-before: # end gitlabciyml list
+
+Get a GitLab CI template:
+
+.. literalinclude:: templates.py
+   :start-after: # gitlabciyml get
+   :end-before: # end gitlabciyml get