colenio-jira-cli 0.1.2__tar.gz

colenio_jira_cli-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+    pull_request:
+    push:
+        branches:
+            - main
+
+jobs:
+    test-and-build:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v4
+
+            - name: Sync dependencies
+              run: uv sync --frozen --extra dev
+
+            - name: Run tests
+              run: uv run pytest -q
+
+            - name: Build package
+              run: uv build
+
+            - name: Upload dist artifacts
+              uses: actions/upload-artifact@v4
+              with:
+                  name: dist
+                  path: dist/*

colenio_jira_cli-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,48 @@
+name: Release
+
+on:
+    push:
+        tags:
+            - "v*"
+
+permissions:
+    contents: read
+    id-token: write
+
+jobs:
+    build:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout
+              uses: actions/checkout@v4
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v4
+
+            - name: Sync dependencies
+              run: uv sync --frozen --extra dev
+
+            - name: Run tests
+              run: uv run pytest -q
+
+            - name: Build package
+              run: uv build
+
+            - name: Upload dist artifacts
+              uses: actions/upload-artifact@v4
+              with:
+                  name: dist
+                  path: dist/*
+
+    publish-pypi:
+        needs: build
+        runs-on: ubuntu-latest
+        steps:
+            - name: Download dist artifacts
+              uses: actions/download-artifact@v4
+              with:
+                  name: dist
+                  path: dist
+
+            - name: Publish to PyPI
+              uses: pypa/gh-action-pypi-publish@release/v1

colenio_jira_cli-0.1.2/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Environment
+.env
+local.env
+.env.local
+
+# Jira CLI
+*.jira

colenio_jira_cli-0.1.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Colenio
+
+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.

colenio_jira_cli-0.1.2/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: colenio-jira-cli
+Version: 0.1.2
+Summary: Modular Jira CLI tool for issue listing, filtering, and management
+Author-email: Colenio <dev@colenio.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1.0
+Requires-Dist: jira>=3.8.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tabulate>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=24.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.2.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Jira CLI
+
+> Modular, class-based Jira command-line tool for issue listing, searching, and management.
+
+## Features
+
+- **List issues** by project with optional filtering (status, assignee, labels)
+- **Search** with custom JQL queries
+- **Find** issues by text in summary/description
+- **View** issue details with comments
+- **Assign** issues to users
+- **Transition** issues to new status
+- **Multiple output formats**: table, JSON, CSV, Markdown
+- **dotenv support**: Load credentials from `.env` or `local.env` in CWD or parent directories
+
+## Installation
+
+### Via uv (local development)
+
+```bash
+cd colenio/tools/jira-cli
+uv sync
+uv run jira-cli list --help
+```
+
+### Via uvx (remote/published)
+
+```bash
+uvx colenio-jira-cli list --project PROJ
+```
+
+## Setup
+
+Create a `.env` or `local.env` file in your working directory:
+
+```bash
+# Required
+JIRA_URL=https://company.atlassian.net
+JIRA_EMAIL=user@example.com
+JIRA_API_TOKEN=your_api_token_here
+
+# Optional
+JIRA_PROJECT=PROJ      # Default project for list/find
+JIRA_PROJECT_KEY=PROJ  # Backward-compatible fallback
+```
+
+### Getting your Jira API Token
+
+1. Log in to your Jira Cloud instance
+2. Go to Account Settings → Security
+3. Click "Create API Token"
+4. Copy the token and save to `.env`
+
+## Usage
+
+### List issues
+
+```bash
+# Basic listing
+jira-cli list --project PROJ
+
+# With filters
+jira-cli list --project PROJ --status "In Progress" --assignee "john@example.com"
+
+# With custom JQL
+jira-cli list --project PROJ --jql 'priority = High'
+
+# Different output formats
+jira-cli list --project PROJ --format json
+jira-cli list --project PROJ --format csv > issues.csv
+jira-cli list --project PROJ --format md
+```
+
+### Search with JQL
+
+```bash
+jira-cli search 'project = PROJ AND status = "To Do" AND assignee is EMPTY'
+jira-cli search 'text ~ "urgent"' --format json
+```
+
+### Find by text
+
+```bash
+jira-cli find --project PROJ "database migration"
+jira-cli find --project PROJ "performance issue" --max-results 100
+```
+
+### View issue details
+
+```bash
+jira-cli view PROJ-123
+jira-cli view PROJ-456 --comments
+```
+
+### Assign issue
+
+```bash
+jira-cli assign PROJ-789 john@example.com
+```
+
+### Transition issue
+
+```bash
+jira-cli transition PROJ-999 "In Progress" --comment "Starting work"
+jira-cli transition PROJ-999 "Done"
+```
+
+## Architecture
+
+- **`client.py`**: `JiraClient` class for REST API calls, auth, and endpoints
+- **`query.py`**: `JiraQuery` class for JQL building and search logic
+- **`render.py`**: `JiraRenderer` class for output formatting (table, JSON, CSV, Markdown)
+- **`models.py`**: Pydantic models for Jira structures (`JiraIssue`, `JiraSearchResult`, `IssueRow`)
+- **`dotenv.py`**: `DotEnv` class for robust `.env`/`local.env` loading
+- **`cli.py`**: Click CLI commands (list, search, find, view, assign, transition)
+
+All code uses proper classes, no helper functions. Follows informix-migration patterns.
+
+## Development
+
+```bash
+# Install dev dependencies
+uv sync --all-groups
+
+# Run tests
+uv run pytest
+
+# Format and lint
+uv run black jira_cli
+uv run ruff check jira_cli
+```
+
+## Distribution
+
+This tool is designed for publishing via uvx (like `helmrelease-verifier`):
+
+1. Push to GitHub at `colenio/jira-cli`
+2. Configure PyPI Trusted Publisher for this repository
+3. Tag with version: `git tag v0.1.0` and push tag (`git push origin v0.1.0`)
+4. GitHub Action `.github/workflows/release.yml` builds, tests, and publishes to PyPI
+5. Package can be invoked anywhere with: `uvx colenio-jira-cli list --project PROJ`
+
+## PowerShell Integration
+
+Add to `$PROFILE` (e.g., via dotfiles/aliases.ps1):
+
+```powershell
+function jira-cli {
+    uvx colenio-jira-cli @args
+}
+
+# Or use directly
+alias jira = 'uvx colenio-jira-cli'
+```
+
+Then:
+
+```powershell
+jira list --project PROJ
+```
+
+## License
+
+MIT

colenio_jira_cli-0.1.2/README.md

@@ -0,0 +1,164 @@
+# Jira CLI
+
+> Modular, class-based Jira command-line tool for issue listing, searching, and management.
+
+## Features
+
+- **List issues** by project with optional filtering (status, assignee, labels)
+- **Search** with custom JQL queries
+- **Find** issues by text in summary/description
+- **View** issue details with comments
+- **Assign** issues to users
+- **Transition** issues to new status
+- **Multiple output formats**: table, JSON, CSV, Markdown
+- **dotenv support**: Load credentials from `.env` or `local.env` in CWD or parent directories
+
+## Installation
+
+### Via uv (local development)
+
+```bash
+cd colenio/tools/jira-cli
+uv sync
+uv run jira-cli list --help
+```
+
+### Via uvx (remote/published)
+
+```bash
+uvx colenio-jira-cli list --project PROJ
+```
+
+## Setup
+
+Create a `.env` or `local.env` file in your working directory:
+
+```bash
+# Required
+JIRA_URL=https://company.atlassian.net
+JIRA_EMAIL=user@example.com
+JIRA_API_TOKEN=your_api_token_here
+
+# Optional
+JIRA_PROJECT=PROJ      # Default project for list/find
+JIRA_PROJECT_KEY=PROJ  # Backward-compatible fallback
+```
+
+### Getting your Jira API Token
+
+1. Log in to your Jira Cloud instance
+2. Go to Account Settings → Security
+3. Click "Create API Token"
+4. Copy the token and save to `.env`
+
+## Usage
+
+### List issues
+
+```bash
+# Basic listing
+jira-cli list --project PROJ
+
+# With filters
+jira-cli list --project PROJ --status "In Progress" --assignee "john@example.com"
+
+# With custom JQL
+jira-cli list --project PROJ --jql 'priority = High'
+
+# Different output formats
+jira-cli list --project PROJ --format json
+jira-cli list --project PROJ --format csv > issues.csv
+jira-cli list --project PROJ --format md
+```
+
+### Search with JQL
+
+```bash
+jira-cli search 'project = PROJ AND status = "To Do" AND assignee is EMPTY'
+jira-cli search 'text ~ "urgent"' --format json
+```
+
+### Find by text
+
+```bash
+jira-cli find --project PROJ "database migration"
+jira-cli find --project PROJ "performance issue" --max-results 100
+```
+
+### View issue details
+
+```bash
+jira-cli view PROJ-123
+jira-cli view PROJ-456 --comments
+```
+
+### Assign issue
+
+```bash
+jira-cli assign PROJ-789 john@example.com
+```
+
+### Transition issue
+
+```bash
+jira-cli transition PROJ-999 "In Progress" --comment "Starting work"
+jira-cli transition PROJ-999 "Done"
+```
+
+## Architecture
+
+- **`client.py`**: `JiraClient` class for REST API calls, auth, and endpoints
+- **`query.py`**: `JiraQuery` class for JQL building and search logic
+- **`render.py`**: `JiraRenderer` class for output formatting (table, JSON, CSV, Markdown)
+- **`models.py`**: Pydantic models for Jira structures (`JiraIssue`, `JiraSearchResult`, `IssueRow`)
+- **`dotenv.py`**: `DotEnv` class for robust `.env`/`local.env` loading
+- **`cli.py`**: Click CLI commands (list, search, find, view, assign, transition)
+
+All code uses proper classes, no helper functions. Follows informix-migration patterns.
+
+## Development
+
+```bash
+# Install dev dependencies
+uv sync --all-groups
+
+# Run tests
+uv run pytest
+
+# Format and lint
+uv run black jira_cli
+uv run ruff check jira_cli
+```
+
+## Distribution
+
+This tool is designed for publishing via uvx (like `helmrelease-verifier`):
+
+1. Push to GitHub at `colenio/jira-cli`
+2. Configure PyPI Trusted Publisher for this repository
+3. Tag with version: `git tag v0.1.0` and push tag (`git push origin v0.1.0`)
+4. GitHub Action `.github/workflows/release.yml` builds, tests, and publishes to PyPI
+5. Package can be invoked anywhere with: `uvx colenio-jira-cli list --project PROJ`
+
+## PowerShell Integration
+
+Add to `$PROFILE` (e.g., via dotfiles/aliases.ps1):
+
+```powershell
+function jira-cli {
+    uvx colenio-jira-cli @args
+}
+
+# Or use directly
+alias jira = 'uvx colenio-jira-cli'
+```
+
+Then:
+
+```powershell
+jira list --project PROJ
+```
+
+## License
+
+MIT

colenio_jira_cli-0.1.2/jira_cli/__init__.py

@@ -0,0 +1,4 @@
+"""Jira CLI — modular command-line interface for Jira issue management."""
+
+__version__ = "0.1.2"
+__author__ = "Colenio"