EOL CLI

Query end-of-life dates and support lifecycles from the terminal

Overview

EOL CLI is a Python command-line tool for querying the endoflife.date API. It helps you inspect product lifecycles, release cycles, categories, tags, identifiers, and API metadata directly from your terminal.

Key Features

Supported Commands

Installation

From PyPI

pip install eol-cli

From Source

git clone https://github.com/seifreed/eol-cli.git
cd eol-cli
pip install -e .

Development Installation

git clone https://github.com/seifreed/eol-cli.git
cd eol-cli
pip install -e ".[dev]"

Quick Start

# List all available products
eol-cli products list

# Get details for a specific product
eol-cli products get ubuntu

# Get the latest release information
eol-cli products release python latest

# Query products by category
eol-cli categories get os

# Query products by tag
eol-cli tags get linux

Usage

Products

# List all products
eol-cli products list

# List all products with full details
eol-cli products list --full

# Get a specific product
eol-cli products get <product-name>

# Get multiple products (comma-separated)
eol-cli products get <product1>,<product2>,<product3>

# Get all product details
eol-cli products get <product-name> --all

# Get a specific release cycle
eol-cli products release <product-name> <release-cycle>

# Get the latest release cycle
eol-cli products release <product-name> latest

Categories

# List all categories
eol-cli categories list

# Get products in a category
eol-cli categories get <category-name>

Tags

# List all tags
eol-cli tags list

# Get products with a specific tag
eol-cli tags get <tag-name>

Identifiers

# List all identifier types
eol-cli identifiers list

# Get products by identifier type
eol-cli identifiers get <identifier-type>

API Information

# Get API index
eol-cli index

Output Formats

Rich Terminal Output

Rich is the default output format. It renders tables and summaries that are easy to read in a terminal.

JSON Output

Use --json for machine-readable JSON output.

eol-cli products get ubuntu --json

XML Output

Use --xml for XML output.

eol-cli products get ubuntu --xml

SARIF Output

Use --sarif for SARIF output in security and automation workflows.

eol-cli products get ubuntu --sarif

Releases

Releases are published from version tags.

git tag v1.0.0
git push origin v1.0.0

That workflow:

• Builds the package artifacts
• Publishes to PyPI with GitHub Actions OIDC trusted publishing
• Uploads the built files to the GitHub Release assets

Before publishing tag-based releases, configure PyPI trusted publishing for this repository:

• Owner: seifreed
• Repository: eol-cli
• Workflow file: publish.yml
• Environment: pypi

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/seifreed/eol-cli.git
cd eol-cli

# Create a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install development dependencies
pip install -e ".[dev]"

Running Tests

# Run all tests
pytest

# Run tests without API calls
pytest -q -m "not api" --tb=short

# Run with coverage
pytest --cov=eol_cli --cov-report=term-missing

Code Quality

# Lint
ruff check eol_cli tests

# Format check
black --check eol_cli tests

# Type check
mypy eol_cli tests

Requirements

• Python 3.13 or 3.14
• See pyproject.toml for the full dependency list

Contributing

Contributions are welcome.

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push the branch
5. Open a pull request

License

This project is licensed under the MIT License. See the LICENSE file for details.

Attribution

• Author: Marc Rivero
• Repository: github.com/seifreed/eol-cli

_{Built for clean EOL lookups and release automation.}