tracemorph 0.1.3

Function execution tracing, visualization, and narrative builder for Python apps.

TraceMorph

TraceMorph adalah library Python untuk melacak eksekusi fungsi, membangun visualisasi call-chain, serta menghasilkan narasi error berbasis AI (via LLM API).

🚀 Fitur

• Dekorator tracing fungsi otomatis
• Pelacakan exception global
• Visualisasi call-stack dan dependensi fungsi
• Ekspor hasil trace ke JSON
• Narasi human-readable berbasis LLM prompt engineering
• Bisa diintegrasikan ke middleware, testing, atau backend

🧠 Contoh Penggunaan

from tracemorph import trace

@trace
def bagi(a, b):
    return a / b

bagi(10, 2)

contoh 2

from tracemorph.core.tracer import trace
from tracemorph.core.builder import TraceBuilder

@trace()
def error_prone(x, y):
    return x / y  # Bisa error kalau y=0

if __name__ == "__main__":
    try:
        error_prone(10, 0)
    except Exception:
        pass  # biarkan decorator handle log trace-nya

    # Ambil data trace terakhir lengkap dengan narasi berwarna
    data = TraceBuilder.build_latest_and_export()

    if data:
        print(data['colored_narrative'])  # Print narasi berwarna rapi di terminal
    else:
        print("No trace found.")

contoh 3

from tracemorph import trace, TraceBuilder

@trace
def test(x):
    return x * 2

test(10)

print(TraceBuilder.build_narrative_for_last()[0])