Merge branch 'master' of https://github.com/7pvd/ffpm

# Conflicts:
#	ffpm.py

Author: tansautn

.gitignore

@@ -0,0 +1,3 @@
+__pycache__
+build
+dist

README.md

@@ -0,0 +1,76 @@
+<a href="http://zuko.pro/">
+    <img src="https://avatars0.githubusercontent.com/u/6666271?v=3&s=96" alt="Z-Logo"
+         title="Halu Universe" align="right" />
+</a>
+# ffpm
+
+# :fire: FFPM — Firefox Profile Manager :fire:
+
+Simple Firefox Profile Manager, including Import/Export  
+**Special Feature:** Monitor directory changes before/after actions.
+
+## Description
+
+**ffpm** is a Python-based tool for managing Firefox profiles. It allows you to import/export profiles and monitor directory changes before or after running actions—ideal for troubleshooting, backups, and tracking modifications.
+
+## Features
+
+- List Firefox profiles
+- Import and export profiles
+- Monitor directory changes before/after actions
+- Simple command-line interface
+
+## Installation & Usage
+
+### Recommended: Use Pre-Built Binaries
+
+For most users, download the latest pre-built binary from the [Releases page](https://github.com/7pvd/ffpm/releases).  
+No Python setup is required—just download and run the binary appropriate for your platform.
+Built binaries was tested and confirmed working on Windows 10 & Debian 11.
+
+### Development: Run from Source
+
+For development or testing only:
+
+```bash
+git clone https://github.com/7pvd/ffpm.git
+cd ffpm
+pip install typer watchdog nuitka
+python ffpm.py [OPTIONS]
+```
+
+## Example Commands
+
+- List profiles:
+  ```bash
+  ffpm list
+  ```
+- Export a profile:
+  ```bash
+  ffpm export --profile <profile_name> --output <output_path>
+  ```
+- Import a profile:
+  ```bash
+  ffpm import --input <input_path> --name <name>
+  ```
+- Monitor directory changes:
+  ```bash
+  ffpm monitor --dir <directory_path>
+  ```
+
+## Requirements (for development)
+
+- Python 3.x
+- [See requirements.txt for dependencies]
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## License
+
+GPL v3
+
+## Acknowledgements
+
+Inspired by the need for easy Firefox profile management and monitoring.

ffpm.py

@@ -18,7 +18,6 @@
 along with this program. If not, see <https://www.gnu.org/licenses/>.
 """
 
-
 #              M""""""""`M            dP
 #              Mmmmmm   .M            88
 #              MMMMP  .MMM  dP    dP  88  .dP   .d8888b.
@@ -34,6 +33,9 @@
 #              * * * * * * * * * * * * * * * * * * * * *
 import subprocess
 import sys
+from functools import cache
+
+from typing_extensions import Annotated
 
 DEPS = ['typer[all]', None, None, 'watchdog']  # None cuz its built-in
 DEP_CHECK_NAMES = ['typer', 'zipfile', 'shutil', 'watchdog']
@@ -60,6 +62,7 @@ def ensure_deps():
 
 import signal
 from datetime import datetime
+import typeguard
 from watchdog.observers import Observer
 from watchdog.events import FileSystemEventHandler
 
@@ -68,7 +71,7 @@ def ensure_deps():
 FIREFOX_DIR = Path.home() / ".mozilla" / "firefox"  # Linux/macOS
 PROFILES_INI = FIREFOX_DIR / "profiles.ini"
 BACKUP_DIR = Path.home() / "firefox-profile-backups"
-
+typeguard.install_import_hook('ffpm')
 
 def get_profile_path(profile_name_or_path: str) -> Path:
     path = Path(profile_name_or_path).expanduser().resolve()
@@ -333,18 +336,48 @@ def _ensureBakDir():
         typer.echo(f"❌ Backup directory '{BACKUP_DIR}' is not a directory.")
         raise typer.Exit(1)
 
+
+def _logo(_):
+    print("""
+             M\"\"\"\"\"\"\"\"`M            dP
+             Mmmmmm   .M            88
+             MMMMP  .MMM  dP    dP  88  .dP   .d8888b.
+             MMP  .MMMMM  88    88  88888"    88'  `88
+             M' .MMMMMMM  88.  .88  88  `8b.  88.  .88
+             M         M  `88888P'  dP   `YP  `88888P'
+             MMMMMMMMMMM    -*-  Created by Zuko  -*-
+
+             * * * * * * * * * * * * * * * * * * * * *
+             * -    - -   F.R.E.E.M.I.N.D   - -    - *
+             * -  Copyright © 2025 (Z) Programing  - *
+             *    -  -  All Rights Reserved  -  -    *
+             * * * * * * * * * * * * * * * * * * * * *
+    """)
+
 @app.command()
 def list():
+    """List available installed profiles"""
     profiles = get_profiles()
+    from rich.table import Table
+    from rich.console import Console
+    table = Table("Name", "Path")
+    console = Console()
     for name, path in profiles.items():
-        typer.echo(f"{name}: {path}")
+        table.add_row(name, str(path))
+    console.print(table)
 
 
 @app.command(name="export")
 def export_profile(
     name: str,
     output: Path = typer.Option(None, "--output", "-o", help="Output zip file (optional)")
 ):
+    """
+    Export a Firefox profile to a zip file
+    Args:
+        name: profile name
+        output: output path, if omitted. It will be {name}.zip, located in ~/firefox-profile-backups
+    """
     useDefaultDir = True
     if not output:
         output = name
@@ -359,6 +392,8 @@ def export_profile(
     if not path or not path.exists():
         typer.echo(f"❌ Profile '{name}' visible in 'profiles.ini' but not found in file system.")
         raise typer.Exit(1)
+    if output.exists():
+        typer.confirm(f"Output file {str(output)} exists. Overwrite?", abort=True)
     with zipfile.ZipFile(output, 'w', zipfile.ZIP_DEFLATED) as zipf:
         for root, _, files in os.walk(path):
             for file in files:
@@ -382,6 +417,12 @@ def import_profile(
     if not zip_path.exists() and not str(zip_path).endswith(".zip"):
         zip_path = zip_path.with_suffix(".zip")
     isRelative = not (str(zip_path).count('/') == 0) or (str(zip_path).count('\\') == 0)
+    """
+    Import a zip file to a Firefox profile
+    Args:
+        zip_path: path to zip file
+        name: profile name
+    """
     if not zip_path.exists():
         if isRelative:
             candidates = [
@@ -425,6 +466,7 @@ def clean(name: str):
 
 
 def main():
+    # noinspection PyShadowingBuiltins
     exec = sys.executable
 
     if len(sys.argv) == 1:

pyproject.toml

@@ -4,9 +4,12 @@ description = "Simple Firefox profile manager, including import/export. Speciall
 license = {text = "GPLv3", file = "./LICENSE.txt"}
 version = "1.0.1"
 dependencies = [
-    "nuitka>=2.7.5",
     "typer[all]",
     "watchdog",
+    "typeguard"
+]
+optional-dependencies=[
+    "nuitka>=2.7.5",
 ]
 authors = [
     {name = "Zuko", email = "tansautn@gmail.com", github = "https://github.com/tansautn"}