Testing

Python Tests

To run the Python tests:

pytest

For coverage information:

pytest --cov=numerous

JavaScript Tests

The client-side JavaScript code (numerous.js) can be tested using Jest. To run the JavaScript tests:

1. Install Node.js if you don't have it already
2. Install the required npm dependencies:

npm install

3. Run the tests:

npm test

For coverage information:

npm test -- --coverage

The JavaScript tests cover the following functionality:

• WidgetModel class for managing widget state
• WebSocketManager for handling WebSocket communication
• Utility functions for logging and debugging

JavaScript tests are automatically run:

• As part of the pre-commit hooks when pushing code
• In the GitHub CI/CD pipeline for every push to the repository
• Coverage reports are generated and archived as artifacts in GitHub Actions

For more details on the JavaScript testing setup, see tests/js/README.md.

Pre-commit Hooks

Both Python and JavaScript tests are included in the pre-commit workflow:

• Python tests run automatically before pushing code
• JavaScript tests run automatically before pushing code

To install the pre-commit hooks:

pre-commit install --hook-type pre-commit --hook-type pre-push

This ensures that all tests pass before code is pushed to the repository.