oilshell.org

Oil Version 0.5.alpha1

What's New

• The Release announcement has a high-level summary of changes.
• Details are in the raw git change log. Some of these changes may not affect the release tarball (e.g. tool changes).

Docs For End Users

• INSTALL. How to install OSH. This text file is also at the root of the tarball.
• OSH Quick Reference, with Examples (in progress). This document underlies the OSH help builtin. It also gives a rough overview of what features OSH implements.

Docs For Developers

• Github Wiki for oilshell/oil

Metrics

• Count lines of source code in different ways:
  • oil-osh-cloc. The core of Oil, as measured by the cloc tool.
  • src. The whole Oil repo organized by type of source file.
  • parser. How big is the parser?
  • runtime. How big is the runtime?
• Count lines of dependencies:
  • pydeps. Oil code plus the Python standard library.
  • nativedeps. Oil code plus A slice of CPython.
• Bytecode Size

Tests Results

• Spec Tests. Test OSH behavior against that of existing shells.
• Wild Tests. Parsing and translating thousands of shell scripts with OSH.
• Unit Tests. Python unit test results.
• Gold Tests. Comparisons against bash (using implicit assertions, no golden output.)
• osh2oil Tests. Test the conversion of OSH to Oil.

Benchmarks

• OSH Parser Performance. How fast does OSH parse compared to other shells?
• OSH Runtime. How fast does OSH run compared to other shells?
• Virtual Memory Baseline. How much memory to shells use at startup?
• OHeap. Metrics for a possible AST encoding format.
• OVM Build. How long does it take for end users to build Oil? How big is the resulting binary?