Metadata-Version: 1.1
Name: pygnurl
Version: 0.3.0
Summary: ctypes-based Python wrapper for GNU Readline
Home-page: https://pypi.python.org/pypi/pygnurl
Author: evanunderscore
Author-email: evanunderscore@gmail.com
License: GNU General Public License v2
Description: pygnurl
        =======
        
        ``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.
        
        Requirements
        ------------
        
        ``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:
        
        http://gnuwin32.sourceforge.net/packages/readline.htm
        
        Quick Start Guide
        -----------------
        
        ::
        
            pip install pygnurl
            set PYGNURL_DLL=X:\path\to\readline.dll
            setx PYGNURL_DLL %PYGNURL_DLL%
            python
            >>> 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.
        
        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
        ------------
        
        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)
        
        .. _pyreadline: https://pypi.python.org/pypi/pyreadline
        .. _gnureadline: https://pypi.python.org/pypi/gnureadline
        .. _rl: https://pypi.python.org/pypi/rl
        
Keywords: gnu readline bindings
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: Microsoft :: Windows
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
