Python

# From PyPI (pre-release)
pip install --pre greenflash

# Optional: better async performance
pip install --pre "greenflash[aiohttp]"

import os
from greenflash import Greenflash

client = Greenflash(api_key=os.environ.get("GREENFLASH_API_KEY"))

# Log your first conversation
create_response = client.messages.create(
    product_id="YOUR_PRODUCT_ID",
    external_user_id="USER_ID",
    external_conversation_id="CONVO_ID",
    messages=[
        { "role": "user", "content": "Hello, how can you help me today?" },
        { "role": "assistant", "content": "I can answer any questions you have!" },
    ],
)

import os
import asyncio
from greenflash import AsyncGreenflash

client = AsyncGreenflash(api_key=os.environ.get("GREENFLASH_API_KEY"))

async def main():
    response = client.messages.create(
        product_id="YOUR_PRODUCT_ID",
        external_user_id="USER_ID",
        external_conversation_id="CONVO_ID",
        messages=[{ "role": "user", "content": "..." }],
    )
    print(f"Conversation ID: {response.conversation_id}")

asyncio.run(main())

from greenflash import Greenflash

client = Greenflash(api_key=os.environ.get("GREENFLASH_API_KEY"))

# Type-safe message creation with TypedDict
params: dict = {
    "product_id": "YOUR_PRODUCT_ID",
    "external_user_id": "USER_ID",
    "external_conversation_id": "CONVO_ID",
    "messages": [{ "role": "user", "content": "..." }],
}

response = client.messages.create(**params)

import greenflash
from greenflash import Greenflash

client = Greenflash(api_key=os.environ.get("GREENFLASH_API_KEY"))

try:
    response = client.messages.create(/* ... */)
except greenflash.APIConnectionError:
    # Handle network connection issues
    print("Network error occurred")
except greenflash.RateLimitError:
    # Handle rate limiting
    print("Rate limit exceeded")
except greenflash.APIStatusError as e:
    # Handle API errors with status codes
    print(f"API Error {e.status_code}: {e.response}")
except greenflash.APIError:
    # Catch any other API-related errors
    print("API error occurred")

from greenflash import Greenflash

# Disable retries globally
client = Greenflash(max_retries=0)

# Override retries for specific request
client.with_options(max_retries=5).messages.create(/* ... */)

from greenflash import Greenflash

# Set global timeout to 20 seconds
client = Greenflash(timeout=20.0)

# Override timeout for specific request
client.with_options(timeout=5.0).messages.create(/* ... */)

# Get raw response with headers
raw_response = client.messages.create(/* ... */).with_raw_response()
print("Custom header:", raw_response.headers.get("X-My-Header"))

# Stream response body
stream_response = client.messages.create(/* ... */).with_streaming_response()
for chunk in stream_response.iter_content():
    print(chunk)

# Set log level via environment variable
export GREENFLASH_LOG=info
# or
export GREENFLASH_LOG=debug