pepotron

CLI to open PEPs in your browser.

Installation

From PyPI

python3 -m pip install --upgrade pepotron

From source

git clone https://github.com/hugovk/pepotron
cd pepotron
pip install .

Usage

Open a PEP

$ pep 8
https://peps.python.org/pep-0008/

Open release schedule PEP for a Python version

$ pep 3.11
https://peps.python.org/pep-0664/

Open a PEP by searching for words in the title

$ pep dead batteries
Score	Result
90	PEP 594: Removing dead batteries from the standard library
55	PEP 288: Generators Attributes and Exceptions
55	PEP 363: Syntax For Dynamic Attribute Access
55	PEP 476: Enabling certificate verification by default for stdlib http clients
52	PEP 349: Allow str() to return unicode strings

https://peps.python.org/pep-0594/

Open a build preview of a python/peps PR

$ pep 594 --pr 2440
https://pep-previews--2440.org.readthedocs.build/pep-0594/

Open the PEPs website

$ pep
https://peps.python.org

$ pep --pr 2440
https://pep-previews--2440.org.readthedocs.build

Help

$ pep --help
usage: pep [-h] [-u URL] [-p PR] [-n] [--clear-cache] [-v] [-V] [search ...]

pepotron: CLI to open PEPs in your browser

positional arguments:
  search             PEP number, or Python version for its schedule, or words
                     from title

options:
  -h, --help         show this help message and exit
  -u URL, --url URL  Base URL for PEPs (default: https://peps.python.org)
  -p PR, --pr PR     Open preview for python/peps PR
  -n, --dry-run      Don't open in browser
  --clear-cache      Clear cache before running
  -v, --verbose      Verbose logging
  -V, --version      show program's version number and exit