pepotron

CLI to open PEPs in your browser.

Installation

From PyPI

python3 -m pip install --upgrade pepotron

With pipx

pipx install pepotron

From source

git clone https://github.com/hugovk/pepotron
cd pepotron
python3 -m 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 PEP topic

$ pep governance
https://peps.python.org/topic/governance/

$ pep packaging
https://peps.python.org/topic/packaging/

$ pep release
https://peps.python.org/topic/release/

$ pep typing
https://peps.python.org/topic/typing/

$ pep topics
https://peps.python.org/topic/

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

Open a BPO issue in the browser

Issues from bugs.python.org have been migrated to GitHub issues and have new numbers. This command will open the redirect page to take you to the new issue.

$ bpo 46208
https://bugs.python.org/issue?@action=redirect&bpo=46208

This redirects to https://github.com/python/cpython/issues/90366

Help

$ pep --help
usage: pep [-h] [-u URL] [-p PR] [--clear-cache] [-n] [-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
  --clear-cache      Clear cache before running
  -n, --dry-run      Don't open in browser
  -v, --verbose      Verbose logging
  -V, --version      show program's version number and exit

$ bpo --help
usage: bpo [-h] [-n] [-v] [-V] bpo

Open this BPO in the browser

positional arguments:
  bpo            BPO number

options:
  -h, --help     show this help message and exit
  -n, --dry-run  Don't open in browser
  -v, --verbose  Verbose logging
  -V, --version  show program's version number and exit