pip install mokra

import mokra

mokra.configure(
    api_key="mk_live_...",
    base_url="https://api.mokra.ai/api"  # Optional
)

export MOKRA_API_KEY="mk_live_..."
export MOKRA_BASE_URL="https://api.mokra.ai/api"  # Optional

import mokra
import os

mokra.configure(api_key=os.environ["MOKRA_API_KEY"])

import stripe

# Your code makes normal API calls
charge = stripe.Charge.create(amount=5000, currency="usd")
# => Returns realistic mock response

import requests

response = requests.post(
    "https://api.stripe.com/v1/charges",
    auth=("sk_test_anything", ""),
    data={"amount": 5000, "currency": "usd"}
)
# => Intercepted and returns mock response

from mokra import mockworld

world = mockworld(name="My test", services=["stripe", "shopify"])

with world.run():
    # Your code here
    # All HTTP calls are intercepted
    stripe.Charge.create(amount=5000, currency="usd")

# Print to console
world.observe()

# Return as string
log = world.observe(print_output=False)
logger.info(log)

# Filter by service
world.observe(service="stripe")

# Natural language (note: assert_ to avoid Python keyword)
world.assert_("a refund was created")
world.assert_("refund amount is $50")

# Multiple assertions
world.assert_(
    "exactly one refund was created",
    "customer was notified",
    "no errors occurred"
)

# With service scope
world.assert_("a return was created", service="loop-returns")

state = world.state()

# By service
state["stripe"]["customers"].count
state["stripe"]["charges"][0]["amount"]

world.seed("""
  stripe:
    customers:
      - id: cus_test
        email: test@example.com

  shopify:
    orders:
      - id: order_123
        total_price: "150.00"
""")

# conftest.py
import pytest
import mokra
import os

@pytest.fixture(autouse=True)
def configure_mokra():
    mokra.configure(api_key=os.environ["MOKRA_API_KEY"])

# test_refund.py
from mokra import mockworld

def test_refund_service():
    world = mockworld(name="Refund test", services=["stripe"])

    with world.run():
        RefundService.process(payment_id="pi_123", amount=5000)

    world.assert_("a refund was created")
    world.assert_("refund amount is $50")

from mokra import mockworld
from langchain.agents import AgentExecutor

def test_support_agent():
    world = mockworld(
        name="Support agent test",
        services=["stripe", "shopify", "sendgrid"]
    )

    with world.run():
        agent = AgentExecutor(...)
        agent.invoke({"input": "Refund order #1234"})

    world.observe()
    world.assert_("exactly one refund was created")
    world.assert_("customer was notified")