https://github.com/chubek/zephyrasdl
An implementation of Zephyr ASDL in C, targeting C
https://github.com/chubek/zephyrasdl
abstract-syntax-tree bison c domain-specific-languages flex gcc gnu gpl lex trees yacc
Last synced: 4 days ago
JSON representation
An implementation of Zephyr ASDL in C, targeting C
- Host: GitHub
- URL: https://github.com/chubek/zephyrasdl
- Owner: Chubek
- License: gpl-3.0
- Created: 2024-02-16T02:13:45.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-12-06T09:50:15.000Z (5 months ago)
- Last Synced: 2025-03-31T22:05:47.184Z (about 2 months ago)
- Topics: abstract-syntax-tree, bison, c, domain-specific-languages, flex, gcc, gnu, gpl, lex, trees, yacc
- Language: C
- Homepage:
- Size: 485 KB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Zephyr ASDL Implementation
This is an implmentation of the Zephyr ASDL language as described [in this 1997 paper](https://www.cs.princeton.edu/~appel/papers/asdl97.pdf) by Wang, Appel, Korn and Serra.
ASDL is a domain-specific language that is used to describe syntax of a language. You specify tree grammars, and these tree grammars are translated into C code. This C code contains the Abstract Syntax Tree declarations and definitions.
There are plans to add more translations. D, Rust and Python would be good.
You can read the documentation for this program at `extras/MANPAGE.md`. There's a lot of goodies available at `extras` directory.
Currently, 3 revisions has been made to this program. Please view them via `CHANGELOG.md`. As such, the documentation is outdated. Please see `examples/shell.asdl` for an updated example.
# How to Install
You need:
1- An implementation of Lex, e.g. Flex
2- An implementation of Yacc, e.g. Bison
3- Perl
Under a Debian-based distro, you may install these with:
```
sudo apt-get install perl5 flex bison
```
After installing these, you may:
```
make && sudo make install
```
After that, bring up the manpage and see what is added to the language:
```
man 1 asdl
```
You can also view the Texinfo with:
```
info asdl
```
The manpage and the Texinfo are available in `extras` under `manual.html` and `guide.html`. After installing, these files, along with examples, and everything within `extras` will be copied to `/usr/local/share/doc/asdl`. If you install via a package manager, omitt `/local`.
# Windows...?
Windows is now equipped with WSL2, which you may use to run this program.
If you need to contact me, you can do so via email: `chubakbidpaa [at] riseup [dot] net`.
Thanks to anyone who uses this program.