Why Sponsor Oils? | source | all docs for version 0.23.0 | all versions | oilshell.org

YSH and OSH Topics by Feature

(in progress)

This page links to topics in the Oils Reference. It's organized differently than the YSH Table of Contents or OSH Table of Contents.

Where YSH Improves on OSH

Errors

YSH:

• try
• _error
• multiple processes
  • _pipeline_status
  • _process_sub_status

OSH:

• $? - not idiomatic in YSH

Environment Variables

YSH:

• ENV
• [simple-command][] - for NAME=val env bindings
  • TODO: should we have a envFromDict() function that goes with env -i?
• Options:
  • shopt --unset no_exported
  • shopt --set env_obj

OSH:

• export

I/O

YSH:

• write
  • echo is a shortcut for write
• read - read --all, etc.
• redir
• The io object

OSH:

• printf

Procs

YSH:

• proc
• Invokable objects: __invoke__, Obj
• simple-command is how you invoke procs

OSH:

• sh-func

Modules

• use
• is-main
• provide (TODO)
• __provide__
• An imported module is an Obj with an __invoke__ method

OSH:

• source
• source-guard

Interactive Shell

• renderPrompt()

OSH:

• complete
• Oils enhancements: compexport, compadjust

Tracing

• set -x aka set -o xtrace
• PS4
• SHX_*

Unicode

• TODO: which functions respect Unicode?

Also see the Unicode doc.

YSH Only

Objects

• Obj
• propView() and prototype() - may be renamed first() rest()
• operator . ysh-attr
• operator -> thin-arrow

Closures

• block-arg
• Maybe: proc, func

Funcs

• func
• Callable objects: __call__ and Obj (TODO)
• ysh-func-call

Reflection

• The io object has eval() methods, etc.
• The vm object for inspecting interpreter structures