https://github.com/chrstnbwnkl/valhalla-gurka-container
Container image for writing your own Gurka tests for applications using Valhalla's C++ API
https://github.com/chrstnbwnkl/valhalla-gurka-container
valhalla
Last synced: 7 months ago
JSON representation
Container image for writing your own Gurka tests for applications using Valhalla's C++ API
- Host: GitHub
- URL: https://github.com/chrstnbwnkl/valhalla-gurka-container
- Owner: chrstnbwnkl
- Created: 2025-07-03T14:12:35.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-26T09:09:00.000Z (about 1 year ago)
- Last Synced: 2025-07-26T15:19:58.409Z (about 1 year ago)
- Topics: valhalla
- Language: Dockerfile
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Valhalla Test Container Image
A container image for writing your own Gurka tests for applications using Valhalla's C++ API
## Introduction
Valhalla uses its own integration test library called Gurka. Besides a lot of convenient features for running actions and checking their outcomes (e.g. routes, matrix, etc.) its most practical use is drawing ASCII maps and converting them into OSM maps and Valhalla graphs. Here's what that looks like:
```cpp
using namespace valhalla;
constexpr double gridsize = 100;
const std::string ascii_map = R"(
A-B-C-D-E
|
|1
F···G
|
|2
H
)";
const gurka::ways ways = {
{"AB", {{"highway", "primary"}}}, {"BC", {{"highway", "primary"}}},
{"CD", {{"highway", "primary"}}}, {"DE", {{"highway", "primary"}}},
{"CF", {{"highway", "service"}}}, {"FH", {{"highway", "service"}}},
{"FG", {{"highway", "footway"}}},
};
const gurka::nodes nodes = {{"E", {{"barrier", "block"}}}};
const auto layout = gurka::detail::map_to_coordinates(ascii_map, gridsize);
auto map = gurka::buildtiles(layout, ways, nodes, {}, "test/data/deadend");
```
You can read more about Gurka [here](https://github.com/valhalla/valhalla/blob/master/docs/docs/test/gurka.md).
## Usage
Just pull the image and use it to integrate with your own application:
```sh
docker pull ghcr.io/chrstnbwnkl/valhalla-gurka-container/valhalla-dev:latest
# or if you want a specific version of Valhalla (reach out if you need an older version)
docker pull ghcr.io/chrstnbwnkl/valhalla-gurka-container/valhalla-dev:3.5.1
```
The image contains a release build of Valhalla with debug information along with Valhalla's test library and headers that you can link your project against if you want to write your own Gurka tests.
`cmake/FindValhallaTest.cmake` contains an example module that you can use for linking. You can copy that module into your project and use it like this:
```cmake
# in your CMakeLists.txt
find_package(ValhallaTest REQUIRED)
# valhalla does not vendor googletest, so include it yourself,
# best as a submodule pointing to the same commit as Valhalla
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
add_subdirectory(${CMAKE_SOURCE_DIR}/third_party/googletest ${CMAKE_BINARY_DIR}/googletest)
target_link_libraries(${your_test} gtest gtest_main gmock ${VALHALLA_TEST_LIB})
```
Then in your tests, you can include everything you need like this:
```cpp
#include
#include
#include
// ...your tests here, just like in the upstream repo
```