pyservx 1.0.4__tar.gz → 1.1.0__tar.gz

pyservx-1.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: pyservx
+Version: 1.1.0
+Summary: A simple Python server package for file sharing with a retro UI.
+Author-email: Subz3r0x01 <subz3r0x01@protonmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/pyservx
+Project-URL: Repository, https://github.com/yourusername/pyservx
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qrcode
+Dynamic: license-file
+
+# PyServeX
+
+A simple HTTP server for file sharing with a retro-styled web interface.
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install pyservx
+```
+
+Or use pipx for an isolated environment (recommended for Linux):
+
+```bash
+pipx install pyservx
+```
+
+Ensure you have Python 3.6 or higher installed.
+
+## Usage
+
+Run the server:
+
+```bash
+python3 run.py
+```
+
+- Follow the prompt to select a shared folder.
+- The server will start at `http://localhost:8088` and other network IPs.
+- Access the web interface to browse, download, or upload files.
+- Use `Ctrl+C` to stop the server.
+
+## Features
+
+- File and folder browsing with a retro "hacker" UI.
+- Download entire folders as ZIP files.
+- Upload files via the web interface.
+- Accessible via localhost (`127.0.0.1`) and network IPs.
+- **QR Code for Easy Access:** Scan a QR code in the terminal to quickly access the server from your mobile device on the same network.
+- **Real-time Progress Bars:** Enjoy real-time progress updates for both uploads and downloads, including ETA, transfer speed, and file size.
+- **Multiple File Uploads:** Upload multiple files simultaneously through the web interface.
+- **No File Size Restriction:** Upload files of any size without limitations.
+- **Enhanced Web Interface:**
+    - **Search Functionality:** Quickly find files with the new search bar.
+    - **File Sorting:** Sort files by name, size, or date for better organization.
+    - **Modern & Responsive UI:** A refreshed, responsive design for seamless use across all devices.
+- **Automated `robots.txt`:** A `robots.txt` file is automatically generated to prevent search engines from indexing your file server, enhancing privacy.
+- **Modular Codebase:** The `server.py` file has been refactored into smaller, more maintainable modules (`request_handler.py`, `html_generator.py`, `file_operations.py`).
+
+## Requirements
+
+- Python 3.6+
+- `qrcode` library (automatically installed with pip)
+
+## License
+
+MIT License

pyservx-1.1.0/README.md

@@ -0,0 +1,58 @@
+# PyServeX
+
+A simple HTTP server for file sharing with a retro-styled web interface.
+
+## Installation
+
+Install using pip:
+
+```bash
+pip install pyservx
+```
+
+Or use pipx for an isolated environment (recommended for Linux):
+
+```bash
+pipx install pyservx
+```
+
+Ensure you have Python 3.6 or higher installed.
+
+## Usage
+
+Run the server:
+
+```bash
+python3 run.py
+```
+
+- Follow the prompt to select a shared folder.
+- The server will start at `http://localhost:8088` and other network IPs.
+- Access the web interface to browse, download, or upload files.
+- Use `Ctrl+C` to stop the server.
+
+## Features
+
+- File and folder browsing with a retro "hacker" UI.
+- Download entire folders as ZIP files.
+- Upload files via the web interface.
+- Accessible via localhost (`127.0.0.1`) and network IPs.
+- **QR Code for Easy Access:** Scan a QR code in the terminal to quickly access the server from your mobile device on the same network.
+- **Real-time Progress Bars:** Enjoy real-time progress updates for both uploads and downloads, including ETA, transfer speed, and file size.
+- **Multiple File Uploads:** Upload multiple files simultaneously through the web interface.
+- **No File Size Restriction:** Upload files of any size without limitations.
+- **Enhanced Web Interface:**
+    - **Search Functionality:** Quickly find files with the new search bar.
+    - **File Sorting:** Sort files by name, size, or date for better organization.
+    - **Modern & Responsive UI:** A refreshed, responsive design for seamless use across all devices.
+- **Automated `robots.txt`:** A `robots.txt` file is automatically generated to prevent search engines from indexing your file server, enhancing privacy.
+- **Modular Codebase:** The `server.py` file has been refactored into smaller, more maintainable modules (`request_handler.py`, `html_generator.py`, `file_operations.py`).
+
+## Requirements
+
+- Python 3.6+
+- `qrcode` library (automatically installed with pip)
+
+## License
+
+MIT License

{pyservx-1.0.4 → pyservx-1.1.0}/pyproject.toml

@@ -1,26 +1,32 @@
-[project]
-name = "pyservx"
-version = "1.0.4"  # Increment to avoid conflict with 1.0.3
-description = "A simple Python server package"
-readme = "README.md"
-requires-python = ">=3.6"
-license = { file = "LICENSE" }
-authors = [
-    { name = "Your Name", email = "your.email@example.com" }
-]
-classifiers = [
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: MIT License",
-    "Operating System :: OS Independent",
-]
-
-[build-system]
-requires = ["setuptools>=61.0", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project.urls]
-Homepage = "https://github.com/yourusername/pyservx"
-Repository = "https://github.com/yourusername/pyservx"
-
-[project.scripts]
+[project]
+name = "pyservx"
+version = "1.1.0"
+description = "A simple Python server package for file sharing with a retro UI."
+readme = "README.md"
+requires-python = ">=3.6"
+license = "MIT"
+authors = [
+    { name = "Subz3r0x01", email = "subz3r0x01@protonmail.com" }
+]
+dependencies = [
+    "qrcode"
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    
+    "Operating System :: OS Independent",
+]
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages]
+find = { include = ["pyservx*"] }
+
+[project.urls]
+Homepage = "https://github.com/yourusername/pyservx"
+Repository = "https://github.com/yourusername/pyservx"
+
+[project.scripts]
 pyservx = "pyservx.server:main"

pyservx-1.1.0/pyservx/file_operations.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+
+import os
+import zipfile
+from io import BytesIO
+
+def format_size(size):
+    if size < 1024:
+        return f"{size} B"
+    elif size < 1024**2:
+        return f"{size / 1024:.2f} KB"
+    elif size < 1024**3:
+        return f"{size / (1024**2):.2f} MB"
+    else:
+        return f"{size / (1024**3):.2f} GB"
+
+def zip_folder(folder_path):
+    memory_file = BytesIO()
+    with zipfile.ZipFile(memory_file, 'w', zipfile.ZIP_DEFLATED) as zipf:
+        for root, _, files in os.walk(folder_path):
+            for file in files:
+                abs_path = os.path.join(root, file)
+                rel_path = os.path.relpath(abs_path, folder_path)
+                zipf.write(abs_path, rel_path)
+    memory_file.seek(0)
+    return memory_file
+
+def write_file_in_chunks(file_path, file_content, progress_callback=None):
+    total_size = len(file_content)
+    bytes_written = 0
+    chunk_size = 8192  # 8KB chunks
+
+    with open(file_path, 'wb') as f:
+        for i in range(0, total_size, chunk_size):
+            chunk = file_content[i:i + chunk_size]
+            f.write(chunk)
+            bytes_written += len(chunk)
+            if progress_callback:
+                progress_callback(bytes_written, total_size)
+
+def read_file_in_chunks(file_path, chunk_size=8192, progress_callback=None):
+    file_size = os.path.getsize(file_path)
+    bytes_read = 0
+    with open(file_path, 'rb') as f:
+        while True:
+            chunk = f.read(chunk_size)
+            if not chunk:
+                break
+            bytes_read += len(chunk)
+            if progress_callback:
+                progress_callback(bytes_read, file_size)
+            yield chunk

pyservx-1.1.0/pyservx/html_generator.py

@@ -0,0 +1,443 @@
+#!/usr/bin/env python3
+
+import html
+import os
+import urllib.parse
+import datetime
+
+def format_size(size):
+    if size < 1024:
+        return f"{size} B"
+    elif size < 1024**2:
+        return f"{size / 1024:.2f} KB"
+    elif size < 1024**3:
+        return f"{size / (1024**2):.2f} MB"
+    else:
+        return f"{size / (1024**3):.2f} GB"
+
+def list_directory_page(handler, path):
+    try:
+        entries = os.listdir(path)
+    except OSError:
+        handler.send_error(404, "Cannot list directory")
+        return None
+
+    query_params = urllib.parse.parse_qs(urllib.parse.urlparse(handler.path).query)
+    search_query = query_params.get('q', [''])[0]
+    sort_by = query_params.get('sort', ['name'])[0]
+    sort_order = query_params.get('order', ['asc'])[0]
+
+    if search_query:
+        entries = [e for e in entries if search_query.lower() in e.lower()]
+
+    def sort_key(item):
+        item_path = os.path.join(path, item)
+        if os.path.isdir(item_path):
+            return (0, item.lower()) # Directories first
+        if sort_by == 'size':
+            return (1, os.path.getsize(item_path))
+        elif sort_by == 'date':
+            return (1, os.path.getmtime(item_path))
+        else:
+            return (1, item.lower())
+
+    entries.sort(key=sort_key, reverse=sort_order == 'desc')
+    
+    displaypath = html.escape(urllib.parse.unquote(handler.path))
+
+    # Build list items for directories and files
+    list_rows = []
+    # Parent directory link if not root
+    if handler.path != '/':
+        parent = os.path.dirname(handler.path.rstrip('/'))
+        if not parent.endswith('/'):
+            parent += '/'
+        list_rows.append(f"""
+            <tr class="hover:bg-green-900/20">
+                <td class="py-2 px-4 border-b border-green-700/50"><a href="{html.escape(parent)}" class="text-neon block">.. (Parent Directory)</a></td>
+                <td class="py-2 px-4 border-b border-green-700/50 text-right">-</td>
+                <td class="py-2 px-4 border-b border-green-700/50 text-right">-</td>
+            </tr>
+        """)
+
+    for name in entries:
+        fullpath = os.path.join(path, name)
+        displayname = name + '/' if os.path.isdir(fullpath) else name
+        href = urllib.parse.quote(name)
+        if os.path.isdir(fullpath):
+            href += '/'
+        
+        size = "-"
+        date_modified = "-"
+        if os.path.isfile(fullpath):
+            size = format_size(os.path.getsize(fullpath))
+            date_modified = datetime.datetime.fromtimestamp(os.path.getmtime(fullpath)).strftime('%Y-%m-%d %H:%M:%S')
+
+        # Add download folder zip link for directories
+        if os.path.isdir(fullpath):
+            list_rows.append(
+                f"""
+                <tr class="hover:bg-green-900/20">
+                    <td class="py-2 px-4 border-b border-green-700/50">
+                        <a href="{href}" class="text-neon block">{html.escape(displayname)}</a>
+                    </td>
+                    <td class="py-2 px-4 border-b border-green-700/50 text-right">{size}</td>
+                    <td class="py-2 px-4 border-b border-green-700/50 text-right">{date_modified}</td>
+                </tr>
+                <tr class="hover:bg-green-900/20">
+                    <td class="py-2 px-4 border-b border-green-700/50" colspan="3">
+                        <a href="{href}download_folder" class="text-neon block">📦 Zip Download</a>
+                    </td>
+                </tr>
+                """
+            )
+        else:
+            list_rows.append(f"""
+                <tr class="hover:bg-green-900/20">
+                    <td class="py-2 px-4 border-b border-green-700/50"><a href="{href}" class="text-neon block">{html.escape(displayname)}</a></td>
+                    <td class="py-2 px-4 border-b border-green-700/50 text-right">{size}</td>
+                    <td class="py-2 px-4 border-b border-green-700/50 text-right">{date_modified}</td>
+                </tr>
+            """)
+
+    list_html = '\n'.join(list_rows)
+
+    return f"""<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>PyServeX - Index of {displaypath}</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <style>
+        @import url('https://fonts.googleapis.com/css2?family=VT323&display=swap');
+
+        body {{
+            font-family: 'VT323', monospace;
+            background: #000000;
+            min-height: 100vh;
+            margin: 0;
+            overflow-x: hidden;
+        }}
+
+        .text-neon {{
+            color: #00ff00;
+        }}
+
+        .typewriter h1 {{
+            overflow: hidden;
+            white-space: nowrap;
+            animation: typing 3s steps(40, end), blink-caret 0.5s step-end infinite;
+            margin: 0 auto;
+            text-align: center;
+        }}
+
+        @keyframes typing {{
+            from {{ width: 0; }}
+            to {{ width: 100%; }}
+        }}
+
+        @keyframes blink-caret {{
+            from, to {{ border-right: 2px solid #00ff00; }}
+            50% {{ border-right: 2px solid transparent; }}
+        }}
+
+        .glitch {{
+            position: relative;
+            animation: glitch 2s infinite;
+        }}
+
+        @keyframes glitch {{
+            0% {{ transform: translate(0); }}
+            10% {{ transform: translate(-2px, 2px); }}
+            20% {{ transform: translate(2px, -2px); }}
+            30% {{ transform: translate(-2px, 2px); }}
+            40% {{ transform: translate(0); }}
+            100% {{ transform: translate(0); }}
+        }}
+
+        .scanline {{
+            position: absolute;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 100%;
+            background: linear-gradient(
+                to bottom,
+                rgba(255, 255, 255, 0),
+                rgba(255, 255, 255, 0.1) 50%,
+                rgba(255, 255, 255, 0)
+            );
+            animation: scan 4s linear infinite;
+            pointer-events: none;
+        }}
+
+        @keyframes scan {{
+            0% {{ transform: translateY(-100%); }}
+            100% {{ transform: translateY(100%); }}
+        }}
+
+        .particle {{
+            position: absolute;
+            width: 3px;
+            height: 3px;
+            background: #00ff00;
+            opacity: 0.5;
+            animation: flicker 3s infinite;
+        }}
+
+        @keyframes flicker {{
+            0% {{ opacity: 0.5; }}
+            50% {{ opacity: 0.1; }}
+            100% {{ opacity: 0.5; }}
+        }}
+
+        main {{
+            margin-top: 100px; /* Adjust based on header height */
+            padding: 2rem;
+            color: #00ff00;
+            text-align: left;
+            max-width: 900px;
+            margin-left: auto;
+            margin-right: auto;
+        }}
+
+        ul {{
+            list-style-type: none;
+            padding-left: 0;
+        }}
+
+        li {{
+            margin-bottom: 0.7rem;
+            font-size: 1.2rem;
+        }}
+
+        a {{
+            text-decoration: none;
+        }}
+
+        a:hover {{
+            text-decoration: underline;
+        }}
+
+        .upload-form, .search-form {{
+            margin-top: 1.5rem;
+            padding: 1rem;
+            border: 1px solid #00ff00;
+            border-radius: 5px;
+        }}
+
+        .upload-form label, .search-form label {{
+            display: block;
+            margin-bottom: 0.5rem;
+        }}
+
+        .upload-form input[type="file"], .search-form input[type="text"] {{
+            color: #00ff00;
+            background: #000000;
+            border: 1px solid #00ff00;
+            padding: 0.5rem;
+        }}
+
+        .upload-form button, .search-form button {{
+            background: #00ff00;
+            color: #000000;
+            padding: 0.5rem 1rem;
+            border: none;
+            cursor: pointer;
+            font-family: 'VT323', monospace;
+            font-size: 1.2rem;
+        }}
+
+        .upload-form button:hover, .search-form button:hover {{
+            background: #00cc00;
+        }}
+
+        table {{
+            width: 100%;
+            border-collapse: collapse;
+            margin-top: 1.5rem;
+        }}
+
+        th, td {{
+            text-align: left;
+            padding: 0.75rem;
+            border-bottom: 1px solid rgba(0, 255, 0, 0.3);
+        }}
+
+        th {{
+            background-color: rgba(0, 255, 0, 0.1);
+            color: #00ff00;
+            font-weight: normal;
+            cursor: pointer;
+        }}
+
+        th:hover {{
+            background-color: rgba(0, 255, 0, 0.2);
+        }}
+
+        tr:nth-child(even) {{
+            background-color: rgba(0, 255, 0, 0.05);
+        }}
+
+        /* Progress bar and popup styles */
+        #progressBarContainer {{
+            display: none;
+            margin-top: 1rem;
+            background-color: #333;
+            border: 1px solid #00ff00;
+            padding: 0.5rem;
+            border-radius: 5px;
+        }}
+
+        #progressBar {{
+            width: 0%;
+            height: 20px;
+            background-color: #00ff00;
+            text-align: center;
+            line-height: 20px;
+            color: #000;
+            font-size: 0.8rem;
+        }}
+
+        #progressText {{
+            color: #00ff00;
+            margin-top: 0.5rem;
+            font-size: 0.9rem;
+        }}
+
+        #successPopup {{
+            display: none;
+            position: fixed;
+            top: 20px;
+            left: 50%;
+            transform: translateX(-50%);
+            background-color: #00ff00;
+            color: #000;
+            padding: 1rem 2rem;
+            border-radius: 5px;
+            font-size: 1.2rem;
+            z-index: 1000;
+            box-shadow: 0 0 10px rgba(0, 255, 0, 0.5);
+        }}
+    </style>
+</head>
+<body>
+    <div class="scanline"></div>
+    <header>
+        <div class="text-center">
+            <h1 class="text-4xl md:text-6xl text-neon typewriter glitch">PyServeX</h1>
+        </div>
+    </header>
+    <main>
+        <h2 class="text-3xl mb-4 text-neon">Index of {displaypath}</h2>
+        <div class="search-form mb-6 p-4 border border-green-700/50 rounded-lg">
+            <form action="{html.escape(handler.path)}" method="GET" class="flex flex-col sm:flex-row items-center space-y-2 sm:space-y-0 sm:space-x-2">
+                <input type="text" name="q" placeholder="Search files..." value="{html.escape(search_query)}" class="flex-grow p-2 bg-black text-neon border border-green-700/50 rounded-md focus:outline-none focus:ring-1 focus:ring-green-500">
+                <button type="submit" class="bg-green-500 text-black py-2 px-4 rounded-md hover:bg-green-600 transition-colors duration-200">Search</button>
+            </form>
+        </div>
+        <div class="overflow-x-auto">
+            <table class="min-w-full bg-black border border-green-700/50 rounded-lg">
+                <thead>
+                    <tr>
+                        <th class="py-3 px-4 border-b border-green-700/50 text-left text-neon">
+                            <a href="?sort=name&order={{'desc' if sort_by == 'name' and sort_order == 'asc' else 'asc'}}" class="block">Name</a>
+                        </th>
+                        <th class="py-3 px-4 border-b border-green-700/50 text-right text-neon">
+                            <a href="?sort=size&order={{'desc' if sort_by == 'size' and sort_order == 'asc' else 'asc'}}" class="block">Size</a>
+                        </th>
+                        <th class="py-3 px-4 border-b border-green-700/50 text-right text-neon">
+                            <a href="?sort=date&order={{'desc' if sort_by == 'date' and sort_order == 'asc' else 'asc'}}" class="block">Date Modified</a>
+                        </th>
+                    </tr>
+                </thead>
+                <tbody>
+                    {list_html}
+                </tbody>
+            </table>
+        </div>
+        <div class="upload-form mt-6 p-4 border border-green-700/50 rounded-lg">
+            <form id="uploadForm" action="{html.escape(handler.path)}upload" method="POST" enctype="multipart/form-data" class="flex flex-col sm:flex-row items-center space-y-2 sm:space-y-0 sm:space-x-2">
+                <label for="file-upload" class="text-neon">Upload files:</label>
+                <input type="file" id="file-upload" name="file" multiple class="flex-grow p-2 bg-black text-neon border border-green-700/50 rounded-md focus:outline-none focus:ring-1 focus:ring-green-500" />
+                <button type="submit" class="bg-green-500 text-black py-2 px-4 rounded-md hover:bg-green-600 transition-colors duration-200">Upload</button>
+            </form>
+            <div id="progressBarContainer">
+                <div id="progressBar"></div>
+                <div id="progressText"></div>
+            </div>
+        </div>
+    </main>
+
+    <div id="successPopup"></div>
+
+    <script>
+        // Generate random particles for hacker effect
+        function createParticles() {{
+            const numParticles = 30;
+            for (let i = 0; i < numParticles; i++) {{
+                const particle = document.createElement('div');
+                particle.classList.add('particle');
+                particle.style.left = `${{Math.random() * 100}}vw`;
+                particle.style.top = `${{Math.random() * 100}}vh`;
+                particle.style.animationDelay = `${{Math.random() * 3}}s`;
+                document.body.appendChild(particle);
+            }}
+        }}
+
+        // Handle file uploads with progress bar
+        document.getElementById('uploadForm').addEventListener('submit', function(e) {{
+            e.preventDefault();
+
+            const formData = new FormData(this);
+            const xhr = new XMLHttpRequest();
+
+            const progressBarContainer = document.getElementById('progressBarContainer');
+            const progressBar = document.getElementById('progressBar');
+            const progressText = document.getElementById('progressText');
+            const successPopup = document.getElementById('successPopup');
+
+            progressBarContainer.style.display = 'block';
+            progressBar.style.width = '0%';
+            progressText.textContent = 'Uploading...';
+
+            xhr.upload.addEventListener('progress', function(event) {{
+                if (event.lengthComputable) {{
+                    const percent = (event.loaded / event.total) * 100;
+                    progressBar.style.width = percent.toFixed(2) + '%';
+                    progressText.textContent = `Uploading: ${{percent.toFixed(2)}}%`;
+                }}
+            }});
+
+            xhr.addEventListener('load', function() {{
+                progressBarContainer.style.display = 'none';
+                if (xhr.status === 200) {{
+                    const response = JSON.parse(xhr.responseText);
+                    successPopup.textContent = response.message;
+                    successPopup.style.display = 'block';
+                    setTimeout(() => {{
+                        successPopup.style.display = 'none';
+                        window.location.reload(); // Reload page to show new files
+                    }}, 2000);
+                }} else {{
+                    progressText.textContent = 'Upload failed!';
+                    alert('Upload failed: ' + xhr.statusText);
+                }}
+            }});
+
+            xhr.addEventListener('error', function() {{
+                progressBarContainer.style.display = 'none';
+                progressText.textContent = 'Upload failed!';
+                alert('Upload failed due to a network error.');
+            }});
+
+            xhr.open('POST', this.action);
+            xhr.send(formData);
+        }});
+
+        window.onload = createParticles;
+    </script>
+</body>
+</html>
+"""