Thanks for working on bpython!

On the GitHub issue tracker some issues are labeled bite-size these are particularly good ones to start out with.

See our section about the :ref:`community` for a list of resources.

#bpython on freenode is particularly useful, but you might have to wait for a while to get a question answered depending on the time of day.

Using a virtual environment is probably a good idea. Create a virtual environment with

$ virtualenv bpython-dev
$ source bpython-dev/bin/activate   # this step is necssary every time you work on bpython
<hack on bpython>
$ deactivate                        # back to normal system environment

Fork bpython in the GitHub web interface, then clone the repo:

$ git clone git@github.com:YOUR_GITHUB_USERNAME/bpython.git

Next install this development version of bpython:

$ pip install pygments curtsies greenlet watchdog urwid  # install all the dependencies
$ pip install sphinx mock                                # development dependencies
$ cd bpython
$ python setup.py develop
<modify a file in some way>
$ bpython-curtsies      # this runs your modified copy of bpython!

As a first dev task, I recommend getting bpython to print your name every time you hit a specific key.

To run tests:

$ python -m unittest discover bpython

The documentation is included in the regular bpython repository. After checking out the bpython repository and installing sphinx as described in the previous step, you can run the following command in your checkout of the repository to build the documentation:

$ make -C doc/sphinx html

Afterwards you can point your browser to doc/sphinx/build/html/index.html. Don't forget to recreate the HTML after you make changes.

The site (and it's theme as well) is stored in a separate repository and built using pelican. To start hacking on the site you need to start out with a checkout and probably a virtual environment:

$ virtualenv bpython-site-dev
$ source bpython-site-dev/bin/activate
$ pip install pelican

Fork bsite and bsite-theme in the GitHub web interface, then clone the repositories:

$ git clone git@github.com:YOUR_GITHUB_USERNAME/bsite.git
$ git clone git@github.com:YOUR_GITHUB_USERNAME/bsite-theme.git

Next you can fiddle around in the source files. If you want to build the site you activate your virtualenv and tell pelican to generate the site with the included configuration file.

$ source bpython-site-dev/bin/activate
$ cd bsite # if you want to fiddle on the text of the site otherwise go into bsite-theme
$ pelican -t ../bsite-theme -s pelicanconf.py # if you checked out the theme in a different place, use that path

After this you can open the output/index.html in your favourite browser and see if your changes had an effect.