better-profanity-rs 0.1.0__tar.gz

better_profanity_rs-0.1.0/Cargo.lock

@@ -0,0 +1,147 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "better-profanity"
+version = "0.1.0"
+dependencies = [
+ "rustc-hash",
+]
+
+[[package]]
+name = "better-profanity-python"
+version = "0.1.0"
+dependencies = [
+ "better-profanity",
+ "pyo3",
+ "rustc-hash",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "libc"
+version = "0.2.191"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
+
+[[package]]
+name = "once_cell"
+version = "1.21.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50"
+
+[[package]]
+name = "portable-atomic"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05c8b63e8d9609db387f0324918f81d68fe27748f084ef092fb35954d0539a85"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "700d18fa267b73b9b521fd7e13580e2f446916f176cacee1ab63fcc8191f1655"
+dependencies = [
+ "libc",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7b3fc0c4d08f6bb10e71fe39dfb9e2f59c6eb6854e22ec8092f50c69a4499adb"
+dependencies = [
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfc0b8e19df29aad7086cf977bb0c2a2f143e30567eb113e9cf72b62ca698330"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6100e8a4b5eba53afaa5ed078364851a0b2499c553a44c31026b929049b49dc6"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.29.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6143877a16e82b5a727b7127ff4cd86858a24a28d745d72f43e6f227c7b1bdb3"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb6935a6f5c20170eeceb1a3835a49e12e19d792f6dd344ccc76a985ca5a6ca"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"

better_profanity_rs-0.1.0/Cargo.toml

@@ -0,0 +1,16 @@
+[workspace]
+members = ["crates/better-profanity", "bindings/python"]
+resolver = "2"
+
+[workspace.package]
+version = "0.1.0"
+authors = ["Alex Kholodniak <alexandrkholodniak@gmail.com>"]
+edition = "2021"
+rust-version = "1.85"
+license = "MIT"
+repository = "https://github.com/SyntaxSpirits/better-profanity-rs"
+homepage = "https://syntaxspirits.dev"
+
+[profile.release]
+lto = "thin"
+codegen-units = 1

better_profanity_rs-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Alex Kholodniak
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

better_profanity_rs-0.1.0/NOTICE

@@ -0,0 +1,18 @@
+better-profanity-rs
+Copyright 2026 Alex Kholodniak
+
+This product is a port of better_profanity (https://github.com/snguyenthanh/better_profanity)
+by Son Nguyen Thanh, licensed under the MIT License. Its LICENSE file reads
+"Copyright (c) 2018 The Python Packaging Authority"; that notice is kept in LICENSE.
+
+The following files are copies of better_profanity 0.7.0, unchanged:
+
+- crates/better-profanity/data/profanity_wordlist.txt and
+  bindings/python/python/better_profanity_rs/profanity_wordlist.txt (the word list);
+- crates/better-profanity/data/alphabetic_unicode.json and
+  bindings/python/python/better_profanity_rs/alphabetic_unicode.json;
+- bindings/python/python/better_profanity_rs/better_profanity.py, constants.py, utils.py and
+  varying_string.py, which the Python package runs for inputs the Rust core does not handle.
+
+bindings/python/python/better_profanity_rs/_original.py holds the source of
+Profanity._hide_swear_words from better_profanity 0.7.0 as a string, unchanged.

better_profanity_rs-0.1.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: better-profanity-rs
+Version: 0.1.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Text Processing :: Filters
+License-File: LICENSE
+License-File: NOTICE
+Summary: Fast drop-in replacement for better_profanity: the same censored text from a Rust core
+Keywords: profanity,better_profanity,censor,swear-words,moderation,rust
+Author-email: Alex Kholodniak <alexandrkholodniak@gmail.com>
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://syntaxspirits.dev
+Project-URL: Issues, https://github.com/SyntaxSpirits/better-profanity-rs/issues
+Project-URL: Repository, https://github.com/SyntaxSpirits/better-profanity-rs
+
+# better-profanity-rs
+
+[![CI](https://github.com/SyntaxSpirits/better-profanity-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/SyntaxSpirits/better-profanity-rs/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/better-profanity-rs.svg)](https://pypi.org/project/better-profanity-rs/)
+[![Crates.io](https://img.shields.io/crates/v/better-profanity.svg)](https://crates.io/crates/better-profanity)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[`better_profanity`](https://pypi.org/project/better-profanity/) with a Rust core: the same
+censored text for every input, about 2,100 times faster on a 10-word message and
+10,000 to 12,000 times faster on texts of 100 to 700 words
+([benchmarks](https://github.com/SyntaxSpirits/better-profanity-rs/blob/main/BENCHMARKS.md)).
+
+`better_profanity` is downloaded about two million times a month, although its last release, 0.7.0,
+dates from November 2020. It is slow: `contains_profanity` takes 9 ms for a 10-word message and
+0.9 s for a 700-word article on an M1 Pro with CPython 3.13. The word list is a Python list of 916
+objects, and each word of the text, alone and joined with the words after it, is compared with every
+one of them by a method that tries the leetspeak variants letter by letter. `better-profanity-rs`
+turns the word list into a trie whose edges are sets of characters (`a`, `@`, `*` and `4` for an
+`a`) and runs the original scan, step for step, in Rust. Words in leetspeak, phrases split by
+separators (`f.u.c.k`, `H4nd j0b`), whitelists, custom word lists and the quirks of the original
+give the same output.
+
+The Python package is `better-profanity-rs`; the Rust crate is `better-profanity`. This is an
+independent project, not affiliated with the author of `better_profanity`.
+
+## Python
+
+```sh
+pip install better-profanity-rs
+```
+
+Change the import and keep the rest of your code:
+
+```python
+from better_profanity_rs import profanity  # was: from better_profanity import profanity
+
+profanity.censor("That wh0re gave m3 a very good H4nd j0b, dude.")
+# 'That **** gave m3 a very good ****, dude.'
+profanity.contains_profanity("he is a m0th3rf*cker")
+# True
+profanity.load_censor_words(["happy", "jolly"], whitelist_words=["jolly"])
+profanity.censor("Happy and jolly days", "-")
+# '---- and jolly days'
+```
+
+`Profanity`, `load_censor_words`, `load_censor_words_from_file`, `add_censor_words`, `censor`
+and `contains_profanity` take the same arguments as in `better_profanity` 0.7.0 and return the
+same results or raise the same exceptions. The attributes `CENSOR_WORDSET`, `CHARS_MAPPING`,
+`MAX_NUMBER_COMBINATIONS` and `ALLOWED_CHARACTERS` can be read and changed as before, and the
+modules `better_profanity`, `constants`, `utils` and `varying_string` are those of 0.7.0.
+
+### Code you do not control
+
+When a library imports `better_profanity` itself, call `install()` before importing it:
+
+```python
+import better_profanity_rs
+
+better_profanity_rs.install()  # `import better_profanity` now returns better_profanity_rs
+
+import my_web_app
+```
+
+`install()` covers `better_profanity` and its modules `better_profanity`, `constants`, `utils`
+and `varying_string`. Modules that imported `better_profanity` before the call keep the
+original.
+
+## Rust
+
+```toml
+[dependencies]
+better-profanity = "0.1"
+```
+
+```rust
+use better_profanity::Profanity;
+
+let profanity = Profanity::new();
+assert_eq!(
+    profanity.censor("That wh0re gave m3 a very good H@nD j0b.", "*"),
+    "That **** gave m3 a very good ****."
+);
+
+let mut custom = Profanity::with_words(["happy", "jolly"]);
+custom.add_censor_words(["merry christmas"]);
+assert!(custom.contains_profanity("Merry Christmas!"));
+```
+
+`Profanity` follows the Python class; `hide_swear_words`, `WordSet` and `CharSet` expose the
+scan for other word sets, separator sets and lowercasing rules. The crate lowercases with Rust's
+Unicode tables, which can differ from those of a given Python for characters added to Unicode
+recently; the Python package always uses the running interpreter's `str.lower()`.
+
+## Compatibility
+
+The tests compare `better-profanity-rs` with `better_profanity` 0.7.0 and fail on any
+difference in output or exception: the original's own test suite, hand-picked cases,
+dictionary words in leetspeak inside texts and joined by separators, custom word lists and
+whitelists, invalid arguments, every kind of attribute change listed below, subclasses,
+pickling, threads and property-based tests, on CPython 3.9 to 3.14. A separate script compares
+285,074 texts, among them the civil_comments test split and the Jigsaw toxic comments (50,532
+of the texts are censored), and 28,183 of them again with a custom word list and whitelist, on
+CPython 3.9, 3.11, 3.13 and 3.14: no output differs (see [BENCHMARKS.md](BENCHMARKS.md)).
+
+This includes the original's quirks. For example, `add_censor_words` does not raise
+`MAX_NUMBER_COMBINATIONS`, and when it is 1, only every other word is joined to the next one.
+After `Profanity(["happy", "jolly"]).add_censor_words(["merry christmas"])`, both packages
+censor "m3rry christmas" and "a b m3rry christmas" but not "a m3rry christmas".
+
+`better_profanity`'s own code, bundled in the package, runs whenever the Rust core could
+behave differently, so the output stays the same and only the speed-up is lost:
+
+- the text or `censor_char` is not an exact `str` (a `str` subclass, for example), or contains
+  lone surrogates;
+- `CENSOR_WORDSET` is not an exact list or tuple of `VaryingString` objects and strings, or a
+  `CHARS_MAPPING` value used by a word has a variant that is not exactly one character
+  (`better_profanity` also accepts longer and empty variants);
+- `MAX_NUMBER_COMBINATIONS` is not an `int`, or the call is made so close to the recursion
+  limit that the original, which recurses `MAX_NUMBER_COMBINATIONS` calls deep, could reach
+  it (within about twice `MAX_NUMBER_COMBINATIONS` + 20 frames);
+- `ALLOWED_CHARACTERS` was replaced by another set, or holds something other than strings;
+- a subclass or a patch replaces `_get_next_words`, `_update_next_words_indices`,
+  `_get_start_index_of_next_word`, `_get_next_word_and_end_index`,
+  `get_replacement_for_swear_word`, `any_next_words_form_swear_word` or
+  `VaryingString.__eq__`, or turns one of the attributes into a property.
+
+The original runs in the same stack frame as in `better_profanity`, so a `RecursionError` is
+raised exactly where `better_profanity` raises it. Changes in place are seen. `CENSOR_WORDSET` is compiled again when its items change: each call
+checks that the list still holds the same objects, which takes about 1 µs for the default
+list. `ALLOWED_CHARACTERS` is a `set` subclass that notes its changes. Lowercasing uses the
+interpreter's `str.lower()`, so, as with `better_profanity`, results follow the Unicode version
+of the Python running them.
+
+Known differences:
+
+- The private attributes of a `VaryingString` (`_char_combos`, `_min_len`, `_max_len`) are
+  read when the word list is compiled; changing them later on an object already in
+  `CENSOR_WORDSET` is not seen.
+- `ALLOWED_CHARACTERS` is a `set` subclass; changes made through `set` itself, as in
+  `set.add(ALLOWED_CHARACTERS, "-")`, are not seen.
+- Near the recursion limit, frames are counted with `sys._getframe`. CPython 3.11 and older
+  also count nested C calls toward the limit; the check allows one per Python frame, so a call
+  made deep inside C-level recursion (a recursive `__repr__`, for example) could still raise
+  where `better_profanity` would not, or the reverse. On CPython 3.11, a call made within two
+  frames of the limit raises `RecursionError` as `better_profanity` does, but the message can
+  name a different operation.
+- A compiled word list keeps the `VaryingString` objects of `CENSOR_WORDSET` alive until the
+  list changes or the `Profanity` object is deleted. An attribute added to one of them that
+  refers back to the `Profanity` object keeps that object alive.
+- Free-threaded CPython builds are not supported: the extension module asks to keep the GIL
+  enabled.
+- `__version__` and `name` are those of `better_profanity_rs`.
+
+## Development
+
+```sh
+cargo test -p better-profanity
+cd bindings/python
+uv sync --group dev
+uv run pytest
+cd benchmarks && uv run --group bench python parity.py   # all corpora
+```
+
+## License
+
+MIT, the same licence as `better_profanity`, whose code, word list and character list this
+project includes. See [NOTICE](NOTICE).
+

better_profanity_rs-0.1.0/README.md

@@ -0,0 +1,167 @@
+# better-profanity-rs
+
+[![CI](https://github.com/SyntaxSpirits/better-profanity-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/SyntaxSpirits/better-profanity-rs/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/better-profanity-rs.svg)](https://pypi.org/project/better-profanity-rs/)
+[![Crates.io](https://img.shields.io/crates/v/better-profanity.svg)](https://crates.io/crates/better-profanity)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+[`better_profanity`](https://pypi.org/project/better-profanity/) with a Rust core: the same
+censored text for every input, about 2,100 times faster on a 10-word message and
+10,000 to 12,000 times faster on texts of 100 to 700 words
+([benchmarks](https://github.com/SyntaxSpirits/better-profanity-rs/blob/main/BENCHMARKS.md)).
+
+`better_profanity` is downloaded about two million times a month, although its last release, 0.7.0,
+dates from November 2020. It is slow: `contains_profanity` takes 9 ms for a 10-word message and
+0.9 s for a 700-word article on an M1 Pro with CPython 3.13. The word list is a Python list of 916
+objects, and each word of the text, alone and joined with the words after it, is compared with every
+one of them by a method that tries the leetspeak variants letter by letter. `better-profanity-rs`
+turns the word list into a trie whose edges are sets of characters (`a`, `@`, `*` and `4` for an
+`a`) and runs the original scan, step for step, in Rust. Words in leetspeak, phrases split by
+separators (`f.u.c.k`, `H4nd j0b`), whitelists, custom word lists and the quirks of the original
+give the same output.
+
+The Python package is `better-profanity-rs`; the Rust crate is `better-profanity`. This is an
+independent project, not affiliated with the author of `better_profanity`.
+
+## Python
+
+```sh
+pip install better-profanity-rs
+```
+
+Change the import and keep the rest of your code:
+
+```python
+from better_profanity_rs import profanity  # was: from better_profanity import profanity
+
+profanity.censor("That wh0re gave m3 a very good H4nd j0b, dude.")
+# 'That **** gave m3 a very good ****, dude.'
+profanity.contains_profanity("he is a m0th3rf*cker")
+# True
+profanity.load_censor_words(["happy", "jolly"], whitelist_words=["jolly"])
+profanity.censor("Happy and jolly days", "-")
+# '---- and jolly days'
+```
+
+`Profanity`, `load_censor_words`, `load_censor_words_from_file`, `add_censor_words`, `censor`
+and `contains_profanity` take the same arguments as in `better_profanity` 0.7.0 and return the
+same results or raise the same exceptions. The attributes `CENSOR_WORDSET`, `CHARS_MAPPING`,
+`MAX_NUMBER_COMBINATIONS` and `ALLOWED_CHARACTERS` can be read and changed as before, and the
+modules `better_profanity`, `constants`, `utils` and `varying_string` are those of 0.7.0.
+
+### Code you do not control
+
+When a library imports `better_profanity` itself, call `install()` before importing it:
+
+```python
+import better_profanity_rs
+
+better_profanity_rs.install()  # `import better_profanity` now returns better_profanity_rs
+
+import my_web_app
+```
+
+`install()` covers `better_profanity` and its modules `better_profanity`, `constants`, `utils`
+and `varying_string`. Modules that imported `better_profanity` before the call keep the
+original.
+
+## Rust
+
+```toml
+[dependencies]
+better-profanity = "0.1"
+```
+
+```rust
+use better_profanity::Profanity;
+
+let profanity = Profanity::new();
+assert_eq!(
+    profanity.censor("That wh0re gave m3 a very good H@nD j0b.", "*"),
+    "That **** gave m3 a very good ****."
+);
+
+let mut custom = Profanity::with_words(["happy", "jolly"]);
+custom.add_censor_words(["merry christmas"]);
+assert!(custom.contains_profanity("Merry Christmas!"));
+```
+
+`Profanity` follows the Python class; `hide_swear_words`, `WordSet` and `CharSet` expose the
+scan for other word sets, separator sets and lowercasing rules. The crate lowercases with Rust's
+Unicode tables, which can differ from those of a given Python for characters added to Unicode
+recently; the Python package always uses the running interpreter's `str.lower()`.
+
+## Compatibility
+
+The tests compare `better-profanity-rs` with `better_profanity` 0.7.0 and fail on any
+difference in output or exception: the original's own test suite, hand-picked cases,
+dictionary words in leetspeak inside texts and joined by separators, custom word lists and
+whitelists, invalid arguments, every kind of attribute change listed below, subclasses,
+pickling, threads and property-based tests, on CPython 3.9 to 3.14. A separate script compares
+285,074 texts, among them the civil_comments test split and the Jigsaw toxic comments (50,532
+of the texts are censored), and 28,183 of them again with a custom word list and whitelist, on
+CPython 3.9, 3.11, 3.13 and 3.14: no output differs (see [BENCHMARKS.md](BENCHMARKS.md)).
+
+This includes the original's quirks. For example, `add_censor_words` does not raise
+`MAX_NUMBER_COMBINATIONS`, and when it is 1, only every other word is joined to the next one.
+After `Profanity(["happy", "jolly"]).add_censor_words(["merry christmas"])`, both packages
+censor "m3rry christmas" and "a b m3rry christmas" but not "a m3rry christmas".
+
+`better_profanity`'s own code, bundled in the package, runs whenever the Rust core could
+behave differently, so the output stays the same and only the speed-up is lost:
+
+- the text or `censor_char` is not an exact `str` (a `str` subclass, for example), or contains
+  lone surrogates;
+- `CENSOR_WORDSET` is not an exact list or tuple of `VaryingString` objects and strings, or a
+  `CHARS_MAPPING` value used by a word has a variant that is not exactly one character
+  (`better_profanity` also accepts longer and empty variants);
+- `MAX_NUMBER_COMBINATIONS` is not an `int`, or the call is made so close to the recursion
+  limit that the original, which recurses `MAX_NUMBER_COMBINATIONS` calls deep, could reach
+  it (within about twice `MAX_NUMBER_COMBINATIONS` + 20 frames);
+- `ALLOWED_CHARACTERS` was replaced by another set, or holds something other than strings;
+- a subclass or a patch replaces `_get_next_words`, `_update_next_words_indices`,
+  `_get_start_index_of_next_word`, `_get_next_word_and_end_index`,
+  `get_replacement_for_swear_word`, `any_next_words_form_swear_word` or
+  `VaryingString.__eq__`, or turns one of the attributes into a property.
+
+The original runs in the same stack frame as in `better_profanity`, so a `RecursionError` is
+raised exactly where `better_profanity` raises it. Changes in place are seen. `CENSOR_WORDSET` is compiled again when its items change: each call
+checks that the list still holds the same objects, which takes about 1 µs for the default
+list. `ALLOWED_CHARACTERS` is a `set` subclass that notes its changes. Lowercasing uses the
+interpreter's `str.lower()`, so, as with `better_profanity`, results follow the Unicode version
+of the Python running them.
+
+Known differences:
+
+- The private attributes of a `VaryingString` (`_char_combos`, `_min_len`, `_max_len`) are
+  read when the word list is compiled; changing them later on an object already in
+  `CENSOR_WORDSET` is not seen.
+- `ALLOWED_CHARACTERS` is a `set` subclass; changes made through `set` itself, as in
+  `set.add(ALLOWED_CHARACTERS, "-")`, are not seen.
+- Near the recursion limit, frames are counted with `sys._getframe`. CPython 3.11 and older
+  also count nested C calls toward the limit; the check allows one per Python frame, so a call
+  made deep inside C-level recursion (a recursive `__repr__`, for example) could still raise
+  where `better_profanity` would not, or the reverse. On CPython 3.11, a call made within two
+  frames of the limit raises `RecursionError` as `better_profanity` does, but the message can
+  name a different operation.
+- A compiled word list keeps the `VaryingString` objects of `CENSOR_WORDSET` alive until the
+  list changes or the `Profanity` object is deleted. An attribute added to one of them that
+  refers back to the `Profanity` object keeps that object alive.
+- Free-threaded CPython builds are not supported: the extension module asks to keep the GIL
+  enabled.
+- `__version__` and `name` are those of `better_profanity_rs`.
+
+## Development
+
+```sh
+cargo test -p better-profanity
+cd bindings/python
+uv sync --group dev
+uv run pytest
+cd benchmarks && uv run --group bench python parity.py   # all corpora
+```
+
+## License
+
+MIT, the same licence as `better_profanity`, whose code, word list and character list this
+project includes. See [NOTICE](NOTICE).

better_profanity_rs-0.1.0/bindings/python/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "better-profanity-python"
+description = "Python bindings for better-profanity"
+publish = false
+version.workspace = true
+authors.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+readme = "README.md"
+
+[lib]
+name = "_core"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.29", features = ["abi3-py39"] }
+better-profanity = { path = "../../crates/better-profanity" }
+rustc-hash = "2"

better_profanity_rs-0.1.0/bindings/python/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Alex Kholodniak
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

better_profanity_rs-0.1.0/bindings/python/NOTICE

@@ -0,0 +1,18 @@
+better-profanity-rs
+Copyright 2026 Alex Kholodniak
+
+This product is a port of better_profanity (https://github.com/snguyenthanh/better_profanity)
+by Son Nguyen Thanh, licensed under the MIT License. Its LICENSE file reads
+"Copyright (c) 2018 The Python Packaging Authority"; that notice is kept in LICENSE.
+
+The following files are copies of better_profanity 0.7.0, unchanged:
+
+- crates/better-profanity/data/profanity_wordlist.txt and
+  bindings/python/python/better_profanity_rs/profanity_wordlist.txt (the word list);
+- crates/better-profanity/data/alphabetic_unicode.json and
+  bindings/python/python/better_profanity_rs/alphabetic_unicode.json;
+- bindings/python/python/better_profanity_rs/better_profanity.py, constants.py, utils.py and
+  varying_string.py, which the Python package runs for inputs the Rust core does not handle.
+
+bindings/python/python/better_profanity_rs/_original.py holds the source of
+Profanity._hide_swear_words from better_profanity 0.7.0 as a string, unchanged.