filefy 1.0.0__tar.gz

filefy-1.0.0/LICENSE

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

filefy-1.0.0/MANIFEST.in

@@ -0,0 +1,13 @@
+include LICENSE
+include README.md
+include pyproject.toml
+
+recursive-include filefy/templates *
+recursive-include filefy/static *
+
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.so
+global-exclude .DS_Store
+global-exclude .git*
+global-exclude *.egg-info

filefy-1.0.0/PKG-INFO

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: filefy
+Version: 1.0.0
+Summary: A professional web-based file manager with dark theme UI
+Home-page: https://github.com/Pymmdrza/filefy
+Author: Mmdrza
+Author-email: Mmdrza <pymmdrza@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/Pymmdrza/filefy
+Project-URL: Documentation, https://github.com/Pymmdrza/filefy#readme
+Project-URL: Repository, https://github.com/Pymmdrza/filefy.git
+Project-URL: Issues, https://github.com/Pymmdrza/filefy/issues
+Project-URL: Changelog, https://github.com/Pymmdrza/filefy/releases
+Keywords: file-manager,web-file-manager,flask,file-browser,remote-download,file-upload,dark-theme,file-explorer
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Flask
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Flask>=2.3.0
+Requires-Dist: Werkzeug>=2.3.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# filefy
+
+[![PyPI version](https://badge.fury.io/py/filefy.svg)](https://badge.fury.io/py/filefy)
+[![Python](https://img.shields.io/pypi/pyversions/filefy.svg)](https://pypi.org/project/filefy/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A **professional web-based file manager** written in Python with Flask. Features a beautiful dark theme UI, file upload/download, remote URL downloads with progress tracking, and comprehensive file operations.
+
+## Features
+
+- **Professional Dark Theme UI** - Modern, responsive design
+- **File Upload** - Drag & drop or click to upload files
+- **File Download** - Download files directly from the browser
+- **Remote Download** - Download files from URLs with progress tracking
+- **File Operations** - Copy, move, rename, delete files and folders
+- **Search** - Quick file search functionality
+- **Context Menu** - Right-click menu with common actions
+- **Keyboard Shortcuts** - Ctrl+C, Ctrl+V, F2, Del, F5
+- **File Preview** - Preview text files and images
+- **Disk Usage** - View disk space information
+
+## Quick Start
+
+### Install from PyPI (One Command!)
+
+```bash
+pip install filefy
+```
+
+### Run the File Manager
+
+```bash
+# Start with default settings (port 5000, home directory)
+filefy
+
+# Custom port
+filefy --port 8080
+
+# Custom directory
+filefy --dir /path/to/directory
+
+# Bind to specific host
+filefy --host 127.0.0.1 --port 3000
+
+# Enable debug mode
+filefy --debug
+```
+
+Then open your browser and go to: **http://localhost:5000**
+
+## Installation Methods
+
+### Method 1: pip (Recommended)
+
+```bash
+pip install filefy
+```
+
+### Method 2: From Source
+
+```bash
+git clone https://github.com/Pymmdrza/filefy.git
+cd filefy
+pip install -e .
+```
+
+### Method 3: Using pipx (Isolated Environment)
+
+```bash
+pipx install filefy
+```
+
+## CLI Usage
+
+```
+usage: filefy [-h] [-H HOST] [-p PORT] [-d DIR] [--debug] [-v]
+
+filefy - Professional Web-Based File Manager
+
+options:
+  -h, --help            show this help message and exit
+  -H, --host HOST       Host to bind the server to (default: 0.0.0.0)
+  -p, --port PORT       Port to run the server on (default: 5000)
+  -d, --dir DIR         Base directory for file management (default: home)
+  --debug               Enable Flask debug mode
+  -v, --version         show program's version number and exit
+
+Examples:
+  filefy                         Start with default settings
+  filefy -p 8080                 Use port 8080
+  filefy --host 127.0.0.1        Only allow local connections
+  filefy -d /home/user/files     Set base directory
+  filefy --debug                 Enable Flask debug mode
+```
+
+## Python API
+
+You can also use filefy programmatically:
+
+```python
+from filefy import app, create_app
+from filefy.server import run
+
+# Option 1: Run with default settings
+run()
+
+# Option 2: Run with custom settings
+run(host='127.0.0.1', port=8080, base_dir='/home/user/files')
+
+# Option 3: Get Flask app for custom deployment
+app = create_app(base_dir='/var/www/files')
+# Use with gunicorn, waitress, etc.
+```
+
+### Using with Gunicorn
+
+```bash
+pip install gunicorn
+gunicorn "filefy:create_app()" -b 0.0.0.0:8000 -w 4
+```
+
+### Using with Waitress (Windows)
+
+```bash
+pip install waitress
+waitress-serve --listen=0.0.0.0:8000 filefy:app
+```
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+C` | Copy selected item |
+| `Ctrl+X` | Cut selected item |
+| `Ctrl+V` | Paste item |
+| `F2` | Rename selected item |
+| `Delete` | Delete selected item |
+| `F5` | Refresh current directory |
+| `Escape` | Close modals / Deselect |
+
+## API Endpoints
+
+The following REST API endpoints are available:
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/browse` | List directory contents |
+| `POST` | `/api/upload` | Upload files |
+| `GET` | `/api/download` | Download a file |
+| `POST` | `/api/remote-download` | Start remote URL download |
+| `GET` | `/api/download-tasks` | Get download progress |
+| `POST` | `/api/copy` | Copy file/folder |
+| `POST` | `/api/move` | Move file/folder |
+| `POST` | `/api/delete` | Delete file/folder |
+| `POST` | `/api/rename` | Rename file/folder |
+| `POST` | `/api/create-folder` | Create new folder |
+| `GET` | `/api/search` | Search files |
+| `GET` | `/api/preview` | Preview file content |
+| `GET` | `/api/file-info` | Get file information |
+| `GET` | `/api/disk-usage` | Get disk usage stats |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/Pymmdrza/filefy.git
+cd filefy
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+---
+
+Made by [MMdrza](https://github.com/Pymmdrza)

filefy-1.0.0/README.md

@@ -0,0 +1,190 @@
+# filefy
+
+[![PyPI version](https://badge.fury.io/py/filefy.svg)](https://badge.fury.io/py/filefy)
+[![Python](https://img.shields.io/pypi/pyversions/filefy.svg)](https://pypi.org/project/filefy/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A **professional web-based file manager** written in Python with Flask. Features a beautiful dark theme UI, file upload/download, remote URL downloads with progress tracking, and comprehensive file operations.
+
+## Features
+
+- **Professional Dark Theme UI** - Modern, responsive design
+- **File Upload** - Drag & drop or click to upload files
+- **File Download** - Download files directly from the browser
+- **Remote Download** - Download files from URLs with progress tracking
+- **File Operations** - Copy, move, rename, delete files and folders
+- **Search** - Quick file search functionality
+- **Context Menu** - Right-click menu with common actions
+- **Keyboard Shortcuts** - Ctrl+C, Ctrl+V, F2, Del, F5
+- **File Preview** - Preview text files and images
+- **Disk Usage** - View disk space information
+
+## Quick Start
+
+### Install from PyPI (One Command!)
+
+```bash
+pip install filefy
+```
+
+### Run the File Manager
+
+```bash
+# Start with default settings (port 5000, home directory)
+filefy
+
+# Custom port
+filefy --port 8080
+
+# Custom directory
+filefy --dir /path/to/directory
+
+# Bind to specific host
+filefy --host 127.0.0.1 --port 3000
+
+# Enable debug mode
+filefy --debug
+```
+
+Then open your browser and go to: **http://localhost:5000**
+
+## Installation Methods
+
+### Method 1: pip (Recommended)
+
+```bash
+pip install filefy
+```
+
+### Method 2: From Source
+
+```bash
+git clone https://github.com/Pymmdrza/filefy.git
+cd filefy
+pip install -e .
+```
+
+### Method 3: Using pipx (Isolated Environment)
+
+```bash
+pipx install filefy
+```
+
+## CLI Usage
+
+```
+usage: filefy [-h] [-H HOST] [-p PORT] [-d DIR] [--debug] [-v]
+
+filefy - Professional Web-Based File Manager
+
+options:
+  -h, --help            show this help message and exit
+  -H, --host HOST       Host to bind the server to (default: 0.0.0.0)
+  -p, --port PORT       Port to run the server on (default: 5000)
+  -d, --dir DIR         Base directory for file management (default: home)
+  --debug               Enable Flask debug mode
+  -v, --version         show program's version number and exit
+
+Examples:
+  filefy                         Start with default settings
+  filefy -p 8080                 Use port 8080
+  filefy --host 127.0.0.1        Only allow local connections
+  filefy -d /home/user/files     Set base directory
+  filefy --debug                 Enable Flask debug mode
+```
+
+## Python API
+
+You can also use filefy programmatically:
+
+```python
+from filefy import app, create_app
+from filefy.server import run
+
+# Option 1: Run with default settings
+run()
+
+# Option 2: Run with custom settings
+run(host='127.0.0.1', port=8080, base_dir='/home/user/files')
+
+# Option 3: Get Flask app for custom deployment
+app = create_app(base_dir='/var/www/files')
+# Use with gunicorn, waitress, etc.
+```
+
+### Using with Gunicorn
+
+```bash
+pip install gunicorn
+gunicorn "filefy:create_app()" -b 0.0.0.0:8000 -w 4
+```
+
+### Using with Waitress (Windows)
+
+```bash
+pip install waitress
+waitress-serve --listen=0.0.0.0:8000 filefy:app
+```
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Ctrl+C` | Copy selected item |
+| `Ctrl+X` | Cut selected item |
+| `Ctrl+V` | Paste item |
+| `F2` | Rename selected item |
+| `Delete` | Delete selected item |
+| `F5` | Refresh current directory |
+| `Escape` | Close modals / Deselect |
+
+## API Endpoints
+
+The following REST API endpoints are available:
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/browse` | List directory contents |
+| `POST` | `/api/upload` | Upload files |
+| `GET` | `/api/download` | Download a file |
+| `POST` | `/api/remote-download` | Start remote URL download |
+| `GET` | `/api/download-tasks` | Get download progress |
+| `POST` | `/api/copy` | Copy file/folder |
+| `POST` | `/api/move` | Move file/folder |
+| `POST` | `/api/delete` | Delete file/folder |
+| `POST` | `/api/rename` | Rename file/folder |
+| `POST` | `/api/create-folder` | Create new folder |
+| `GET` | `/api/search` | Search files |
+| `GET` | `/api/preview` | Preview file content |
+| `GET` | `/api/file-info` | Get file information |
+| `GET` | `/api/disk-usage` | Get disk usage stats |
+
+## Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/Pymmdrza/filefy.git
+cd filefy
+python -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+pip install -e ".[dev]"
+```
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+---
+
+Made by [MMdrza](https://github.com/Pymmdrza)

filefy-1.0.0/filefy/__init__.py

@@ -0,0 +1,37 @@
+"""
+Filefy - A Professional Web-Based File Manager
+
+A powerful web-based file manager written in Python with Flask.
+Features include file upload/download, remote URL downloads with progress,
+copy, move, delete, rename operations, and a beautiful dark theme UI.
+
+Usage:
+    $ filefy              # Start with default settings
+    $ filefy --port 8080  # Start on port 8080
+    $ filefy --host 127.0.0.1 --port 3000  # Custom host and port
+"""
+
+import sys
+from pathlib import Path
+
+# Add parent directory to path for config imports
+BASE_DIR = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(BASE_DIR))
+
+# Try to get version from config
+try:
+    from config import get_details
+    _details = get_details()
+    __version__ = _details.version
+    __author__ = _details.programmer
+    __email__ = _details.email
+except ImportError:
+    __version__ = "1.0.0"
+    __author__ = "Mmdrza"
+    __email__ = "pymmdrza@gmail.com"
+
+__license__ = "MIT"
+
+from .server import app, create_app
+
+__all__ = ["app", "create_app", "__version__"]

filefy-1.0.0/filefy/__main__.py

@@ -0,0 +1,9 @@
+#!/usr/bin/env python3
+"""
+Allow running the package directly with: python -m filefy
+"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

filefy-1.0.0/filefy/cli.py

@@ -0,0 +1,106 @@
+#!/usr/bin/env python3
+"""
+Filer CLI - Command Line Interface
+
+Usage:
+    filefy                    # Start with defaults (port 5000, home directory)
+    filefy --port 8080        # Start on custom port
+    filefy --host 127.0.0.1   # Bind to specific host
+    filefy --dir /path/to/dir # Start with custom directory
+    filefy --debug            # Enable debug mode
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+# Add parent directory to path for config imports
+BASE_DIR = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(BASE_DIR))
+
+# Import configuration
+try:
+    from config import get_settings, get_details
+    CONFIG_AVAILABLE = True
+except ImportError:
+    CONFIG_AVAILABLE = False
+
+
+def main():
+    """Main entry point for the CLI"""
+    # Get defaults from config if available
+    if CONFIG_AVAILABLE:
+        settings = get_settings()
+        details = get_details()
+        default_host = settings.host
+        default_port = settings.port
+        default_dir = settings.root_directory
+        version = details.version
+    else:
+        default_host = "0.0.0.0"
+        default_port = 5000
+        default_dir = None
+        version = "1.0.0"
+
+    parser = argparse.ArgumentParser(
+        prog="filefy",
+        description="🗂️  Filefy - Professional Web-Based File Manager",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  filefy                         Start with default settings
+  filefy -p 8080                 Use port 8080
+  filefy --host 127.0.0.1        Only allow local connections
+  filefy -d /home/user/files     Set base directory
+  filefy --debug                 Enable Flask debug mode
+
+Visit https://github.com/Pymmdrza/filefy for more information.
+        """,
+    )
+
+    parser.add_argument(
+        "-H",
+        "--host",
+        type=str,
+        default=default_host,
+        help=f"Host to bind the server to (default: {default_host})",
+    )
+
+    parser.add_argument(
+        "-p",
+        "--port",
+        type=int,
+        default=default_port,
+        help=f"Port to run the server on (default: {default_port})",
+    )
+
+    parser.add_argument(
+        "-d",
+        "--dir",
+        "--directory",
+        type=str,
+        default=default_dir,
+        dest="directory",
+        help="Base directory for file management (default: home directory)",
+    )
+
+    parser.add_argument("--debug", action="store_true", help="Enable Flask debug mode")
+
+    parser.add_argument("-v", "--version", action="version", version=f"%(prog)s {version}")
+
+    args = parser.parse_args()
+
+    try:
+        from .server import run
+
+        run(host=args.host, port=args.port, debug=args.debug, base_dir=args.directory)
+    except KeyboardInterrupt:
+        print("\n\n👋 Filefy stopped. Goodbye!")
+        sys.exit(0)
+    except Exception as e:
+        print(f"\n❌ Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()