Add 'gitea_api' module

Co-authored-by: Dan Čermák <dcermak@suse.com>

osc/gitea_api/ssh_key.py

@@ -0,0 +1,75 @@
+from typing import Optional
+
+from .connection import Connection
+from .connection import GiteaHTTPResponse
+
+
+class SSHKey:
+    @classmethod
+    def get(cls, conn: Connection, id: int) -> GiteaHTTPResponse:
+        """
+        Get an authenticated user's public key by its ``id``.
+
+        :param conn: Gitea ``Connection`` instance.
+        :param id: key numeric id
+        """
+        url = conn.makeurl("user", "keys", str(id))
+        return conn.request("GET", url)
+
+    @classmethod
+    def list(cls, conn: Connection) -> GiteaHTTPResponse:
+        """
+        List the authenticated user's public keys.
+
+        :param conn: Gitea ``Connection`` instance.
+        """
+        url = conn.makeurl("user", "keys")
+        return conn.request("GET", url)
+
+    @classmethod
+    def _split_key(cls, key):
+        import re
+        return re.split(" +", key, maxsplit=2)
+
+    @classmethod
+    def create(cls, conn: Connection, key: str, title: Optional[str] = None) -> GiteaHTTPResponse:
+        """
+        Create a public key.
+
+        :param conn: Gitea ``Connection`` instance.
+        :param key: An armored SSH key to add.
+        :param title: Title of the key to add. Derived from the key if not specified.
+        """
+        url = conn.makeurl("user", "keys")
+
+        # TODO: validate that we're sending a public ssh key
+
+        if not title:
+            title = cls._split_key(key)[2]
+
+        data = {
+            "key": key,
+            "title": title,
+        }
+        return conn.request("POST", url, json_data=data)
+
+    @classmethod
+    def delete(cls, conn: Connection, id: int):
+        """
+        Delete a public key
+
+        :param conn: Gitea ``Connection`` instance.
+        :param id: Id of key to delete.
+        """
+
+        url = conn.makeurl("user", "keys", str(id))
+        return conn.request("DELETE", url)
+
+    @classmethod
+    def to_human_readable_string(cls, data):
+        from osc.output import KeyValueTable
+        table = KeyValueTable()
+        table.add("ID", f"{data['id']}", color="bold")
+        table.add("Title", f"{data['title']}")
+        table.add("Key", f"{data['key']}")
+        return str(table)