Getting Started
Welcome to AsciiDots!
Installation
Using pip (recommended):
pip install asciidots
Using Docker Hub (recommended):
Run sample program from this repo:
docker run -ti --rm aaronduino/asciidots samples/hello_world.dots
Run local file test.dots
:
docker run -ti --rm -v $PWD:/data aaronduino/asciidots /data/test.dots
Using Local Dockerfile:
Build the image:
docker build -t asciidots ./docker
Run sample program from this repo:
docker run -ti --rm asciidots samples/hello_world.dots
Run local file test.dots
:
docker run -ti --rm -v $PWD:/data asciidots /data/test.dots
From source:
Download the source code:
With Git:
git clone https://github.com/aaronjanse/asciidots
Without git:
Just download the zip from the Github page, and unzip it
Install:
pip install -r requirements.txt
Run it from source using python 3:
python __main__.py [arguments]
or alias it to asciidots
using:
# on Ubuntu, replace `.bash_profile` with `.bashrc`
echo "alias asciidots='python $(pwd)/__main__.py'" >> ~/.bash_profile
source ~/.bash_profile
Running
You can simply run a program with:
$ asciidots [asciidots file to run]
You can read more about running AsciiDots programs on the interpreter guide
Quick sample programs to try out
If you just want to run a fun sample program, I suggest running the counter in debug mode:
$ asciidots samples/counter.dots -y -d -a 0.02
If you want something more complex, try this:
$ asciidots samples/find_primes.dots -d -a 0.02
Programming in AsciiDots
Read the language guide & docs page for a friendly and informative guide to programming in AsciiDots.