The TASS application assists users in creating and running reproducible test cases for web applications. TASS uses json configuration files to define test cases, organize them as test suites and run them via test runs.
TASS relies on a conda compatible environment and package manager. The framework is tested on Windows, and efforts are made for it to be compatible with Linux/macOS.
To contribute to the project, please read our best practices: docs/best_practices.md. Also, create your conda environment via
conda env create -f environment.yaml.
The conda environment will contain all the of the dependencies at the
correct versions. To run tests, make sure you have an editable install
with pip install -e <module> from the root directory. Where <module>
is replaced with the desired component of TASS:
- tass-base
- tass-converter
To build the pypi package, navigate to the root of the directory and type
python -m build. This will use the pyproject.toml file to build the
package. The package will be in the dist folder in your repository.
To build the conda package, navigate to the root of the directory and type
conda build <module>/conda-recipe. The package can be found in a folder specified
in the command output. You can always install it via conda install --use-local <module>
if you wish to install it in the same environment you built it.
The framework can be installed by downloading the appropriate release and then running the install command.
Download the .whl file for the desired release version. Using the CLI
with pip and python >=3.10 enter the command pip install <path/to/wheel/file>
Download the .tar.bz2 file for the desired release version. Using your conda environment
enter the command conda install <path/to/tar.bz2/file>. After this instllation is
successful enter the command conda install --use-local <module name> to install
dependencies.
The testing framework can be invoked from your CLI with the command
python -m tass.base --file/-f ./path/to/config/file --browser/-b <chrome|firefox|edge>.
The repository comes with a working demo. Clone the repository, then
create and active your conda environment. Assuming the working
directory is the root of the git repository, you can run the demo with
python -m tass.base --file/-f demo/tass_sample.json --browser/-b <chrome|firefox|edge>.
This short demo will go through some of the actions TASS supports on a test webpage. The test webpage is locally present in the repository.
The code and all files in this repository are licensed under the Apache license version 2, unless otherwise specified within the respective file. In that case, the license specified in the file is applicable.
Copyright © His Majesty the King in Right of Canada, as represented by the Minister of Statistics Canada, 2023.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Further documentation can be found in the docs folder. The documentation
can be built using the sphinx-build -b html source build from the doc
folder.