Skip to main content

The standard Python readline extension statically linked against the GNU readline library.

Project description

Stand-alone readline module

Some platforms, such as Mac OS X, do not ship with GNU readline installed. The readline extension module in the standard library of Mac “system” Python uses NetBSD’s editline (libedit) library instead, which is a readline replacement with a less restrictive software license.

As the alternatives to GNU readline do not have fully equivalent functionality, it is useful to add proper readline support to these platforms. This module achieves this by bundling the standard Python readline module with the GNU readline source code, which is compiled and statically linked to it. The end result is a package which is simple to install and requires no extra shared libraries.

The module can be used with both Python 2.x and 3.x, and has been tested with Python versions 2.5, 2.6, 2.7 and 3.1. The major and minor numbers of the module version reflect the version of the underlying GNU readline library, while the third (patch) number distinguishes different module updates based on the same readline library.

This module is usually unnecessary on Linux and other Unix systems with default readline support. An exception is if you have a Python distribution that does not include GNU readline due to licensing restrictions (such as ActiveState’s ActivePython). If you are using Windows, which also ships without GNU readline, you might want to consider using the pyreadline module instead, which is a readline replacement written in pure Python that interacts with the Windows clipboard.

The latest development version is available from the GitHub repository.


6.1.0 (2010-09-20)

  • Changed version number to reflect readline version instead of Python version
  • #4: Updated to build against readline 6.1 (patch-level 2)
  • #2: Python 3 support
  • Uses Python 2.x readline.c from release27-maint branch (r83672)
  • Uses Python 3.x readline.c from r32a2 tag (r84541)
  • Source code moved to GitHub
  • Additional maintainer: Sridhar Ratnakumar

2.6.4 (2009-11-26)

  • Added -fPIC to compiler flags to fix linking error on 64-bit Ubuntu
  • Enabled all readline functionality specified in pyconfig.h macros
  • Uses readline.c from Python svn trunk (r75725), which followed 2.6.4 release
  • Patched readline.c to replace Py_XDECREF calls with the safer Py_CLEAR
  • Fixed compilation error on Mac OS 10.4 with XCode older than version 2.4

2.6.1 (2009-11-18)

  • Updated package to work with Mac OS 10.6 (Snow Leopard), which ships with Python 2.6.1
  • Uses readline.c from Python 2.6.1 release
  • Backported “spurious trailing space” bugfix from Python svn trunk (see e.g. for details on bug)
  • Updated to build against readline 6.0 (patch-level 4)
  • Now builds successfully on Linux (removed Mac-specific flags in this case), and still supports Mac OS 10.4 and 10.5

2.5.1 (2008-05-28)

  • Updated package to work with Mac OS 10.5 (Leopard), which ships with Python 2.5.1
  • Uses readline.c from Python 2.5.1 release
  • Updated to build against readline 5.2 (patch-level 12)
  • New maintainer: Ludwig Schwardt

2.4.2 (2005-12-26)

  • Original package by Bob Ippolito, supporting Python 2.3 / 2.4 on Mac OS 10.3 (Panther) and 10.4 (Tiger)
  • Builds against readline 5.1

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for readline, version 6.1.0
Filename, size File type Python version Upload date Hashes
Filename, size readline-6.1.0-py2.5-macosx-10.5-i386.egg (387.1 kB) File type Egg Python version 2.5 Upload date Hashes View
Filename, size readline-6.1.0-py2.6-macosx-10.6-universal.egg (308.3 kB) File type Egg Python version 2.6 Upload date Hashes View
Filename, size readline-6.1.0.tar.gz (2.3 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page