Short Circuit

Short Circuit is a tile-based digital logic sandbox inspired by Wireworld and Minecraft's Redstone.

It is in pre-alpha. Expect nothing to work!

Quickstart

./docker-build.sh
./docker-run.sh

# View the help
python ./shortcircuit/main.py --help

# Load the demo - Press "o" over switches to toggle
#                 Press "." to advance the simulation
python ./shortcircuit/main.py --file data/full-adder.ssboard

Controls

arrow keys or h j k l : Cursor movement
o : Place/toggle switches
n : Place/rotate NANDs
space : Place wire/delete node
b : Place a wire bridge
. : Tick the simulation
w : Write out current layout to disk
q : Quit

Goals

Give myself a fun project to work on
Provide users with:
- The bare minimum required components to be Turing complete
- A graphical, tile-based editor which can be used to design a system without tedious drudgery
  - Easy to use means of encapsulating and reusing components
  - "Applied Energistics" style ways to push multiple signals through a single wire, and then unpack them at the other end
Be able to "compile" a user design from graphical tiles to an in-memory graph representation so the system can be simulated without having to perform cellular automata evaluation
Be able to parallelize the evaluation of large designs

Testing

Tests are written with the unittest module from the Standard Python Library.

To run tests, you can simply run the test file that you are interested in:

export PYTHONPATH=${PYTHONPATH}:./shortcircuit
python3 ./shortcircuit/test/FILE_HERE.py

Or you can use pytest to call them all at once:

export PYTHONPATH=${PYTHONPATH}:./shortcircuit
pip install pytest
pytest ./shortcircuit/test/*

Development

Here's how I develop short-circuit if you would like to jump in and help!

I prefer to do my development with docker images, you may find it easier to just use a python venv. If you choose to use docker, there are two convenience scripts in the repo to help get set up quickly.

docker-build.sh : Builds the docker image with all the dependencies.
docker-run.sh : Runs the docker image and mounts the source directory.

My workflow

Build the docker image as shown above
Run the docker image as shown above, which will place you at a bash prompt
Start a tail -F ./output/gameplay.log in another terminal to view logs
Hack on the source in your editor
Run the linter in the container with flake8 ./shortcircuit
Run the tests in the container with pytest ./shortcircuit/test/*
Run the code in the container with python ./shortcircuit/main.py
GOTO 4

Because the source directory is mounted, it's possible to quickly hack on source without having to rebuild everything.