README

Generate random German cake names — saftige-kirsch-torte, süßer-apfel-kuchen, schlichtes-marzipan-brötchen. Inspired by petname.

Install

composer require kolaente/kuchen-name

Requires PHP 8.2+.

Library

use KuchenName\Generator;

$gen = Generator::default();
echo $gen->generate();                              // saftige-torte
echo $gen->generate(words: 3);                      // süßer-apfel-kuchen
echo $gen->generate(words: 4, separator: '_');      // saftiger_schoko_kirsch_kuchen

For deterministic output (tests, fixtures), inject a seeded Randomizer:

use Random\Randomizer;
use Random\Engine\Mt19937;

$gen = Generator::default(new Randomizer(new Mt19937(seed: 42)));

How it works

Three text files under resources/:

adjektive.txt — adjective stems (no ending), e.g. saftig, süß
sorten.txt — flavors / ingredients, e.g. schoko, kirsch
kuchentypen.txt — Noun|gender pairs, e.g. Torte|f

For 2 words: <adjective>-<kuchentyp>. For N≥3: <adjective>-<sorte>×(N-2)-<kuchentyp>. The adjective is inflected to match the noun's grammatical gender (-er/-e/-es).

Irregular adjectives

Stems ending in -el or -er (e.g. dunkel, edel, teuer, sauer) drop their final e when an ending is added: dunkle Torte, not dunkele Torte. To handle these, write the entry on one line as stem|masculine|feminine|neuter:

dunkel|dunkler|dunkle|dunkles
edel|edler|edle|edles

Regular adjectives stay as a single token (saftig). Mixed entries in the same file are fine.

To add words, edit the text files and send a PR.

License

LGPL-3.0-only. See LICENSE.

kolaente / kuchen-name

Maintainers

Package info

Statistics

Security