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 (as Python on Windows comes without a readline module by default) and Mac OS X (as its readline module is implemented using libedit, not GNU Readline).

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

Requirements

pygnurl dynamically loads a Readline library, so you need a version matching the architecture of your Python interpreter (not necessarily your system).

More information on where to get Readline can be found on the Readline home page:

http://tiswww.case.edu/php/chet/readline/rltop.html#Availability

Windows users can get a pre-built 32-bit Readline DLL from:

http://gnuwin32.sourceforge.net/packages/readline.htm

Quick Start Guide

Set the PYGNURL_LIB environment variable to the filename of your Readline library. This will be loaded using the shared library search order rules of your system.

pip install pygnurl
python
>>> import rlcompleter
>>> import readline
>>> readline.parse_and_bind('tab: complete')
>>> r<tab><tab>

Motivation

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.

Development

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

https://github.com/evanunderscore/pygnurl

Alternatives

readline - Part of the standard library. Python on Mac OS X may implement this using libedit instead of GNU Readline and must be configured accordingly.

pyreadline - A python implmentation of GNU readline.

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

rl - Alternative Python bindings for GNU Readline.

Platforms

Library

Interfaces

pygnurl

Any

Dynamic

Subset

readline

Unix-like

Static

Subset

pyreadline

Windows

Pure Python

Subset

gnureadline

Unix-like

Static

Subset

rl

Unix-like

Static

All

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

pygnurl-0.4.0.zip (23.0 kB view hashes)

Uploaded source

Built Distribution

pygnurl-0.4.0-py2.py3-none-any.whl (13.8 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