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

git clone https://git.bues.ch/git/awlsim.git

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 NotABug.org.
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.

• Please file an issue at Github
• Alternatively you may send your report via e-mail

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 send a pull request via Github
• or alternatively send any patches to the project via e-mail

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/run.sh script. Optionally the -q option can be supplied to run.sh 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).