feat(api): add support for Topics API

4 files changed, 143 insertions, 1 deletions

diff --git a/tests/functional/api/test_topics.py b/tests/functional/api/test_topics.py
new file mode 100644
index 0000000..7ad71a5
--- /dev/null
+++ b/tests/functional/api/test_topics.py
@@ -0,0 +1,21 @@
+"""
+GitLab API:
+https://docs.gitlab.com/ce/api/topics.html
+"""
+
+
+def test_topics(gl):
+    assert not gl.topics.list()
+
+    topic = gl.topics.create({"name": "my-topic", "description": "My Topic"})
+    assert topic.name == "my-topic"
+    assert gl.topics.list()
+
+    topic.description = "My Updated Topic"
+    topic.save()
+
+    updated_topic = gl.topics.get(topic.id)
+    assert updated_topic.description == topic.description
+
+    topic.delete()
+    assert not gl.topics.list()
diff --git a/tests/functional/conftest.py b/tests/functional/conftest.py
index 625cff9..109ee24 100644
--- a/tests/functional/conftest.py
+++ b/tests/functional/conftest.py
@@ -24,6 +24,8 @@ def reset_gitlab(gl):
         for deploy_token in group.deploytokens.list():
             deploy_token.delete()
         group.delete()
+    for topic in gl.topics.list():
+        topic.delete()
     for variable in gl.variables.list():
         variable.delete()
     for user in gl.users.list():
diff --git a/tests/functional/fixtures/.env b/tests/functional/fixtures/.env
index 374f7ac..30abd5c 100644
--- a/tests/functional/fixtures/.env
+++ b/tests/functional/fixtures/.env
@@ -1,2 +1,2 @@
 GITLAB_IMAGE=gitlab/gitlab-ce
-GITLAB_TAG=14.3.2-ce.0
+GITLAB_TAG=14.5.2-ce.0
diff --git a/tests/unit/objects/test_topics.py b/tests/unit/objects/test_topics.py
new file mode 100644
index 0000000..14b2cfd
--- /dev/null
+++ b/tests/unit/objects/test_topics.py
@@ -0,0 +1,119 @@
+"""
+GitLab API:
+https://docs.gitlab.com/ce/api/topics.html
+"""
+import pytest
+import responses
+
+from gitlab.v4.objects import Topic
+
+name = "GitLab"
+new_name = "gitlab-test"
+topic_content = {
+    "id": 1,
+    "name": name,
+    "description": "GitLab is an open source end-to-end software development platform.",
+    "total_projects_count": 1000,
+    "avatar_url": "http://www.gravatar.com/avatar/a0d477b3ea21970ce6ffcbb817b0b435?s=80&d=identicon",
+}
+topics_url = "http://localhost/api/v4/topics"
+topic_url = f"{topics_url}/1"
+
+
+@pytest.fixture
+def resp_list_topics():
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.GET,
+            url=topics_url,
+            json=[topic_content],
+            content_type="application/json",
+            status=200,
+        )
+        yield rsps
+
+
+@pytest.fixture
+def resp_get_topic():
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.GET,
+            url=topic_url,
+            json=topic_content,
+            content_type="application/json",
+            status=200,
+        )
+        yield rsps
+
+
+@pytest.fixture
+def resp_create_topic():
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.POST,
+            url=topics_url,
+            json=topic_content,
+            content_type="application/json",
+            status=200,
+        )
+        yield rsps
+
+
+@pytest.fixture
+def resp_update_topic():
+    updated_content = dict(topic_content)
+    updated_content["name"] = new_name
+
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.PUT,
+            url=topic_url,
+            json=updated_content,
+            content_type="application/json",
+            status=200,
+        )
+        yield rsps
+
+
+@pytest.fixture
+def resp_delete_topic(no_content):
+    with responses.RequestsMock() as rsps:
+        rsps.add(
+            method=responses.DELETE,
+            url=topic_url,
+            json=no_content,
+            content_type="application/json",
+            status=204,
+        )
+        yield rsps
+
+
+def test_list_topics(gl, resp_list_topics):
+    topics = gl.topics.list()
+    assert isinstance(topics, list)
+    assert isinstance(topics[0], Topic)
+    assert topics[0].name == name
+
+
+def test_get_topic(gl, resp_get_topic):
+    topic = gl.topics.get(1)
+    assert isinstance(topic, Topic)
+    assert topic.name == name
+
+
+def test_create_topic(gl, resp_create_topic):
+    topic = gl.topics.create({"name": name})
+    assert isinstance(topic, Topic)
+    assert topic.name == name
+
+
+def test_update_topic(gl, resp_update_topic):
+    topic = gl.topics.get(1, lazy=True)
+    topic.name = new_name
+    topic.save()
+    assert topic.name == new_name
+
+
+def test_delete_topic(gl, resp_delete_topic):
+    topic = gl.topics.get(1, lazy=True)
+    topic.delete()