Oil is a new Unix shell, still in its early stages.
This repo contains a prototype in Python of a very complete bash parser, along with a runtime that is less complete.
The dialect of bash that is recognized is called the osh language. The main goal now is to design the oil language, which shell scripts can be automatically converted to.
The code is in Python, but we deploy a native executable. A subset of the Python-2.7.13/ directory is packaged with the application.
Clone the repo, build the Python extension, and run bin/osh. Basic things
like pipelines, variables, functions, etc. should work.
bash$ build/pylibc.sh build
...
# Now you should have a libc.so symlink in the repository root directory
bash$ bin/osh
osh$ name=world
osh$ echo "hello $name"
hello world
If you want to contribute, e-mail [email protected].
The blog has some general updates on the project status.
For information on how to build and test Oil, see Contributing on the wiki.
Try this to show a summary of what's in the repo and their line counts:
$ scripts/count.sh all
(Other functions in this file may be useful as well.)
# Development Scripts
benchmarks/ # Test for speed
build/ # Build automation
pylibc.sh # For developers to build the Python extension
test/ # Test automation
unit.sh ## Types of test runner: unit, spec, wild, smoke
spec.sh
wild.sh
smoke.sh
sh_spec.py # shell spec test framework
spec/ # spec test cases
scripts/ # Other development scripts
web/ # HTML/JS/CSS for tests and tools
# Oil Code
Python-2.7.13/ # CPython is the initial basis for the Oil VM
asdl/ # ASDL implementation
bin/ # programs to run (bin/osh)
core/ # the implementation (AST, runtime, etc.)
native/ # Native code for Oil, e.g. libc.c
osh/ # osh front end
oil/ # oil front end (empty now)
opy/ # Python compiler in Python
# Temporary Directories
_bin/ # Native executables are put here
_release/ # Source release tarballs are put here
_build/ # Temporary build files
_tmp/ # Temporary test files and the like
# Dev Docs
README.md
# End user docs
LICENSE
INSTALL
# End user build system
Makefile
configure
install
Unit tests are named foo_test.py and live next to foo.py.
Right now we're using /r/oilshell on Reddit for general discussion.
I have docs that need to be cleaned up and published. For now, there is a fair amount of design information on the blog at oilshell.org.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent