https://github.com/antlr/antlr4-lab
A client/server for trying out and learning about ANTLR
https://github.com/antlr/antlr4-lab
Last synced: about 2 months ago
JSON representation
A client/server for trying out and learning about ANTLR
- Host: GitHub
- URL: https://github.com/antlr/antlr4-lab
- Owner: antlr
- License: mit
- Created: 2022-07-04T18:00:37.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-03T19:29:20.000Z (10 months ago)
- Last Synced: 2025-04-04T19:08:21.015Z (2 months ago)
- Language: Java
- Size: 202 KB
- Stars: 41
- Watchers: 9
- Forks: 12
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# antlr4-lab
A client/server for trying out and learning about ANTLR
## Building and launching server
Ubuntu with lab.antlr.org static IP
```bash
cd ~
sudo apt-get update
sudo apt install -y openjdk-11-jre
sudo apt install -y maven
sudo apt install -y git
sudo apt install -y ghostscript # gets ps2pdf
sudo apt install -y pdf2svg
git clone https://github.com/antlr/antlr4-lab.git
cd antlr4-lab
mvn install
sudo mkdir /var/log/antlrlab
sudo chmod 777 /var/log/antlrlab
ssh-keygen -t ed25519 -C 'parrt@...' # add key to github
git config --global user.email "parrt@..."
git config --global user.name "Terence Parr"
```
Launch!
```bash
cd ~/antlr4-lab
sudo nohup java -cp ~/.m2/repository/org/antlr/antlr4-lab/0.4-SNAPSHOT/antlr4-lab-0.4-SNAPSHOT-complete.jar org.antlr.v4.server.ANTLRHttpServer
```
Or to restart if it fails, do:
```bash
while true
do
sudo java -cp ~/.m2/repository/org/antlr/antlr4-lab/0.4-SNAPSHOT/antlr4-lab-0.4-SNAPSHOT-complete.jar org.antlr.v4.server.ANTLRHttpServer
sudo cp /var/log/antlrlab/antlrlab.log /var/log/antlrlab/antlrlab-died.log
sleep 1
done
```
which I've put into `~/antlr4-lab/launch.sh`:
```bash
nohup launch.sh &
```
If you are running the server locally on your box, visit [http://localhost/index.html](http://localhost/index.html) to run the client.
### Docker
I created a [Dockerfile](Dockerfile), although I'm not sure how useful it will be to people. This might be useful for deploying in the cloud later.
Here's how to build the docker file:
```bash
cd antlr4-lab
mvn clean package # has to be built first as docker copies in the jar
docker build --tag antlr4-lab-docker .
```
and here's how to use the docker to launch:
```bash
docker run -p80:80 --rm antlr4-lab-docker
```
@kaby76 reports the following: Seems to work fine. But I had to do some things to get it to work on Windows/WSL2.
In Windows: Install Docker Desktop
In WSL2/Ubuntu:
```bash
sudo apt install docker.io
git clone https://github.com/antlr/antlr4-lab.git
cd antlr4-lab
git checkout docker
mvn clean; mvn install
docker build .
docker image ls # get image name.
docker run -d -p 127.0.0.1:80:80 -e BIND_ADDR=0.0.0.0:80 image-name-from-above
```
In Windows again, run Firefox and connect to 127.0.0.1.
It looks like docker binds port 80 to 0.0.0.0 by default (after installing `net-tools`, and doing `netstat -a`).