tempspace-cli 1.0.0__py3-none-any.whl

cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

cli/tempspace.py

@@ -0,0 +1,137 @@
+import argparse
+import requests
+import os
+import sys
+import hashlib
+import multiprocessing
+from tqdm import tqdm
+from requests_toolbelt.multipart.encoder import MultipartEncoder, MultipartEncoderMonitor
+from rich.console import Console
+from rich.panel import Panel
+
+# Default configuration
+DEFAULT_SERVER_URL = "https://tempspace.fly.dev/"
+CHUNK_SIZE = 1024 * 1024  # 1MB
+
+def parse_time(time_str: str) -> int:
+    """
+    Parse a time string (e.g., '7d', '24h', '360') into an integer number of hours.
+    Returns the number of hours as an integer, or None if parsing fails.
+    """
+    time_str = time_str.lower().strip()
+    if time_str.endswith('d'):
+        try:
+            days = int(time_str[:-1])
+            return days * 24
+        except ValueError:
+            return None
+    elif time_str.endswith('h'):
+        try:
+            return int(time_str[:-1])
+        except ValueError:
+            return None
+    else:
+        try:
+            return int(time_str)
+        except ValueError:
+            return None
+
+def calculate_file_hash(filepath: str) -> str:
+    """Calculate the SHA256 hash of a file in chunks."""
+    sha256_hash = hashlib.sha256()
+    try:
+        with open(filepath, "rb") as f:
+            for byte_block in iter(lambda: f.read(CHUNK_SIZE), b""):
+                sha256_hash.update(byte_block)
+        return sha256_hash.hexdigest()
+    except IOError as e:
+        print(f"Error reading file for hashing: {e}", file=sys.stderr)
+        sys.exit(1)
+
+def main():
+    """Main function to handle argument parsing and file upload."""
+    console = Console()
+
+    parser = argparse.ArgumentParser(
+        description="Upload a file to Tempspace.",
+        formatter_class=argparse.RawTextHelpFormatter
+    )
+
+    parser.add_argument("filepath", help="The path to the file you want to upload.")
+    parser.add_argument("-t", "--time", type=str, default='24', help="Set the file's expiration time. Examples: '24h', '7d', '360' (hours).\nDefault: '24' (24 hours).")
+    parser.add_argument("-p", "--password", type=str, help="Protect the file with a password.")
+    parser.add_argument("--one-time", action="store_true", help="The file will be deleted after the first download.")
+    parser.add_argument("--url", type=str, default=os.environ.get("TEMPSPACE_URL", DEFAULT_SERVER_URL), help=f"The URL of the Tempspace server.\nCan also be set with the TEMPSPACE_URL environment variable.\nDefault: {DEFAULT_SERVER_URL}")
+
+    args = parser.parse_args()
+
+    # --- Validate Inputs ---
+    if not os.path.isfile(args.filepath):
+        console.print(f"[bold red]Error:[/] File not found at '{args.filepath}'")
+        sys.exit(1)
+
+    hours = parse_time(args.time)
+    if hours is None:
+        console.print(f"[bold red]Error:[/] Invalid time format '{args.time}'. Use formats like '24h', '7d', or '360'.")
+        sys.exit(1)
+
+    # --- Hashing ---
+    console.print("[cyan]Calculating file hash...[/]")
+    client_hash = calculate_file_hash(args.filepath)
+    console.print(f"  [cyan]- Hash:[/] {client_hash}")
+
+    # --- Prepare Upload ---
+    upload_url = f"{args.url.rstrip('/')}/upload"
+    filename = os.path.basename(args.filepath)
+    file_size = os.path.getsize(args.filepath)
+
+    fields = {
+        'hours': str(hours),
+        'one_time': str(args.one_time).lower(),
+        'client_hash': client_hash,
+        'file': (filename, open(args.filepath, 'rb'), 'application/octet-stream')
+    }
+    if args.password:
+        fields['password'] = args.password
+
+    encoder = MultipartEncoder(fields=fields)
+    response = None
+
+    try:
+        bar_format = "{desc}: {percentage:3.0f}%|{bar}| {n_fmt}/{total_fmt} [Speed: {rate_fmt}, ETA: {remaining}]"
+        with tqdm(total=encoder.len, unit='B', unit_scale=True, desc=f"Uploading {filename}", bar_format=bar_format) as pbar:
+            monitor = MultipartEncoderMonitor(encoder, lambda m: pbar.update(m.bytes_read - pbar.n))
+            response = requests.post(upload_url, data=monitor, headers={'Content-Type': monitor.content_type})
+
+    except FileNotFoundError:
+        console.print(f"[bold red]Error:[/] The file '{args.filepath}' was not found.")
+        sys.exit(1)
+    except requests.exceptions.RequestException as e:
+        console.print("\n[bold red]An error occurred while connecting to the server:[/]")
+        console.print(e)
+        sys.exit(1)
+    except Exception as e:
+        console.print(f"\n[bold red]An unexpected error occurred:[/] {e}")
+        sys.exit(1)
+    finally:
+        # Ensure the file handle is closed
+        if 'file' in fields and not fields['file'][1].closed:
+            fields['file'][1].close()
+
+    # --- Handle Response ---
+    if response is not None:
+        if response.status_code == 200:
+            console.print("\n[bold green]Upload successful![/]")
+            console.print(Panel(response.text.strip(), title="[bold cyan]Download Link[/]", border_style="green"))
+        else:
+            console.print(f"\n[bold red]Error:[/] Upload failed with status code {response.status_code}")
+            try:
+                error_details = response.json()
+                console.print(f"[red]Server message:[/] {error_details.get('detail', 'No details provided.')}")
+            except requests.exceptions.JSONDecodeError:
+                console.print(f"[red]Server response:\n[/]{response.text}")
+            sys.exit(1)
+
+if __name__ == "__main__":
+    multiprocessing.freeze_support()
+    main()

tempspace_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: tempspace-cli
+Version: 1.0.0
+Summary: A command-line tool for uploading files to Tempspace.
+Author-email: Tempspace <tempspace@example.com>
+License: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.31.0
+Requires-Dist: tqdm==4.66.1
+Requires-Dist: requests-toolbelt==1.0.0
+Requires-Dist: rich==13.7.1
+
+# 🚀 FileShare - Enhanced Terminal File Upload Service
+
+A modern, terminal-style file sharing service with password protection, rate limiting, and QR code generation.
+
+## 📦 Installation
+
+### Server
+
+To run the web server, you can clone the repository and run it locally.
+
+```bash
+# Clone the repository
+git clone <your-repo>
+cd fileshare
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Copy environment template
+cp .env.example .env
+
+# Edit .env and change admin credentials!
+nano .env
+
+# Run the server
+python main.py
+```
+
+### Command-Line Tool (CLI)
+
+To use the command-line tool, you can install it directly from PyPI.
+
+```bash
+pip install tempspace-cli
+```
+
+## ✨ Features
+
+### 🔒 Security
+- **Rate Limiting**: 10 uploads/hour, 100 downloads/hour per IP
+- **Password Protection**: Optional password-protected uploads
+- **Secure Admin Panel**: HTTP Basic Auth for debug endpoints
+- **File Deduplication**: Automatic duplicate detection (SHA256)
+- **One-Time Downloads**: Self-destructing links after first download
+
+### 🎨 UI/UX
+- **Modern Terminal Design**: Green-on-black terminal aesthetic
+- **Drag & Drop**: Intuitive file upload interface
+- **QR Code Generation**: Instant QR codes for mobile sharing
+- **Upload History**: Local storage of recent uploads (browser)
+- **Toast Notifications**: Non-intrusive feedback system
+- **Real-time Progress**: Upload progress with speed indicators
+- **Countdown Timer**: Shows time remaining until expiry
+- **Responsive Design**: Works on mobile, tablet, and desktop
+
+### 📦 File Management
+- **Large File Support**: Up to 4GB per file
+- **Image Previews**: Automatic preview for images
+- **Multiple Expiry Options**: 1, 3, 6, 12, or 24 hours
+- **Chunked Uploads**: Efficient streaming for large files
+- **Automatic Cleanup**: Background task removes expired files
+
+## 📖 Usage
+
+### Web Interface
+
+1. **Open** `http://localhost:8000` in your browser
+2. **Drag & drop** a file or click to browse
+3. **Configure** expiry time and optional password
+4. **Upload** and share the generated link
+5. **Scan QR code** for mobile access
+
+### CLI Usage
+
+Once installed, you can use the `tempspace` command.
+
+#### Basic Upload
+```bash
+tempspace /path/to/document.pdf -t 6h
+```
+
+#### Password Protected Upload
+```bash
+tempspace /path/to/secret.txt -t 12h -p "mypassword"
+```
+
+#### One-Time Download
+```bash
+tempspace /path/to/report.pdf --one-time
+```
+
+## 🔧 Configuration
+
+### Environment Variables
+
+Create a `.env` file for the server:
+
+```bash
+# Admin credentials (CHANGE THESE!)
+ADMIN_USER=admin
+ADMIN_PASS=your-secure-password-here
+
+# Optional: Custom limits
+RATE_LIMIT_UPLOADS=10
+RATE_LIMIT_DOWNLOADS=100
+```
+
+## 🛡️ Admin Endpoints
+
+Protected by HTTP Basic Auth (use credentials from `.env`).
+
+### View Statistics
+```bash
+curl -u admin:password http://localhost:8000/debug/stats
+```
+
+### Wipe All Files
+```bash
+curl -X POST -u admin:password http://localhost:8000/debug/wipe
+```
+
+⚠️ **Warning**: This deletes ALL uploaded files permanently!
+
+## 📝 License
+
+MIT License - Feel free to use and modify!
+
+## 🤝 Contributing
+
+Contributions welcome! Please:
+1. Fork the repository
+2. Create a feature branch
+3. Submit a pull request
+
+## 📧 Support
+
+For issues and questions, please open a GitHub issue.

tempspace_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+cli/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+cli/tempspace.py,sha256=3pu-xLDhzWoYxxrthzUM5lyCnTES0V7wzveVZY6gNow,5443
+tempspace_cli-1.0.0.dist-info/METADATA,sha256=IZ-40lW57UaEJw9N71K9DWaU65WXMYRq8WNbYrmJyD4,3754
+tempspace_cli-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tempspace_cli-1.0.0.dist-info/entry_points.txt,sha256=DBBYsRS-fK4MSA3-4lrSPyi6oyHxoJLCII7c793nPtw,49
+tempspace_cli-1.0.0.dist-info/top_level.txt,sha256=2ImG917oaVHlm0nP9oJE-Qrgs-fq_fGWgba2H1f8fpE,4
+tempspace_cli-1.0.0.dist-info/RECORD,,

tempspace_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

tempspace_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+tempspace = cli.tempspace:main

tempspace_cli-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cli