eol-cli 1.0.0

CLI tool for endoflife.date API - Check EOL dates and support lifecycles

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

Feature	Description
Product Lookup	Inspect products, release cycles, and release metadata
Category Queries	List categories or fetch products by category
Tag Queries	List tags or fetch products by tag
Identifier Queries	Resolve products by PURL, CPE, and other identifier types
API Index	Inspect the API index and available surfaces
Rich Output	Human-friendly terminal output with tables and colors
Structured Output	JSON, XML, and SARIF output for automation
Tag-Based Releases	Publish releases from git tags with GitHub Actions

Supported Commands

Command	Purpose
products list	List all products
products get <name>	Show product details
products release <product> <release>	Show a specific release cycle
categories list	List categories
categories get <name>	Show products in a category
tags list	List tags
tags get <name>	Show products for a tag
identifiers list	List identifier types
identifiers get <type>	Show products for an identifier type
index	Show API index data

---

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.}