Oil Native Quick Start

1. Get bin/osh -c 'echo hi' Working

The Contributing page will walk you through it. You need a Linux machine -- Ubuntu/Debian-ish are most likely to work. This often takes less than 1 minute.

If it takes more than 5 or 10 minutes, something has gone wrong! Paste the command you ran and the error message in #oil-dev at https://oilshell.zulipchat.com/

Run the spec tests

I usually run this command as a sanity check.

~/git/oilshell/oil$ test/spec.sh smoke 
smoke.test.sh
case    line    dash    bash    mksh    osh
  0       4     pass    pass    pass    pass    builtin
  1       8     pass    pass    pass    pass    command sub

The Contributing page has more details. Also see Spec Tests.

2. Get `_bin/cxx-dbg/osh_eval -c 'echo hi' Working

This is oil-native, the C++ translation. This is a bit harder to run.

Instructions are in mycpp/README.md.

Again let us know if anything doesn't work!

Run the Spec Tests

~/git/oilshell/oil$ test/spec-cpp.sh run-with-osh-eval smoke
smoke.test.sh
case    line    osh     osh_.py osh_.cc
  0       4     pass    pass    pass    builtin
  1       8     pass    pass    pass    command sub
...

Find the Spec Tests in the CI

Go to http://travis-ci.oilshell.org/github-jobs/ → cpp task → spec-cpp RESULTS.

Example: http://travis-ci.oilshell.org/github-jobs/2022-05-23__17-34-18.wwz/_tmp/spec/cpp/osh-summary.html