Skip to content

About

NCurses Terminal app to demonstrate various features

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

39 Commits

Folders and files

Repository files navigation

CI

mazes_n_things

Portable C++23 maze experiments built with CMake.

Requirements

  • CMake 3.28 or newer
  • A C23 and C++23 compiler
  • ncurses
  • macOS or Linux

Windows is not supported yet. On the first configure, CMake fetches and builds c-roblib from its main branch. Later builds reuse the staged dependency in the build directory. When the source checkout already exists, configuration checks the remote branch and updates the dependency only when a different revision is available; if the network is unavailable, the local revision is used unchanged.

On macOS, if Homebrew and its keg-only ncurses formula are installed, the build automatically prefers Homebrew's wide-character ncursesw through pkg-config. Otherwise it falls back to CMake's portable Curses discovery. The Homebrew path supplies _DARWIN_C_SOURCE and the required include and linker settings without requiring project-wide compiler flags.

Configure and build

From the project root, configure a Debug build with:

cmake -S . -B cmake-build-debug -DCMAKE_BUILD_TYPE=Debug

Build the project with:

cmake --build cmake-build-debug

For a Release build, use a separate build directory (NOTE: no release build supported yet):

cmake -S . -B cmake-build-release -DCMAKE_BUILD_TYPE=Release
cmake --build cmake-build-release

The executable is written to the selected build directory as mazes_n_things.

Google Test is fetched only for Debug configurations. CMake caches the checkout under cmake-build-debug/_deps/; it is reused across normal rebuilds and reconfiguration. Removing cmake-build-debug also removes that checkout, so the next configure will download it again.

Run

Run the Debug build from the project root with:

./cmake-build-debug/mazes_n_things

For the Release build, use:

./cmake-build-release/mazes_n_things

Test

Run the configured tests with:

ctest --test-dir cmake-build-debug --output-on-failure

Clean

To remove one generated build directory, use:

rm -rf cmake-build-debug

For the Release build, use:

rm -rf cmake-build-release

Removing a build directory also removes its locally staged c-roblib source, archive, and headers. The next configure will therefore require network access to fetch the dependency again.

To skip the remote revision check, configure with -DROBLIB_CHECK_FOR_UPDATES=OFF. ROBLIB_REPOSITORY and ROBLIB_TAG remain available as cache variables for selecting a repository or branch, tag, or commit; pinning a specific release is recommended once c-roblib has stable versioning.

About

NCurses Terminal app to demonstrate various features

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages