Development environment setup and workflow automation for the jiratools JIRA automation CLI. Handles venv activation, testing, code quality checks, and JIRA operations (clone/transition tickets).
Development assistant for the jiratools repository — a Python CLI for automating JIRA ticket operations (cloning, transitions) with rich terminal UI.
Helps you work with the jiratools codebase by:
**CRITICAL**: Always activate the virtual environment before ANY command.
```bash
source ./activate.sh
```
This script:
**Pattern for all commands**: Prefix with `source ./activate.sh && <command>`
Run the main CLI:
```bash
source ./activate.sh && jiratools --help
```
Clone tickets with customizable JQL:
```bash
source ./activate.sh && jiratools clone --help
source ./activate.sh && jiratools clone <args>
```
Transition tickets by project and transition name:
```bash
source ./activate.sh && jiratools transition --help
source ./activate.sh && jiratools transition <args>
```
Run all tests with coverage (XML report):
```bash
source ./activate.sh && pytest -v --cov=src/ --cov-report=xml tests
```
Run all tests (no coverage):
```bash
source ./activate.sh && pytest tests/
```
Run specific test file:
```bash
source ./activate.sh && pytest tests/test_clone_tickets.py
```
**CRITICAL**: Only use pre-commit for code quality. Never run ruff or mypy directly.
```bash
source ./activate.sh && pre-commit run --all-files
```
This runs:
**Package Structure:**
**Authentication:**
**Testing:**
**Code Quality:**
**Adding a new feature:**
1. Activate environment: `source ./activate.sh`
2. Write code in `src/jiratools/`
3. Add tests in `tests/`
4. Run tests: `source ./activate.sh && pytest -v --cov=src/ --cov-report=xml tests`
5. Check code quality: `source ./activate.sh && pre-commit run --all-files`
**Debugging a test failure:**
1. Run specific test: `source ./activate.sh && pytest tests/test_<name>.py -v`
2. Check mock fixtures in `tests/conftest.py`
3. Verify JIRA API call patterns in test assertions
**Before committing:**
```bash
source ./activate.sh && pre-commit run --all-files
```
**Setup and run tests:**
```bash
source ./activate.sh && pytest -v --cov=src/ --cov-report=xml tests
```
**Clone tickets with custom JQL:**
```bash
source ./activate.sh && jiratools clone --jql "project = MYPROJ AND status = Open"
```
**Transition tickets:**
```bash
source ./activate.sh && jiratools transition --project MYPROJ --transition "In Progress"
```
**Full quality check before commit:**
```bash
source ./activate.sh && pre-commit run --all-files
```
Leave a review
No reviews yet. Be the first to review this skill!
# Download SKILL.md from killerskills.ai/api/skills/jira-tools-helper/raw