Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
dy2
 
 
 
 
 
 
 
 
rt1
 
 
rt2
 
 
 
 
rt3
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

The Very Slow Jython Project

The aim of the Very Slow Jython project is to re-think implementation choices in the Jython core, through the gradual, narrated evolution of a toy implementation, starting from zero code.

This project is as much a writing project as a programming one. The narrative of the development is in reStructuredText using Sphinx. It may be read at The Very Slow Jython Project on Read the Docs. (Thanks for hosting it, guys.)

Contents

Without building the project, GitHub does a reasonable job of rendering pages but not the navigation. The chapters are these:

Contents

  1. Background to the Very Slow Jython Project
  2. A Tree-Python Interpreter
  3. A Generated Code Interpreter
  4. Performance
  5. Architecture
  6. Writing Code

However, it is better read at Read the Docs, which should be up to date thanks to an integration with GitHub. Alternatively, it can be built on your own machine.

Building the Project

This project builds using Gradle. As it stands, the primary output is the narrative. It uses the excellent sphinx-gradle-plugin, which delivers HTML output to the directory docs/build/site.

Windows

To build the narrative documentation type:

.\gradlew --console=plain site

The conventional main task:

.\gradlew --console=plain test

compiles and runs the unit tests that call the code shown in the text.

Organisation of Sources

The narrative of the Very Slow Jython project will be maintained as documentation in reStructuredText, in the same repository as the code itself. However the "false starts", various failed implementation ideas, will stay around so that the narrative can make reference to them.

Currently, I organise the successive versions as sub-projects and packages, concurrently in the project structure, at the cost of some duplication.

About

Very slowly rethinking Jython through toy implementations

Resources

Releases

No releases published

Packages

No packages published