Latest changes

2025-04-12 (Sat), 5:50 PM - Jens Grassel - 01bac893ae89c2de8a77d8e8b01cfe7700cdf7f9

README: add information about the data file format

2025-04-12 (Sat), 5:43 PM - Jens Grassel - e3ed0571503626b9c29f782610ec09bba6379726

Refactoring: make cli arguments cross platform compatible

Clone this repository

Generate a random identity.

This is a small tool which will generate a random identity.

Currently it will only generate common names with a matching postal code and city name.

License

This code is licensed under the EUPL version 1.2 or later, see the LICENSE file for details.

Installation

TODO: Create a useful installer and package from the source!

Copy the files under resources either to /usr/local/share/rig or ~/.local/share/rig and create parent directories as needed. The program will look under both paths preferring the path under the home directory.

After having copied the resource file you can run the code from this directory via zig build run.

Development

Data files

The data files used for generating the output are simple TSV (tab separated values) files. All files MUST be named lang_code.tsv in lower case letters!

Forenames

A forename file SHALL be sorted alphabetically and contain one forename per line.

Surnames

A surname file SHALL be sorted alphabetically and contain one forename per line.

Zip codes and cities

A zip code file SHALL be sorted by zip code and contain the zip code, the matching city and possible further data separated by tabs. An example for "further data" is the department information for french cities.