xoltar / idris-py

Python backend for Idris (generates Python source, not bytecode).

Python back-end for Idris

Goodies

• expressions in tail positions return directly
• if-elif sequences optimised
  • not doing comparison if it's clear which branch to take
  • single-branch trees turned into assertions (ignore them with python -O) and flattened
• tail-call optimisation (does not work for mutual recursion)
  • There is a full TCO branch using trampolines but it consumes more stack frames, thus making non-tail-recursive programs crash earlier so it's not merged into master.
  • Another full TCO branch preserves the number of stack frames but it's even slower.
• principled codegen monad makes it easy to compile from DExp
• allows typechecked use of Python libraries (example)
  • thanks to signatures for Python objects (example).
  • fully dependent type signatures are supported (example), including arguments with defaults
• allows duck typing (example)
• error reflection yields messages like:
  • Field "gets" does not exist in object signature "Session"
  • Iterable Int is not mixed into signature "Response"
• foreach -- higher-order FFI :)
• big case trees compiled specially
  • constructor-cases to binary search on tags
    • seems to bring down pythag 100 from 5.5 secs to 3.5 secs, probably because of APPLY0
  • constant-cases to dictionary lookups
    • a bit wasteful (evaluates too much in non-trivial cases) -- but apparently easy to do
• comments in the generated Python code show the meaning of low-level code
  • constructor names next to numeric constructor tags
  • readable names next to mangled names
• exceptions (no hierarchy yet, though) (example)
• threading, message passing and forkPIO (example)
• Just x compiles to x, Nothing compiles to None
  • this gives choice to FFI authors to say whether they care about None by having FFI functions take/return either bare values or maybe-values.
• calling Idris from Python (exports, usage)

Observations

• it turns out that using Text to represent generated code in the prettyprinter (branches/text) is not that much win
  • strict Text seems to be a bit slower than String
  • lazy Text seems to be about as fast as String
  • String is the simplest

Install

First, the codegen:

$ cabal sandbox init --sandbox $IDRIS_PATH/.cabal-sandbox
$ cabal configure && cabal build

Then, the library:

$ cd lib
$ idris --install python.ipkg

Some Python libraries for the example programs:

$ pip install requests bs4 numpy

Finally, set up your path appropriately:

$ export PATH="$PATH:$IDRIS_PATH/.cabal-sandbox/bin/"

Examples

Compile the example

$ cd examples/
$ idris example.idr -p python --codegen python -o example.py

Calling Python from Idris

$ python example.py
Idris has got the following exciting features:
1. Full dependent types with dependent pattern matching
2. Simple foreign function interface (to C)
3. Compiler-supported interactive editing: the compiler helps you write code using the types
4. where clauses, with rule, simple case expressions, pattern matching let and lambda bindings
5. Dependent records with projection and update
6. Type classes
7. Type-driven overloading resolution
8. do notation and idiom brackets
9. Indentation significant syntax
10. Extensible syntax
11. Cumulative universes
12. Totality checking
13. Hugs style interactive environment
Total number of features: 13

thread A starting
thread B starting
thread A done
thread B done
thread A says 9121
thread B says 9121

And now, let's fail!
  -> (1) everything's fine: [Errno 13] Permission denied: '/root/hello'
  -> (2) everything's fine: [Errno 13] Permission denied: '/root/hello'

Calling Idris from Python

>>> import example
>>> example.greet()
Hello world!