runspec-gitlab 0.2.0__tar.gz → 0.2.1__tar.gz

{runspec_gitlab-0.2.0 → runspec_gitlab-0.2.1}/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `runspec-gitlab` are documented here.
 
+## [0.2.1] — 2026-09-20
+
+### Changed
+
+- **Packaging metadata for the runspec-console Marketplace.** Add a README
+  (rendered in the Marketplace card's Details view) and publish `keywords`
+  and Documentation / Source / Changelog / Issues project URLs, so the
+  package's Marketplace card shows a description, tags and links. No
+  runnable, argument, or behaviour changes.
+
 ## [0.2.0]
 
 Reconciled the verb set against GitLab's canonical MCP tool registry

runspec_gitlab-0.2.1/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.5
+Name: runspec-gitlab
+Version: 0.2.1
+Summary: GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server
+Project-URL: Documentation, https://runspec.app/
+Project-URL: Source, https://github.com/jasonfinestone/runspec/tree/main/packages/python/runspec-gitlab
+Project-URL: Changelog, https://github.com/jasonfinestone/runspec/blob/main/packages/python/runspec-gitlab/CHANGELOG.md
+Project-URL: Issues, https://github.com/jasonfinestone/runspec/issues
+Keywords: gitlab,mcp,runnable,runspec
+Requires-Python: >=3.10
+Requires-Dist: runspec-gitlab-core>=0.2.0
+Requires-Dist: runspec>=0.44.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff==0.15.20; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# runspec-gitlab
+
+A read-only GitLab runnable for [runspec](https://pypi.org/project/runspec/),
+ported onto the GitLab REST API (v4) — **not** proxying GitLab's hosted MCP
+server. One runnable — **`gitlab`** — with 17 read verbs, all `autonomy =
+"autonomous"`. `pip install` it into a venv and it's discoverable by `runspec
+local`, `runspec serve` (MCP), and runspec-console.
+
+`runspec serve` flattens each verb into a leaf MCP tool (`gitlab_get-issue`, …).
+Verb names are reconciled against GitLab's canonical MCP tool registry; the
+extras (`whoami`, `get-project`, `search-projects`, `list-issues`, `get-file`,
+`list-tree`) are useful REST reads GitLab has no MCP tool for.
+
+## Install
+
+```
+pip install runspec-gitlab
+```
+
+## Verbs
+
+| Area | Verbs |
+|---|---|
+| Account / project | `whoami`, `get-project`, `search-projects`, `get-file`, `list-tree` |
+| Issues | `list-issues`, `get-issue` |
+| Merge requests | `list-merge-requests`, `get-merge-request`, `get-merge-request-diffs`, `get-merge-request-commits`, `get-merge-request-notes`, `get-merge-request-pipelines`, `get-merge-request-conflicts` |
+| Pipelines | `list-pipelines`, `get-pipeline-jobs`, `get-job-log` |
+
+`get-merge-request-conflicts` is best-effort — GitLab has no public `/api/v4`
+conflicts endpoint, so it relays the web-UI endpoint and returns its JSON
+verbatim.
+
+## Auth — env vars only
+
+```
+export GITLAB_URL=https://gitlab.example.com        # default https://gitlab.com
+export GITLAB_TOKEN=<personal-or-project-access-token>
+export GITLAB_PROJECT=group/subgroup/project        # optional default
+```
+
+Every verb takes `--env`, selecting `GITLAB_<ENV>_*` prefixed vars. `--project`
+accepts a numeric id or a `group/project` path and falls back to
+`GITLAB_PROJECT`.
+
+```
+gitlab whoami
+gitlab list-merge-requests --project group/app --state opened
+gitlab get-job-log --project group/app --job-id 998877
+```
+
+## Public Python API
+
+The pure logic is in **[`runspec-gitlab-core`](../runspec-gitlab-core)** —
+`httpx`-only, no `runspec` dependency, no entry points. Every op takes a
+`GitlabConfig` first arg and raises `GitlabError`, so a private wrapper can
+inject credentials and bake in a default `project` / `env`:
+
+```python
+from runspec_gitlab_core import config_from_env, get_issue, list_merge_requests
+
+cfg = config_from_env(env="prod")
+mrs = list_merge_requests(cfg, state="opened")
+```
+
+## Development
+
+```
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+pytest
+```

runspec_gitlab-0.2.1/README.md

@@ -0,0 +1,72 @@
+# runspec-gitlab
+
+A read-only GitLab runnable for [runspec](https://pypi.org/project/runspec/),
+ported onto the GitLab REST API (v4) — **not** proxying GitLab's hosted MCP
+server. One runnable — **`gitlab`** — with 17 read verbs, all `autonomy =
+"autonomous"`. `pip install` it into a venv and it's discoverable by `runspec
+local`, `runspec serve` (MCP), and runspec-console.
+
+`runspec serve` flattens each verb into a leaf MCP tool (`gitlab_get-issue`, …).
+Verb names are reconciled against GitLab's canonical MCP tool registry; the
+extras (`whoami`, `get-project`, `search-projects`, `list-issues`, `get-file`,
+`list-tree`) are useful REST reads GitLab has no MCP tool for.
+
+## Install
+
+```
+pip install runspec-gitlab
+```
+
+## Verbs
+
+| Area | Verbs |
+|---|---|
+| Account / project | `whoami`, `get-project`, `search-projects`, `get-file`, `list-tree` |
+| Issues | `list-issues`, `get-issue` |
+| Merge requests | `list-merge-requests`, `get-merge-request`, `get-merge-request-diffs`, `get-merge-request-commits`, `get-merge-request-notes`, `get-merge-request-pipelines`, `get-merge-request-conflicts` |
+| Pipelines | `list-pipelines`, `get-pipeline-jobs`, `get-job-log` |
+
+`get-merge-request-conflicts` is best-effort — GitLab has no public `/api/v4`
+conflicts endpoint, so it relays the web-UI endpoint and returns its JSON
+verbatim.
+
+## Auth — env vars only
+
+```
+export GITLAB_URL=https://gitlab.example.com        # default https://gitlab.com
+export GITLAB_TOKEN=<personal-or-project-access-token>
+export GITLAB_PROJECT=group/subgroup/project        # optional default
+```
+
+Every verb takes `--env`, selecting `GITLAB_<ENV>_*` prefixed vars. `--project`
+accepts a numeric id or a `group/project` path and falls back to
+`GITLAB_PROJECT`.
+
+```
+gitlab whoami
+gitlab list-merge-requests --project group/app --state opened
+gitlab get-job-log --project group/app --job-id 998877
+```
+
+## Public Python API
+
+The pure logic is in **[`runspec-gitlab-core`](../runspec-gitlab-core)** —
+`httpx`-only, no `runspec` dependency, no entry points. Every op takes a
+`GitlabConfig` first arg and raises `GitlabError`, so a private wrapper can
+inject credentials and bake in a default `project` / `env`:
+
+```python
+from runspec_gitlab_core import config_from_env, get_issue, list_merge_requests
+
+cfg = config_from_env(env="prod")
+mrs = list_merge_requests(cfg, state="opened")
+```
+
+## Development
+
+```
+python -m venv .venv && . .venv/bin/activate
+pip install -e ".[dev]"
+ruff check . && ruff format --check .
+pytest
+```

{runspec_gitlab-0.2.0 → runspec_gitlab-0.2.1}/pyproject.toml

@@ -4,9 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "runspec-gitlab"
-version = "0.2.0"
+version = "0.2.1"
 requires-python = ">=3.10"
 description = "GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server"
+readme = "README.md"
+keywords = ["runspec", "runnable", "gitlab", "mcp"]
 dependencies = [
     # 0.44.0 surfaces inherited args (the global --env) on each leaf subcommand's
     # MCP tool via `runspec serve`.
@@ -14,6 +16,12 @@ dependencies = [
     "runspec-gitlab-core>=0.2.0",
 ]
 
+[project.urls]
+Documentation = "https://runspec.app/"
+Source        = "https://github.com/jasonfinestone/runspec/tree/main/packages/python/runspec-gitlab"
+Changelog     = "https://github.com/jasonfinestone/runspec/blob/main/packages/python/runspec-gitlab/CHANGELOG.md"
+Issues        = "https://github.com/jasonfinestone/runspec/issues"
+
 [project.scripts]
 # Entry point name MUST match the runnable name in runspec.toml (`gitlab`).
 gitlab = "runspec_gitlab.cli:main"

runspec_gitlab-0.2.0/PKG-INFO

@@ -1,11 +0,0 @@
-Metadata-Version: 2.4
-Name: runspec-gitlab
-Version: 0.2.0
-Summary: GitLab read runnable for runspec — issues, merge requests, pipelines, and repository reads, ported from the GitLab MCP server
-Requires-Python: >=3.10
-Requires-Dist: runspec-gitlab-core>=0.2.0
-Requires-Dist: runspec>=0.44.0
-Provides-Extra: dev
-Requires-Dist: mypy; extra == 'dev'
-Requires-Dist: pytest>=8.0; extra == 'dev'
-Requires-Dist: ruff==0.15.20; extra == 'dev'