Rune Caster 1.0.0
Modern C++ Text Processing Framework
Loading...
Searching...
No Matches
spells.hpp
Go to the documentation of this file.
1#pragma once
2
3#include "spell_unified.hpp"
4#include "unicode.hpp"
5#include "language.hpp"
6
7namespace rune_caster {
8
16namespace spells {
17
18// === Text normalization spells ===
19
26extern const Spell whitespace_normalizer;
27
31extern const Spell trim_whitespace;
32
36extern const Spell collapse_whitespace;
37
38// === Case conversion spells ===
39
43extern const Spell to_lowercase;
44
48extern const Spell to_uppercase;
49
53extern const Spell to_titlecase;
54
55// === Unicode normalization spells ===
56
60extern const Spell unicode_nfc;
61
65extern const Spell unicode_nfd;
66
70extern const Spell unicode_nfkc;
71
75extern const Spell unicode_nfkd;
76
77// === Filtering spells ===
78
82extern const Spell remove_punctuation;
83
87extern const Spell alphanumeric_only;
88
92extern const Spell remove_digits;
93
97extern const Spell ascii_only;
98
99// === Common combinations ===
100
104extern const Spell text_cleanup;
105
109extern const Spell search_preprocess;
110
114extern const Spell display_format;
115
116// === Factory functions for dynamic spell creation ===
117
124Spell whitespace(bool collapse_multiple = true, bool trim_edges = true);
125
132Spell replace_char(char32_t from, char32_t to);
133
140Spell replace_string(std::string_view from, std::string_view to);
141
147template<typename Predicate>
148Spell remove_if(Predicate&& predicate) {
149 return spell_factory::filter_spell(
150 [pred = std::forward<Predicate>(predicate)](const Rune& rune) {
151 return !pred(rune);
152 },
153 "RemoveIf",
154 "Remove characters matching predicate"
155 );
156}
157
163template<typename Predicate>
164Spell keep_if(Predicate&& predicate) {
165 return spell_factory::filter_spell(
166 std::forward<Predicate>(predicate),
167 "KeepIf",
168 "Keep only characters matching predicate"
169 );
170}
171
177template<typename Transform>
178Spell transform_chars(Transform&& transform) {
179 return spell_factory::per_rune_spell(
180 std::forward<Transform>(transform),
181 "TransformChars",
182 "Transform each character"
183 );
184}
185
186// === Language-specific spells ===
187
192Spell detect_language();
193
200Spell filter_by_script(unicode::Script script, bool keep = true);
201
208Spell filter_by_category(unicode::Category category, bool keep = true);
209
210} // namespace spells
211
212// === Usage examples and documentation ===
213
241
242} // namespace rune_caster
rune_caster::Rune
Represents a single textual unit with Unicode and linguistic properties.
Definition rune.hpp:23
rune_caster::Spell
Unified spell object for text transformation.
Definition spell_unified.hpp:29
language.hpp
Language identification and localization support.
rune_caster::spell_factory::filter_spell
auto filter_spell(Predicate &&predicate, std::string name="FilterSpell", std::string description="Rune filtering")
Create a spell that filters runes based on a predicate.
Definition spell_unified.hpp:246
rune_caster::spell_factory::per_rune_spell
auto per_rune_spell(RuneTransform &&rune_transform, std::string name="PerRuneSpell", std::string description="Per-rune transformation")
Create a spell that applies a transformation to each rune.
Definition spell_unified.hpp:225
rune_caster::spells
Pre-defined spells using the unified Spell interface.
Definition spells.hpp:16
rune_caster::spells::text_cleanup
const Spell text_cleanup
Standard text cleanup (whitespace + NFC + lowercase)
rune_caster::spells::keep_if
Spell keep_if(Predicate &&predicate)
Create a spell that keeps only characters matching a predicate.
Definition spells.hpp:164
rune_caster::spells::detect_language
Spell detect_language()
Create a language detection spell.
rune_caster::spells::filter_by_script
Spell filter_by_script(unicode::Script script, bool keep=true)
Create a script filtering spell.
rune_caster::spells::to_uppercase
const Spell to_uppercase
Convert text to uppercase.
rune_caster::spells::unicode_nfkd
const Spell unicode_nfkd
Apply Unicode NFKD normalization.
rune_caster::spells::alphanumeric_only
const Spell alphanumeric_only
Keep only letters and digits.
rune_caster::spells::search_preprocess
const Spell search_preprocess
Search-optimized preprocessing.
rune_caster::spells::remove_digits
const Spell remove_digits
Remove digits.
rune_caster::spells::remove_punctuation
const Spell remove_punctuation
Remove punctuation characters.
rune_caster::spells::to_lowercase
const Spell to_lowercase
Convert text to lowercase.
rune_caster::spells::whitespace
Spell whitespace(bool collapse_multiple=true, bool trim_edges=true)
Create a custom whitespace normalizer.
rune_caster::spells::ascii_only
const Spell ascii_only
Keep only ASCII characters.
rune_caster::spells::collapse_whitespace
const Spell collapse_whitespace
Collapse multiple whitespace into single spaces.
rune_caster::spells::remove_if
Spell remove_if(Predicate &&predicate)
Create a spell that removes characters matching a predicate.
Definition spells.hpp:148
rune_caster::spells::replace_string
Spell replace_string(std::string_view from, std::string_view to)
Create a string replacement spell.
rune_caster::spells::replace_char
Spell replace_char(char32_t from, char32_t to)
Create a character replacement spell.
rune_caster::spells::to_titlecase
const Spell to_titlecase
Convert text to title case.
rune_caster::spells::display_format
const Spell display_format
Display-optimized formatting.
rune_caster::spells::whitespace_normalizer
const Spell whitespace_normalizer
Normalize whitespace characters.
rune_caster::spells::unicode_nfkc
const Spell unicode_nfkc
Apply Unicode NFKC normalization.
rune_caster::spells::filter_by_category
Spell filter_by_category(unicode::Category category, bool keep=true)
Create a category filtering spell.
rune_caster::spells::unicode_nfd
const Spell unicode_nfd
Apply Unicode NFD normalization.
rune_caster::spells::trim_whitespace
const Spell trim_whitespace
Trim leading and trailing whitespace.
rune_caster::spells::unicode_nfc
const Spell unicode_nfc
Apply Unicode NFC normalization.
rune_caster::spells::transform_chars
Spell transform_chars(Transform &&transform)
Create a spell that transforms each character.
Definition spells.hpp:178
rune_caster::unicode::Category
Category
Definition unicode.hpp:9
rune_caster::unicode::Script
Script
Definition unicode.hpp:21
rune_caster
Definition caster.hpp:9
spell_unified.hpp