publish_devto_localstack.py

"""Publish the LocalStack alternative Dev.to article for kaz/EVA.

Usage: python3 publish_devto_localstack.py [--draft]
"""
import json
import sys
import os
import subprocess

sys.path.insert(0, '/Users/services/drebin/tools')
sys.path.insert(0, '/Users/services/kaz')
from devto_post_publish import post_publish_actions, post_chat

ARTICLE_FILE      = '/Users/services/EVA/devto-article-localstack-alternative.md'
DEVTO_API         = 'https://dev.to/api/articles'
DEVTO_ARTICLE_ID  = 3394243   # draft created 2026-03-24
CHAT_CHANNEL      = '#kaz'
CHAT_AGENT        = 'kaz'

TITLE = "LocalStack Now Requires an Account — Here's How to Test AWS in Python Without One in 2026"
TAGS  = ['python', 'testing', 'aws', 'devtools']

FIRST_COMMENT = """\
Happy to answer questions on any of the approaches. A few things worth knowing:

- **April 6 deadline**: the `LS_ACKNOWLEDGE_ACCOUNT_REQUIREMENT=1` bypass still works until April 6 — if you're using it, set a calendar reminder now so you don't hit a surprise break.
- **Moto coverage**: Moto covers S3, DynamoDB, SQS, SNS, Lambda, Secrets Manager, and a lot more. The [service coverage docs](https://docs.getmoto.org/en/latest/docs/services/index.html) are worth checking if you're on something less common.
- **testcontainers-python users**: there's no official `LOCALSTACK_AUTH_TOKEN` support in the library as of March 2026. The `with_env` workaround still works — I'll keep the article updated if an official patch lands.

What service are you testing? The right migration path varies a lot depending on S3-only vs multi-service.\
"""

PYCODERS_DESCRIPTION = (
    "LocalStack now requires an account for all usage, including CI. This post walks through "
    "the drop-in alternatives for Python AWS testing: Moto for unit/integration tests, "
    "testcontainers workarounds, and a conftest.py template that replaces LocalStack for the "
    "most common services (S3, DynamoDB, SQS). Also covers the April 6 bypass window and "
    "the free token path if you want to stay on LocalStack."
)

PYTHON_WEEKLY_SUBJECT = "Submission: LocalStack Now Requires an Account — Here's How to Test AWS in Python Without One"
PYTHON_WEEKLY_BODY = """\
Hi,

Submitting for consideration in Python Weekly:

**Title:** LocalStack Now Requires an Account — Here's How to Test AWS in Python Without One in 2026
**URL:** {url}
**Description:** LocalStack now requires an account for all usage, including CI. This post covers the drop-in alternatives: Moto for unit/integration tests, testcontainers workarounds, and a conftest.py template covering S3/DynamoDB/SQS. Also covers the April 6 bypass window and the free token path for teams that want to stay on LocalStack.

Thanks
"""


def get_api_key():
    raw = subprocess.check_output(
        ['node', '/Users/services/drebin/tools/account-helper.js', 'get', 'dev.to', '--json'],
        timeout=10
    ).decode()
    return json.loads(raw)['api_key']


def extract_body(filepath):
    with open(filepath) as f:
        lines = f.readlines()
    start = None
    for i, line in enumerate(lines):
        if line.strip() == '## Article':
            start = i + 1
            break
    if start is None:
        raise ValueError("Could not find '## Article' marker in file")
    end = len(lines)
    for i in range(start, len(lines)):
        if lines[i].strip() in ('## Publishing Notes', '## Positioning Notes'):
            end = i
            break
    return ''.join(lines[start:end]).strip()


def publish(draft=False):
    import httpx

    api_key = get_api_key()
    body    = extract_body(ARTICLE_FILE)

    url     = f"{DEVTO_API}/{DEVTO_ARTICLE_ID}"
    payload = {
        'article': {
            'title':         TITLE,
            'body_markdown': body,
            'published':     not draft,
            'tags':          TAGS,
        }
    }

    resp = httpx.put(
        url,
        headers={'api-key': api_key, 'Content-Type': 'application/json'},
        json=payload,
        timeout=30,
    )
    resp.raise_for_status()
    result = resp.json()

    article_url = result.get('url', '?')
    article_id  = result.get('id', DEVTO_ARTICLE_ID)
    status      = 'DRAFT' if draft else 'PUBLISHED'
    msg         = f"Dev.to article {status}: {article_url} | '{TITLE}' | @peytongreen_dev"
    print(msg)
    post_chat(CHAT_CHANNEL, f"📝 {msg}")
    if not draft:
        post_chat('#general', f"📝 LocalStack alternative article live: {article_url}")
        post_publish_actions(
            article_id, article_url, FIRST_COMMENT,
            PYCODERS_DESCRIPTION, PYTHON_WEEKLY_SUBJECT, PYTHON_WEEKLY_BODY,
            article_title=TITLE,
        )
    return result


if __name__ == '__main__':
    draft = '--draft' in sys.argv
    try:
        result = publish(draft=draft)
        print(f"ID: {result.get('id')} URL: {result.get('url')}")
    except Exception as e:
        msg = f"⚠️ publish_devto_localstack FAILED: {e}"
        print(msg)
        post_chat(CHAT_CHANNEL, msg)
        sys.exit(1)