Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cwchentw/cl2js
Convert Common Lisp to JavaScript with Parenscript
https://github.com/cwchentw/cl2js
common-lisp common-lisp-tools javascript-translator lisp parenscript
Last synced: 20 days ago
JSON representation
Convert Common Lisp to JavaScript with Parenscript
- Host: GitHub
- URL: https://github.com/cwchentw/cl2js
- Owner: cwchentw
- License: mit
- Created: 2020-04-12T10:55:38.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-04-07T05:52:13.000Z (almost 3 years ago)
- Last Synced: 2024-11-17T04:36:05.315Z (3 months ago)
- Topics: common-lisp, common-lisp-tools, javascript-translator, lisp, parenscript
- Language: Shell
- Homepage:
- Size: 33.3 MB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cl2js
[](https://opensource.org/licenses/MIT)
A command-line utility to convert Common Lisp to JavaScript with Parenscript.
## System Requirements
* Either Common Lisp implementation
* [SBCL](http://www.sbcl.org/) (default)
* [Clozure CL](https://ccl.clozure.com/)
* [Armed Bear CL](https://common-lisp.net/project/armedbear/)
* [Parenscript](https://common-lisp.net/project/parenscript/)
* [cl-portable](https://github.com/cwchentw/cl-portable/)
* [cl-yautils](https://github.com/cwchentw/cl-yautils/)
Our *build* script for Unix and *build.bat* for Windows script will download and install Parenscript, cl-portable and cl-yautils automatically. Hence, you don't need to manage dependency by yourself.
## Build
### Unix
Compile and package `cl2js` with SBCL:
```
$ ./scripts/package
```
or
```
$ ./scripts/package sbcl
```
Alternatively, compile and package `cl2js` with Clozure CL:
```
$ ./scripts/package ccl
```
Uncompress *cl2js.tar.gz* to some path and add *path\to\cl2js\bin* to **PATH** variable. Keep the structure of *cl2js* directory intact.
### Windows
Compile and package `cl2js` with SBCL:
```
> .\scripts\package.bat
```
or
```
> .\scripts\package.bat sbcl
```
Alternatively, compile and package `cl2js` with Clozure CL:
```
> .\scripts\package.bat ccl
```
Uncompress *cl2js.zip* to some path and add *path\to\cl2js\bin* to **PATH** variable. Keep the structure of *cl2js* directory intact.
### Java Platform
You may also run `jcl2js` on Unix or `jcl2js.bat` on Windows *as-is*.
To use `jcl2js`, add the local path of this repo to **PATH** variable.
## Usage
### `cl2js`
*Note: It's cl2js.exe on Windows.*
Assume *source.lisp* is a valid Parenscript source.
Compile *source.lisp* to *output.js*:
```
$ cl2js source.lisp > output.js
```
Later, run *output.js* with Node.js:
```
$ node output.js
```
Run *source.lisp* with Node.js on-the-fly:
```
$ cl2js source.lisp | node
```
### `jcl2js`
*Note: It's jcl2js.bat on Windows.*
On first run, `jcl2js` will install Parenscript automatically for you:
```
$ jcl2js
```
Later, run `jcl2js` to compile *source.lisp*:
```
$ jcl2js source.lisp > output.js
```
## Known Issues or Bugs
* Armed Bear CL starts too slowly to be useful as a scripting language
## Note
The version of Armed Bear CL bundled in this repo is 1.8.0.
## See Also
[burtonsamograd/sigil](https://github.com/burtonsamograd/sigil)
## Copyright
Copyright (c) 2020 Michelle Chen. Licensed under MIT