PyReadline: a ctypes-based readline for Windows
pyreadline is based on UNC readline by Gary Bishop. New features:
- Support for international characters (if you have the correct codepage active)
- Copy and paste using the clipboard
- Smart paste for convenient use with ipython. Converting tab separated data
- to python list or numpy array. Converting file paths to use / and escaping any spaces using \ .
- Pasting of multiline code removing empty lines
- System bell is disabled by default, can be activated in config file.
Note: UNC readline is not being developed further by Gary, and PyReadline can be considered the continuation of that project. This was done in full agreement with Gary, given his current development priorities.
Mailing list
Questions and bug reports can be directed to the ipython-user mailing list.
Status
Currently no release has been made. You can however run the subversion version.
Dependencies
ctypes (included with python 2.5 - for older versions you need to download it separately)
Install using binary installer
Download installer from here.
- make sure no other readline is installed
- run installer
- The configuration file pyreadlineconfig.ini can be copied from Python24/lib/site-packages/pyreadline/configuration to your HOME directory (usually c:/documents and settings/YOURNAME).
- When using ipython pyreadline is automatically activated. If you want to use pyreadline from the interactive prompt of the python interpreter then you have to include the code in Python24/lib/site-packages/pyreadline/configuration/startup.py in your pythonstartup file or set the PYTHONSTARTUP environment variable to point to that file.
- Manual can be found in Python24/share/doc/pyreadline
Install using easy_install
Requires setuptools, install by running http://peak.telecommunity.com/dist/ez_setup.py if you haven't already done this.
- make sure no other readline is installed
- easy_install pyreadline==dev
- copy pyreadlineconfig.ini from pyreadline-egg/pyreadline/config to your homedir
- (usually c:/documents and settings/USERNAME)
- copy contents of pyreadline-egg/pyreadline/config/startup.py to your
- PYTHONSTARTUP file to get pyreadline available at python prompt (not necessary for ipython)
Install using subversion
Requires subversion client
svn co http://ipython.scipy.org/svn/ipython/pyreadline/trunk pyreadline
- cd pyreadline
- python setup.py install
- copy pyreadlineconfig.ini from pyreadline-egg/pyreadline/config to your homedir
- (usually c:/documents and settings/USERNAME)
- copy contents of pyreadline-egg/pyreadline/config/startup.py to your
- PYTHONSTARTUP file to get pyreadline available at python prompt (not necessary for ipython)
Egg install in development mode using subversion
Requires subversion client
svn co http://ipython.scipy.org/svn/ipython/pyreadline/trunk pyreadline
- cd pyreadline
- python eggsetup.py develop
- Now you can edit the checked out code and test it immediately
- copy pyreadlineconfig.ini from pyreadline/pyreadline/config to your homedir
- (usually c:/documents and settings/USERNAME)
- copy contents of pyreadline/pyreadline/config/startup.py to your
- PYTHONSTARTUP file to get pyreadline available at python prompt (not necessary for ipython)