# Welcome to dgtools’s documentation!¶

dgtools is a mini-toolchain for compiling and testing ASM programs for the Digirule 2.

It is composed of an assembler (dgasm.py), a binary file “inspector” (dginspect.py) and a simulator (dgsim.py) that are used to develop and test code and also assist in “keying” it in, to the ruler itself.

For an example of the level of detail in terms of simulating program execution, please see this sample output file and keep reading through the introductory section to generate traces of your own code.