#!/usr/bin/env python3
"""
Quick Start Script for Lark Base Python SDK
This script helps you verify your setup and test basic operations.
Run: python quickstart.py
"""
import os
import sys
from dotenv import load_dotenv
# Load environment variables
load_dotenv()
def check_environment():
"""Check if all required environment variables are set."""
required_vars = ['LARK_APP_ID', 'LARK_APP_SECRET', 'LARK_APP_TOKEN']
missing_vars = []
print("Checking environment variables...")
for var in required_vars:
value = os.getenv(var)
if not value:
missing_vars.append(var)
print(f" ❌ {var}: Not set")
else:
masked_value = value[:8] + '...' if len(value) > 8 else '***'
print(f" ✓ {var}: {masked_value}")
if missing_vars:
print("\n⚠️ Missing required environment variables!")
print("Please set them in your .env file:")
for var in missing_vars:
print(f" {var}=your-value-here")
return False
print("\n✓ All environment variables are set!\n")
return True
def test_client():
"""Test basic client initialization and operations."""
try:
from lark_client import LarkBaseClient, LarkConfig
print("Testing Lark Base Client...")
# Initialize client
config = LarkConfig(
app_id=os.getenv('LARK_APP_ID'),
app_secret=os.getenv('LARK_APP_SECRET'),
log_level='INFO'
)
client = LarkBaseClient(config, rate_limit=10)
print(" ✓ Client initialized successfully")
# Test listing tables
app_token = os.getenv('LARK_APP_TOKEN')
tables = client.list_tables(app_token)
print(f" ✓ Successfully connected to Lark Base")
print(f" ✓ Found {len(tables)} tables in your base")
if tables:
print("\n Tables:")
for table in tables[:5]: # Show first 5 tables
print(f" - {table['name']} (ID: {table['table_id']})")
if len(tables) > 5:
print(f" ... and {len(tables) - 5} more")
return True
except ImportError as e:
print(f" ❌ Import error: {e}")
print(" Run: pip install -r requirements.txt")
return False
except Exception as e:
print(f" ❌ Error: {e}")
return False
def show_next_steps():
"""Show next steps for the user."""
print("\n" + "=" * 60)
print("✓ Setup Complete! Here's what you can do next:")
print("=" * 60)
print("\n1. Run the basic usage example:")
print(" python examples/basic_usage.py")
print("\n2. Try syncing TikTok data:")
print(" python examples/sync_tiktok_data.py")
print("\n3. Test batch operations:")
print(" python examples/batch_update.py")
print("\n4. Read the documentation:")
print(" See README.md for comprehensive guide")
print("\n5. Create your own script:")
print("""
from lark_client import LarkBaseClient, LarkConfig
from data_manager import DataManager
config = LarkConfig(
app_id=os.getenv('LARK_APP_ID'),
app_secret=os.getenv('LARK_APP_SECRET')
)
client = LarkBaseClient(config)
# Start building!
""")
def main():
"""Main function."""
print("=" * 60)
print("Lark Base Python SDK - Quick Start")
print("=" * 60)
print()
# Check environment
if not check_environment():
sys.exit(1)
# Test client
if not test_client():
sys.exit(1)
# Show next steps
show_next_steps()
if __name__ == '__main__':
main()
