Why Sponsor Oils? | source | all docs for version 0.24.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
• Options:
  • strict_errexit, command_sub_errexit, ...

OSH:

• $? - not idiomatic in YSH
• Options:
  • errexit, pipefail, inherit_errexit

Environment Variables

YSH:

• ENV
• ysh-prefix-binding - for NAME=val env bindings
• simple-command - external commands are started with an environ
• Options:
  • shopt --unset no_exported
  • shopt --set env_obj

OSH:

• export
• prefix-binding - for NAME=val env bindings

I/O

YSH:

• write
  • ysh-echo is a shortcut for write
• ysh-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)
• _this_dir
• __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
  • __invoke__ and __call__
  • propView() and prototype() - may be renamed first() rest()
  • ENV is an Obj
• 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

Namespaces

• ENV
• __builtins__