Apache Trusted Releases Client

Clone this repo:

Branches

  1. 98d91f2 Add a function to select JSON output if configured by Sean B. Palmer · 5 days ago main
  2. c4affd8 Split the core client implementation into several modules by Sean B. Palmer · 5 days ago
  3. 91a878f Update dependencies and shared models, and fix a test by Sean B. Palmer · 5 days ago
  4. d1278f9 Add GH projects by Dave Fisher · 3 weeks ago
  5. 720024d Update the shared models and client dependencies by Sean B. Palmer · 7 weeks ago

apache-releases-client

This is a command line client for the Apache Trusted Releases (ATR) platform, utilising the ATR API to perform actions. The ATR provides Apache Software Foundation (ASF) participants with an easy way to make software releases. The goal of this client is to make things even easier, especially for those who prefer CLI or TUI workflows.

This project is maintained by ASF Tooling. As of July 2025, we have only just started work on this client, so there isn‘t anything to test yet. As we add functionality, we’ll update this README. We will be focusing on the CLI first of all, keeping the TUI as a long term goal.

Please feedback to the ASF Tooling mailing list, or the #apache-trusted-releases Slack. We welcome contributions already, and you may file issues or create pull requests. To assist us in reviewing your code, please adhere to our style guidelines as noted in the codebase. Thank you.

The ATR API is not stable, so please do not rely on its schema. The client CLI is also not stable, so please do not use it in unattended scripts.

Quick Start

  1. Installation of atr client from within a target directory.

    python3 -m venv venv
    source venv/bin/activate
    pip3 install -U pip setuptools wheel
    pip3 install git+https://github.com/apache/tooling-releases-client atr
    atr --version
    
  2. Configuration

    atr set asf.uid <your asf id>
    atr set tokens.pat "<pat from ATR site>"
    atr jwt refresh