Apache Trusted Releases Client

Clone this repo:

Branches

  1. 092bce3 Update models by Sean B. Palmer · 2 days ago main
  2. 16df03b Add a pre-commit analysis workflow by Sean B. Palmer · 8 days ago
  3. eaa61b2 Add zizmor to lints and fix detected problems by Sean B. Palmer · 8 days ago
  4. 42c7545 Include JWT refresh by Dave Fisher · 5 weeks ago
  5. 9149ac7 Added Quick Start to README by Dave Fisher · 5 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