C++

The C++ implementation lives in namzy-cpp. It is a Qt 5 project that links against Qt Core.

Build

From the repository root:

cmake -S namzy-cpp -B namzy-cpp/build
cmake --build namzy-cpp/build

If CMake cannot find Qt 5, pass CMAKE_PREFIX_PATH:

cmake -S namzy-cpp -B namzy-cpp/build -DCMAKE_PREFIX_PATH=/path/to/Qt/5.x/clang_64
cmake --build namzy-cpp/build

The project uses C++17 and enables Qt automoc.

CLI

After building, run the executable from the build directory:

namzy-cpp/build/namzy --count 5

With a deterministic seed:

namzy-cpp/build/namzy --count 5 --seed 42

CLI flags:

Flag	Description
--count N	Print N names. Defaults to 1.
--seed N	Seed the generator.

Use from Qt 5 code

Include namzy.h and link the implementation files into your Qt target.

#include "namzy.h"

Namzy generator(42);

QString name = generator.generate();

generate() picks one geographic word and one common word from the shared bundled lists, then randomly joins either geographic+common or common+geographic. That gives 500,000 raw ordered source pairings before seam cleanup and replacement collisions.

CMake embedding example

find_package(Qt5 COMPONENTS Core REQUIRED)

add_executable(my_app
  main.cpp
  ../namzy-cpp/src/namzy.cpp
  ../namzy-cpp/src/mangle.cpp
  ../namzy-cpp/src/wordlist.cpp
)

target_include_directories(my_app PRIVATE ../namzy-cpp/src)
target_link_libraries(my_app PRIVATE Qt5::Core)