vwp-sdk 0.1.0a1

VWP Python SDK — primitives for vibe-coded backends (rate limiting, auth, notifications, and more).

vwp-sdk

Python SDK for VWP — primitives for vibe-coded backends.

pip install vwp-sdk

Quickstart

import vwp

client = vwp.Client(api_key="vwp_test_...")  # or set VWP_API_KEY in env

result = client.rate_limit.check(
    key="login:[e-mail]",
    limit=5,
    window="15m",
)
if not result.allowed:
    # Block this request — your handler returns 429 to the end user.
    print(f"Try again in {result.retry_after_seconds}s")

Or, async:

import asyncio
import vwp

async def main():
    async with vwp.AsyncClient(api_key="vwp_test_...") as client:
        result = await client.rate_limit.check(
            key="login:[e-mail]", limit=5, window="15m",
        )
        print(result)

asyncio.run(main())

What's in this release (0.1.0a1)

• vwp.rate_limit.check(...) — SECURITY-RATE-LIMIT-001, fully wired against https://api.vibewithprimitiveai.com/v1.
• vwp.Client / vwp.AsyncClient — explicit clients for connection reuse.
• Typed errors — ApiKeyError (401), BadRequestError (400), MetaRateLimitedError (429), ServerError (5xx), NetworkError (no response).

Other modules (vwp.auth, vwp.notify, vwp.data, vwp.queue) are present as stubs and will be implemented in Phase 2. Calling them raises NotImplementedError with a pointer to the docs.

Errors

Every error subclasses vwp.VWPError. Catch the base class to handle anything:

try:
    result = vwp.rate_limit.check(key="...", limit=5, window="15m")
except vwp.ApiKeyError as e:
    print("Bad API key:", e.request_id)
except vwp.BadRequestError as e:
    print("Bad input:", e.field, e.message)
except vwp.VWPError as e:
    print("Other VWP error:", e)

Compatibility

Python 3.9+. Production-tested on 3.12.

License

Apache-2.0.