Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/forivall/tacoscript
:taco: The bidirectional alt-JS language
https://github.com/forivall/tacoscript
alt-js ast-transformations babylon coffeescript cst generator javascript parser
Last synced: 17 days ago
JSON representation
:taco: The bidirectional alt-JS language
- Host: GitHub
- URL: https://github.com/forivall/tacoscript
- Owner: forivall
- License: mit
- Created: 2015-10-03T23:21:34.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-02-06T20:40:53.000Z (9 months ago)
- Last Synced: 2024-04-29T10:07:03.710Z (7 months ago)
- Topics: alt-js, ast-transformations, babylon, coffeescript, cst, generator, javascript, parser
- Language: JavaScript
- Homepage: http://tacoscript.github.io
- Size: 4.18 MB
- Stars: 46
- Watchers: 6
- Forks: 3
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[TacoScript][TacoScript]
==========
[](https://travis-ci.org/forivall/tacoscript) [](https://waffle.io/forivall/tacoscript) [](https://gitter.im/forivall/tacoscript?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
An es2015+-isomorphic altjs language, with syntax inspired by CoffeeScript,
Python, Ruby, and [frappe], and architecture inspired by [Babel].
Syntax Specification
## What does it mean that this language is "es2015+-isomorphic"?
TacoScript shares its Abstract Syntax Tree (AST) with JavaScript, using the same
format as [Babylon]. This means that, for any valid JavaScript code, there is an
exact, lossless version of that code in TacoScript, and vice versa: For all
valid TacoScript code, there is an exact translated representation in
JavaScript. Currently, whitespace will not always be preserved; eventually,
whitespace will also be preserved.
> Unlike CoffeeScript, TacoScript _actually_ is, 100%, just JavaScript.
So, if it is just JavaScript, why does this exist? For the same reason that
there are both British English and American English: Some people just prefer
different conventions.
And also to experiment with new syntax that won't or can't be an [ECMAScript]
proposal. (so [Babel] won't support them).
## Packages
### [tacoscript](./packages/tacoscript)
_(In Progress)_
Command line tools. Currently includes `repl`, `compose`, `transpose`, `compile`, and `node` commands.
### [horchata](./packages/horchata)
Parses TacoScript into an AST/[CST]. Uses the same tree format as [Babylon],
deviating where necessary.
import * as horchata from "horchata"
ast = horchata.parse(code, options)
### [cstify](./packages/cstify)
Adds [CST] `sourceElements` to an existing JavaScript / [Babylon] / estree CST.
### [tacotruck](./packages/tacotruck)
_(Previously `tacoscript-generator`)_
Generates TacoScript code from a [Babylon] AST/CST.
import generate from "tacotruck"
code = generate(ast, options, originalSourceCode)
### [taqueria](./packages/taqueria)
_(Not Implemented)_
Converts a JavaScript AST with CST elements to a TacoScript CST, which preserves
whitespace. Inverse of `alpastor`.
### [alpastor](./packages/alpastor)
_(In progress)_
Converts a TacoScript AST's CST elements to JavaScript CST elements, which then
can be output as JavaScript code that preserves the whitespace present in the
TacoScript code. Inverse of `taqueria`
### [comal](./packages/comal)
AST translator (transpiler / detranspiler) core.
> comal (noun) _/koˈmal/_ - A flat, pan-like clay or metal griddle used to cook
> tortillas or other foods.
### tacoscript-eslint
_(Not Implemented)_
Transforms a TacoScript AST so that it can be checked by [ESLint].
### tacoscript-implicit-return-function
_(In Progress, needs generator and transforms)_
AST transformations for implicitly returning functions ("sharp arrows").
### [tacoscript-strudel-this-member](./packages/tacoscript-strudel-this-member)
_(In Progress, needs generator and transforms)_
AST transformations for `this.` → [`@`][strudel]
shorthand.
### [tacoscript-logical-assign](./packages/tacoscript-logical-assign)
_(In Progress, needs generator and transforms)_
Parser & Generator plugins and AST transformations for `and=` and `or=`.
Could also include an acorn plugin for parsing `||=` and `&&=` in javascript.
### tacoscript-auto-const-extern
_(Not Implemented)_
Parser & Generator plugins for extern declarations. Required by any auto-const
plugins, or if anyone creates an auto-let or CoffeeScript-style auto-var
alternative plugin.
### tacoscript-auto-const-statement
_(Not Implemented)_
AST transformations for automatic const variables when assignment is a
statement. [_(Spec)_](./doc/auto-const.md).
### tacoscript-auto-const-expression-simple
_(Not Implemented)_
AST transformations for automatic const variables in restricted expression
forms. [_(Spec)_](./doc/auto-const.md).
### tacoscript-auto-const-full
_(Not Implemented)_
AST transformations for automatic const variables anywhere forms.
[_(Spec)_](./doc/auto-const.md). May create ugly JavaScript code.
### [tacoscript-iife-with](./packages/tacoscript-iife-with)
_(In Progress, needs generator)_
Parser & Generator and transformations for iife's created with the `with` keyword syntax.
Example:
```
with= {bar: foo, boop: beep} > bar + boop
```
### tacoscript-negative-conditional
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `unless` and `until`.
### tacoscript-useful-modulo
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `%%`.
### tacoscript-fluid-comparison
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `a < b < c`, etc.
### tacoscript-negative-binary-keywords
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `not instanceof`, `not
in` (, `not of`).
### tacoscript-universal-fat-arrow
_(Parsing complete, generator and transformations ready to start)_
AST transformations and verification for using the fat arrow (`=>`) in any
function definition situation, for lexical binding of `this` and `arguments`.
Uses horchata's `lexicallyBoundNamedFunctions` feature parsing option.
### tacoscript-asbool
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `!!` (`not not`) to
`asbool`.
### tacoscript-binary-of
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `of` binary operator.
### tacoscript-soak
_(Not Implemented)_
Parser & Generator plugins and AST transformations for soak member expressions:
`?.` and `?[`.
### tacoscript-null-coalescing-op
_(Not Implemented)_
Parser & Generator plugins and AST transformations for the null coalescing
operator: `a ? b`.
### tacoscript-null-coalescing-assign
_(Not Implemented)_
Combination of tacoscript-logical-assign and tacoscript-null-coalescing-op.
### tacoscript-typeof-null-is-null
_(Not Implemented)_
Parser & Generator plugins and AST transformations so that in TacoScript,
`typeof null === "null"`.
### tacoscript-safe-switch
_(Not Implemented)_
Parser & Generator plugins and AST transformations for the non-fallthrough
switch variant.
### tacoscript-double-strudel-class-member
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `@@` shorthand operator.
### tacoscript-dynamic-super
_(Not Implemented)_
Allow super in any (i.e. non-class) function, and translate `super()` to
`this.constructor.super_.call(this)` and `super.foo()` to
`this.constructor.super_.prototype.foo.call(this)`
The `super_` convention is codified in `util.inherits`.
### tacoscript-generic-template-string
_(Not Implemented)_
### tacoscript-multiline-string
_(Not Implemented)_
### tacoscript-multiline-regex
_(Not Implemented)_
### tacoscript-boolean-switch-statement
_(Not Implemented)_
### tacoscript-boolean-switch-expression
_(Not Implemented)_
### tacoscript-auto-label
_(Not Implemented)_
Parser & Generator plugins and AST transformations for automatic labels for long
breaks: `break for`, etc.
### tacoscript-conditional-catch
_(Not Implemented)_
Parser & Generator plugins and AST transformations for [conditional catch
clauses].
### tacoscript-rescue
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `rescue` blocks for
functions, for simplified error handling.
### tacoscript-conditional-rescue
_(Not Implemented)_
Combines tacoscript-conditional-catch and tacoscript-rescue.
### tacoscript-incremental-for-loop
_(Not Implemented)_
Parser & Generator plugins and AST transformations for `upto`, `below`, `downto`, `above` and `by`
in for loop headers
### tacoscript-literate
_(Not Implemented)_
Parser & Generator plugins for literate mode.
### tacoscript-comprehensions
_(Not Implemented)_
### tacoscript-ranges
_(Not Implemented)_
### tacoscript-operator-overloading
_(Not Implemented)_
### tacoscript-block-break
_(Not Implemented)_
### tacoscript-variable-declaration-expressions
_(Not Implemented)_
### tacoscript-git-magic
_(Not Implemented)_
Git hooks to automatically create an equivalent history in git as if a
JavaScript project was written in TacoScript, and to therefore seamlessly
contribute to JavaScript projects by coding in TacoScript, and vice-versa.
[TacoScript]: http://tacoscript.github.io/
[frappe]: https://github.com/lydell/frappe
[Babel]: https://github.com/babel/babel
[Babylon]: https://github.com/babel/babylon
[estree]: https://github.com/estree/estree
[ECMAScript]: https://github.com/tc39/ecma262
[CST]: https://github.com/estree/estree/pull/107
[strudel]: http://www.catb.org/~esr/jargon/html/S/strudel.html
[ESLint]: http://eslint.org
[conditional catch clauses]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch#Conditional_catch_clauses
[ImmediatelyInvokedFunctionExpression]: ./doc/ast/spec.md#immediatelyinvokedfunctionexpression