Shasta extension for libbash

dash-bash-diffs.md

@@ -0,0 +1,36 @@
+# Differences between Dash and Bash frontends
+
+Shasta was designed for libdash, with libbash support added later.
+Both `json_to_ast` (for libdash) and `bash_to_shasta_ast` (for libbash) contain `to_ast_node(s)` functions,
+which each take a parsed, untyped AST and convert it to a shasta AST as defined in `ast_node`.
+Thr transformation is direct; bash is assumed to be a superset of dash. This is not strictly true, since
+both have some minor divergences from the POSIX spec, but is good enough.
+
+### The following fields of `AstNodes` are only used for Bash scripts:
+
+- `RedirectionNode` and `*RedirNode`: The `fd` field is either `('var', filename)` or `('fixed', fd)`.
+   Dash only uses the latter form; the first exists to support bashisms like `exec {fd} > log.txt`,
+   which open the file and assigns `fd` the new file descriptor.
+- `FileRedirNode`: 'ReadingString' subtype. Handles here-strings.
+- `BackgroundNode`: The `after_ampersand` field. Handles an edge case with heredocs.
+
+The pretty printer uses the various `nobraces` and `semicolon` fields to determine
+whether braces and semicolons are printed. In dash, this doesn't matter, but in bash
+they can lead to a syntax error. For example:
+
+```bash
+( { echo hi; echo bye } )
+```
+
+is invalid.
+
+### The following AstNodes are only used for Bash scripts:
+
+- `SelectNode`
+- `ArithNode`
+- `CondNode`
+- `ArithForNode`
+- `CoprocNode`
+- `TimeNode`
+- `SingleArgRedirNode`
+- `GroupNode`

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shasta"
-version = "0.1.0"
+version = "0.2.0"
 authors = [
   { name="Konstantinos Kallas", email="[email protected]" },
 ]
@@ -15,6 +15,9 @@ classifiers = [
     "Operating System :: POSIX",
 ]
 
+[project.optional-dependencies]
+dev = ["libbash", "libdash"]
+
 [project.urls]
 "Homepage" = "https://github.com/binpash/shasta"
 "Bug Tracker" = "https://github.com/binpash/shasta/issues"

setup.py

@@ -4,7 +4,7 @@
 long_description = (Path(__file__).parent / "README.md").read_text()
 
 setup(name='shasta',
-      version='0.1.0',
+      version='0.2.0',
       packages=['shasta'],
       ## Necessary for the markdown to be properly rendered
       long_description=long_description,