Location via proxy:   
[Report a bug]   [Manage cookies]                
Skip to content

Introduction

Peplum Peplum v0.6.0 — All; Sorted by Date Created (reversed) (684) │All [a]684│784Adding Zstandard to   Standards Track, Draft│Title ││the standard library  │Adding Zstandard to the standard li │─────── Type ───────│Emma Harper Smith2025-04-06│ │Informational    101│────────────────────────────────────────────────────────│Author │Process           52│783Emscripten Packaging  Standards Track, Draft│Emma Harper Smith │Standards Track  531▃│Hood Chatham2025-03-28│ ││────────────────────────────────────────────────────────│Discussions To │────── Status ──────│782Add PyBytesWriter C   Standards Track, Draft│https://discuss.python.org/t/87377 │Accepted          21│API                   │ │Active            35│Victor Stinner2025-03-27│Status │Deferred          35│────────────────────────────────────────────────────────│Draft │Draft             46│781Make ``TYPE_CHECKING``Standards Track, Draft│ │Final            331│a built-in constant   │Type │Provisional        1│Inada Naoki2025-03-24│Standards Track │Rejected         125│────────────────────────────────────────────────────────│ │Superseded        24│780ABI features as       Standards Track, Draft│Created │Withdrawn         66│environment markers   │2025-04-06 (4 days ago) ││Klaus Zimmermann, Ralf Gommers2025-03-21│ │── Python Version ──│────────────────────────────────────────────────────────│Python Version │None203│776Emscripten Support    Informational, Draft│3.14 │1.6                1│Hood Chatham2025-03-18│ │2.0                9│────────────────────────────────────────────────────────│Post History │2.1               25│779Criteria for supportedStandards Track, Draft│2025-04-07 (3 days ago) 🔗 │2.2               24│status for            │ │2.3               26│free-threaded Python  │URL │2.4               18│Thomas Wouters, Matt Page, Sam Gross2025-03-13│https://peps.python.org/pep-0784/ │2.5               24│────────────────────────────────────────────────────────│ │2.6               16│775Make zlib required to Standards Track, Draft│ │2.7               12│build CPython         │ │2.7.9              2│Gregory P. Smith, Stan Ulbrych, Petr 2025-02-24│ │2.7.12             1│Viktorin│ │2.8                1│────────────────────────────────────────────────────────│ │2.x                1│774Removing the LLVM     Standards Track, Draft│ │3.0               46│requirement for JIT   │ │3.1                6│builds                │ │3.2               12│Savannah Ostrowski2025-01-27│ │3.3               29│────────────────────────────────────────────────────────│ │3.4               22│772Packaging governance  Process, Draft│ │3.4.3              1│process               │ │3.5               20│Barry Warsaw, Deb Nicholson, Pradyun 2025-01-21│ │3.6               26│Gedam│ │3.7               25│────────────────────────────────────────────────────────│ │3.8               20│773A Python Installation Standards Track, Draft│ │3.9               15│Manager for Windows   │ │3.10              21│Steve Dower2025-01-21│ │3.11              17│────────────────────────────────────────────────────────│ │3.12              26│771Default Extras for    Standards Track, Draft│ │3.13              21│Python Software       │  f1 Help  f2 Notes  f3 Details  f4 View  f10 Quit  ^r Redownload ▏^p Commands

Peplum is a terminal-based lookup manager for Python Enhancement Proposals. It provides the ability to browse, filter and search the metadata for all the PEPs available via the PEP API.

Installation

pipx

The application can be installed using pipx:

pipx install peplum

uv

If you are a uv user you can:

uv tool install peplum

Also, if you do have uv installed, you can simply use uvx:

uvx peplum

to run peplum.

Homebrew

The package is available via Homebrew. Use the following commands to install:

brew tap davep/homebrew
brew install peplum

Running Peplum

Once you've installed Peplum using one of the above methods, you can run the application using the peplum command.

Command line options

Peplum has a number of command line options; they include:

-b, --bindings

Prints the application commands whose keyboard bindings can be modified, giving the defaults too.

peplum --bindings

ChangeTheme - Change the application's theme
    Default: f9
EditNotes - Edit the highlighted PEP's notes
    Default: f2
Escape - Back up through the panes, right to left, or exit the app if the navigation pane has focus
    Default: escape
FindPEP - Find and jump to a specific PEP
    Default: p
Help - Show help for and information about the application
    Default: f1, ?
Quit - Quit the application
    Default: f10, ctrl+q
RedownloadPEPs - Redownload the list of PEPs
    Default: ctrl+r
Search - Search for text anywhere in the PEPs
    Default: /
SearchAuthor - Search for an author then filter by them
    Default: u
SearchPythonVersion - Search for a Python version and then filter by it
    Default: v
SearchStatus - Search for a PEP status and then filter by it
    Default: s
SearchType - Search for a PEP type and then filter by it
    Default: t
ShowAll - Clear any filters and show all PEPs
    Default: a
SortByCreated - Sort PEPs by their created date
    Default: 2
SortByNumber - Sort PEPs by their number
    Default: 1
SortByTitle - Sort PEPs by their title
    Default: 3
ToggleAuthorsSortOrder - Toggle the sort order of the authors in the navigation panel
    Default: A
TogglePEPDetails - Toggle the display of the PEP details panel
    Default: f3
TogglePythonVersionsSortOrder - Toggle the sort order of Python versions in the navigation panel
    Default: V
ToggleSortOrder - Toggle the current sort order
    Default: minus
ToggleStatusesSortOrder - Toggle the sort order of the statuses in the navigation panel
    Default: S
ToggleTypesSortOrder - Toggle the sort order of types in the navigation panel
    Default: T
ViewPEP - View the source of the currently-highlighted PEP
    Default: f4

-h, --help

Prints the help for the peplum command.

peplum --help

usage: peplum [-h] [-v] [--license] [-b]
              [-s {number,created,title,~number,~created,~title}] [-t THEME]
              [pep]

The PEP lookup manager for your terminal.

positional arguments:
  pep                   A PEP to highlight

options:
  -h, --help            show this help message and exit
  -v, --version         Show version information
  --license, --licence  Show license information
  -b, --bindings        List commands that can have their bindings changed
  -s, --sort-by {number,created,title,~number,~created,~title}
                        Set the sort order for the PEPs; prefix with '~' for
                        reverse order
  -t, --theme THEME     Set the theme for the application (set to ? to list
                        available themes)

v0.6.0

--license, --licence

Prints a summary of Peplum's license.

peplum --license

Peplum - The PEP lookup manager for the terminal.  
Copyright (C) 2025 Dave Pearson

This program is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
more details.

You should have received a copy of the GNU General Public License along with
this program. If not, see <https://www.gnu.org/licenses/>.

-t, --theme

Sets Peplum's theme; this overrides and changes any previous theme choice made via the user interface.

To see a list of available themes use ? as the theme name:

peplum --theme=?

catppuccin-latte
catppuccin-mocha
dracula
flexoki
gruvbox
monokai
nord
solarized-light
textual-dark
textual-light
tokyo-night

-v, --version

Prints the version number of Peplum.

peplum --version

peplum v0.6.0

Getting help

A great way to get to know Peplum is to read the help screen. Once in the application you can see this by pressing F1.

The Peplum Help Screen Peplum v0.6.0 — All; Sorted by Date Created (reversed) (684) │All [a]684│784Adding Zstandard to   Standards Track, Draft│Title │┌─ Help ─────────────────────────────────────────────────────────────────────────────────┐the standard li │─────── Type││ │Informational││ │Process      ││ │Standards Tra│Peplum 0.6.0│ │││ │────── Status││on.org/t/87377 │Accepted     ││ │Active       │Navigation Panel│ │Deferred     ││ │Draft        │Select items in this panel to filter the list of PEPs.│ │Final        ││ │Provisional  ││ │Rejected     │Main application keys and commands│ │Superseded   ││ │Withdrawn    │The following keys and commands can be used anywhere here on the main screen.│go) │││ │── Python Ver││ │None│Command                          Key  Description                              │ │1.6          │ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ │2.0          │Change Theme                     f9   Change the application's theme           ▅│ │2.1          │Edit Notes                       f2   Edit the highlighted PEP's notes         │go) 🔗 │2.2          │Escape                           esc  Back up through the panes, right to left,│ │2.3          │or exit the app if the navigation pane   │ │2.4          │has focus                                │org/pep-0784/ │2.5          │Find PEP                         p    Find and jump to a specific PEP          │ │2.6          │Help                             f1, ?Show help for and information about the  │ │2.7          │application                              │ │2.7.9        │Quit                             f10  Quit the application                     │ │2.7.12       │Redownload All PEPs              ^r   Redownload the list of PEPs              │ │2.8          │Search                           /    Search for text anywhere in the PEPs     │ │2.x          │Search Author                    u    Search for an author then filter by them │ │3.0          │Search Python Version            v    Search for a Python version and then     │ │3.1          │filter by it                             │ │3.2          │Search Status                    s    Search for a PEP status and then filter  │ │3.3          │by it                                    │ │3.4          │Search Type                      t    Search for a PEP type and then filter by │ │3.4.3        │it                                       │ │3.5          │Show All                         a    Clear any filters and show all PEPs      │ │3.6          │Sort By Created                  2    Sort PEPs by their created date          │ │3.7          │────────────────────────────────────────────────────────────────────────────────────────│ │3.8          │▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔│ │3.9          │ Okay [Esc]│ │3.10         │▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁│ │3.11         └────────────────────────────────────────────────────────────────────────────────────────┘ │3.12              26│771Default Extras for    Standards Track, Draft│ │3.13              21│Python Software       │  f1 Help  f2 Notes  f3 Details  f4 View  f10 Quit  ^r Redownload ▏^p Commands

The command palette

Another way of discovering commands and keys in Peplum is to use the command palette (by default you can call it with ctrl+p or meta+x).

The Peplum Command Palette Peplum v0.6.0 — All; Sorted by Date Created (reversed) (684) │All [a]684│784Adding Zstandard to   Standards Track, Draft│Title ││the standard library  │Adding Zstandard to the standard li │─────── Type▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔ │Informational │Process      Search for commands… │Standards Tra │ │────── StatusChange Theme [f9]on.org/t/87377 │Accepted     Change the application's theme │Active       Edit Notes [f2] │Deferred     Edit the highlighted PEP's notes │Draft        Escape [esc] │Final        Back up through the panes, right to left, or exit the app if the navigation pane has │Provisional  focus │Rejected     Find PEP [p] │Superseded   Find and jump to a specific PEP │Withdrawn    Help [f1]go) │Show help for and information about the application │── Python VerQuit [f10] │NoneQuit the application │1.6          Redownload All PEPs [^r] │2.0          Redownload the list of PEPs │2.1          Search [/]go) 🔗 │2.2          Search for text anywhere in the PEPs │2.3          Search Author [u] │2.4          Search for an author then filter by themorg/pep-0784/ │2.5          Search Python Version [v] │2.6          Search for a Python version and then filter by it │2.7          Search Status [s] │2.7.9        Search for a PEP status and then filter by it │2.7.12       Search Type [t]▆ │2.8          Search for a PEP type and then filter by it │2.x          Show All [a] │3.0          Clear any filters and show all PEPs │3.1          Sort By Created [2] │3.2          Sort PEPs by their created date │3.3          Sort By Number [1] │3.4          Sort PEPs by their number │3.4.3        Sort By Title [3] │3.5          Sort PEPs by their title │3.6          ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁ │3.7               25│────────────────────────────────────────────────────────│ │3.8               20│773A Python Installation Standards Track, Draft│ │3.9               15│Manager for Windows   │ │3.10              21│Steve Dower2025-01-21│ │3.11              17│────────────────────────────────────────────────────────│ │3.12              26│771Default Extras for    Standards Track, Draft│ │3.13              21│Python Software       │  f1 Help  f2 Notes  f3 Details  f4 View  f10 Quit  ^r Redownload ▏^p Commands

Questions and feedback

If you have any questions about Peplum, or you have ideas for how it might be improved, do please feel free to visit the discussion area and ask your question or suggest an improvement.

When doing so, please do search past discussions and also issues current and previous to make sure I've not already dealt with this, or don't have your proposed change already flagged as something to do.