Why Sponsor Oils? | source | all versions | oilshell.org

Oils 0.21.0

This is the home page for version 0.21.0 of Oils, a Unix shell. To use it,

1. Download a source tarball.
2. Build it and do a "smoke test", as described in INSTALL.

These steps take 30 to 60 seconds on most machines. After installation, see Getting Started.

The associated quality page shows test results, metrics, and benchmarks.

Download

Oils Packaging Guidelines:

• The oils-for-unix tarball is the fast shell in C++, completed in 2024. The distro package should be called oils-for-unix.
• The oil tarball is the slow reference interpreter based on CPython.
  • Don't rename old distro packages. They can remain oil.
  • It's not worth packaging oil in new distros. It may be removed at some point.
• The project is now called Oils, or Oils for Unix. There is no more oil!

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

These docs are ready to read:

• Getting Started
• FAQ on Documentation. Look here if you can't find something.
• OSH:
  • Known Differences Between OSH and Other Shells | Quirks | Tracing Execution | Headless Mode
• YSH:
  • Intro: A Tour of YSH | A Feel For YSH Syntax | YSH vs. Shell Idioms and Shell Idioms | What Breaks When You Upgrade to YSH | YSH Language FAQ
  • Comparisons: YSH vs. Shell | YSH Expressions vs. Python
  • Features: Egg Expressions (YSH Regexes) | YSH Regex API | Guide to Procs and Funcs | YSH Fixes Shell's Error Handling | Simple Word Evaluation | Variable Declaration, Mutation, and Scope | Hay - Custom Languages for Unix Systems
• Data Languages:
  • JSON | J8 Notation
• Language Design:
  • Syntactic Concepts | Command vs. Expression Mode | Language Influences
  • Notes: Novelties in OSH and YSH | Warts
• Reference:
  • Oils Error Catalog, With Hints

More:

• All Docs about Oils (in progress).
  • Including the Oils Reference (in progress)
• Github Wiki for oilshell/oil. The Oil Deployments wiki page has other ways of getting Oils. These versions may not be up-to-date.