skip to navigation
skip to content

Not Logged In

konch 0.1.0

Customizes your Python shell.

Latest Version: 1.1.0

konch is a utility libary and command line interface for creating custom Python shells.

  • Automatically import any object upon startup
  • Per-project configuration
  • Compatible with IPython and BPython (automatically falls back to built-in interpreter)

Screencast

Get it now

$ pip install konch

Get started

Just use the konch command to run your interactive Python interpreter.

$ konch init
$ konch

To customize your shell environment, edit the .konchrc file created when you ran konch init.

.konchrc is just a regular Python file that calls the konch.config(config_dict) function.

You can pass any of the following options:

  • context: A dictionary of objects that will be available to you in your shell session.
  • shell: Default shell to use. May be konch.IPythonShell, konch.BPythonShell, konch.PythonShell, or konch.AutoShell (default).
  • banner: Custom banner text to show.

Here is an example .konchrc file that includes some functions from the requests library in its context.

import konch
import requests

konch.config({
    'context': {
        'httpget': requests.get,
        'httppost': requests.post,
        'httpput': requests.put,
        'httpdelete': requests.delete
    },
    'banner': 'A humanistic HTTP shell'
})

For more examples, see the example_rcfiles directory.

For more info on available command-line options, run konch --help.

Requirements

  • Python 2 or 3 (tested on 2.6, 2.7, 3.2, 3.3)

License

MIT licensed. See the bundled LICENSE file for more details.

Changelog

0.1.0 (2014-03-14)

  • First release to PyPI.
 
File Type Py Version Uploaded on Size
konch-0.1.0.tar.gz (md5) Source 2014-03-14 11KB
  • Downloads (All Versions):
  • 71 downloads in the last day
  • 538 downloads in the last week
  • 1852 downloads in the last month