Function demo_gotchas_and_tips

python/examples/migration_guide.py:185–220

Show potential gotchas and migration tips.

()

def demo_gotchas_and_tips():
    """Show potential gotchas and migration tips."""
    print("\n=== Migration Tips & Potential Gotchas ===\n")

    print("1. CAPACITY TUNING:")
    print("   Default capacity (128) is good for most use cases")
    print("   For very large datasets, consider capacity=64 or higher")
    print("   For testing/small data, capacity=4-16 is fine")

    tree_small = BPlusTreeMap(capacity=4)
    tree_large = BPlusTreeMap(capacity=128)
    print(f"   Small capacity tree: {tree_small.capacity}")
    print(f"   Large capacity tree: {tree_large.capacity}")

    print("\n2. KEY ORDERING:")
    print("   Keys must be comparable (support <, >, ==)")
    print("   Mixed types that can't be compared will raise TypeError")

    tree = BPlusTreeMap()
    tree[1] = "number"
    tree["hello"] = "string"
    # tree[None] = "none"  # This would fail: None < 1 not supported
    print("   ✓ Use consistent key types for best results")

    print("\n3. WHEN NOT TO MIGRATE:")
    print("   - Very small datasets (< 100 items)")
    print("   - Mostly random single-key lookups")
    print("   - Memory is extremely constrained")
    print("   - Keys are not orderable")

    print("\n4. WHEN TO DEFINITELY MIGRATE:")
    print("   ✓ Need range queries")
    print("   ✓ Frequently iterate in order")
    print("   ✓ Large datasets (1000+ items)")
    print("   ✓ Database-like access patterns")
    print("   ✓ Pagination or 'top N' queries")


def demo_real_world_migration():