1.1.0: matrix-nio 0.26.0 support, interactive cache mode, globals refactor, getpass, reset command, msgtype fix, tests and ci

Author: berkaygediz

.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release Check
+
+on:
+  push:
+    tags:
+      - "[0-9]+.[0-9]+.[0-9]+"
+
+jobs:
+  test-and-lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Run Ruff (Linting)
+        run: uv run ruff check .
+
+      - name: Run Tests
+        run: uv run pytest

README.md

@@ -1,8 +1,6 @@
 # LocalModeration for Matrix
 
-A CLI tool for bulk message deletion, media cleanup, and sticker purge in Matrix rooms.
-
-> **Note:** This tool targets **public (unencrypted) rooms**. Encrypted messages are skipped automatically.
+A CLI tool for bulk message deletion, media cleanup, and sticker purge in public (unencrypted) Matrix rooms. Encrypted messages are skipped automatically.
 
 ## Installation
 
@@ -25,6 +23,7 @@ uv tool install localmoderationmatrix
 ## Session
 
 Once logged in, your session is saved in your home directory. Just enter your **User ID** on the next run to auto-login.
+If you need to clear the saved session, type `reset` as your User ID.
 
 ## Usage
 
@@ -39,6 +38,7 @@ localmoderationmatrix <room_id> [options]
 | `room_id` | (Required) The Matrix room ID. |
 | `--search` | Search for a single keyword. |
 | `--file` | Search using a wordlist file (one word per line). |
+| `--interactive` | Scan room once and enter Interactive Hub mode. |
 | `--purge-media` | Delete media older than X days (`0` for all). |
 | `--purge-sticker` | Delete stickers older than X days (`0` for all). |
 | `--log-room` | Room ID to send moderation logs. |
@@ -52,7 +52,7 @@ localmoderationmatrix <room_id> [options]
 * `y` : Delete.
 * `n` : Skip.
 * `a` : **Delete All** remaining items automatically.
-* `q` : Quit.
+* `q` : Quit current review (returns to menu in Interactive Mode).
 
 ## Examples
 
@@ -74,16 +74,10 @@ localmoderationmatrix "!roomID:matrix.org" --file words.txt --days 7 --log-room
 localmoderationmatrix "!roomID:matrix.org" --purge-media 90
 ```
 
-**Delete ALL stickers:**
-
-```bash
-localmoderationmatrix "!roomID:matrix.org" --purge-sticker 0
-```
-
-**Custom time filter:**
+**Interactive Mode (Scan once, filter instantly):**
 
 ```bash
-localmoderationmatrix "!roomID:matrix.org" --search "test" --days 3 --hours 12
+localmoderationmatrix "!roomID:matrix.org" --interactive --days 7
 ```
 
 ## Building from Source
@@ -97,7 +91,7 @@ uv build
 **Standalone Executable:**
 
 ```bash
-pyinstaller --onefile --name LocalModerationMatrix --clean --noconfirm --optimize 2 src/localmoderationmatrix/cli.py
+pyinstaller --onefile --name LocalModerationMatrix --clean --noconfirm --optimize 2 --collect-all localmoderationmatrix src/localmoderationmatrix/cli.py
 ```
 
 ## License

pyproject.toml

@@ -1,23 +1,50 @@
 [project]
 name = "localmoderationmatrix"
-version = "1.0.2"
-description = "CLI moderation tool for bulk message deletion and media cleanup in public Matrix rooms."
+version = "1.1.0"
+description = "A CLI tool for bulk message deletion, media cleanup, and sticker purge in public Matrix rooms."
 readme = "README.md"
 license = { text = "Apache-2.0" }
-requires-python = ">=3.13"
-keywords = ["matrix", "moderation", "cli", "purge", "bulk-delete", "sticker", "media-cleanup", "matrix-org"]
+requires-python = ">=3.11"
+authors = [{ name = "Berkay Gediz" }]
+keywords = [
+    "matrix",
+    "matrix-org",
+    "moderation",
+    "cli",
+    "bulk-delete",
+    "purge",
+    "media-cleanup",
+    "sticker",
+    "chat-moderation",
+    "synapse",
+    "matrix-bot",
+    "community-management",
+]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Environment :: Console",
     "Intended Audience :: System Administrators",
+    "Intended Audience :: Telecommunications Industry",
     "License :: OSI Approved :: Apache Software License",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3 :: Only",
     "Topic :: Communications :: Chat",
     "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
 ]
-dependencies = [
-    "matrix-nio>=0.25.2",
-]
+dependencies = ["matrix-nio>=0.26.0"]
+
+[project.urls]
+Homepage = "https://github.com/berkaygediz/LocalModerationMatrix"
+Repository = "https://github.com/berkaygediz/LocalModerationMatrix"
+Issues = "https://github.com/berkaygediz/LocalModerationMatrix/issues"
+Changelog = "https://github.com/berkaygediz/LocalModerationMatrix/releases"
 
 [project.scripts]
 localmoderationmatrix = "localmoderationmatrix.cli:main"
@@ -30,6 +57,4 @@ build-backend = "hatchling.build"
 packages = ["src/localmoderationmatrix"]
 
 [dependency-groups]
-dev = [
-    "pyinstaller>=6.20.0",
-]
+dev = ["pyinstaller>=6.21.0", "pytest>=9.1.1"]

requirements.txt

@@ -1 +1 @@
-matrix-nio>=0.25.2
+matrix-nio>=0.26.0

src/localmoderationmatrix/__init__.py

@@ -1,3 +1,3 @@
 """LocalModeration for Matrix - CLI moderation tool for bulk message deletion and media cleanup in public Matrix rooms."""
 
-__version__ = "1.0.2"
+__version__ = "1.1.0"