Welcome to AsciiDots!

Installation

pip install asciidots

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:

Requirements:

  • Python 3

Download the source code:

With Git:

git clone https://github.com/aaronduino/asciidots

Without git:

Just download the zip from the Github page, and unzip it screenshot

Install:

pip install -r requirements.txt

Run it from source using python 3:

python3 __main__.py [arguments]

or alias it to asciidots using:

# on Ubuntu, replace `.bash_profile` with `.bashrc`
echo "alias asciidots='python3 $(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.