crier 0.2.0__tar.gz

crier-0.2.0/.github/workflows/docs.yml

@@ -0,0 +1,30 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          pip install mkdocs-material
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

crier-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,90 @@
+# Crier Auto-Publish Workflow
+#
+# Copy this to your content repo at .github/workflows/crier-publish.yml
+# Then set up the required secrets in your repo settings.
+#
+# Required secrets (set in GitHub repo Settings > Secrets):
+#   CRIER_DEVTO_API_KEY - Your dev.to API key
+#   CRIER_BLUESKY_API_KEY - handle.bsky.social:app-password
+#   CRIER_MASTODON_API_KEY - instance.social:access-token
+#   (add others as needed)
+
+name: Auto-Publish Content
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - 'posts/**/*.md'
+      - 'content/**/*.md'
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Full history for registry
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install Crier
+        run: pip install crier
+
+      - name: Configure platforms
+        env:
+          CRIER_DEVTO_API_KEY: ${{ secrets.CRIER_DEVTO_API_KEY }}
+          CRIER_BLUESKY_API_KEY: ${{ secrets.CRIER_BLUESKY_API_KEY }}
+          CRIER_MASTODON_API_KEY: ${{ secrets.CRIER_MASTODON_API_KEY }}
+          CRIER_HASHNODE_API_KEY: ${{ secrets.CRIER_HASHNODE_API_KEY }}
+        run: |
+          echo "Configured platforms:"
+          crier platforms
+
+      - name: Audit content
+        env:
+          CRIER_DEVTO_API_KEY: ${{ secrets.CRIER_DEVTO_API_KEY }}
+          CRIER_BLUESKY_API_KEY: ${{ secrets.CRIER_BLUESKY_API_KEY }}
+          CRIER_MASTODON_API_KEY: ${{ secrets.CRIER_MASTODON_API_KEY }}
+          CRIER_HASHNODE_API_KEY: ${{ secrets.CRIER_HASHNODE_API_KEY }}
+        run: |
+          # Audit posts directory (adjust path as needed)
+          if [ -d "posts" ]; then
+            crier audit ./posts || true
+          elif [ -d "content" ]; then
+            crier audit ./content || true
+          fi
+
+      - name: Publish missing content
+        env:
+          CRIER_DEVTO_API_KEY: ${{ secrets.CRIER_DEVTO_API_KEY }}
+          CRIER_BLUESKY_API_KEY: ${{ secrets.CRIER_BLUESKY_API_KEY }}
+          CRIER_MASTODON_API_KEY: ${{ secrets.CRIER_MASTODON_API_KEY }}
+          CRIER_HASHNODE_API_KEY: ${{ secrets.CRIER_HASHNODE_API_KEY }}
+        run: |
+          # Backfill any missing publications
+          if [ -d "posts" ]; then
+            crier backfill ./posts --yes || true
+          elif [ -d "content" ]; then
+            crier backfill ./content --yes || true
+          fi
+
+      - name: Commit registry updates
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+
+          # Add registry if it exists
+          if [ -d ".crier" ]; then
+            git add .crier/
+            git diff --staged --quiet || git commit -m "Update crier publication registry
+
+            🤖 Auto-updated by Crier GitHub Action"
+            git push
+          fi

crier-0.2.0/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Distribution
+*.tar.gz
+*.whl
+
+# Local config (contains API keys)
+config.yaml

crier-0.2.0/CLAUDE.md

@@ -0,0 +1,85 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+Crier is a CLI tool for cross-posting content to multiple platforms. It reads markdown files with YAML front matter and publishes them via platform APIs. Designed to be used with Claude Code for automated content distribution.
+
+## Development Commands
+
+```bash
+# Install in development mode with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=crier
+
+# Run a single test
+pytest tests/test_file.py::test_function -v
+
+# Lint
+ruff check src/
+
+# Format check
+ruff format --check src/
+
+# Build and serve docs locally
+mkdocs serve
+```
+
+## Architecture
+
+**CLI Layer** (`cli.py`): Click-based commands that orchestrate the workflow:
+- `publish` — Publish to platforms (supports `--dry-run`, `--profile`)
+- `status` — Show publication status for files
+- `audit` — Check what's missing from platforms
+- `backfill` — Publish missing content
+- `doctor` — Validate API keys
+- `config` — Manage API keys and profiles
+
+**Platform Abstraction** (`platforms/`):
+- `base.py`: Abstract `Platform` class defining the interface (`publish`, `update`, `list_articles`, `get_article`, `delete`) and core data classes (`Article`, `PublishResult`)
+- Each platform implements the `Platform` interface
+- `PLATFORMS` registry in `__init__.py` maps platform names to classes
+
+**Platform Categories** (13 total):
+- Blog: devto, hashnode, medium, ghost, wordpress
+- Newsletter: buttondown
+- Social: bluesky, mastodon, linkedin, threads, twitter (copy-paste mode)
+- Announcement: telegram, discord
+
+**Config** (`config.py`): API keys and profiles stored in `~/.config/crier/config.yaml` or via `CRIER_{PLATFORM}_API_KEY` environment variables. Environment variables take precedence. Supports composable profiles.
+
+**Registry** (`registry.py`): Tracks publications in `.crier/registry.yaml`. Records what's been published where, enables status checks, audit, and backfill.
+
+**Converters** (`converters/markdown.py`): Parses markdown files with YAML front matter into `Article` objects.
+
+## Key Features
+
+- **Dry run mode**: Preview before publishing with `--dry-run`
+- **Publishing profiles**: Group platforms (e.g., `--profile blogs`)
+- **Publication tracking**: Registry tracks what's published where
+- **Audit & backfill**: Find and publish missing content
+- **Doctor**: Validate all API keys work
+
+## Adding a New Platform
+
+1. Create `platforms/newplatform.py` implementing the `Platform` abstract class
+2. Register in `platforms/__init__.py` by adding to `PLATFORMS` dict
+3. Add documentation in `docs/platforms/newplatform.md`
+4. Update README.md with API key format
+
+## Documentation
+
+Documentation is in `docs/` using MkDocs with Material theme. Deployed to GitHub Pages via `.github/workflows/docs.yml`.
+
+## Testing Notes
+
+Tests directory exists but is currently empty. When adding tests:
+- Use pytest fixtures for mocking API responses
+- Test both success and failure paths for platform operations
+- Mock `requests` calls rather than hitting real APIs

crier-0.2.0/PKG-INFO

@@ -0,0 +1,227 @@
+Metadata-Version: 2.4
+Name: crier
+Version: 0.2.0
+Summary: Cross-post your content to dev.to, Hashnode, Medium, and more
+Project-URL: Homepage, https://github.com/queelius/crier
+Project-URL: Repository, https://github.com/queelius/crier
+Project-URL: Issues, https://github.com/queelius/crier/issues
+Author-email: Alex Towell <lex@metafunctor.com>
+License-Expression: MIT
+Keywords: blogging,content,cross-posting,devto,hashnode,medium
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.28
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: mkdocs-material>=9.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Crier
+
+Cross-post your content to dev.to, Ghost, WordPress, Hashnode, Medium, Bluesky, Mastodon, Threads, Telegram, Discord, and more.
+
+Like a town crier announcing your content to the world.
+
+## Installation
+
+```bash
+pip install crier
+```
+
+## Quick Start
+
+```bash
+# Configure your API keys
+crier config set devto.api_key YOUR_API_KEY
+crier config set bluesky.api_key "handle.bsky.social:app-password"
+crier config set mastodon.api_key "mastodon.social:access-token"
+
+# Publish a markdown file
+crier publish post.md --to devto
+
+# Publish to multiple platforms at once
+crier publish post.md --to devto --to bluesky --to mastodon
+
+# List your articles
+crier list devto
+
+# Update an existing article
+crier update devto 12345 --file updated-post.md
+```
+
+## Supported Platforms
+
+| Platform | API Key Format | Notes |
+|----------|---------------|-------|
+| **dev.to** | `api_key` | Full article support |
+| **Hashnode** | `token` or `token:publication_id` | Full article support |
+| **Medium** | `integration_token` | Publish only (no edit/list) |
+| **Ghost** | `https://site.com:key_id:key_secret` | Full article support |
+| **WordPress** | `site.wordpress.com:token` or `https://site.com:user:app_pass` | Full article support |
+| **Buttondown** | `api_key` | Newsletter publishing |
+| **Bluesky** | `handle:app_password` | Short posts with link cards |
+| **Mastodon** | `instance:access_token` | Toots with hashtags |
+| **Threads** | `user_id:access_token` | Short posts (no edit support) |
+| **Telegram** | `bot_token:chat_id` | Channel/group posts |
+| **Discord** | `webhook_url` | Server announcements |
+| **LinkedIn** | `access_token` | Requires API access |
+| **Twitter/X** | `any` (copy-paste mode) | Generates tweet for manual posting |
+
+### Platform Notes
+
+**Blog Platforms** (dev.to, Hashnode, Medium, Ghost, WordPress):
+- Full markdown article publishing
+- Preserves front matter (title, description, tags, canonical_url)
+- Best for long-form content
+
+**Newsletter Platforms** (Buttondown):
+- Publishes to email subscribers
+- Full markdown support
+- Great for content repurposing
+
+**Social Platforms** (Bluesky, Mastodon, LinkedIn, Twitter, Threads):
+- Creates short posts with link to canonical URL
+- Uses title + description + hashtags from tags
+- Best for announcing new content
+
+**Announcement Channels** (Telegram, Discord):
+- Posts to channels/servers
+- Good for community announcements
+- Discord uses webhook embeds
+
+## Configuration
+
+API keys can be set via:
+
+1. **Config file** (`~/.config/crier/config.yaml`):
+   ```yaml
+   platforms:
+     devto:
+       api_key: your_key_here
+     bluesky:
+       api_key: "handle.bsky.social:app-password"
+     mastodon:
+       api_key: "mastodon.social:access-token"
+   ```
+
+2. **Environment variables**:
+   ```bash
+   export CRIER_DEVTO_API_KEY=your_key_here
+   export CRIER_BLUESKY_API_KEY="handle.bsky.social:app-password"
+   ```
+
+## Markdown Format
+
+Crier reads standard markdown with YAML front matter:
+
+```markdown
+---
+title: "My Amazing Post"
+description: "A brief description"
+tags: [python, programming]
+canonical_url: https://myblog.com/my-post
+published: true
+---
+
+Your content here...
+```
+
+## Commands
+
+```bash
+crier publish FILE [--to PLATFORM]...  # Publish to platform(s)
+crier update PLATFORM ID --file FILE   # Update existing article
+crier list PLATFORM                     # List your articles
+crier config set KEY VALUE              # Set configuration
+crier config show                       # Show configuration
+crier platforms                         # List available platforms
+```
+
+## Getting API Keys
+
+### dev.to
+1. Go to https://dev.to/settings/extensions
+2. Generate API key
+
+### Hashnode
+1. Go to https://hashnode.com/settings/developer
+2. Generate Personal Access Token
+
+### Medium
+1. Go to https://medium.com/me/settings/security
+2. Generate Integration Token
+
+### Bluesky
+1. Go to Settings → App Passwords
+2. Create an app password
+3. Use format: `yourhandle.bsky.social:xxxx-xxxx-xxxx-xxxx`
+
+### Mastodon
+1. Go to Settings → Development → New Application
+2. Create app with `write:statuses` scope
+3. Use format: `instance.social:your-access-token`
+
+### Twitter/X
+Uses copy-paste mode - generates formatted tweet text for manual posting.
+No API setup required. Just set any placeholder value:
+```bash
+crier config set twitter.api_key manual
+```
+
+### Ghost
+1. Go to Settings → Integrations → Add custom integration
+2. Copy the Admin API Key (format: `key_id:key_secret`)
+3. Use format: `https://yourblog.com:key_id:key_secret`
+
+### WordPress
+**WordPress.com:**
+1. Go to https://developer.wordpress.com/apps/
+2. Create an app and get OAuth token
+3. Use format: `yoursite.wordpress.com:access_token`
+
+**Self-hosted WordPress:**
+1. Go to Users → Profile → Application Passwords
+2. Create a new application password
+3. Use format: `https://yoursite.com:username:app_password`
+
+### Buttondown
+1. Go to https://buttondown.email/settings/programming
+2. Copy your API key
+3. Use format: `api_key`
+
+### Threads
+1. Create a Meta Developer account at https://developers.facebook.com/
+2. Create an app with Threads API access
+3. Get your user_id and access_token
+4. Use format: `user_id:access_token`
+
+### Telegram
+1. Message @BotFather to create a bot and get the bot token
+2. Add your bot as admin to your channel
+3. Get your channel's chat_id (e.g., `@yourchannel` or numeric ID)
+4. Use format: `bot_token:chat_id`
+
+### Discord
+1. Go to Server Settings → Integrations → Webhooks
+2. Create a new webhook for your announcement channel
+3. Copy the webhook URL
+4. Use the full URL as the API key
+
+## License
+
+MIT

crier-0.2.0/README.md

@@ -0,0 +1,194 @@
+# Crier
+
+Cross-post your content to dev.to, Ghost, WordPress, Hashnode, Medium, Bluesky, Mastodon, Threads, Telegram, Discord, and more.
+
+Like a town crier announcing your content to the world.
+
+## Installation
+
+```bash
+pip install crier
+```
+
+## Quick Start
+
+```bash
+# Configure your API keys
+crier config set devto.api_key YOUR_API_KEY
+crier config set bluesky.api_key "handle.bsky.social:app-password"
+crier config set mastodon.api_key "mastodon.social:access-token"
+
+# Publish a markdown file
+crier publish post.md --to devto
+
+# Publish to multiple platforms at once
+crier publish post.md --to devto --to bluesky --to mastodon
+
+# List your articles
+crier list devto
+
+# Update an existing article
+crier update devto 12345 --file updated-post.md
+```
+
+## Supported Platforms
+
+| Platform | API Key Format | Notes |
+|----------|---------------|-------|
+| **dev.to** | `api_key` | Full article support |
+| **Hashnode** | `token` or `token:publication_id` | Full article support |
+| **Medium** | `integration_token` | Publish only (no edit/list) |
+| **Ghost** | `https://site.com:key_id:key_secret` | Full article support |
+| **WordPress** | `site.wordpress.com:token` or `https://site.com:user:app_pass` | Full article support |
+| **Buttondown** | `api_key` | Newsletter publishing |
+| **Bluesky** | `handle:app_password` | Short posts with link cards |
+| **Mastodon** | `instance:access_token` | Toots with hashtags |
+| **Threads** | `user_id:access_token` | Short posts (no edit support) |
+| **Telegram** | `bot_token:chat_id` | Channel/group posts |
+| **Discord** | `webhook_url` | Server announcements |
+| **LinkedIn** | `access_token` | Requires API access |
+| **Twitter/X** | `any` (copy-paste mode) | Generates tweet for manual posting |
+
+### Platform Notes
+
+**Blog Platforms** (dev.to, Hashnode, Medium, Ghost, WordPress):
+- Full markdown article publishing
+- Preserves front matter (title, description, tags, canonical_url)
+- Best for long-form content
+
+**Newsletter Platforms** (Buttondown):
+- Publishes to email subscribers
+- Full markdown support
+- Great for content repurposing
+
+**Social Platforms** (Bluesky, Mastodon, LinkedIn, Twitter, Threads):
+- Creates short posts with link to canonical URL
+- Uses title + description + hashtags from tags
+- Best for announcing new content
+
+**Announcement Channels** (Telegram, Discord):
+- Posts to channels/servers
+- Good for community announcements
+- Discord uses webhook embeds
+
+## Configuration
+
+API keys can be set via:
+
+1. **Config file** (`~/.config/crier/config.yaml`):
+   ```yaml
+   platforms:
+     devto:
+       api_key: your_key_here
+     bluesky:
+       api_key: "handle.bsky.social:app-password"
+     mastodon:
+       api_key: "mastodon.social:access-token"
+   ```
+
+2. **Environment variables**:
+   ```bash
+   export CRIER_DEVTO_API_KEY=your_key_here
+   export CRIER_BLUESKY_API_KEY="handle.bsky.social:app-password"
+   ```
+
+## Markdown Format
+
+Crier reads standard markdown with YAML front matter:
+
+```markdown
+---
+title: "My Amazing Post"
+description: "A brief description"
+tags: [python, programming]
+canonical_url: https://myblog.com/my-post
+published: true
+---
+
+Your content here...
+```
+
+## Commands
+
+```bash
+crier publish FILE [--to PLATFORM]...  # Publish to platform(s)
+crier update PLATFORM ID --file FILE   # Update existing article
+crier list PLATFORM                     # List your articles
+crier config set KEY VALUE              # Set configuration
+crier config show                       # Show configuration
+crier platforms                         # List available platforms
+```
+
+## Getting API Keys
+
+### dev.to
+1. Go to https://dev.to/settings/extensions
+2. Generate API key
+
+### Hashnode
+1. Go to https://hashnode.com/settings/developer
+2. Generate Personal Access Token
+
+### Medium
+1. Go to https://medium.com/me/settings/security
+2. Generate Integration Token
+
+### Bluesky
+1. Go to Settings → App Passwords
+2. Create an app password
+3. Use format: `yourhandle.bsky.social:xxxx-xxxx-xxxx-xxxx`
+
+### Mastodon
+1. Go to Settings → Development → New Application
+2. Create app with `write:statuses` scope
+3. Use format: `instance.social:your-access-token`
+
+### Twitter/X
+Uses copy-paste mode - generates formatted tweet text for manual posting.
+No API setup required. Just set any placeholder value:
+```bash
+crier config set twitter.api_key manual
+```
+
+### Ghost
+1. Go to Settings → Integrations → Add custom integration
+2. Copy the Admin API Key (format: `key_id:key_secret`)
+3. Use format: `https://yourblog.com:key_id:key_secret`
+
+### WordPress
+**WordPress.com:**
+1. Go to https://developer.wordpress.com/apps/
+2. Create an app and get OAuth token
+3. Use format: `yoursite.wordpress.com:access_token`
+
+**Self-hosted WordPress:**
+1. Go to Users → Profile → Application Passwords
+2. Create a new application password
+3. Use format: `https://yoursite.com:username:app_password`
+
+### Buttondown
+1. Go to https://buttondown.email/settings/programming
+2. Copy your API key
+3. Use format: `api_key`
+
+### Threads
+1. Create a Meta Developer account at https://developers.facebook.com/
+2. Create an app with Threads API access
+3. Get your user_id and access_token
+4. Use format: `user_id:access_token`
+
+### Telegram
+1. Message @BotFather to create a bot and get the bot token
+2. Add your bot as admin to your channel
+3. Get your channel's chat_id (e.g., `@yourchannel` or numeric ID)
+4. Use format: `bot_token:chat_id`
+
+### Discord
+1. Go to Server Settings → Integrations → Webhooks
+2. Create a new webhook for your announcement channel
+3. Copy the webhook URL
+4. Use the full URL as the API key
+
+## License
+
+MIT