ullu

A test suite to test APL Primitives.

🤔 What is ullu?

Ullu is a QA for DyalogAPL (can be used to test any APL ideally) which tests specifically the functionality of primitives one by one. This test suite's main focus is finding bugs, irregularities, edge cases and code coverage.

🎿 Coverage

💪 Available Tests

• divide (dyadic ÷)
• floor (monadic ⌊)
• magnitude (monadic |)
• residue (dyadic |)
• unique (monadic ∪)
• unique mask (monadic ≠)

🧱 Under progress

• index of (dyadic ⍳) (Not tested for coverage)
• membership (dyadic ∊) (Not tested for coverage)

✍ The name

Pronounced as /ˈulːluː/, The name comes from the Hindi word for owl.

Just as the owl represents both wisdom and foolishness the QA also has a dual nature of being wise and dumb at the same time.

⬇ Usage

You can use ullu in a dyalog session on any supported operating system.

Quick Run

Run tests using dyalogscript:

dyalogscript run.apls

After this, you will be prompted with options to choose from

Detailed Run

Using Dyalog Interpreter (prefered):

• Load the namespaces:

]LINK.Create # <path to repository>

• Run the test cases

unittest.RunTests tests.[test_namespace] [verbose= 1|0] [stop=1|0] [⎕RL=any seed value(''?'' for random)] (0 default)

Options:

verbose: if set to 0, only output failing tests and a single summary line.

stop: if set to 1, any test which fails causes the framework to stop and allows the developer to inspect the failing test.

⎕RL: Seed value to for the random link variable that generates random numbers through the tests (it gets reset after each test)

Example:

unittest.RunTests tests.membership 1 0 1232

or

unittest.RunTests tests.membership

🔗 More documentation

• Contributing.md: Guide on how to contribute to the codebase
• Decision docs: Explains the decisions taken with each step of the codebase and also documents anomalies for future users.

🔗 Suggestions/Questions

Feel free to open GitHub issues for any questions, suggestions or feature requests

If you want to reach out, please email aarush[at]dyalog.com

⚖ Licence

Copyright 2023 Dyalog

Licensed under MIT License: https://opensource.org/licenses/MIT