{"id":15359150,"url":"https://github.com/hugovk/pepotron","last_synced_at":"2025-08-24T08:29:54.045Z","repository":{"id":37029582,"uuid":"468868225","full_name":"hugovk/pepotron","owner":"hugovk","description":"CLI to open PEPs in your browser","archived":false,"fork":false,"pushed_at":"2025-04-08T12:55:04.000Z","size":776,"stargazers_count":37,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-09T15:08:34.970Z","etag":null,"topics":["cli","command-line","hacktoberfest","pep","peps","python","python3"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/pepotron/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hugovk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-11T19:00:49.000Z","updated_at":"2025-04-08T12:55:06.000Z","dependencies_parsed_at":"2023-10-03T10:22:23.614Z","dependency_job_id":"f209052b-63b7-4dd1-b981-63096124b2e2","html_url":"https://github.com/hugovk/pepotron","commit_stats":{"total_commits":666,"total_committers":12,"mean_commits":55.5,"dds":0.2657657657657657,"last_synced_commit":"e7b49d7df9e48c7d79925ce20d50b48223ae8d4c"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugovk%2Fpepotron","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugovk%2Fpepotron/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugovk%2Fpepotron/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugovk%2Fpepotron/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hugovk","download_url":"https://codeload.github.com/hugovk/pepotron/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248055282,"owners_count":21040157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","command-line","hacktoberfest","pep","peps","python","python3"],"created_at":"2024-10-01T12:43:56.743Z","updated_at":"2025-04-09T15:08:43.050Z","avatar_url":"https://github.com/hugovk.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pepotron\n\n[![PyPI version](https://img.shields.io/pypi/v/pepotron.svg?logo=pypi\u0026logoColor=FFE873)](https://pypi.org/project/pepotron/)\n[![Supported Python versions](https://img.shields.io/pypi/pyversions/pepotron.svg?logo=python\u0026logoColor=FFE873)](https://pypi.org/project/pepotron/)\n[![PyPI downloads](https://img.shields.io/pypi/dm/pepotron.svg)](https://pypistats.org/packages/pepotron)\n[![Test](https://github.com/hugovk/pepotron/actions/workflows/test.yml/badge.svg)](https://github.com/hugovk/pepotron/actions)\n[![Codecov](https://codecov.io/gh/hugovk/pepotron/branch/main/graph/badge.svg)](https://codecov.io/gh/hugovk/pepotron)\n[![Licence](https://img.shields.io/github/license/hugovk/pepotron.svg)](LICENSE.txt)\n[![Code style: Black](https://img.shields.io/badge/code%20style-Black-000000.svg)](https://github.com/psf/black)\n\nCLI to open PEPs in your browser.\n\n## Installation\n\n### From PyPI\n\n```bash\npython3 -m pip install --upgrade pepotron\n```\n\n### With [pipx][pipx]\n\n```bash\npipx install pepotron\n```\n\n[pipx]: https://github.com/pypa/pipx\n\n### From source\n\n```bash\ngit clone https://github.com/hugovk/pepotron\ncd pepotron\npython3 -m pip install .\n```\n\n## Usage\n\n### Open a PEP\n\nRun `pep` or `pepotron`, they do the same thing.\n\n\u003c!-- [[[cog\nfrom pepotron.scripts.run_command import run\nrun(\"pep 8\")\n]]] --\u003e\n\n```console\n$ pep 8\nhttps://peps.python.org/pep-0008/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n```console\n$ # Or:\n$ pepotron 8\nhttps://peps.python.org/pep-0008/\n$ # Or:\n$ uvx pepotron 8\nhttps://peps.python.org/pep-0008/\n```\n\n### Open release schedule PEP for a Python version\n\n\u003c!-- [[[cog run(\"pep 3.11\") ]]] --\u003e\n\n```console\n$ pep 3.11\nhttps://peps.python.org/pep-0664/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n### Open a PEP by searching for words in the title\n\n\u003c!-- [[[cog run(\"pep dead batteries\") ]]] --\u003e\n\n```console\n$ pep dead batteries\nScore   Result\n90      PEP 594: Removing dead batteries from the standard library\n61      PEP 767: Annotating Read-Only Attributes\n58      PEP 415: Implement context suppression with exception attributes\n55      PEP 476: Enabling certificate verification by default for stdlib http clients\n55      PEP 500: A protocol for delegating datetime methods to their tzinfo implementations\n\nhttps://peps.python.org/pep-0594/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n### Open a PEP topic\n\n\u003c!-- [[[cog run(\"pep governance\") ]]] --\u003e\n\n```console\n$ pep governance\nhttps://peps.python.org/topic/governance/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n\u003c!-- [[[cog run(\"pep packaging\") ]]] --\u003e\n\n```console\n$ pep packaging\nhttps://peps.python.org/topic/packaging/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n\u003c!-- [[[cog run(\"pep release\") ]]] --\u003e\n\n```console\n$ pep release\nhttps://peps.python.org/topic/release/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n\u003c!-- [[[cog run(\"pep typing\") ]]] --\u003e\n\n```console\n$ pep typing\nhttps://peps.python.org/topic/typing/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n\u003c!-- [[[cog run(\"pep topics\") ]]] --\u003e\n\n```console\n$ pep topics\nhttps://peps.python.org/topic/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n### Open a build preview of a python/peps PR\n\n\u003c!-- [[[cog run(\"pep 594 --pr 2440\") ]]] --\u003e\n\n```console\n$ pep 594 --pr 2440\nhttps://pep-previews--2440.org.readthedocs.build/pep-0594/\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n### Open the PEPs website\n\n\u003c!-- [[[cog run(\"pep\") ]]] --\u003e\n\n```console\n$ pep\nhttps://peps.python.org\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n\u003c!-- [[[cog run(\"pep --pr 2440\") ]]] --\u003e\n\n```console\n$ pep --pr 2440\nhttps://pep-previews--2440.org.readthedocs.build\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n### Find the next available PEP number\n\nCheck published PEPs and [open PRs](https://github.com/python/peps/pulls) to find the\nnext available PEP number.\n\n\u003c!-- [[[cog run(\"pep next\") ]]] --\u003e\n\n```console\n$ pep next\nNext available PEP: 769\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n### Open a BPO issue in the browser\n\nIssues from [bugs.python.org](https://bugs.python.org/) have been migrated to\n[GitHub issues](https://github.com/python/cpython/issues) and have new numbers. This\ncommand will open the redirect page to take you to the new issue.\n\n\u003c!-- [[[cog run(\"bpo 46208\") ]]] --\u003e\n\n```console\n$ bpo 46208\nhttps://bugs.python.org/issue?@action=redirect\u0026bpo=46208\n```\n\n\u003c!-- [[[end]]] --\u003e\n\nThis redirects to https://github.com/python/cpython/issues/90366\n\n### Help\n\n\u003c!-- [[[cog run(\"pep --help\") ]]] --\u003e\n\n```console\n$ pep --help\nusage: pep [-h] [-u URL] [-p PR] [--clear-cache] [-n] [-v] [-V] [search ...]\n\npepotron: CLI to open PEPs in your browser\n\npositional arguments:\n  search         PEP number, or Python version for its schedule, or words from title, or 'next' to\n                 find next available PEP number\n\noptions:\n  -h, --help     show this help message and exit\n  -u, --url URL  Base URL for PEPs (default: https://peps.python.org)\n  -p, --pr PR    Open preview for python/peps PR\n  --clear-cache  Clear cache before running\n  -n, --dry-run  Don't open in browser\n  -v, --verbose  Verbose logging\n  -V, --version  show program's version number and exit\n```\n\n\u003c!-- [[[end]]] --\u003e\n\n\u003c!-- [[[cog run(\"bpo --help\") ]]] --\u003e\n\n```console\n$ bpo --help\nusage: bpo [-h] [-n] [-v] [-V] bpo\n\nOpen this BPO in the browser\n\npositional arguments:\n  bpo            BPO number\n\noptions:\n  -h, --help     show this help message and exit\n  -n, --dry-run  Don't open in browser\n  -v, --verbose  Verbose logging\n  -V, --version  show program's version number and exit\n```\n\n\u003c!-- [[[end]]] --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugovk%2Fpepotron","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhugovk%2Fpepotron","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugovk%2Fpepotron/lists"}