This is pyrepl 0.8.4, a readline-a-like in Python.

It requires python 2.7 (or newer) and features:

  • sane multi-line editing
  • history, with incremental search
  • completion, including displaying of available options
  • a fairly large subset of the readline emacs-mode keybindings (adding more is mostly just a matter of typing)
  • a liberal, Python-style, license
  • a new python top-level
  • no global variables, so you can run two or more independent readers without having their histories interfering.
  • no hogging of control -- it should be easy to integrate pyrepl into YOUR application's event loop.
  • generally speaking, a much more interactive experience than readline (it's a bit like a cross between readline and emacs's mini-buffer)
  • unicode support (given terminal support)

There are probably still a few little bugs & misfeatures, but _I_ like it, and use it as my python top-level most of the time.

To get a feel for it, just execute:

$ python pythoni

(One point that may confuse: because the arrow keys are used to move up and down in the command currently being edited, you need to use ^P and ^N to move through the history)

If you like what you see, you can install it with the familiar

$ python install

which will also install the above "pythoni" script.

Summary of 0.8.4:

  • python3 support
  • support for more readline hooks
  • backport various fixes from pypy
  • gracefully break on sys.stdout.close()

Summary of 0.8.3:

  • First release from new home on bitbucket.
  • Various fixes to pyrepl.readline.
  • Allow pyrepl to run if unicodedata is unimportable.

Summary of 0.8.2:

  • This is the same version which is distributed with PyPy 1.4, which uses it as its default interactive interpreter:

    • have the possibility of having a "CPython-like" prompt, with ">>>" as PS1 and "..." as PS2
    • add the pyrepl.readline module, which exposes a subset of CPython's readline implemented on top of pyrepl
  • Add support for colored completions: see e.g. fancycomplete:

Summary of 0.8.1:
  • Fixes - in the area of unbound keys and unknown commands - in quoted-insert - in unicode support

  • make Reader and subclasses new-style classes - make the inheritance hierachy look like this



    HistoricalReader CompletingReader



    Turns out I've been wanting new-style classes since before they existed!

    • needed to slightly change the way keymaps are built
Summary of 0.8.0:
  • A whole bundle of things. - unicode support (although working out what encoding the terminal

    is using can be "tricky")

    • internal rearchitecting
    • probably a bunch of new bugs...
  • Development and web-presence moved to

Summary of new stuff in 0.7.1:
  • A non-broken
Summary of new stuff in 0.7.0:
  • Moved to a package architecture.
  • Wrote a (very simple!) distutils script.
  • Changed the keyspec format to be more sensible. See the docstring in pyrepl/ for more information.
  • Portability fixes.
  • Various tortuous changes to use 2.2 features where possible but retaining 2.1 support (I hope; haven't got a 2.1 here to test with).
  • Jumping up and down on control-C now shouldn't dump you out of pyrepl (via a large hammer kind of approach).
  • Bug fixes, particularly in the history handling stuff.
  • reader.Reader has a new method, bind(), intended to be used by the user.
  • Changes to the init file handling.
  • Sundry code reorganization. Libraries built on top of pyrepl will probably require small modifications (but I'm not sure anyone has written any of these yet!).
  • A prototypical pygame console.
    -- see CHANGES for more details and older news