pip install cocobase

from cocobase_client.client import CocoBaseClient

db = CocoBaseClient(
    api_key="YOUR_API_KEY",
    project_id="YOUR_PROJECT_ID",  # required for cloud functions
    base_url="https://api.cocobase.buzz"  # Optional
)

# List documents
docs = db.list_documents("posts")

# Get single document
doc = db.get_document("posts", "doc-id")

# Create document
created = db.create_document("posts", {
    "title": "My First Post",
    "content": "Hello World!"
})

# Update document
db.update_document("posts", "doc-id", {
    "title": "Updated Title"
})

# Delete document
db.delete_document("posts", "doc-id")

# Find active users older than 18
query = QueryBuilder().eq("status", "active").gt("age", 18)
users = db.list_documents("users", query=query)

from cocobase_client.query import QueryBuilder

query = (QueryBuilder()
    .eq("status", "active")
    .gt("age", 18)
    .contains("email", "@gmail.com")
    .limit(10))

users = db.list_documents("users", query=query)

# Sort by creation date (newest first)
query = QueryBuilder().from_dict({"sort": "createdAt", "order": "desc"})
posts = db.list_documents("posts", query=query)

# Get page 3 (20 items per page)
query = QueryBuilder().limit(20).offset(40)
posts = db.list_documents("posts", query=query)

from dataclasses import dataclass
from typing import Optional

@dataclass
class Book:
    title: str
    author: str
    price: float
    published_at: Optional[str] = None

    @classmethod
    def from_dict(cls, data: dict) -> "Book":
        return cls(
            title=data["title"],
            author=data["author"],
            price=data["price"],
            published_at=data.get("publishedAt")
        )

    def to_dict(self) -> dict:
        return {
            "title": self.title,
            "author": self.author,
            "price": self.price,
            "publishedAt": self.published_at
        }

new_book = Book(
    title="Clean Code",
    author="Robert Martin",
    price=45.99
)

created = db.create_document("books", new_book.to_dict())

doc = db.get_document("books", "doc-id")
book = Book.from_dict(doc.data)
print(book.title)

# Register
result = db.auth.register(
    "user@example.com",
    "securePassword123",
    {"username": "johndoe"}  # optional extra data
)

# Login
result = db.auth.login("user@example.com", "securePassword123")

# Logout
db.auth.logout()

# Get current user
current_user = db.auth.get_current_user()

# Check authentication
if db.auth.is_authenticated():
    print("Logged in")

# Google OAuth
user = db.auth.login_with_google(
    id_token="google-id-token",
    platform="web"  # or "mobile", "ios", "android"
)

# GitHub OAuth
user = db.auth.login_with_github(
    code="github-auth-code",
    redirect_uri="https://yourapp.com/callback",
    platform="web"
)

result = db.auth.register_with_files(
    email="john@example.com",
    password="password123",
    data={"username": "johndoe"},
    files={"avatar": avatar_file}
)

updated_user = db.auth.update_user(
    data={"bio": "Updated bio"},
    email="newemail@example.com"
)

updated_user = db.auth.update_user_with_files(
    data={"bio": "Updated bio"},
    files={"avatar": new_avatar_file}
)

# Enable 2FA
db.auth.enable_2fa()

# Disable 2FA
db.auth.disable_2fa()

# Verify 2FA login
user = db.auth.verify_2fa_login(
    email="user@example.com",
    code="123456"
)

if db.auth.has_role("admin"):
    print("User is an admin")

users = db.auth.list_users({"limit": 10, "offset": 0})

user = db.auth.get_user_by_id("user-id")

def main():
    from cocobase_client.client import CocoBaseClient
    from cocobase_client.query import QueryBuilder

    db = CocoBaseClient()  # Auto-configured in cloud environment

    # Your function logic here
    query = QueryBuilder().limit(10)
    docs = db.list_documents("posts", query=query)

    return {
        "success": True,
        "count": len(docs)
    }

def main(event):
    from cocobase_client.client import CocoBaseClient

    db = CocoBaseClient()

    # Access trigger data
    document = event.get("document")
    trigger_type = event.get("type")

    if trigger_type == "created":
        docs = db.list_documents("users")
        db.create_document("logs", {
            "action": "user_created",
            "userId": document.get("id")
        })

    return {"success": True}

def main():
    from cocobase_client.client import CocoBaseClient
    from cocobase_client.query import QueryBuilder
    from datetime import datetime, timedelta

    db = CocoBaseClient()

    # Clean up old documents
    cutoff = (datetime.now() - timedelta(days=30)).isoformat()

    query = QueryBuilder().from_dict({"createdAt__lt": cutoff}).limit(100)
    old_docs = db.list_documents("logs", query=query)

    for doc in old_docs:
        db.delete_document("logs", doc.id)

    return {
        "success": True,
        "deleted": len(old_docs)
    }

from cocobase_client.exceptions import CocobaseError

try:
    doc = db.get_document("posts", "non-existent-id")
except CocobaseError as e:
    print(f"Error: {e}")

# Good
@dataclass
class Post:
    title: str
    content: str

post = Post.from_dict(doc.data)
print(post.title)

# Avoid
print(doc.data["title"])

try:
    doc = db.get_document("posts", post_id)
    return doc
except CocobaseError as e:
    logger.error(f"Failed to get post: {e}")
    raise

import os

db = CocoBaseClient(
    api_key=os.environ.get("COCOBASE_API_KEY")
)

from cocobase_client.query import QueryBuilder

# Good
query = QueryBuilder().limit(20)
docs = db.list_documents("posts", query=query)

# Bad - could return thousands
docs = db.list_documents("posts")