Awlsim development
Back to the Awlsim home

The development source code of awlsim can be downloaded using the Git version control system as follows:

git clone

To browse the Git repository online, go to the repository web interface.
Or download the compressed snapshot.
A mirror of the repository is available on GitHub, GitLab, Bitbucket and on
If you want to contribute to awlsim, please read the contribution guidelines first.

If you find any bugs in awlsim or if you have any suggestion for new features, we would like to hear from you.
Your help is greatly appreciated and will help to create better software and improve the overall experience for everybody. So don't hesitate to report anything that that limits your awlsim usage.

If you have got any code improvements or other improvements that should be merged into the project, please send such enhancements to the awlsim maintainer.

Please read the contribution guidelines first.

Awlsim has unit tests for all of its core features. The test suite is located in the tests subdirectory of the source tree.
The test suite currently comprises about 150,000 lines of test code.

The testsuite can be run using the tests/ script. Optionally the -q option can be supplied to so that a quick test is done.

For core features it is an absolute requirement to have complete tests before a new feature can be merged. Software quality is important. Tests are required, so that all features work correctly and features remain to work correctly. All regression tests are executed before an Awlsim release is done to assure the software quality of Awlsim.

Regressions are not acceptable.
A feature that used to work must continue to work correctly in the future. If there is a broken feature that used to work correctly in an earlier version of Awlsim, I would like to know about that problem. Please contact me.

For the GUI (graphical user interface) there currently are no automated tests. That is unfortunate and will have to change in the future, so that GUI features can automatically be validated, too.

Awlsim is a complex piece of software. The following two diagrams show the basic connections and interactions between the basic parts of the software package. (Click to enlarge).

Updated: Tuesday 12 March 2024 19:10 (UTC)
xhtml / css