The files in this directory are for demonstrating how scripts using
pysh currently look, and for exploring what features are important.
They come in threes:
-
foo.orig: A Bash script, originally written somewhere else to do some useful task unrelated to Pysh. -
foo: A port offoo.origas a Python script using thepyshlibrary. -
test_foo.py(usually): Tests forfoo.
As we make changes to pysh, we update the demo scripts to match
changes in the API. The tests help make sure the scripts remain
accurate as demos.
When pysh is serving a given script's use case well, the Python
version is only as much code as the Bash version or slightly more,
and each part of it is at least as easy to read. When the Python
version is significantly longer, or the bits that do classic shell
tasks like invoking CLIs and setting up pipelines are more cumbersome
or complicated, that's an area where there's more to do.