jython-docs/devguide / index.rst

Python Developer's Guide

Quick Start

Here is a list of the basic steps necessary to get set up and make a patch:

  1. get :ref:`a clone of Jython <setup>` with hg clone
  2. Run ant to :ref:`build Jython <compiling>`.
  3. :doc:`run the tests <runtests>` with ant regrtest
  4. make the :doc:`patch <patch>`;
  5. submit it to the issue tracker.


We encourage everyone to contribute to Jython and that's why we have put up this developer's guide. If you still have questions after reviewing the material in this guide, then the Python Mentors group is available to help guide new contributors through the process. The :doc:`Developer FAQ <faq>` is another useful source of information.

Guide for contributing to Python:

It is recommended that the above documents be read in the order listed. You can stop where you feel comfortable and begin contributing immediately without reading and understanding these documents all at once. If you do choose to skip around within the documentation, be aware that it is written assuming preceding documentation has been read so you may find it necessary to backtrack to fill in missing concepts and terminology.

Proposing changes to Jython itself

Improving Jython's code, documentation and tests are ongoing tasks that are never going to be "finished", as Jython operates as part of an ever-evolving system of technology. An even more challenging ongoing task than these necessary maintenance activities is finding ways to make Python, in the form of the standard library and the language definition, an even better tool in a developer's toolkit.

While these kinds of change are much rarer than those described above, they do happen and that process is also described as part of this guide:

Other Interpreter Implementations

This guide is specifically for contributing to the Jython interpreter. (while most of the standard library is written in Python, the interpreter core is written in Java and integrates most easily with the Java ecosystem).

There are other Python implementations, each with a different focus. Like Jython, they always have more things they would like to do than they have developers to work on them. Some major example that may be of interest are:

  • PyPy: A Python interpreter focused on high speed (JIT-compiled) operation on major platforms
  • Jython: A Python interpreter focused on good integration with the Java Virtual Machine (JVM) environment
  • IronPython: A Python interpreter focused on good integration with the Common Language Runtime (CLR) provided by .NET and Mono
  • Stackless: A Python interpreter focused on providing lightweight microthreads while remaining largely compatible with CPython specific extension modules