tech
ec5dda61ef
- Replace --url, --username, --password CLI options with single --server option - Server credentials are now read from config file (~/.config/zzpyjenkins/config.toml) - Remove os and typing imports (no longer needed) - Update type hints to use modern str | None syntax (Python 3.11+) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
zzpyjenkins
A CLI tool to interact with Jenkins server for building jobs.
Installation
Using uvx (recommended)
uvx install zzpyjenkins
Or run directly:
uvx --from zzpyjenkins zzpyjenkins --help
From source
uv sync
uv run zzpyjenkins --help
Configuration
You can provide Jenkins credentials via command-line options or environment variables:
Command-line options (preferred)
zzpyjenkins -u https://jenkins.example.com -U username -P token info
Environment variables
export JENKINS_URL="https://your-jenkins-server.com"
export JENKINS_USERNAME="your_username"
export JENKINS_PASSWORD="your_api_token" # or JENKINS_TOKEN
Usage
# Show Jenkins server info
zzpyjenkins info
# List all jobs
zzpyjenkins list
# List jobs with filter
zzpyjenkins list -p "my-project"
# Trigger a build
zzpyjenkins build my-job-name
# Trigger a build with parameters
zzpyjenkins build my-job-name -p BRANCH=main -p ENV=staging
# Get build status
zzpyjenkins status my-job-name
# Get specific build status
zzpyjenkins status my-job-name 123
# Watch build progress
zzpyjenkins watch my-job-name
Development
# Install dev dependencies
uv sync
# Run tests
uv run pytest
# Format code
uv run ruff format .
# Lint
uv run ruff check .