https://github.com/dderevjanik/diesel-js
Dumb Interpretively Executed String Expression Language
https://github.com/dderevjanik/diesel-js
autocad diesel diesel-expression diesel-langauge fourmilab macro
Last synced: about 1 month ago
JSON representation
Dumb Interpretively Executed String Expression Language
- Host: GitHub
- URL: https://github.com/dderevjanik/diesel-js
- Owner: dderevjanik
- Created: 2024-08-01T12:54:10.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-22T13:02:21.000Z (about 1 year ago)
- Last Synced: 2025-08-09T04:37:35.203Z (about 2 months ago)
- Topics: autocad, diesel, diesel-expression, diesel-langauge, fourmilab, macro
- Language: JavaScript
- Homepage: https://dderevjanik.github.io/diesel-js/
- Size: 174 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DIESEL JS
## What is DIESEL ?
**Diesel is widely used in AutoCAD**
This **D**umb **I**nterpretively **E**xecuted **S**tring **E**xpression **L**anguage is the kernel of a macro language you can customize by adding C code and embedding it into your program.
It is short, written in portable C, and is readily integrated into any program. It is useful primarily for programs that need a very rudimentary macro expansion facility without the complexity of a full language such as Lisp or FORTH.
**Try it online:**
Our DIESEL documentation with Examples: [./docs/DIESEL.md](./docs/DIESEL.md)
[Fourmilab DIESEL Documentation](https://www.fourmilab.ch/diesel/)
## What is DIESEL JS ?
Diesel JS is a JavaScript compilation of the DIESEL language using [Emscripten](https://emscripten.org/). It is a simple and easy-to-use library that allows you to evaluate DIESEL expressions in JavaScript.
Diesel JS is compiled with
- **VARIABLES**
- [SETVAR](./docs/DIESEL.md#variables)
- [GETVAR](./docs/DIESEL.md#variables)
- **UNIXTENSIONS**
- [GETENV](./docs/DIESEL.md#getenvvarname)
- [TIME](./docs/DIESEL.md#time)
- [EDTIME](./docs/DIESEL.md#edtimetimepicture)
## Usage
Install package `npm i diesel`
### Browser
### Node
```javascript
import { evaluate } from "diesel";
const result = await evaluate("$(+, 1, 2)");
console.log(result); // 3
```
### CLI
`npx diesel '$(+, 1, 2)'`
or by installing diesel-cli globally `npm i -g diesel` and then using `diesel '$(+, 1, 2)'`
### Try it online
[https://dderevjanik.github.io/diesel-js/](https://dderevjanik.github.io/diesel-js/)
### Examples
Checkout [Diesel Examples](./docs/DIESEL.md#examples)
## Differences with AutoCAD DIESEL
AutoCAD extends DIESEL with additional functions and variables. This library does not support all of them, but it does support the most common ones. Functions like `rtos` and `angtos` are not supported in DIESEL JS.
- [Autocad DIESEL functions reference](https://help.autodesk.com/view/ACDLT/2024/ENU/?guid=GUID-F94A885A-4DA2-432B-AC1A-EB49CC6C1C72)
## Development
### (Optional) Compiling DIESEL into WASM
In order to compile DIESEL into javascript, you need to have [Docker](https://www.docker.com/) installed (emscripten is used to compile the C code into WebAssembly).
`npm run compile-diesel`
### Running the project
- `npm i` install dependencies
- `npm test` to run unit tests (based on Fourmilab DIESEL tests)
- `ts-node ./src/cli.ts -h` to run the CLI
## TODO
- [ ] Add AutoCAD functions (`rtos`, `angtos`, etc.)
- [ ] Publish to NPM
## Related
- [Fourmilab DIESEL Documentation](https://www.fourmilab.ch/diesel/)
- [Autocad DIESEL functions reference](https://help.autodesk.com/view/ACDLT/2024/ENU/?guid=GUID-F94A885A-4DA2-432B-AC1A-EB49CC6C1C72)