py-eol 0.4.0

Check if a Python version is End-Of-Life (EOL)

py-eol

Check if a Python version is End-Of-Life (EOL).

Table of Contents

• Why py-eol?
• Installation
• Usage
  • As a Python module
  • As a CLI tool
  • As a pre-commit hook
• License

Why py-eol?

• Programmatically check if a Python version is supported or EOL
• Works both as a Python module and a CLI tool
• Useful for local checks, automation scripts, and CI/CD pipelines
• Helps teams avoid using unsupported Python versions

Installation

pip install py-eol

Usage

As a Python module

from py_eol import is_eol, get_eol_date, supported_versions, eol_versions, latest_supported_version

print(is_eol("3.7")) # True
print(get_eol_date("3.8")) # 2024-10-07
print(supported_versions()) # ['3.14', '3.13', '3.12', '3.11', '3.10', '3.9']
print(eol_versions()) # ['3.8', '3.7', '3.6', '3.5', '3.4', '3.3', '3.2', '2.7', '3.1', '3.0', '2.6']
print(latest_supported_version()) # 3.14

As a CLI tool

py-eol --help
usage: py-eol [-h] [--version] {versions,files,list,check-self,refresh} ...

Check if a Python version is EOL (End Of Life).

positional arguments:
  {versions,files,list,check-self,refresh}
                        sub-command help
    versions            Check specific Python versions
    files               Check files for Python versions
    list                List all supported Python versions
    check-self          Check the current Python interpreter version
    refresh             Refresh the EOL data from endoflife.date

options:
  -h, --help            show this help message and exit
  --version             Show the version of the tool

Examples

# Check a specific version
py-eol versions 3.9

# Check multiple versions
py-eol versions 3.7 3.8 3.11

# Check files for EOL Python versions (shows file:line information)
py-eol files pyproject.toml setup.py .github/workflows/ci.yml

# Check current Python interpreter
py-eol check-self

# List all currently supported versions
py-eol list

# Output result in JSON format
py-eol versions 3.8 3.9 --json

# Refresh the latest EOL data
py-eol refresh

As a pre-commit hook

[!NOTE] This hook checks Python versions specified in pyproject.toml, setup.py, and GitHub Actions workflow files. When an EOL version is found, it reports the exact file and line number for easy identification.

To use py-eol as a pre-commit hook, you can add the following configuration to your .pre-commit-config.yaml file:

repos:
  - repo: https://github.com/shenxianpeng/py-eol
    rev:  # Use the ref you want to point at
    hooks:
      - id: py-eol

Example output:

Check Python version EOL.................................................Failed
- hook id: py-eol
- exit code: 1

pyproject.toml:9: ⚠️ Python 3.7 is already EOL since 2023-06-27
.github/workflows/ci.yml:16: ⚠️ Python 3.9 is already EOL since 2025-10-31

License

MIT License