xyberos-gitlab 0.1.0__tar.gz

xyberos_gitlab-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: xyberos-gitlab
+Version: 0.1.0
+Summary: GitLab REST plugin (RFC-0019, M7): project tools for Xyberos agents
+License: Apache-2.0
+Keywords: xyberos,plugin,gitlab,tool
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: xyberos>=1.0
+
+# xyberos-gitlab
+
+**GitLab REST plugin — RFC-0019, M7 (community wave).** Project tools for
+Xyberos agents via the GitLab REST API v4. Stdlib-only with an injectable
+transport for tests.
+
+## Install
+
+```bash
+pip install -e ./gitlab
+```
+
+## Usage
+
+```python
+from xyberos import create_app
+from xyberos_gitlab import GitlabPlugin
+
+app = create_app()
+app.load_plugin(GitlabPlugin())            # token from GITLAB_TOKEN
+
+app.tools.execute("gitlab_get_project", None, project="group/repo")
+app.tools.execute("gitlab_list_projects", None, search="xyberos", per_page=20)
+```
+
+## Tools
+
+| Tool | Notes |
+| ---- | ----- |
+| `gitlab_get_project(project)` | project by id or URL-encoded path |
+| `gitlab_list_projects(search="", per_page=20)` | search projects |
+
+Requires `GITLAB_TOKEN`.
+
+## Tests
+
+```bash
+pip install pytest
+pytest tests/
+```
+
+Canned responses via an injectable transport — no network.
+
+## Ship location
+
+Plugin (`xyberos.plugins` entry point) — community wave (M7).

xyberos_gitlab-0.1.0/README.md

@@ -0,0 +1,46 @@
+# xyberos-gitlab
+
+**GitLab REST plugin — RFC-0019, M7 (community wave).** Project tools for
+Xyberos agents via the GitLab REST API v4. Stdlib-only with an injectable
+transport for tests.
+
+## Install
+
+```bash
+pip install -e ./gitlab
+```
+
+## Usage
+
+```python
+from xyberos import create_app
+from xyberos_gitlab import GitlabPlugin
+
+app = create_app()
+app.load_plugin(GitlabPlugin())            # token from GITLAB_TOKEN
+
+app.tools.execute("gitlab_get_project", None, project="group/repo")
+app.tools.execute("gitlab_list_projects", None, search="xyberos", per_page=20)
+```
+
+## Tools
+
+| Tool | Notes |
+| ---- | ----- |
+| `gitlab_get_project(project)` | project by id or URL-encoded path |
+| `gitlab_list_projects(search="", per_page=20)` | search projects |
+
+Requires `GITLAB_TOKEN`.
+
+## Tests
+
+```bash
+pip install pytest
+pytest tests/
+```
+
+Canned responses via an injectable transport — no network.
+
+## Ship location
+
+Plugin (`xyberos.plugins` entry point) — community wave (M7).

xyberos_gitlab-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xyberos-gitlab"
+version = "0.1.0"
+description = "GitLab REST plugin (RFC-0019, M7): project tools for Xyberos agents"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "Apache-2.0"}
+dependencies = ["xyberos>=1.0"]
+keywords = ["xyberos", "plugin", "gitlab", "tool"]
+
+[project.entry-points."xyberos.plugins"]
+gitlab = "xyberos_gitlab.plugin:plugin"
+
+[tool.setuptools]
+packages = ["xyberos_gitlab"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]

xyberos_gitlab-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xyberos_gitlab-0.1.0/tests/test_client.py

@@ -0,0 +1,41 @@
+"""Tests for the GitLab REST client (injectable transport, no network)."""
+
+from __future__ import annotations
+
+import pytest
+from xyberos.exceptions.provider import ProviderError
+
+from xyberos_gitlab import GitlabClient
+
+
+def _fake_request():
+    def request(method, url, **kwargs):
+        if url.endswith("/projects/group%2Frepo"):
+            return 200, {"id": 1, "name": "repo", "path_with_namespace": "group/repo", "web_url": "https://gitlab.com/group/repo"}
+        if url.endswith("/projects"):
+            return 200, [{"name": "repo", "path_with_namespace": "group/repo", "web_url": "https://gitlab.com/group/repo"}]
+        return 404, {"message": "not found"}
+
+    return request
+
+
+def test_get_project_encodes_path():
+    request = _fake_request()
+    client = GitlabClient(token="t", request=request)
+    result = client.get_project("group/repo")
+    assert result["path_with_namespace"] == "group/repo"
+    assert result["web_url"] == "https://gitlab.com/group/repo"
+
+
+def test_list_projects():
+    request = _fake_request()
+    client = GitlabClient(token="t", request=request)
+    projects = client.list_projects("repo", per_page=5)
+    assert projects[0]["name"] == "repo"
+
+
+def test_requires_token():
+    request = _fake_request()
+    client = GitlabClient(token=None, request=request)
+    with pytest.raises(ProviderError, match="token"):
+        client.get_project("g/r")

xyberos_gitlab-0.1.0/tests/test_plugin.py

@@ -0,0 +1,28 @@
+"""Tests for loading the GitLab plugin into a Xyberos app."""
+
+from __future__ import annotations
+
+from xyberos import create_app
+
+from xyberos_gitlab import GitlabPlugin
+
+
+def _fake_request():
+    def request(method, url, **kwargs):
+        if url.endswith("/projects"):
+            return 200, [{"name": "repo", "path_with_namespace": "group/repo", "web_url": "https://gitlab.com/group/repo"}]
+        return 404, {"message": "not found"}
+
+    return request
+
+
+def test_plugin_registers_and_executes():
+    app = create_app()
+    app.load_plugin(GitlabPlugin(token="t", request=_fake_request()))
+    assert "gitlab_get_project" in app.tools.names
+    assert "gitlab_list_projects" in app.tools.names
+
+    projects = app.tools.execute("gitlab_list_projects", None, search="repo")
+    assert projects[0]["name"] == "repo"
+
+    app.unload_plugin("gitlab")

xyberos_gitlab-0.1.0/xyberos_gitlab/__init__.py

@@ -0,0 +1,6 @@
+"""GitLab REST plugin (RFC-0019, M7)."""
+
+from .client import GitlabClient
+from .plugin import GitlabPlugin
+
+__all__ = ["GitlabClient", "GitlabPlugin"]

xyberos_gitlab-0.1.0/xyberos_gitlab/client.py

@@ -0,0 +1,70 @@
+"""A minimal GitLab REST client (stdlib ``urllib``, injectable transport)."""
+
+from __future__ import annotations
+
+import os
+import urllib.parse
+from typing import Any
+
+from xyberos.exceptions.provider import ProviderError
+
+from .http import RequestTransport, default_request
+
+
+def _raise_for_status(status: int, body: Any) -> None:
+    if 200 <= status < 300:
+        return
+    message = body if isinstance(body, str) else str(body)
+    raise ProviderError(f"GitLab API returned HTTP {status}: {message[:200]}")
+
+
+class GitlabClient:
+    """Thin client for the GitLab REST API v4."""
+
+    def __init__(
+        self,
+        token: str | None = None,
+        *,
+        base_url: str = "https://gitlab.com/api/v4",
+        request: RequestTransport | None = None,
+        timeout: float = 30.0,
+    ) -> None:
+        self._token = token if token is not None else os.getenv("GITLAB_TOKEN")
+        self._base_url = base_url.rstrip("/")
+        self._request = request or default_request
+        self._timeout = timeout
+
+    def get_project(self, project: str) -> dict[str, Any]:
+        encoded = urllib.parse.quote(project, safe="")
+        status, body = self._request(
+            "GET",
+            f"{self._base_url}/projects/{encoded}",
+            headers=self._headers(),
+            timeout=self._timeout,
+        )
+        _raise_for_status(status, body)
+        return {
+            "id": body.get("id"),
+            "name": body.get("name"),
+            "path_with_namespace": body.get("path_with_namespace"),
+            "web_url": body.get("web_url"),
+        }
+
+    def list_projects(self, search: str = "", *, per_page: int = 20) -> list[dict[str, Any]]:
+        status, body = self._request(
+            "GET",
+            f"{self._base_url}/projects",
+            query={"search": search, "per_page": per_page},
+            headers=self._headers(),
+            timeout=self._timeout,
+        )
+        _raise_for_status(status, body)
+        return [
+            {"name": project.get("name"), "path_with_namespace": project.get("path_with_namespace"), "web_url": project.get("web_url")}
+            for project in body
+        ]
+
+    def _headers(self) -> dict[str, str]:
+        if not self._token:
+            raise ProviderError("GitLab requires a token (set GITLAB_TOKEN)")
+        return {"PRIVATE-TOKEN": self._token}

xyberos_gitlab-0.1.0/xyberos_gitlab/http.py

@@ -0,0 +1,57 @@
+"""A tiny stdlib HTTP helper (no third-party deps).
+
+``default_request`` performs one HTTP request with ``urllib`` and returns
+``(status, body)`` where ``body`` is parsed JSON when the response is JSON,
+otherwise raw text. Injectable so tests run without a network.
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Callable
+
+#: (method, url, *, json_body, headers, query, timeout) -> (status, body)
+RequestTransport = Callable[..., tuple[int, Any]]
+
+
+def default_request(
+    method: str,
+    url: str,
+    *,
+    json_body: Any = None,
+    headers: dict[str, str] | None = None,
+    query: dict[str, Any] | None = None,
+    timeout: float = 30.0,
+) -> tuple[int, Any]:
+    """Send one request and return ``(status, parsed_json_or_text)``."""
+    final_url = url
+    if query:
+        separator = "&" if "?" in url else "?"
+        final_url = url + separator + urllib.parse.urlencode(query)
+
+    data: bytes | None = None
+    request_headers = dict(headers or {})
+    if json_body is not None:
+        data = json.dumps(json_body).encode("utf-8")
+        request_headers.setdefault("Content-Type", "application/json")
+
+    request = urllib.request.Request(
+        final_url, data=data, headers=request_headers, method=method
+    )
+    try:
+        with urllib.request.urlopen(request, timeout=timeout) as response:
+            raw = response.read()
+            content_type = response.headers.get("Content-Type", "")
+    except urllib.error.HTTPError as exc:
+        return exc.code, exc.read().decode("utf-8", errors="replace")
+
+    text = raw.decode("utf-8", errors="replace")
+    if "application/json" in content_type or text.lstrip().startswith("{"):
+        try:
+            return 200, json.loads(text)
+        except json.JSONDecodeError:
+            return 200, text
+    return 200, text

xyberos_gitlab-0.1.0/xyberos_gitlab/plugin.py

@@ -0,0 +1,60 @@
+"""GitLab plugin entry point (RFC-0019, M7)."""
+
+from __future__ import annotations
+
+from typing import Any, cast
+
+from xyberos.contracts import Plugin, Tool
+from xyberos.tools import FunctionTool
+
+from .client import GitlabClient
+from .http import RequestTransport
+
+
+def _pop_tool(registry: Any, name: str) -> None:
+    unregister = getattr(registry, "unregister", None)
+    if callable(unregister):
+        unregister(name)
+        return
+    store = getattr(registry, "_tools", None)
+    if isinstance(store, dict):
+        cast(dict[str, Any], store).pop(name, None)
+
+
+class GitlabPlugin(Plugin):
+    """Registers GitLab tools (projects)."""
+
+    def __init__(self, token: str | None = None, *, request: RequestTransport | None = None) -> None:
+        self._client = GitlabClient(token, request=request)
+
+    @property
+    def name(self) -> str:
+        return "gitlab"
+
+    def tools(self) -> list[Tool]:
+        client = self._client
+
+        def _get_project(project: str) -> dict[str, Any]:
+            return client.get_project(project)
+
+        def _list_projects(search: str = "", per_page: int = 20) -> list[dict[str, Any]]:
+            return client.list_projects(search, per_page=per_page)
+
+        return [
+            FunctionTool("gitlab_get_project", _get_project, description="Get a GitLab project by path or id."),
+            FunctionTool("gitlab_list_projects", _list_projects, description="Search GitLab projects."),
+        ]
+
+    def register(self, kernel: object) -> None:
+        registry = kernel.resolve("tools")
+        for tool in self.tools():
+            registry.register(tool)
+
+    def unregister(self, kernel: object) -> None:
+        registry = kernel.resolve("tools")
+        for tool in self.tools():
+            _pop_tool(registry, tool.name)
+
+
+#: Auto-discovered by ``app.load_entry_points()``.
+plugin = GitlabPlugin()

xyberos_gitlab-0.1.0/xyberos_gitlab.egg-info/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: xyberos-gitlab
+Version: 0.1.0
+Summary: GitLab REST plugin (RFC-0019, M7): project tools for Xyberos agents
+License: Apache-2.0
+Keywords: xyberos,plugin,gitlab,tool
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: xyberos>=1.0
+
+# xyberos-gitlab
+
+**GitLab REST plugin — RFC-0019, M7 (community wave).** Project tools for
+Xyberos agents via the GitLab REST API v4. Stdlib-only with an injectable
+transport for tests.
+
+## Install
+
+```bash
+pip install -e ./gitlab
+```
+
+## Usage
+
+```python
+from xyberos import create_app
+from xyberos_gitlab import GitlabPlugin
+
+app = create_app()
+app.load_plugin(GitlabPlugin())            # token from GITLAB_TOKEN
+
+app.tools.execute("gitlab_get_project", None, project="group/repo")
+app.tools.execute("gitlab_list_projects", None, search="xyberos", per_page=20)
+```
+
+## Tools
+
+| Tool | Notes |
+| ---- | ----- |
+| `gitlab_get_project(project)` | project by id or URL-encoded path |
+| `gitlab_list_projects(search="", per_page=20)` | search projects |
+
+Requires `GITLAB_TOKEN`.
+
+## Tests
+
+```bash
+pip install pytest
+pytest tests/
+```
+
+Canned responses via an injectable transport — no network.
+
+## Ship location
+
+Plugin (`xyberos.plugins` entry point) — community wave (M7).

xyberos_gitlab-0.1.0/xyberos_gitlab.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+tests/test_client.py
+tests/test_plugin.py
+xyberos_gitlab/__init__.py
+xyberos_gitlab/client.py
+xyberos_gitlab/http.py
+xyberos_gitlab/plugin.py
+xyberos_gitlab.egg-info/PKG-INFO
+xyberos_gitlab.egg-info/SOURCES.txt
+xyberos_gitlab.egg-info/dependency_links.txt
+xyberos_gitlab.egg-info/entry_points.txt
+xyberos_gitlab.egg-info/requires.txt
+xyberos_gitlab.egg-info/top_level.txt

xyberos_gitlab-0.1.0/xyberos_gitlab.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

xyberos_gitlab-0.1.0/xyberos_gitlab.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[xyberos.plugins]
+gitlab = xyberos_gitlab.plugin:plugin

xyberos_gitlab-0.1.0/xyberos_gitlab.egg-info/requires.txt

@@ -0,0 +1 @@
+xyberos>=1.0

xyberos_gitlab-0.1.0/xyberos_gitlab.egg-info/top_level.txt

@@ -0,0 +1 @@
+xyberos_gitlab