anti-profanity 0.1.8

A multilingual profanity filter supporting English, Hindi, and Bengali

ProfanityFilter

A simple and customizable profanity filtering class supporting multiple languages: English (en), Hindi (hi), and Bengali (bn). It allows you to censor, detect, or remove profane words from a given text.

Features

• 🔍 Detect profanity in text
• ✂️ Remove profanity completely
• ✳️ Censor profanity with a customizable replacement character
• 🌐 Multilingual support (English, Hindi, Bengali)
• 💡 Easy to integrate and extend

---

Installation

pip3 install anti-profanity

from anti_profanity import ProfanityFilter

# For English only
pf_en = ProfanityFilter("en")

# For English and Hindi
pf_multi = ProfanityFilter(["en", "hi"])

# For all supported languages
pf_all = ProfanityFilter()

Methods

Example 1

censor_profanity(text, replacement="*", lang=None)

Replaces each character of any detected profanity with the replacement character.

text = "This contains shit."
censored = pf_en.censor_profanity(text)
print(censored)  # Output: This contains ****

Example 2

is_profanity(text, lang=None)

Checks whether the given text contains any profane words.

is_dirty = pf_multi.is_profanity("Text with badword2")
print(is_dirty)  # Output: True

Example 3

remove_profanity(text, lang=None)

Removes all profane words from the given text.

cleaned = pf_en.remove_profanity("Some fucking text")
print(cleaned)  # Output: Some  text

Customization

You can extend the filter by adding your own languages or editing the existing profanity lists in the data subdirectory: Each language file (e.g., english.py) should export a list of profane words:

License

MIT