Skip to main content

ctypes-based Python wrapper for GNU Readline

Project description

pygnurl is a ctypes-based Python wrapper for GNU Readline intended to be used as a drop-in replacement for Python’s built-in readline module. It is currently intended for Windows Python which does not ship with a readline module by default.

pygnurl works with 32- and 64-bit Python 2 and 3.


pygnurl dynamically binds to a Readline DLL, so you need a DLL matching the architecture of your Python interpreter (not necessarily your system). If you are using 32-bit Python, you can get a pre-built Windows-compatible Readline DLL from:

Quick Start Guide

pip install pygnurl
set PYGNURL_DLL=X:\path\to\readline.dll
>>> import rlcompleter
>>> import readline
>>> readline.parse_and_bind('tab: complete')
>>> r<tab><tab>

If your Readline DLL is on your path, you can specify PYGNURL_DLL by name only. Note that if you specify PYGNURL_DLL with a path, pygnurl won’t be able to load it if it depends on other DLLs not on your path.


pygnurl aims to provide full GNU Readline support across all platforms with no compilation overhead. Any pre-built Readline library should be able to be dropped in with no code modifications. If necessary, version- or platform-specific compatibility fixes can be implemented in Python, not C.


For source code, questions and bug reports, visit the GitHub repository:


pyreadline - A python implmentation of GNU readline. (Windows)

gnureadline - The standard Python readline extension statically linked against the GNU readline library. (Mac OS X, Posix)

rl - Alternative Python bindings for GNU Readline. (Linux, Mac OS X)

Project details

Download files

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

Source Distribution (22.1 kB view hashes)

Uploaded source

Built Distribution

pygnurl-0.3.0-py2.py3-none-any.whl (13.2 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page