basic.py

"""Basic examples — no API key needed, pattern matching only."""

import butwhy

# ── Example 1: NameError ──
print("=" * 50)
print("Example 1: NameError")
print("=" * 50)
try:
    print(undefined_variable)
except NameError as e:
    print(butwhy.explain_error(e))

# ── Example 2: KeyError ──
print("\n" + "=" * 50)
print("Example 2: KeyError")
print("=" * 50)
try:
    d = {"name": "Alice", "age": 30}
    print(d["email"])
except KeyError as e:
    print(butwhy.explain_error(e))

# ── Example 3: ZeroDivisionError ──
print("\n" + "=" * 50)
print("Example 3: ZeroDivisionError")
print("=" * 50)
try:
    x = 0
    result = 100 / x
except ZeroDivisionError as e:
    print(butwhy.explain_error(e))

# ── Example 4: IndexError ──
print("\n" + "=" * 50)
print("Example 4: IndexError")
print("=" * 50)
try:
    items = [1, 2, 3]
    print(items[5])
except IndexError as e:
    print(butwhy.explain_error(e))

# ── Example 5: AttributeError (NoneType) ──
print("\n" + "=" * 50)
print("Example 5: AttributeError on None")
print("=" * 50)
try:
    data = None
    result = data.split(",")
except AttributeError as e:
    print(butwhy.explain_error(e))

# ── Example 6: ImportError ──
print("\n" + "=" * 50)
print("Example 6: ModuleNotFoundError")
print("=" * 50)
try:
    import cv2
except ModuleNotFoundError as e:
    print(butwhy.explain_error(e))

# ── Example 7: Using the decorator ──
print("\n" + "=" * 50)
print("Example 7: @butwhy.explain decorator")
print("=" * 50)

@butwhy.explain
def divide(a, b):
    return a / b

try:
    divide(10, 0)
except ZeroDivisionError:
    pass  # The decorator already printed the explanation

# ── Example 8: Using the context manager ──
print("\n" + "=" * 50)
print("Example 8: with butwhy.trace()")
print("=" * 50)

with butwhy.trace(reraise=False):
    nums = [1, 2]
    print(nums[10])  # IndexError, but suppressed

print("Execution continues after the context manager.")

# ── Example 9: butwhy.this ──
print("\n" + "=" * 50)
print("Example 9: butwhy.this")
print("=" * 50)
print(butwhy.this)