profy-filter 0.1.0a1__tar.gz

profy_filter-0.1.0a1/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: python -m pip install --upgrade pytest
+      - run: python -m pytest
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade build
+      - run: python -m build
+      - run: python -m venv /tmp/profy-venv
+      - run: /tmp/profy-venv/bin/python -m pip install dist/profy_filter-*.whl
+      - run: |
+          cd /tmp
+          /tmp/profy-venv/bin/python - <<'PY'
+          from profy import filter_text
+
+          result = filter_text("Das ist scheisse", languages="german")
+          assert result.clean == "Das ist ********"
+          assert filter_text("Scunthorpe").is_clean
+          PY

profy_filter-0.1.0a1/.github/workflows/release.yml

@@ -0,0 +1,38 @@
+name: Release
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install --upgrade build pytest
+      - run: python -m pytest
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: profy-dist
+          path: dist/*
+      - uses: softprops/action-gh-release@v2
+        if: github.ref_type == 'tag'
+        with:
+          prerelease: true
+          files: dist/*
+          generate_release_notes: true
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          skip-existing: true

profy_filter-0.1.0a1/.gitignore

@@ -0,0 +1,17 @@
+# Python
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.venv/
+.wheel-venv/
+dist/
+build/
+*.egg-info/
+
+# Local/editor
+.DS_Store
+.idea/
+.vscode/
+
+# Upstream sync cache
+.cache/

profy_filter-0.1.0a1/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0a1
+
+- Initial alpha release of Profy.
+- Replaced the PHP/Laravel fork contents with a standalone Python package.
+- Ported Blasp's core obfuscation-aware profanity matching, masking, severity scoring, allow/block lists, and result objects.
+- Bundled English, Spanish, German, and French dictionaries exported from Blasp's PHP config.
+- Added Python CI, release workflow, and upstream Blasp sync tooling.

profy_filter-0.1.0a1/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Michael Deeming
+
+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.

profy_filter-0.1.0a1/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: profy-filter
+Version: 0.1.0a1
+Summary: A Python profanity filter forked from Blaspsoft/blasp.
+Project-URL: Homepage, https://github.com/mantleCurve/profy
+Project-URL: Repository, https://github.com/mantleCurve/profy
+Project-URL: Issues, https://github.com/mantleCurve/profy/issues
+Project-URL: Changelog, https://github.com/mantleCurve/profy/blob/main/CHANGELOG.md
+Project-URL: Upstream, https://github.com/Blaspsoft/blasp
+Author: MantleCurve
+License-Expression: MIT
+License-File: LICENSE.md
+Keywords: blasp,filter,moderation,profanity,text-cleaning
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing :: Filters
+Requires-Python: >=3.9
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Profy
+
+Profy is a Python fork of [Blaspsoft/blasp](https://github.com/Blaspsoft/blasp), focused on the core profanity filtering engine rather than Laravel integration. It ports Blasp's dictionary-driven, obfuscation-aware matching into a standalone Python package.
+
+The repository lives at [mantleCurve/profy](https://github.com/mantleCurve/profy).
+
+## Install
+
+```bash
+pip install profy-filter
+```
+
+The import package is `profy`:
+
+```python
+from profy import filter_text, clean_text, check_text
+
+result = filter_text("This is f-uuck!ng noisy")
+
+print(result.is_offensive)      # True
+print(result.clean)             # This is ********* noisy
+print(result.unique_words)      # ['fucking']
+print(result.score)             # severity-weighted score from 0 to 100
+
+assert check_text("f**k")
+assert clean_text("shit") == "****"
+```
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Reuse a Filter
+
+Create a `ProfanityFilter` when you need to process many strings with the same options.
+
+```python
+from profy import ProfanityFilter, Severity
+
+shield = ProfanityFilter(
+    languages=["english", "spanish"],
+    mask="#",
+    minimum_severity=Severity.MODERATE,
+    allow=["heck"],
+    block=["internal-ban-word"],
+)
+
+result = shield.check("clean this text")
+print(result.to_dict())
+```
+
+## Options
+
+`filter_text()` and `ProfanityFilter()` accept:
+
+- `languages`: a language name or iterable. Bundled data includes `english`, `spanish`, `german`, and `french`.
+- `all_languages`: use every bundled language dictionary.
+- `allow`: words that should never be flagged.
+- `block`: extra words that should always be flagged.
+- `mask`: a replacement character or callback `(word, length) -> str`.
+- `minimum_severity`: `mild`, `moderate`, `high`, or `extreme`.
+
+## Result Shape
+
+```python
+{
+    "original": "This is shit",
+    "clean": "This is ****",
+    "is_offensive": True,
+    "score": 40,
+    "count": 1,
+    "unique_words": ["shit"],
+    "severity": "high",
+    "words": [
+        {
+            "text": "shit",
+            "base": "shit",
+            "severity": "high",
+            "position": 8,
+            "length": 4,
+            "language": "english",
+        }
+    ],
+}
+```
+
+## Scope
+
+This fork intentionally ports the profanity filter itself, not Blasp's Laravel service provider, middleware, Eloquent helpers, events, facades, or cache layer.
+
+## Upstream Sync
+
+Use `scripts/sync_from_blasp.py` to fetch the latest Blasp PHP repository, export updated dictionary/config data into Profy's Python package, and generate an implementation-change report for PHP files that need manual port review.
+
+```bash
+python scripts/sync_from_blasp.py
+```
+
+## Release
+
+Alpha releases use PEP 440 versions such as `0.1.0a1` and Git tags such as `v0.1.0a1`. The GitHub Actions release workflow runs tests, builds the source distribution and wheel, uploads them as artifacts, and attaches them to the GitHub Release.
+
+## Attribution
+
+Profy is a Python fork of [Blaspsoft/blasp](https://github.com/Blaspsoft/blasp), originally authored by Michael Deeming and released under the MIT license.
+
+## License
+
+MIT. See [LICENSE.md](LICENSE.md).

profy_filter-0.1.0a1/README.md

@@ -0,0 +1,112 @@
+# Profy
+
+Profy is a Python fork of [Blaspsoft/blasp](https://github.com/Blaspsoft/blasp), focused on the core profanity filtering engine rather than Laravel integration. It ports Blasp's dictionary-driven, obfuscation-aware matching into a standalone Python package.
+
+The repository lives at [mantleCurve/profy](https://github.com/mantleCurve/profy).
+
+## Install
+
+```bash
+pip install profy-filter
+```
+
+The import package is `profy`:
+
+```python
+from profy import filter_text, clean_text, check_text
+
+result = filter_text("This is f-uuck!ng noisy")
+
+print(result.is_offensive)      # True
+print(result.clean)             # This is ********* noisy
+print(result.unique_words)      # ['fucking']
+print(result.score)             # severity-weighted score from 0 to 100
+
+assert check_text("f**k")
+assert clean_text("shit") == "****"
+```
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Reuse a Filter
+
+Create a `ProfanityFilter` when you need to process many strings with the same options.
+
+```python
+from profy import ProfanityFilter, Severity
+
+shield = ProfanityFilter(
+    languages=["english", "spanish"],
+    mask="#",
+    minimum_severity=Severity.MODERATE,
+    allow=["heck"],
+    block=["internal-ban-word"],
+)
+
+result = shield.check("clean this text")
+print(result.to_dict())
+```
+
+## Options
+
+`filter_text()` and `ProfanityFilter()` accept:
+
+- `languages`: a language name or iterable. Bundled data includes `english`, `spanish`, `german`, and `french`.
+- `all_languages`: use every bundled language dictionary.
+- `allow`: words that should never be flagged.
+- `block`: extra words that should always be flagged.
+- `mask`: a replacement character or callback `(word, length) -> str`.
+- `minimum_severity`: `mild`, `moderate`, `high`, or `extreme`.
+
+## Result Shape
+
+```python
+{
+    "original": "This is shit",
+    "clean": "This is ****",
+    "is_offensive": True,
+    "score": 40,
+    "count": 1,
+    "unique_words": ["shit"],
+    "severity": "high",
+    "words": [
+        {
+            "text": "shit",
+            "base": "shit",
+            "severity": "high",
+            "position": 8,
+            "length": 4,
+            "language": "english",
+        }
+    ],
+}
+```
+
+## Scope
+
+This fork intentionally ports the profanity filter itself, not Blasp's Laravel service provider, middleware, Eloquent helpers, events, facades, or cache layer.
+
+## Upstream Sync
+
+Use `scripts/sync_from_blasp.py` to fetch the latest Blasp PHP repository, export updated dictionary/config data into Profy's Python package, and generate an implementation-change report for PHP files that need manual port review.
+
+```bash
+python scripts/sync_from_blasp.py
+```
+
+## Release
+
+Alpha releases use PEP 440 versions such as `0.1.0a1` and Git tags such as `v0.1.0a1`. The GitHub Actions release workflow runs tests, builds the source distribution and wheel, uploads them as artifacts, and attaches them to the GitHub Release.
+
+## Attribution
+
+Profy is a Python fork of [Blaspsoft/blasp](https://github.com/Blaspsoft/blasp), originally authored by Michael Deeming and released under the MIT license.
+
+## License
+
+MIT. See [LICENSE.md](LICENSE.md).

profy_filter-0.1.0a1/RELEASES.md

@@ -0,0 +1,36 @@
+# Releases
+
+Profy follows semantic versioning with PEP 440 pre-release suffixes for alpha builds, for example `0.1.0a1`.
+
+## Publishing
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine upload dist/*
+```
+
+Create a matching Git tag:
+
+```bash
+git tag v0.1.0a1
+git push origin v0.1.0a1
+```
+
+Pushing that tag runs the `Release` GitHub Actions workflow, which runs tests, builds the source distribution and wheel, uploads them as workflow artifacts, and attaches them to a GitHub Release.
+
+The same workflow publishes to PyPI using Trusted Publishing. Configure PyPI with:
+
+- Project name: `profy-filter`
+- Owner: `mantleCurve`
+- Repository: `profy`
+- Workflow: `release.yml`
+- Environment: `pypi`
+
+GitHub Releases should include:
+
+- version number
+- installation command
+- upstream Blasp commit, if synced
+- highlights
+- any compatibility or behavior notes

profy_filter-0.1.0a1/docs/index.md

@@ -0,0 +1,51 @@
+# Profy Documentation
+
+Profy is a Python fork of [Blaspsoft/blasp](https://github.com/Blaspsoft/blasp). It keeps Blasp's core profanity filtering ideas and bundled language data while exposing a small Python API.
+
+## API
+
+Use `filter_text()` when you want the full `ShieldResult`, `clean_text()` when you only need sanitized text, and `check_text()` when you only need a boolean.
+
+```python
+from profy import filter_text
+
+result = filter_text("f-u-c-k", mask="*")
+assert result.clean == "*******"
+```
+
+## Matching Behavior
+
+The detector is regex-based and uses Blasp-style generated expressions for each dictionary word. It supports:
+
+- case-insensitive matching
+- substitution characters such as `@`, `$`, `!`, `1`, `*`, and accented variants
+- separators between letters
+- repeated substitution characters
+- invisible Unicode format character removal
+- false-positive guards for known words, UUIDs, long hex tokens, and many embedded clean words
+
+## Languages
+
+Bundled dictionaries: English, Spanish, German, and French.
+
+```python
+from profy import filter_text
+
+result = filter_text("maldición", languages="spanish")
+```
+
+For multi-language checks:
+
+```python
+result = filter_text("text", languages=["english", "spanish"])
+result = filter_text("text", all_languages=True)
+```
+
+## Release Checklist
+
+1. Update `profy/__init__.py` and `pyproject.toml` with the new version.
+2. Update `CHANGELOG.md`.
+3. Install development dependencies with `python -m pip install -e ".[dev]"`.
+4. Run `python -m pytest`.
+5. Build with `python -m build`.
+6. Create and push a `v*` version tag.

profy_filter-0.1.0a1/docs/upstream-sync-report.md

@@ -0,0 +1,18 @@
+# Upstream Blasp Sync Report
+
+- Upstream: `https://github.com/Blaspsoft/blasp.git`
+- Current commit: `cce2dd02e0cdad5c504d18d554322098d4ee2c28`
+- Previous synced commit: `cce2dd02e0cdad5c504d18d554322098d4ee2c28`
+- Synced at: `2026-05-07T05:59:47.679144+00:00`
+
+## Exported Data
+
+- `profy/data/global.json`
+- `profy/data/languages/english.json`
+- `profy/data/languages/french.json`
+- `profy/data/languages/german.json`
+- `profy/data/languages/spanish.json`
+
+## PHP Implementation Changes
+
+No tracked PHP implementation files changed since the previous sync.

profy_filter-0.1.0a1/profy/__init__.py

@@ -0,0 +1,23 @@
+"""Profy: a Python profanity filter forked from Blaspsoft/blasp."""
+
+from .core import (
+    Match,
+    ProfanityFilter,
+    Severity,
+    ShieldResult,
+    check_text,
+    clean_text,
+    filter_text,
+)
+
+__all__ = [
+    "Match",
+    "ProfanityFilter",
+    "Severity",
+    "ShieldResult",
+    "check_text",
+    "clean_text",
+    "filter_text",
+]
+
+__version__ = "0.1.0a1"