qodev-gitlab-cli 0.1.1__tar.gz → 0.2.0__tar.gz

qodev_gitlab_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qodev GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qodev_gitlab_cli-0.2.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: qodev-gitlab-cli
+Version: 0.2.0
+Summary: Agent-friendly CLI for the GitLab API
+Project-URL: Homepage, https://github.com/qodevai/gitlab-cli
+Project-URL: Repository, https://github.com/qodevai/gitlab-cli
+Project-URL: Issues, https://github.com/qodevai/gitlab-cli/issues
+Author-email: Jan Scheffler <jan.scheffler@qodev.ai>
+License: MIT
+License-File: LICENSE
+Keywords: api,cli,devops,gitlab
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: cyclopts>=3.0
+Requires-Dist: qodev-gitlab-api>=0.1.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.15; extra == 'dev'
+Requires-Dist: pytest>=9.0; extra == 'dev'
+Requires-Dist: ruff>=0.15; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# qodev-gitlab-cli
+
+Agent-friendly CLI for the GitLab API. Designed for both human and AI-agent workflows, with structured JSON output, consistent flags, and predictable error codes.
+
+## Installation
+
+```bash
+pip install qodev-gitlab-cli
+```
+
+Or run directly without installing:
+
+```bash
+uvx qodev-gitlab-cli
+```
+
+## Quick Start
+
+```bash
+# Set your GitLab token
+export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxx"
+
+# List open merge requests for a project
+qodev-gitlab mrs list --project mygroup/myproject
+
+# Get details of a specific issue
+qodev-gitlab issues get 42 --project mygroup/myproject
+
+# List pipelines, output as JSON for scripting
+qodev-gitlab pipelines list --project mygroup/myproject --json
+
+# Create a merge request from the current branch
+qodev-gitlab mrs create --title "Add new feature" --project mygroup/myproject
+```
+
+## Commands
+
+| Group | Subcommand | Description |
+|---|---|---|
+| **projects** | `list` | List projects (`--owned` for owned only) |
+| | `get` | Get project details |
+| **mrs** | `list` | List merge requests (`--state`) |
+| | `get` | Get merge request details |
+| | `create` | Create a merge request (`--title`, `--source`, `--target`, `--description`, `--labels`, `--squash`) |
+| | `update` | Update a merge request (`--title`, `--description`, `--labels`, `--target`) |
+| | `merge` | Merge a merge request (`--squash`, `--when-pipeline-succeeds`) |
+| | `close` | Close a merge request |
+| | `discussions` | List discussions on a merge request |
+| | `changes` | Show diff for a merge request |
+| | `commits` | List commits in a merge request |
+| | `approvals` | Show approval status |
+| | `comment` | Comment on a merge request (`--body`) |
+| | `pipelines` | List pipelines for a merge request |
+| **pipelines** | `list` | List pipelines (`--ref`, `--limit`) |
+| | `get` | Get pipeline details |
+| | `jobs` | List jobs for a pipeline |
+| | `wait` | Wait for a pipeline to complete (`--timeout`, `--interval`) |
+| **jobs** | `get` | Get job details |
+| | `log` | Get job log output |
+| | `retry` | Retry a failed job |
+| **issues** | `list` | List issues (`--state`, `--labels`, `--milestone`) |
+| | `get` | Get issue details |
+| | `create` | Create an issue (`--title`, `--description`, `--labels`) |
+| | `update` | Update an issue (`--title`, `--description`, `--labels`) |
+| | `close` | Close an issue |
+| | `comment` | Comment on an issue (`--body`) |
+| | `notes` | List comments/notes on an issue |
+| **releases** | `list` | List releases |
+| | `get` | Get release details by tag |
+| | `create` | Create a release (`--tag`, `--name`, `--description`, `--ref`) |
+| **variables** | `list` | List CI/CD variables (values hidden) |
+| | `get` | Get a CI/CD variable |
+| | `set` | Set (create or update) a CI/CD variable (`--protected`, `--masked`) |
+
+## Configuration
+
+### Authentication
+
+Set the `GITLAB_TOKEN` environment variable, or pass `--token` on each invocation:
+
+```bash
+export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxx"
+```
+
+### GitLab Instance
+
+By default the CLI targets `https://gitlab.com`. Override with the `GITLAB_URL` environment variable or the `--url` flag:
+
+```bash
+export GITLAB_URL="https://gitlab.example.com"
+```
+
+### Global Options
+
+| Flag | Description | Default |
+|---|---|---|
+| `--json` | Output as JSON (for scripting / agents) | `false` |
+| `--project`, `-p` | Project ID or path | auto-detected from git remote |
+| `--limit` | Results per page | `25` |
+| `--page` | Page number | `1` |
+| `--token` | GitLab token (overrides `GITLAB_TOKEN`) | |
+| `--url` | GitLab URL (overrides `GITLAB_URL`) | |
+
+### Exit Codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success |
+| `80` | Authentication error |
+| `81` | Not found |
+| `82` | API error |
+| `83` | Validation error |
+| `84` | Configuration error |
+
+## License
+
+MIT -- see [LICENSE](LICENSE) for details.

qodev_gitlab_cli-0.2.0/README.md

@@ -0,0 +1,117 @@
+# qodev-gitlab-cli
+
+Agent-friendly CLI for the GitLab API. Designed for both human and AI-agent workflows, with structured JSON output, consistent flags, and predictable error codes.
+
+## Installation
+
+```bash
+pip install qodev-gitlab-cli
+```
+
+Or run directly without installing:
+
+```bash
+uvx qodev-gitlab-cli
+```
+
+## Quick Start
+
+```bash
+# Set your GitLab token
+export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxx"
+
+# List open merge requests for a project
+qodev-gitlab mrs list --project mygroup/myproject
+
+# Get details of a specific issue
+qodev-gitlab issues get 42 --project mygroup/myproject
+
+# List pipelines, output as JSON for scripting
+qodev-gitlab pipelines list --project mygroup/myproject --json
+
+# Create a merge request from the current branch
+qodev-gitlab mrs create --title "Add new feature" --project mygroup/myproject
+```
+
+## Commands
+
+| Group | Subcommand | Description |
+|---|---|---|
+| **projects** | `list` | List projects (`--owned` for owned only) |
+| | `get` | Get project details |
+| **mrs** | `list` | List merge requests (`--state`) |
+| | `get` | Get merge request details |
+| | `create` | Create a merge request (`--title`, `--source`, `--target`, `--description`, `--labels`, `--squash`) |
+| | `update` | Update a merge request (`--title`, `--description`, `--labels`, `--target`) |
+| | `merge` | Merge a merge request (`--squash`, `--when-pipeline-succeeds`) |
+| | `close` | Close a merge request |
+| | `discussions` | List discussions on a merge request |
+| | `changes` | Show diff for a merge request |
+| | `commits` | List commits in a merge request |
+| | `approvals` | Show approval status |
+| | `comment` | Comment on a merge request (`--body`) |
+| | `pipelines` | List pipelines for a merge request |
+| **pipelines** | `list` | List pipelines (`--ref`, `--limit`) |
+| | `get` | Get pipeline details |
+| | `jobs` | List jobs for a pipeline |
+| | `wait` | Wait for a pipeline to complete (`--timeout`, `--interval`) |
+| **jobs** | `get` | Get job details |
+| | `log` | Get job log output |
+| | `retry` | Retry a failed job |
+| **issues** | `list` | List issues (`--state`, `--labels`, `--milestone`) |
+| | `get` | Get issue details |
+| | `create` | Create an issue (`--title`, `--description`, `--labels`) |
+| | `update` | Update an issue (`--title`, `--description`, `--labels`) |
+| | `close` | Close an issue |
+| | `comment` | Comment on an issue (`--body`) |
+| | `notes` | List comments/notes on an issue |
+| **releases** | `list` | List releases |
+| | `get` | Get release details by tag |
+| | `create` | Create a release (`--tag`, `--name`, `--description`, `--ref`) |
+| **variables** | `list` | List CI/CD variables (values hidden) |
+| | `get` | Get a CI/CD variable |
+| | `set` | Set (create or update) a CI/CD variable (`--protected`, `--masked`) |
+
+## Configuration
+
+### Authentication
+
+Set the `GITLAB_TOKEN` environment variable, or pass `--token` on each invocation:
+
+```bash
+export GITLAB_TOKEN="glpat-xxxxxxxxxxxxxxxxxxxx"
+```
+
+### GitLab Instance
+
+By default the CLI targets `https://gitlab.com`. Override with the `GITLAB_URL` environment variable or the `--url` flag:
+
+```bash
+export GITLAB_URL="https://gitlab.example.com"
+```
+
+### Global Options
+
+| Flag | Description | Default |
+|---|---|---|
+| `--json` | Output as JSON (for scripting / agents) | `false` |
+| `--project`, `-p` | Project ID or path | auto-detected from git remote |
+| `--limit` | Results per page | `25` |
+| `--page` | Page number | `1` |
+| `--token` | GitLab token (overrides `GITLAB_TOKEN`) | |
+| `--url` | GitLab URL (overrides `GITLAB_URL`) | |
+
+### Exit Codes
+
+| Code | Meaning |
+|---|---|
+| `0` | Success |
+| `80` | Authentication error |
+| `81` | Not found |
+| `82` | API error |
+| `83` | Validation error |
+| `84` | Configuration error |
+
+## License
+
+MIT -- see [LICENSE](LICENSE) for details.

{qodev_gitlab_cli-0.1.1 → qodev_gitlab_cli-0.2.0}/pyproject.toml

@@ -1,8 +1,22 @@
 [project]
 name = "qodev-gitlab-cli"
-version = "0.1.1"
+version = "0.2.0"
 description = "Agent-friendly CLI for the GitLab API"
+readme = "README.md"
 requires-python = ">=3.11"
+authors = [{ name = "Jan Scheffler", email = "jan.scheffler@qodev.ai" }]
+license = { text = "MIT" }
+keywords = ["gitlab", "cli", "api", "devops"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
 dependencies = [
     "cyclopts>=3.0",
     "rich>=13.0",
@@ -18,6 +32,7 @@ qodev-gitlab = "qodev_gitlab_cli.app:main"
 [project.urls]
 Homepage = "https://github.com/qodevai/gitlab-cli"
 Repository = "https://github.com/qodevai/gitlab-cli"
+Issues = "https://github.com/qodevai/gitlab-cli/issues"
 
 [build-system]
 requires = ["hatchling"]

{qodev_gitlab_cli-0.1.1 → qodev_gitlab_cli-0.2.0}/src/qodev_gitlab_cli/commands/mrs.py

@@ -64,6 +64,7 @@ def create(
             from qodev_gitlab_cli.output import error
 
             error("Could not detect current branch. Use --source.", ctx=ctx)
+            return  # unreachable, but helps mypy
 
     result = client.create_merge_request(
         project,

qodev_gitlab_cli-0.1.1/PKG-INFO

@@ -1,15 +0,0 @@
-Metadata-Version: 2.4
-Name: qodev-gitlab-cli
-Version: 0.1.1
-Summary: Agent-friendly CLI for the GitLab API
-Project-URL: Homepage, https://github.com/qodevai/gitlab-cli
-Project-URL: Repository, https://github.com/qodevai/gitlab-cli
-Requires-Python: >=3.11
-Requires-Dist: cyclopts>=3.0
-Requires-Dist: qodev-gitlab-api>=0.1.0
-Requires-Dist: rich>=13.0
-Provides-Extra: dev
-Requires-Dist: mypy>=1.13.0; extra == 'dev'
-Requires-Dist: pytest-mock>=3.15; extra == 'dev'
-Requires-Dist: pytest>=9.0; extra == 'dev'
-Requires-Dist: ruff>=0.15; extra == 'dev'