all releases | oilshell.org

Oil 0.7.pre4

This is the home page for version 0.7.pre4 of Oil, a Unix shell. To use it,

1. Download a source tarball.
2. Build and install it, as described in INSTALL.

These steps take 30 to 60 seconds on most machines. After that, you can assemble an oshrc file, which is described in the manual.

Test results, metrics, and benchmarks are shown below.

Download

What's New

• Details are in the raw git change log. Not all changes affect the release tarball.
• I sometimes write a release announcement with a high-level description of changes.

Documentation

• INSTALL: How do I install Oil? This text file is also in the tarball.
• OSH User Manual: How do I use it?
  • Known Differences is trivia for advanced users. It lists differences between Oil and other shells.
  • OSH Quick Reference, with examples (incomplete). This document underlies the help builtin, and gives a rough overview of what features OSH implements.
• Github Wiki for oilshell/oil
  • The Oil Deployments wiki page has other ways of getting Oil. These versions may not be up-to-date.

Metrics

• Lines of source, counted in differented ways:
  • osh-cloc. OSH and common libraries, as measured by the cloc tool.
  • src. The whole Oil repo organized by type of source file.
  • OPy. How much code is in the OPy toolchain?
• Lines of dependencies:
  • pydeps. Oil code plus the Python standard library.
  • nativedeps. Oil code plus A slice of CPython.
• Bytecode Metrics
  • overview - Compare OPy vs. CPython.
  • oil-with-opy - Oil compiled with OPy.
  • oil-with-cpython - Oil compiled with CPython (for comparison).
  • src-bin-ratio-with-opy - How big is the compiled output?
• Native Code Metrics
  • overview - An analysis of GCC's compilation of OVM (a subset of CPython). Bloaty provides the underlying data.
  • cpython-defs/overview - We try to ship as little of CPython as possible, and this is what's left.

Oil Tests

• 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.

More tests:

• Gold Tests. Comparisons against bash (using implicit assertions, no golden output.)
• osh2oil Tests. Test the conversion of OSH to Oil.
• parse-errors. A list of all parse errors.
• runtime-errors. A list of all runtime errors.
• arena. Testing an invariant for the parser.
• osh-usage. Misc tests of the osh binary.
• oshc-deps. Tests for a subcommand in progress.
• opyc. Tests for the opyc tool.
• Smoosh test suite (from mgree/smoosh):
  • smoosh
  • smoosh-hang

OPy Tests

The OPy compiler is used to compile Oil to bytecode, but isn't itself part of the release.

• build-oil-repo
• test-gold
• regtest-compile
• regtest-verify-golden

Tree-shaking:

• Symbols in Oil
• Symbols in OPy

Manual Tests

• [ ] Test build and install on OS X

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 do shells use at startup?
• OVM Build. How long does it take for end users to build Oil? How big is the resulting binary?