Home

Welcome to the oil wiki!

For Users

• How To Test OSH
• Shell Programs That Run Under OSH
• Oil Deployments
• Migration Guide

For Developers

• Contributing / Spec Tests
• Git Tips -- Patterns for using Git on this project.
• Testing the Interactive Shell -- a bunch of manual test cases
• Debugging Completion Scripts -- the useful --debug-file flag!
• Using Zephyr ASDL
• Implementing the Oil Expression Language

Other:

• Project Goals / Carrots

Implementation Details

• Signal Handling in Oil

Reference

External Resources -- External Resources on Unix shells, programming language design, and implementation

Protocol Designs

• Coprocess Protocol Proposal
• Shellac Protocol Proposal -- for shell-independent command-line completion.
• TSV2 Proposal

Other Designs

• Documentation Strategy
• Structured Data in Oil
  • Structured Data Over Pipes

• Interactive Shell -- Ideas about the interactive shell and possibly graphical shell.
  • Shell Autocompletion

Analysis of Unix Shell

• Shell Security Problems
• Shell WTFs
• Unix Tools -- notes on the things that a shell interacts with. The shell "standard library".
• Little Languages

OSH Parser / OSH Optimization Log

Programming Language Implementation

Parsing Case Studies -- What algorithms and tools do production-quality languages use for parsing?

Bootstrapping Case Studies -- How are languages bootstrapped?

Lossless Syntax Tree Pattern

Language Subsets -- an abstract but practical way of specifying a language

Compact AST Representation

Architecture of Various Interpreters

Programming Language Design

• Language Data Models
• Language Design and Theory of Computation

Oil Blog Planning

• Metaprogramming
• Metaprogramming Use Cases
• Partial Evaluation

Programming Patterns

• Feature Detection Is Better than Version Detection
• Language Composition Bestiary
• Exhaustive Test Suite

Blog Themes / Post Ideas

Parsing is Difficult

• Interesting facts about other language implementations:

  • Clang AST, TypeScript external visitors with "switch", TableGen language in LLVM, sh/awk/C code gen in most shells.

• Breaking abstractions -- the git log | python pipeline is like the Go-style of unicode handling with utf-8. You don't always have to parse, operate, serialize. Sometimes you can just massage the input.

• Remote evaluation. ssh user@host find -type f -a -executable sends an expression over the wire, just like SQL does. Or sh, awk, etc.