Skip to main content
Version: v1.8

Automation Test

Hangar project source code includes unit tests and validation tests.

Validation Test​

In Container​

Use following commands to run hangar validation tests in a container.

  1. Run make build to build hangar executable binary in container.
  2. Run make validation-test to run validation tests for all hangar subcommands.

Without Container​

To run validation tests on your local machine:

  1. Build hangar on your local machine by following Building without a container.

  2. Install python dependencies:

    cd test/
    pip install -r requirements.txt
    pip install tox

  3. Run scripts/registry.sh, this will create a temporary private registry server for tests.

    ./scripts/registry.sh

  4. To run specific test file:

    # Set REGISTRY_AUTH_FILE environment variable to avoid permission denied error during tests.
    export REGISTRY_AUTH_FILE="${HOME}/.config/containers/auth.json"

    # Specify the REGISTRY_URL environment variable manually.
    export REGISTRY_URL=127.0.0.1:5000

    cd suite/

    # Run specific test file.
    pytest -s test_help.py
    # Run specific test case.
    pytest -s test_help.py::test_help

  5. Cleanup:

    • Run scripts/clean.sh.
    • Delete the registry directory.

Unit Test​

  • Run unit tests in container:

    make test

  • Run unit tests on local machine:

    ./scripts/test.sh