{"id":20656222,"url":"https://github.com/cgal/cgal-testsuite-dockerfiles","last_synced_at":"2025-09-15T03:21:31.205Z","repository":{"id":21118484,"uuid":"24419159","full_name":"CGAL/cgal-testsuite-dockerfiles","owner":"CGAL","description":"Container images for the automated Linux CGAL test suite","archived":false,"fork":false,"pushed_at":"2025-09-11T08:50:26.000Z","size":564,"stargazers_count":9,"open_issues_count":5,"forks_count":9,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-09-11T11:45:24.116Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CGAL.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-09-24T14:50:28.000Z","updated_at":"2025-09-11T08:50:29.000Z","dependencies_parsed_at":"2023-02-17T19:45:23.609Z","dependency_job_id":"567a19bd-36cf-41a6-894c-6e742325ed6d","html_url":"https://github.com/CGAL/cgal-testsuite-dockerfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/CGAL/cgal-testsuite-dockerfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CGAL%2Fcgal-testsuite-dockerfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CGAL%2Fcgal-testsuite-dockerfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CGAL%2Fcgal-testsuite-dockerfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CGAL%2Fcgal-testsuite-dockerfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CGAL","download_url":"https://codeload.github.com/CGAL/cgal-testsuite-dockerfiles/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CGAL%2Fcgal-testsuite-dockerfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275198866,"owners_count":25422420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-15T02:00:09.272Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T18:14:24.754Z","updated_at":"2025-09-15T03:21:31.193Z","avatar_url":"https://github.com/CGAL.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"cgal-testsuite-dockerfiles\n==========================\n\nDockerfiles and tools to run the CGAL testsuite inside containers.\n\nIt is recommended to get the images directly from Docker Hub instead\nof building them locally:\n\n    docker pull --all-tags cgal/testsuite-docker # get all images\n    docker pull cgal/testsuite-docker:TAG # get a specific image by replacing TAG with some tag\n\nA list of available tags can [be found here](https://hub.docker.com/r/cgal/testsuite-docker/tags).\n\nBuilding Images locally\n-----------------------\n\nTo build images locally see the help of `build_images.py`.\n\nRunning the testsuite\n---------------------\n\nTo run the testsuite using this image:\n\n    ./test_cgal.py --user **** --passwd **** --images cgal-testsuite/centos6\n\nIf you would like to use an already extraced internal release:\n\n    ./test_cgal.py --use-local --testsuite /path/to/release --images cgal-testsuite/centos6\n\nIt is also possible to only test specific packages, but keep in mind that this will alter the release:\n\n    ./test_cgal.py --use-local --testsuite /path/to/release --images cgal-testsuite/centos6 \\\n                   --packages Core Mesh_2 Mesh_3\n\n\nRunning the testsuite for one container\n---------------------------------------\n\nUse a command similar to that one:\n\n    docker run --rm -t -i -v $HOME/Git/cgal-master:/mnt/testsuite:ro,z -v $PWD/docker-entrypoint.sh:/mnt/testsuite/docker-entrypoint.sh:ro,z -v $PWD/run-testsuite.sh:/mnt/testsuite/run-testsuite.sh:z -v $PWD/testresults:/mnt/testresults:z cgal/testsuite-docker:debian-testing bash /mnt/testsuite/docker-entrypoint.sh\n\nIf you want a limited testsuite, you can have a file `testresults/list_test_packages` containing something like:\n\n    echo Mesh_2\n    echo Triangulation_2\n\nDefault Arguments\n-----------------\n\nDefault arguments can be provided through a `test_cgal_rc` file in\n`$XDG_CONFIG_HOME` (typically `$HOME/.config`) or the config directory\nof the resource `CGAL`.\n\nCron Job\n--------\n\nTo set up a machine for submission of the whole testsuite via a\ncronjob the following configuration could be used:\n\n    --user xxxxxxx\n    --passwd xxxxxx\n    --force-rm\n    --upload-results\n    --tester-name=\"My Name\"\n    --tester-address joe@example.com\n    --testsuite /path/to/testsuite\n    --testresults /path/to/testresults\n    --images cgal/testsuite-docker:centos5\n             cgal/testsuite-docker:centos6\n             cgal/testsuite-docker:archlinux\n\nThe names of the images depend on how they have been obtained. The\nexample shows the names that will typically be used when obtaining the\nimages through Docker Hub.\n\nModifying the build environment\n-------------------------------\n\nTo run a testsuite in a specific environment (specific version of some\nlibrary), set up a Docker image that provides that environment. Don't\nforget to make sure your installed library is preferred by CMake over\nthe system library by setting appropriate environment variables.\n\nTo control how the testsuite is being build use the environment\nvariable `CGAL_CMAKE_FLAGS` to change the CMake invocation. This\nvariable must look like an declaration where each array element\ncontains one command line argument of the cmake call, e.g.\n\n    ENV CGAL_CMAKE_FLAGS=\"(\\\"-DCGAL_CXX_FLAGS=-std=c++11 -Wextra\\\" \\\"-DCMAKE_CXX_FLAGS=-fno-asm\\\")\"\n\nYou can also change default build variables through the classic\nenvironment variables (e.g. `LD_FLAGS`, `CXX_FLAGS`).\n\nRequired Non-Standard Python Packages\n------------------------\n\nThe code requires several non-standard python2 packages, which are\navailable in all common distributions.\n\n- `docker`\n- `xdg`\n\nThey can be installed using `pip`:\n\n    pip install docker xdg\n\nSELinux issues\n--------------\nOn Linux system using SELinux (such as the default setting for the recent\nversions of Fedora, RHEL, and CentOS), you might need to relabel the host\nfiles and directories used as volumes by the containers:\n\n    chcon -Rt svirt_sandbox_file_t ./docker-entrypoint.sh ./testsuite ./testresults\n\nIf you use the options `--testsuite /path/to/testsuite` or `--testresults /path/to/testresults`, then the pointed directories must also be relabeled with `svirt_sandbox_file_t`:\n\n    chcon -Rt svirt_sandbox_file_t /path/to/testresults /path/to/testresults\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcgal%2Fcgal-testsuite-dockerfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcgal%2Fcgal-testsuite-dockerfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcgal%2Fcgal-testsuite-dockerfiles/lists"}