nexus3-tool 0.1.0

A CLI tool for managing Sonatype Nexus3 via its REST API

nexus3-tool

A command-line tool for managing Sonatype Nexus3 via its REST API, following a familiar docker-style command pattern.

⚠️ This package is in early development (v0.1.0). Commands are scaffolded but not yet fully implemented. Watch this space!

---

Installation

pip install nexus3-tool

---

Usage

nexus3-tool [OPTIONS] COMMAND [ARGS]...

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  login              Authenticate with a Nexus3 instance.
  prune-docker-repo  Prune old tags from a Nexus3 Docker repository.

Login

Authenticate with your Nexus3 instance. Credentials will be stored in ~/.nexus-credentials for use by subsequent commands.

nexus3-tool login https://nexus.example.com

Prune Docker Repository

Remove old image tags from a hosted Docker repository, keeping only the most recent.

# Keep the 5 most recent tags (default)
nexus3-tool prune-docker-repo my-app

# Keep the 10 most recent tags
nexus3-tool prune-docker-repo my-app --keep-last=10

---

Planned Features

• nexus3-tool login <url> — Authenticate and store credentials in ~/.nexus-credentials
• nexus3-tool prune-docker-repo <image> --keep-last=<n> — Prune old Docker image tags

---

Development

Clone the repository and install in editable mode:

git clone https://github.com/tkdpython/nexus3-tool.git
cd nexus3-tool
pip install -e ".[dev]"

---

Publishing a Release

Releases are published to PyPI automatically via GitHub Actions when a version tag is pushed:

git tag v0.1.0
git push origin v0.1.0

The workflow uses PyPI Trusted Publishers (OIDC) — no API token secrets required.
You must configure a Trusted Publisher on PyPI for this repository first. See the setup guide below.

PyPI Trusted Publisher Setup

1. Log in to pypi.org and navigate to your project (or create it via the first manual publish).
2. Go to Manage → Publishing and add a new Trusted Publisher:
   • Owner: tkdpython
   • Repository: nexus3-tool
   • Workflow filename: publish.yml
   • Environment name: release
3. On GitHub, create a Environment named release under Settings → Environments (optional but recommended for approval gates).

---

License

MIT © tkdpython