putplace-server 0.8.2__tar.gz

putplace_server-0.8.2/.gitignore

@@ -0,0 +1,97 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# uv
+.python-version
+uv.lock
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+coverage.xml
+*.cover
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+
+# Linting
+.ruff_cache/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Configuration files (actual config files, not templates)
+ppserver.toml
+ppserver-*.toml
+*-config.toml
+
+# Client configuration
+ppclient.conf
+
+# AWS credentials and configuration output
+aws_credentials_output/
+.env
+.env.*
+!.env.example
+
+# Documentation
+docs/_build/
+
+# Storage
+storage/
+.storage/
+
+# PutPlace server runtime files
+.ppserver.pid
+ppserver.log
+
+# Backup directories from package split
+src_old/
+tests_old/

putplace_server-0.8.2/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: putplace-server
+Version: 0.8.2
+Summary: PutPlace FastAPI server for file metadata storage
+License: Apache-2.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Archiving
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: aioboto3>=12.0.0
+Requires-Dist: argon2-cffi>=23.1.0
+Requires-Dist: authlib>=1.3.0
+Requires-Dist: boto3>=1.34.0
+Requires-Dist: certifi>=2023.0.0
+Requires-Dist: configargparse>=1.7.0
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: google-auth>=2.27.0
+Requires-Dist: httpx>=0.26.0
+Requires-Dist: invoke>=2.2.1
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: pymongo>=4.10.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: rich>=13.7.0
+Requires-Dist: tomli-w>=1.0.0
+Requires-Dist: tomli>=2.0.0; python_version < '3.11'
+Requires-Dist: uvicorn[standard]>=0.27.0
+Provides-Extra: dev
+Requires-Dist: invoke>=2.2.0; extra == 'dev'
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Requires-Dist: twine>=5.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# PutPlace Server
+
+A FastAPI-based file metadata storage service using MongoDB.
+
+## Installation
+
+```bash
+pip install putplace-server
+```
+
+## Quick Start
+
+```bash
+# Start MongoDB (using Docker)
+docker run -d --name mongodb -p 27017:27017 mongo:latest
+
+# Configure the server (creates admin user, tests connections)
+putplace_configure
+
+# Start the server
+ppserver start
+
+# Check server status
+ppserver status
+
+# View logs
+ppserver logs
+```
+
+## Features
+
+- REST API for storing and retrieving file metadata
+- MongoDB backend with async support
+- JWT and API key authentication
+- User registration with email confirmation
+- Admin dashboard for user management
+- S3 storage backend support (optional)
+- Google OAuth integration (optional)
+
+## API Endpoints
+
+- `GET /` - Root endpoint
+- `GET /health` - Health check
+- `POST /put_file` - Store file metadata
+- `GET /get_file/{sha256}` - Retrieve file by SHA256 hash
+- `GET /docs` - Interactive API documentation (Swagger UI)
+- `GET /redoc` - Alternative API documentation
+
+## Configuration
+
+Configuration via environment variables or `.env` file:
+
+```bash
+MONGODB_URL=mongodb://localhost:27017
+MONGODB_DATABASE=putplace
+API_TITLE=PutPlace API
+API_VERSION=0.8.1
+
+# Admin user (created on first startup)
+PUTPLACE_ADMIN_EMAIL=admin@example.com
+PUTPLACE_ADMIN_PASSWORD=your-secure-password
+```
+
+Or via `ppserver.toml`:
+
+```toml
+[server]
+host = "0.0.0.0"
+port = 8000
+
+[mongodb]
+url = "mongodb://localhost:27017"
+database = "putplace"
+```
+
+## Server Management
+
+```bash
+# Start server (background)
+ppserver start
+
+# Start with custom options
+ppserver start --host 0.0.0.0 --port 8080
+
+# Stop server
+ppserver stop
+
+# Restart server
+ppserver restart
+
+# Check status
+ppserver status
+
+# View logs
+ppserver logs
+ppserver logs --follow
+```
+
+## User Management
+
+```bash
+# List all users
+pp_manage_users list
+
+# Add a new user
+pp_manage_users add --email user@example.com
+
+# Delete a user
+pp_manage_users delete --email user@example.com
+
+# Reset password
+pp_manage_users reset-password --email user@example.com
+
+# Set/unset admin privileges
+pp_manage_users setadmin --email user@example.com
+pp_manage_users unsetadmin --email user@example.com
+
+# List pending registrations
+pp_manage_users pending
+
+# Approve pending user
+pp_manage_users approve --email user@example.com
+```
+
+## Related
+
+- [putplace-client](https://pypi.org/project/putplace-client/) - CLI tool for scanning directories and uploading file metadata
+
+## License
+
+Apache-2.0

putplace_server-0.8.2/README.md

@@ -0,0 +1,131 @@
+# PutPlace Server
+
+A FastAPI-based file metadata storage service using MongoDB.
+
+## Installation
+
+```bash
+pip install putplace-server
+```
+
+## Quick Start
+
+```bash
+# Start MongoDB (using Docker)
+docker run -d --name mongodb -p 27017:27017 mongo:latest
+
+# Configure the server (creates admin user, tests connections)
+putplace_configure
+
+# Start the server
+ppserver start
+
+# Check server status
+ppserver status
+
+# View logs
+ppserver logs
+```
+
+## Features
+
+- REST API for storing and retrieving file metadata
+- MongoDB backend with async support
+- JWT and API key authentication
+- User registration with email confirmation
+- Admin dashboard for user management
+- S3 storage backend support (optional)
+- Google OAuth integration (optional)
+
+## API Endpoints
+
+- `GET /` - Root endpoint
+- `GET /health` - Health check
+- `POST /put_file` - Store file metadata
+- `GET /get_file/{sha256}` - Retrieve file by SHA256 hash
+- `GET /docs` - Interactive API documentation (Swagger UI)
+- `GET /redoc` - Alternative API documentation
+
+## Configuration
+
+Configuration via environment variables or `.env` file:
+
+```bash
+MONGODB_URL=mongodb://localhost:27017
+MONGODB_DATABASE=putplace
+API_TITLE=PutPlace API
+API_VERSION=0.8.1
+
+# Admin user (created on first startup)
+PUTPLACE_ADMIN_EMAIL=admin@example.com
+PUTPLACE_ADMIN_PASSWORD=your-secure-password
+```
+
+Or via `ppserver.toml`:
+
+```toml
+[server]
+host = "0.0.0.0"
+port = 8000
+
+[mongodb]
+url = "mongodb://localhost:27017"
+database = "putplace"
+```
+
+## Server Management
+
+```bash
+# Start server (background)
+ppserver start
+
+# Start with custom options
+ppserver start --host 0.0.0.0 --port 8080
+
+# Stop server
+ppserver stop
+
+# Restart server
+ppserver restart
+
+# Check status
+ppserver status
+
+# View logs
+ppserver logs
+ppserver logs --follow
+```
+
+## User Management
+
+```bash
+# List all users
+pp_manage_users list
+
+# Add a new user
+pp_manage_users add --email user@example.com
+
+# Delete a user
+pp_manage_users delete --email user@example.com
+
+# Reset password
+pp_manage_users reset-password --email user@example.com
+
+# Set/unset admin privileges
+pp_manage_users setadmin --email user@example.com
+pp_manage_users unsetadmin --email user@example.com
+
+# List pending registrations
+pp_manage_users pending
+
+# Approve pending user
+pp_manage_users approve --email user@example.com
+```
+
+## Related
+
+- [putplace-client](https://pypi.org/project/putplace-client/) - CLI tool for scanning directories and uploading file metadata
+
+## License
+
+Apache-2.0

putplace_server-0.8.2/pyproject.toml

@@ -0,0 +1,124 @@
+[project]
+name = "putplace-server"
+# IMPORTANT: Keep this version in sync with src/putplace_server/version.py!
+version = "0.8.2"
+description = "PutPlace FastAPI server for file metadata storage"
+readme = "README.md"
+license = {text = "Apache-2.0"}
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Framework :: FastAPI",
+    "Topic :: System :: Archiving",
+    "Topic :: System :: Filesystems",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "fastapi>=0.110.0",
+    "uvicorn[standard]>=0.27.0",
+    "pymongo>=4.10.0",
+    "pydantic>=2.6.0",
+    "pydantic-settings>=2.1.0",
+    "python-dotenv>=1.0.0",
+    "httpx>=0.26.0",
+    "rich>=13.7.0",
+    "configargparse>=1.7.0",
+    "python-multipart>=0.0.6",
+    "argon2-cffi>=23.1.0",
+    "python-jose[cryptography]>=3.3.0",
+    "tomli>=2.0.0; python_version < '3.11'",
+    "tomli-w>=1.0.0",
+    "authlib>=1.3.0",
+    "google-auth>=2.27.0",
+    "certifi>=2023.0.0",
+    "boto3>=1.34.0",
+    "aioboto3>=12.0.0",
+    "invoke>=2.2.1",
+]
+
+[project.scripts]
+ppserver = "putplace_server.ppserver:main"
+putplace_configure = "putplace_server.scripts.putplace_configure:main"
+pp_manage_users = "putplace_server.scripts.pp_manage_users:run"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=4.1.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-xdist>=3.5.0",
+    "invoke>=2.2.0",
+    "ruff>=0.3.0",
+    "mypy>=1.8.0",
+    "twine>=5.0.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/putplace_server"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=putplace_server",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+markers = [
+    "integration: marks tests as integration tests (require server and database)",
+]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "E",  # pycodestyle errors
+    "W",  # pycodestyle warnings
+    "F",  # pyflakes
+    "I",  # isort
+    "B",  # flake8-bugbear
+    "C4", # flake8-comprehensions
+    "UP", # pyupgrade
+]
+ignore = []
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = ["B", "S101"]
+"src/putplace_server/ppserver.py" = ["T201"]  # Allow print statements in server script
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+strict_equality = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false

putplace_server-0.8.2/src/putplace_server/__init__.py

@@ -0,0 +1,5 @@
+"""PutPlace Server - FastAPI server for file metadata storage."""
+
+from .version import __version__
+
+__all__ = ["__version__"]