glitchlings 0.2.2__tar.gz → 0.2.4__tar.gz

{glitchlings-0.2.2 → glitchlings-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: glitchlings
-Version: 0.2.2
+Version: 0.2.4
 Summary: Monsters for your language games.
 Author: osoleve
 License:                                  Apache License
@@ -209,25 +209,21 @@ Project-URL: Homepage, https://github.com/osoleve/glitchlings
 Project-URL: Repository, https://github.com/osoleve/glitchlings.git
 Project-URL: Issues, https://github.com/osoleve/glitchlings/issues
 Project-URL: Changelog, https://github.com/osoleve/glitchlings/releases
-Keywords: nlp,text,adversarial augmentation,text augmentation
+Keywords: nlp,text,adversarial augmentation,text augmentation,large language models,llms,data augmentation,confusables,typo,
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Rust
-Classifier: Operating System :: MacOS :: MacOS X
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Operating System :: OS Independent
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Testing
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: confusable-homoglyphs>=3.3.1
-Requires-Dist: jellyfish>=1.2.0
 Provides-Extra: hf
 Requires-Dist: datasets>=4.0.0; extra == "hf"
 Provides-Extra: wordnet
@@ -235,6 +231,7 @@ Requires-Dist: nltk>=3.9.1; extra == "wordnet"
 Requires-Dist: numpy<=2.0,>=1.24; extra == "wordnet"
 Provides-Extra: prime
 Requires-Dist: verifiers>=0.1.3.post0; extra == "prime"
+Requires-Dist: jellyfish>=1.2.0; extra == "prime"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0.0; extra == "dev"
 Requires-Dist: hypothesis>=6.140.0; extra == "dev"
@@ -280,14 +277,16 @@ After all, what good is general intelligence if it can't handle a little chaos?
 pip install -U glitchlings
 ```
 
+> Glitchlings requires Python 3.10 or newer.
+
 ```python
 from glitchlings import Gaggle, SAMPLE_TEXT, Typogre, Mim1c, Reduple, Rushmore
 
 gaggle = Gaggle([
-    Typogre(max_change_rate=0.03),
-    Mim1c(replacement_rate=0.02),
+    Typogre(rate=0.03),
+    Mim1c(rate=0.02),
     Reduple(seed=404),
-    Rushmore(max_deletion_rate=0.02),
+    Rushmore(rate=0.02),
 ])
 
 print(gaggle(SAMPLE_TEXT))
@@ -295,41 +294,10 @@ print(gaggle(SAMPLE_TEXT))
 
 > Onҽ m‎ھ‎rning, wһen Gregor Samƽa woke from trouble𝐝 𝑑reams, he found himself transformed in his bed into a horrible vermin‎٠‎ He l   lay on his armour-like back, and if he lifted his head a little he could see his brown belly, slightlh domed and divided by arches ino stiff sections. The bedding was adly able to cover it and and seemed ready to slide off any  moment. His many legxs, pitifully thin compared with the size of the the rest of him, waved about helplessly ashe looked looked.
 
-## Usage
-
-Need detailed usage patterns, dataset workflows, or tips for enabling the
-Rust accelerator? Consult the [Glitchlings Usage Guide](docs/index.md)
-for end-to-end instructions spanning the Python API, CLI, Hugging Face
+Consult the [Glitchlings Usage Guide](docs/index.md)
+for end-to-end instructions spanning the Python API, CLI, HuggingFace and Prime Intellect
 integrations, and the feature-flagged Rust pipeline.
 
-### Prime Intellect environments
-
-After `pip install -e .[prime]`, the `glitchlings.dlc.prime.load_environment` helper mirrors `verifiers.load_environment` for Prime Intellect scenarios while optionally applying glitchlings before returning the environment:
-
-```python
-from glitchlings import Mim1c, Typogre
-from glitchlings.dlc.prime import echo_chamber, load_environment
-
-env = load_environment(
-    "osoleve/syllabify-en",
-    glitchlings=[Mim1c(replacement_rate=0.01), Typogre(max_change_rate=0.02)],
-    seed=404,
-)
-
-# Spin up an echo chamber that corrupts a dataset column and
-# rewards models for perfectly restoring it
-practice_env = echo_chamber(
-    "osoleve/clean-room",
-    column="text",
-    glitchlings=["Typogre", "Mim1c"],
-    reward_function=lambda prompt, completion, answer: float(completion == answer),
-)
-```
-
-Skip the `glitchlings` argument to receive an untouched verifier dataset, and
-override `reward_function` when you want to evaluate completions with a custom
-scoring routine.
-
 ## Motivation
 
 If your model performs well on a particular task, but not when `Glitchling`s are present, it's a sign that it hasn't actually generalized to the problem.
@@ -344,8 +312,8 @@ Glitchlings are standard Python classes, so you can instantiate them with whatev
 ```python
 from glitchlings import Gaggle, Typogre, Mim1c
 
-custom_typogre = Typogre(max_change_rate=0.1)
-selective_mimic = Mim1c(replacement_rate=0.05, classes=["LATIN", "GREEK"])
+custom_typogre = Typogre(rate=0.1)
+selective_mimic = Mim1c(rate=0.05, classes=["LATIN", "GREEK"])
 
 gaggle = Gaggle([custom_typogre, selective_mimic], seed=99)
 print(gaggle("Summoned heroes do not fear the glitch."))
@@ -376,7 +344,7 @@ glitchlings --list
 glitchlings -g typogre --file documents/report.txt --diff
 
 # Configure glitchlings inline by passing keyword arguments.
-glitchlings -g "Typogre(max_change_rate=0.05)" "Ghouls just wanna have fun"
+glitchlings -g "Typogre(rate=0.05)" "Ghouls just wanna have fun"
 
 # Pipe text straight into the CLI for an on-the-fly corruption.
 echo "Beware LLM-written flavor-text" | glitchlings -g mim1c
@@ -400,7 +368,7 @@ _What a nice word, would be a shame if something happened to it._
 >
 > Args
 >
-> - `max_change_rate (float)`: The maximum number of edits to make as a percentage of the length (default: 0.02, 2%).
+> - `rate (float)`: The maximum number of edits to make as a percentage of the length (default: 0.02, 2%).
 > - `keyboard (str)`: Keyboard layout key-neighbor map to use (default: "CURATOR_QWERTY"; also accepts "QWERTY", "DVORAK", "COLEMAK", and "AZERTY").
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
@@ -412,7 +380,7 @@ _Wait, was that...?_
 >
 > Args
 >
-> - `replacement_rate (float)`: The maximum proportion of characters to replace (default: 0.02, 2%).
+> - `rate (float)`: The maximum proportion of characters to replace (default: 0.02, 2%).
 > - `classes (list[str] | "all")`: Restrict replacements to these Unicode script classes (default: ["LATIN", "GREEK", "CYRILLIC"]).
 > - `banned_characters (Collection[str])`: Characters that must never appear as replacements (default: none).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
@@ -425,7 +393,7 @@ _How can a computer need reading glasses?_
 >
 > Args
 >
-> - `error_rate (float)`: The maximum proportion of eligible confusion spans to replace (default: 0.02, 2%).
+> - `rate (float)`: The maximum proportion of eligible confusion spans to replace (default: 0.02, 2%).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
 ### Jargoyle
@@ -436,7 +404,7 @@ _Uh oh. The worst person you know just bought a thesaurus._
 >
 > Args
 >
-> - `replacement_rate (float)`: The maximum proportion of words to replace (default: 0.1, 10%).
+> - `rate (float)`: The maximum proportion of words to replace (default: 0.1, 10%).
 > - `part_of_speech`: The WordNet part(s) of speech to target (default: nouns). Accepts `wn.NOUN`, `wn.VERB`, `wn.ADJ`, `wn.ADV`, any iterable of those tags, or the string `"any"` to include them all.
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
@@ -448,7 +416,7 @@ _Did you say that or did I?_
 >
 > Args
 >
-> - `reduplication_rate (float)`: The maximum proportion of words to reduplicate (default: 0.05, 5%).
+> - `rate (float)`: The maximum proportion of words to reduplicate (default: 0.05, 5%).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
 ### Rushmore
@@ -459,7 +427,7 @@ _I accidentally an entire word._
 >
 > Args
 >
-> - `max_deletion_rate (float)`: The maximum proportion of words to delete (default: 0.01, 1%).
+> - `rate (float)`: The maximum proportion of words to delete (default: 0.01, 1%).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
 ### Redactyl
@@ -471,7 +439,7 @@ _Oops, that was my black highlighter._
 > ### Args
 >
 > - `replacement_char (str)`: The character to use for redaction (default: █).
-> - `redaction_rate (float)`: The maximum proportion of words to redact (default: 0.05, 5%).
+> - `rate (float)`: The maximum proportion of words to redact (default: 0.05, 5%).
 > - `merge_adjacent (bool)`: Whether to redact the space between adjacent redacted words (default: False).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 

{glitchlings-0.2.2 → glitchlings-0.2.4}/README.md

@@ -36,14 +36,16 @@ After all, what good is general intelligence if it can't handle a little chaos?
 pip install -U glitchlings
 ```
 
+> Glitchlings requires Python 3.10 or newer.
+
 ```python
 from glitchlings import Gaggle, SAMPLE_TEXT, Typogre, Mim1c, Reduple, Rushmore
 
 gaggle = Gaggle([
-    Typogre(max_change_rate=0.03),
-    Mim1c(replacement_rate=0.02),
+    Typogre(rate=0.03),
+    Mim1c(rate=0.02),
     Reduple(seed=404),
-    Rushmore(max_deletion_rate=0.02),
+    Rushmore(rate=0.02),
 ])
 
 print(gaggle(SAMPLE_TEXT))
@@ -51,41 +53,10 @@ print(gaggle(SAMPLE_TEXT))
 
 > Onҽ m‎ھ‎rning, wһen Gregor Samƽa woke from trouble𝐝 𝑑reams, he found himself transformed in his bed into a horrible vermin‎٠‎ He l   lay on his armour-like back, and if he lifted his head a little he could see his brown belly, slightlh domed and divided by arches ino stiff sections. The bedding was adly able to cover it and and seemed ready to slide off any  moment. His many legxs, pitifully thin compared with the size of the the rest of him, waved about helplessly ashe looked looked.
 
-## Usage
-
-Need detailed usage patterns, dataset workflows, or tips for enabling the
-Rust accelerator? Consult the [Glitchlings Usage Guide](docs/index.md)
-for end-to-end instructions spanning the Python API, CLI, Hugging Face
+Consult the [Glitchlings Usage Guide](docs/index.md)
+for end-to-end instructions spanning the Python API, CLI, HuggingFace and Prime Intellect
 integrations, and the feature-flagged Rust pipeline.
 
-### Prime Intellect environments
-
-After `pip install -e .[prime]`, the `glitchlings.dlc.prime.load_environment` helper mirrors `verifiers.load_environment` for Prime Intellect scenarios while optionally applying glitchlings before returning the environment:
-
-```python
-from glitchlings import Mim1c, Typogre
-from glitchlings.dlc.prime import echo_chamber, load_environment
-
-env = load_environment(
-    "osoleve/syllabify-en",
-    glitchlings=[Mim1c(replacement_rate=0.01), Typogre(max_change_rate=0.02)],
-    seed=404,
-)
-
-# Spin up an echo chamber that corrupts a dataset column and
-# rewards models for perfectly restoring it
-practice_env = echo_chamber(
-    "osoleve/clean-room",
-    column="text",
-    glitchlings=["Typogre", "Mim1c"],
-    reward_function=lambda prompt, completion, answer: float(completion == answer),
-)
-```
-
-Skip the `glitchlings` argument to receive an untouched verifier dataset, and
-override `reward_function` when you want to evaluate completions with a custom
-scoring routine.
-
 ## Motivation
 
 If your model performs well on a particular task, but not when `Glitchling`s are present, it's a sign that it hasn't actually generalized to the problem.
@@ -100,8 +71,8 @@ Glitchlings are standard Python classes, so you can instantiate them with whatev
 ```python
 from glitchlings import Gaggle, Typogre, Mim1c
 
-custom_typogre = Typogre(max_change_rate=0.1)
-selective_mimic = Mim1c(replacement_rate=0.05, classes=["LATIN", "GREEK"])
+custom_typogre = Typogre(rate=0.1)
+selective_mimic = Mim1c(rate=0.05, classes=["LATIN", "GREEK"])
 
 gaggle = Gaggle([custom_typogre, selective_mimic], seed=99)
 print(gaggle("Summoned heroes do not fear the glitch."))
@@ -132,7 +103,7 @@ glitchlings --list
 glitchlings -g typogre --file documents/report.txt --diff
 
 # Configure glitchlings inline by passing keyword arguments.
-glitchlings -g "Typogre(max_change_rate=0.05)" "Ghouls just wanna have fun"
+glitchlings -g "Typogre(rate=0.05)" "Ghouls just wanna have fun"
 
 # Pipe text straight into the CLI for an on-the-fly corruption.
 echo "Beware LLM-written flavor-text" | glitchlings -g mim1c
@@ -156,7 +127,7 @@ _What a nice word, would be a shame if something happened to it._
 >
 > Args
 >
-> - `max_change_rate (float)`: The maximum number of edits to make as a percentage of the length (default: 0.02, 2%).
+> - `rate (float)`: The maximum number of edits to make as a percentage of the length (default: 0.02, 2%).
 > - `keyboard (str)`: Keyboard layout key-neighbor map to use (default: "CURATOR_QWERTY"; also accepts "QWERTY", "DVORAK", "COLEMAK", and "AZERTY").
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
@@ -168,7 +139,7 @@ _Wait, was that...?_
 >
 > Args
 >
-> - `replacement_rate (float)`: The maximum proportion of characters to replace (default: 0.02, 2%).
+> - `rate (float)`: The maximum proportion of characters to replace (default: 0.02, 2%).
 > - `classes (list[str] | "all")`: Restrict replacements to these Unicode script classes (default: ["LATIN", "GREEK", "CYRILLIC"]).
 > - `banned_characters (Collection[str])`: Characters that must never appear as replacements (default: none).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
@@ -181,7 +152,7 @@ _How can a computer need reading glasses?_
 >
 > Args
 >
-> - `error_rate (float)`: The maximum proportion of eligible confusion spans to replace (default: 0.02, 2%).
+> - `rate (float)`: The maximum proportion of eligible confusion spans to replace (default: 0.02, 2%).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
 ### Jargoyle
@@ -192,7 +163,7 @@ _Uh oh. The worst person you know just bought a thesaurus._
 >
 > Args
 >
-> - `replacement_rate (float)`: The maximum proportion of words to replace (default: 0.1, 10%).
+> - `rate (float)`: The maximum proportion of words to replace (default: 0.1, 10%).
 > - `part_of_speech`: The WordNet part(s) of speech to target (default: nouns). Accepts `wn.NOUN`, `wn.VERB`, `wn.ADJ`, `wn.ADV`, any iterable of those tags, or the string `"any"` to include them all.
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
@@ -204,7 +175,7 @@ _Did you say that or did I?_
 >
 > Args
 >
-> - `reduplication_rate (float)`: The maximum proportion of words to reduplicate (default: 0.05, 5%).
+> - `rate (float)`: The maximum proportion of words to reduplicate (default: 0.05, 5%).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
 ### Rushmore
@@ -215,7 +186,7 @@ _I accidentally an entire word._
 >
 > Args
 >
-> - `max_deletion_rate (float)`: The maximum proportion of words to delete (default: 0.01, 1%).
+> - `rate (float)`: The maximum proportion of words to delete (default: 0.01, 1%).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 
 ### Redactyl
@@ -227,7 +198,7 @@ _Oops, that was my black highlighter._
 > ### Args
 >
 > - `replacement_char (str)`: The character to use for redaction (default: █).
-> - `redaction_rate (float)`: The maximum proportion of words to redact (default: 0.05, 5%).
+> - `rate (float)`: The maximum proportion of words to redact (default: 0.05, 5%).
 > - `merge_adjacent (bool)`: Whether to redact the space between adjacent redacted words (default: False).
 > - `seed (int)`: The random seed for reproducibility (default: 151).
 

{glitchlings-0.2.2 → glitchlings-0.2.4}/pyproject.toml

@@ -1,33 +1,29 @@
 [project]
 name = "glitchlings"
-version = "0.2.2"
+version = "0.2.4"
 description = "Monsters for your language games."
 readme = "README.md"
-requires-python = ">=3.12"
+requires-python = ">=3.10"
 
 dependencies = [
     "confusable-homoglyphs>=3.3.1",
-    "jellyfish>=1.2.0",
 ]
 
 authors = [
     { name = "osoleve" }
 ]
 
-keywords = ["nlp", "text", "adversarial augmentation", "text augmentation"]
+keywords = ["nlp", "text", "adversarial augmentation", "text augmentation", "large language models", "llms", "data augmentation", "confusables", "typo", ""]
 
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: Apache Software License",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Rust",
-    "Operating System :: MacOS :: MacOS X",
-    "Operating System :: Microsoft :: Windows",
-    "Operating System :: POSIX :: Linux",
-    "Operating System :: OS Independent",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",
     "Topic :: Software Development :: Testing",
 ]
@@ -47,7 +43,7 @@ glitchlings = "glitchlings.main:main"
 [project.optional-dependencies]
 hf = ["datasets>=4.0.0"]
 wordnet = ["nltk>=3.9.1", "numpy>=1.24,<=2.0"]
-prime = ["verifiers>=0.1.3.post0"]
+prime = ["verifiers>=0.1.3.post0", "jellyfish>=1.2.0"]
 dev = [
     "pytest>=8.0.0",
     "hypothesis>=6.140.0",

{glitchlings-0.2.2 → glitchlings-0.2.4}/rust/zoo/build.rs

@@ -9,10 +9,15 @@ fn main() {
     prepare_confusion_table().expect("failed to stage OCR confusion table for compilation");
     pyo3_build_config::add_extension_module_link_args();
 
-    if let Some(python) = configured_python() {
-        link_python(&python);
-    } else if let Some(python) = detect_python() {
-        link_python(&python);
+    // Only perform custom Python linking on non-Linux platforms.
+    // On Linux, manylinux wheels must NOT link against libpython to ensure portability.
+    // PyO3's add_extension_module_link_args() already handles this correctly by default.
+    if cfg!(not(target_os = "linux")) {
+        if let Some(python) = configured_python() {
+            link_python(&python);
+        } else if let Some(python) = detect_python() {
+            link_python(&python);
+        }
     }
 }
 
@@ -23,7 +28,13 @@ fn configured_python() -> Option<OsString> {
 }
 
 fn detect_python() -> Option<OsString> {
-    const CANDIDATES: &[&str] = &["python3.12", "python3", "python"];
+    const CANDIDATES: &[&str] = &[
+        "python3.12",
+        "python3.11",
+        "python3.10",
+        "python3",
+        "python",
+    ];
 
     for candidate in CANDIDATES {
         let status = Command::new(candidate)
@@ -71,6 +82,7 @@ fn link_python(python: &OsStr) {
             let stem = stripped
                 .strip_suffix(".so")
                 .or_else(|| stripped.strip_suffix(".a"))
+                .or_else(|| stripped.strip_suffix(".dylib"))
                 .unwrap_or(stripped);
             if !stem.is_empty() {
                 println!("cargo:rustc-link-lib={stem}");

{glitchlings-0.2.2 → glitchlings-0.2.4}/src/glitchlings/dlc/prime.py

@@ -79,8 +79,8 @@ def tutorial_level(
 ) -> vf.Environment:
     """Create a low-corruption environment using tuned defaults."""
 
-    tuned_mim1c = Mim1c(replacement_rate=0.01 * difficulty.value)
-    tuned_typogre = Typogre(max_change_rate=0.025 * difficulty.value)
+    tuned_mim1c = Mim1c(rate=0.01 * difficulty.value)
+    tuned_typogre = Typogre(rate=0.025 * difficulty.value)
 
     return load_environment(
         env,
@@ -220,32 +220,54 @@ def echo_chamber(
             "Specify which split to use when the dataset loads as a DatasetDict."
         )
 
-    prompts: list[list[dict[str, str]]] = []
-    answers: list[str] = []
+    filtered_dataset = hf_dataset.filter(
+        lambda row: row.get(column) is not None,
+        load_from_cache_file=False,
+    )
 
-    for row in hf_dataset:
-        value = row.get(column)
-        if value is None:
-            continue
+    source_column_names = list(filtered_dataset.column_names)
 
-        text = str(value)
-        prompts.append(
-            [
-                {"role": "system", "content": instructions},
-                {"role": "user", "content": f"Corrupted text:\n{text}"},
-            ]
-        )
-        answers.append(text)
+    def _build_prompt(row: dict[str, Any]) -> dict[str, Any]:
+        text = str(row[column])
+        prompt = [
+            {"role": "system", "content": instructions},
+            {"role": "user", "content": f"Corrupted text:\n{text}"},
+        ]
+        return {"prompt": prompt, "answer": text}
 
-    if not prompts:
-        raise ValueError(
-            f"Column '{column}' did not yield any textual entries in dataset '{dataset_id}'."
-        )
+    base_dataset = filtered_dataset.map(
+        _build_prompt,
+        remove_columns=source_column_names,
+        load_from_cache_file=False,
+    )
 
-    dataset = HFDataset.from_dict({"prompt": prompts, "answer": answers})
+    try:
+        dataset_length = len(base_dataset)  # type: ignore[arg-type]
+    except TypeError:
+        preview_rows: list[dict[str, Any]]
+        take_fn = getattr(base_dataset, "take", None)
+        if callable(take_fn):
+            preview_rows = list(take_fn(1))
+        else:
+            iterator = iter(base_dataset)
+            try:
+                first_row = next(iterator)
+            except StopIteration:
+                preview_rows = []
+            else:
+                preview_rows = [first_row]
+        if not preview_rows:
+            raise ValueError(
+                f"Column '{column}' did not yield any textual entries in dataset '{dataset_id}'."
+            )
+    else:
+        if dataset_length == 0:
+            raise ValueError(
+                f"Column '{column}' did not yield any textual entries in dataset '{dataset_id}'."
+            )
 
     gaggle = _as_gaggle(glitchlings, seed=seed)
-    glitched_dataset = gaggle.corrupt_dataset(dataset, ["prompt"])
+    glitched_dataset = gaggle.corrupt_dataset(base_dataset, ["prompt"])
 
     rubric_func = reward_function or symmetric_damerau_levenshtein_similarity
     rubric = vf.Rubric(funcs=[rubric_func], weights=[1.0])

{glitchlings-0.2.2 → glitchlings-0.2.4}/src/glitchlings/main.py

@@ -46,7 +46,7 @@ def build_parser() -> argparse.ArgumentParser:
         metavar="SPEC",
         help=(
             "Glitchling to apply, optionally with parameters like "
-            "Typogre(max_change_rate=0.05). Repeat for multiples; defaults to all built-ins."
+            "Typogre(rate=0.05). Repeat for multiples; defaults to all built-ins."
         ),
     )
     parser.add_argument(

glitchlings-0.2.4/src/glitchlings/zoo/_rate.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+
+def resolve_rate(
+    *,
+    rate: float | None,
+    legacy_value: float | None,
+    default: float,
+    legacy_name: str,
+) -> float:
+    """Return the effective rate while enforcing mutual exclusivity."""
+
+    if rate is not None and legacy_value is not None:
+        raise ValueError(
+            f"Specify either 'rate' or '{legacy_name}', not both."
+        )
+    if rate is not None:
+        return rate
+    if legacy_value is not None:
+        return legacy_value
+    return default