putplace 0.5.1__tar.gz → 0.5.6__tar.gz

{putplace-0.5.1 → putplace-0.5.6}/CLAUDE.md

@@ -95,6 +95,40 @@ curl -X POST http://localhost:8000/api_keys \
   -d '{"name": "my-key"}'
 ```
 
+### Configuration Wizard
+
+Use the configuration wizard to set up PutPlace after installation:
+
+```bash
+# Interactive configuration
+invoke configure
+# Or: uv run python -m putplace.scripts.putplace_configure
+
+# Non-interactive (for automation)
+uv run python -m putplace.scripts.putplace_configure --non-interactive \
+  --admin-username admin \
+  --admin-email admin@example.com \
+  --storage-backend local
+
+# Standalone AWS tests (v0.5.2+)
+uv run python -m putplace.scripts.putplace_configure S3   # Test S3 access
+uv run python -m putplace.scripts.putplace_configure SES  # Test SES access
+invoke configure --test-mode=S3                  # Via invoke
+invoke configure --test-mode=SES                 # Via invoke
+
+# Test in specific region
+uv run python -m putplace.scripts.putplace_configure S3 --aws-region us-west-2
+```
+
+**What it does:**
+- Creates admin user with secure password
+- Tests MongoDB connection
+- Checks AWS S3/SES access (optional)
+- Configures storage backend (local or S3)
+- Generates `ppserver.toml` configuration file
+
+**Note:** The configure script uses `pty=True` in the invoke task to properly handle readline/terminal input for better backspace behavior.
+
 ## Common Commands
 
 All development tasks are managed through `invoke` (see tasks.py):

{putplace-0.5.1 → putplace-0.5.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: putplace
-Version: 0.5.1
+Version: 0.5.6
 Summary: File and Metadata storage system
 License: Apache-2.0
 License-File: LICENSE
@@ -21,6 +21,7 @@ Classifier: Topic :: System :: Systems Administration
 Requires-Python: >=3.10
 Requires-Dist: argon2-cffi>=23.1.0
 Requires-Dist: authlib>=1.3.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
@@ -115,7 +116,7 @@ invoke setup
 # Configure the server (create admin user, check AWS, set storage backend)
 source .venv/bin/activate
 invoke configure
-# Or directly: putplace-configure
+# Or directly: putplace_configure
 
 # Start MongoDB and server
 invoke quickstart
@@ -129,16 +130,16 @@ PutPlace includes a configuration wizard to set up your server after installatio
 
 ```bash
 # Interactive configuration (recommended for first-time setup)
-putplace-configure
+putplace_configure
 
 # Non-interactive configuration (for automation/CI/CD)
-putplace-configure --non-interactive \
+putplace_configure --non-interactive \
   --admin-username admin \
   --admin-email admin@example.com \
   --storage-backend local
 
 # With S3 storage
-putplace-configure --non-interactive \
+putplace_configure --non-interactive \
   --admin-username admin \
   --admin-email admin@example.com \
   --storage-backend s3 \
@@ -146,13 +147,23 @@ putplace-configure --non-interactive \
   --aws-region us-west-2
 
 # Skip validation checks (useful for testing)
-putplace-configure --skip-checks
+putplace_configure --skip-checks
+
+# Standalone AWS tests (new in v0.5.2)
+putplace_configure S3                        # Test S3 access
+putplace_configure SES                       # Test SES access
+putplace_configure S3 --aws-region us-west-2 # Test in specific region
+
+# Via invoke task
+invoke configure --test-mode=S3
+invoke configure --test-mode=SES
 ```
 
 **Features:**
 - ✅ **Creates admin user** with secure password generation
 - ✅ **Tests MongoDB connection** before configuration
 - ✅ **Checks AWS S3 and SES access** (optional)
+- ✅ **Standalone S3/SES tests** - Test AWS credentials independently
 - ✅ **Configures storage backend** (local or S3)
 - ✅ **Generates `ppserver.toml`** configuration file
 - ✅ **Non-interactive mode** for automation
@@ -361,7 +372,7 @@ The server looks for `ppserver.toml` in:
 2. `~/.config/putplace/ppserver.toml` (user config)
 3. `/etc/putplace/ppserver.toml` (system config)
 
-You can also use `invoke configure` or `putplace-configure` for guided setup. Environment variables can override TOML settings if needed. See [Configuration Guide](https://putplace.readthedocs.io/en/latest/configuration.html) for details.
+You can also use `invoke configure` or `putplace_configure` for guided setup. Environment variables can override TOML settings if needed. See [Configuration Guide](https://putplace.readthedocs.io/en/latest/configuration.html) for details.
 
 ## API Endpoints
 
@@ -384,9 +395,21 @@ Once the server is running:
 **Authentication:**
 - `POST /api/register` - Register new user
 - `POST /api/login` - Login and get JWT token
+- `POST /api/auth/google` - Google Sign-In authentication
+- `GET /api/oauth/config` - Get OAuth configuration
 - `POST /api_keys` - Create API key (requires JWT)
 - `GET /api_keys` - List API keys (requires JWT)
 
+**Google Sign-In Setup:**
+
+To enable Google Sign-In in the Electron client and web interface, see [GOOGLE_OAUTH_SETUP.md](GOOGLE_OAUTH_SETUP.md) for detailed configuration instructions.
+
+Quick summary:
+1. Create OAuth credentials in [Google Cloud Console](https://console.cloud.google.com/)
+2. Add Client ID to `ppserver.toml` or set `GOOGLE_CLIENT_ID` environment variable
+3. Restart the server
+4. Google Sign-In button will appear automatically in the Electron client
+
 See [API Reference](https://putplace.readthedocs.io/en/latest/api-reference.html) for complete endpoint documentation.
 
 ## Architecture

{putplace-0.5.1 → putplace-0.5.6}/README.md

@@ -65,7 +65,7 @@ invoke setup
 # Configure the server (create admin user, check AWS, set storage backend)
 source .venv/bin/activate
 invoke configure
-# Or directly: putplace-configure
+# Or directly: putplace_configure
 
 # Start MongoDB and server
 invoke quickstart
@@ -79,16 +79,16 @@ PutPlace includes a configuration wizard to set up your server after installatio
 
 ```bash
 # Interactive configuration (recommended for first-time setup)
-putplace-configure
+putplace_configure
 
 # Non-interactive configuration (for automation/CI/CD)
-putplace-configure --non-interactive \
+putplace_configure --non-interactive \
   --admin-username admin \
   --admin-email admin@example.com \
   --storage-backend local
 
 # With S3 storage
-putplace-configure --non-interactive \
+putplace_configure --non-interactive \
   --admin-username admin \
   --admin-email admin@example.com \
   --storage-backend s3 \
@@ -96,13 +96,23 @@ putplace-configure --non-interactive \
   --aws-region us-west-2
 
 # Skip validation checks (useful for testing)
-putplace-configure --skip-checks
+putplace_configure --skip-checks
+
+# Standalone AWS tests (new in v0.5.2)
+putplace_configure S3                        # Test S3 access
+putplace_configure SES                       # Test SES access
+putplace_configure S3 --aws-region us-west-2 # Test in specific region
+
+# Via invoke task
+invoke configure --test-mode=S3
+invoke configure --test-mode=SES
 ```
 
 **Features:**
 - ✅ **Creates admin user** with secure password generation
 - ✅ **Tests MongoDB connection** before configuration
 - ✅ **Checks AWS S3 and SES access** (optional)
+- ✅ **Standalone S3/SES tests** - Test AWS credentials independently
 - ✅ **Configures storage backend** (local or S3)
 - ✅ **Generates `ppserver.toml`** configuration file
 - ✅ **Non-interactive mode** for automation
@@ -311,7 +321,7 @@ The server looks for `ppserver.toml` in:
 2. `~/.config/putplace/ppserver.toml` (user config)
 3. `/etc/putplace/ppserver.toml` (system config)
 
-You can also use `invoke configure` or `putplace-configure` for guided setup. Environment variables can override TOML settings if needed. See [Configuration Guide](https://putplace.readthedocs.io/en/latest/configuration.html) for details.
+You can also use `invoke configure` or `putplace_configure` for guided setup. Environment variables can override TOML settings if needed. See [Configuration Guide](https://putplace.readthedocs.io/en/latest/configuration.html) for details.
 
 ## API Endpoints
 
@@ -334,9 +344,21 @@ Once the server is running:
 **Authentication:**
 - `POST /api/register` - Register new user
 - `POST /api/login` - Login and get JWT token
+- `POST /api/auth/google` - Google Sign-In authentication
+- `GET /api/oauth/config` - Get OAuth configuration
 - `POST /api_keys` - Create API key (requires JWT)
 - `GET /api_keys` - List API keys (requires JWT)
 
+**Google Sign-In Setup:**
+
+To enable Google Sign-In in the Electron client and web interface, see [GOOGLE_OAUTH_SETUP.md](GOOGLE_OAUTH_SETUP.md) for detailed configuration instructions.
+
+Quick summary:
+1. Create OAuth credentials in [Google Cloud Console](https://console.cloud.google.com/)
+2. Add Client ID to `ppserver.toml` or set `GOOGLE_CLIENT_ID` environment variable
+3. Restart the server
+4. Google Sign-In button will appear automatically in the Electron client
+
 See [API Reference](https://putplace.readthedocs.io/en/latest/api-reference.html) for complete endpoint documentation.
 
 ## Architecture