Implemented content upload app with tests and pre-commit hooks

README.md

@@ -0,0 +1,112 @@
+# ContentAutomation Boilerplate
+
+Project scaffold for posting media from a storage backend to multiple social networks.
+
+## Structure
+
+```text
+src/content_automation/
+	adapters/
+		social/
+			base.py
+			instagram.py
+			youtube.py
+		storage/
+			base.py
+			local.py
+			s3.py
+	controller.py
+	factories.py
+	interfaces.py
+	main.py
+	settings.py
+```
+
+## Design
+
+- `SocialNetworkAdapter` interface defines a typed `post_media(media_url, caption)` contract.
+- Social adapters inherit from `SocialNetworkBaseAdapter` and use typed `uplink.Consumer` clients.
+- `StorageAdapterBase` defines `exists()` and `get_public_url()`.
+- `LocalFilesystemStorageAdapter` and `S3StorageAdapter` implement storage behavior.
+- `PublishController` is adapter-agnostic and only depends on abstractions.
+- `AppSettings` uses `pydantic-settings` with nested settings classes per adapter/backend.
+
+## Configuration
+
+Environment variables use prefix `CONTENT_AUTOMATION_` and nested delimiter `__`.
+
+Examples:
+
+```powershell
+# Targets
+$env:CONTENT_AUTOMATION_TARGET_SOCIAL_NETWORKS='["instagram","youtube"]'
+
+# Instagram
+$env:CONTENT_AUTOMATION_INSTAGRAM__ACCESS_TOKEN='your-instagram-token'
+$env:CONTENT_AUTOMATION_INSTAGRAM__USER_ID='your-instagram-user-id'
+$env:CONTENT_AUTOMATION_INSTAGRAM__API_VERSION='v25.0'
+
+# YouTube
+$env:CONTENT_AUTOMATION_YOUTUBE__ACCESS_TOKEN='your-youtube-token'
+$env:CONTENT_AUTOMATION_YOUTUBE__REFRESH_TOKEN='your-youtube-refresh-token'
+$env:CONTENT_AUTOMATION_YOUTUBE__CLIENT_ID='your-google-oauth-client-id'
+$env:CONTENT_AUTOMATION_YOUTUBE__CLIENT_SECRET='your-google-oauth-client-secret'
+$env:CONTENT_AUTOMATION_YOUTUBE__TOKEN_URI='https://oauth2.googleapis.com/token'
+$env:CONTENT_AUTOMATION_YOUTUBE__SCOPES='["https://www.googleapis.com/auth/youtube.upload"]'
+$env:CONTENT_AUTOMATION_YOUTUBE__EXPIRY='2026-03-13T00:00:00Z'
+$env:CONTENT_AUTOMATION_YOUTUBE__CATEGORY_ID='22'
+$env:CONTENT_AUTOMATION_YOUTUBE__PRIVACY_STATUS='public'
+
+# Storage backend (local or s3)
+$env:CONTENT_AUTOMATION_STORAGE__BACKEND='local'
+
+# Local storage settings
+$env:CONTENT_AUTOMATION_STORAGE__LOCAL__ROOT_DIRECTORY='D:\media'
+
+# S3 storage settings
+$env:CONTENT_AUTOMATION_STORAGE__BACKEND='s3'
+$env:CONTENT_AUTOMATION_STORAGE__S3__BUCKET_NAME='your-bucket'
+$env:CONTENT_AUTOMATION_STORAGE__S3__KEY_PREFIX='uploads'
+$env:CONTENT_AUTOMATION_STORAGE__S3__REGION_NAME='us-west-1'
+```
+
+## Run
+
+```powershell
+python -m content_automation.main path/to/video.mp4 --caption "My new post"
+```
+
+## Pre-commit
+
+Install hooks:
+
+```bash
+uv run pre-commit install --hook-type pre-commit --hook-type pre-push
+```
+
+Run hooks manually:
+
+```bash
+uv run pre-commit run --all-files
+```
+
+## Docker
+
+Build the image:
+
+```bash
+docker build -t content-automation .
+```
+
+Run a publish job:
+
+```bash
+docker run --rm --env-file .env -v "$PWD:/workspace" content-automation upload path/to/video.mp4 --caption "My new post"
+```
+
+Run any other command in the container:
+
+```bash
+docker run --rm -it --env-file .env content-automation bash
+```
+