traceback-id 0.1.0__py3-none-any.whl

traceback_id/__init__.py

@@ -0,0 +1,19 @@
+"""traceback_id — penjelasan error/traceback pemrograman dalam Bahasa
+Indonesia, dimulai dari Python (lihat PRD.md).
+
+Mode in-process (khusus Python, DX terbaik untuk kasus ini)::
+
+    import traceback_id
+    traceback_id.activate()
+
+Mode CLI (universal, dipakai bahasa apa pun yang punya adapter)::
+
+    traceback_id run script.py
+    traceback_id run script.js
+"""
+from __future__ import annotations
+
+from traceback_id.hook import activate, deactivate, is_active
+
+__all__ = ["activate", "deactivate", "is_active", "__version__"]
+__version__ = "0.1.0"

traceback_id/__main__.py

@@ -0,0 +1,8 @@
+from __future__ import annotations
+
+import sys
+
+from traceback_id.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

traceback_id/adapters/__init__.py

@@ -0,0 +1 @@
+"""Paket adapter bahasa. Lihat adapters/base.py untuk kontraknya."""

traceback_id/adapters/base.py

@@ -0,0 +1,36 @@
+"""Kontrak adapter bahasa (ARCHITECTURE.md §4).
+
+Setiap adapter — built-in maupun plugin komunitas yang didaftarkan lewat
+entry_points `traceback_id.adapters` — wajib mengimplementasikan interface
+ini. `core/` hanya bergantung pada `LanguageAdapter` + `StructuredError`,
+tidak pernah mengimpor adapter bahasa tertentu secara langsung.
+"""
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from pathlib import Path
+
+from traceback_id.core.models import StructuredError
+
+
+class LanguageAdapter(ABC):
+    """Interface yang wajib dipenuhi setiap adapter bahasa."""
+
+    name: str
+    file_extensions: list[str]
+
+    @abstractmethod
+    def capture(self, command: list[str]) -> str:
+        """Jalankan command, kembalikan raw stderr/output sebagai teks."""
+        raise NotImplementedError
+
+    @abstractmethod
+    def parse(self, raw_output: str) -> StructuredError:
+        """Ubah teks error mentah jadi StructuredError."""
+        raise NotImplementedError
+
+    @property
+    @abstractmethod
+    def rules_path(self) -> Path:
+        """Lokasi file rule khusus bahasa ini."""
+        raise NotImplementedError

traceback_id/adapters/python/__init__.py

@@ -0,0 +1 @@
+"""Adapter Python. Lihat adapter.py untuk implementasi, rules.yaml untuk rule."""

traceback_id/adapters/python/adapter.py

@@ -0,0 +1,140 @@
+"""Adapter Python — implementasi pertama & satu-satunya yang matang di v0.1
+(PRD.md §4). Semua kekhususan Python (capture via hook/subprocess, parsing
+traceback) hidup di sini, terisolasi dari adapter bahasa lain.
+"""
+from __future__ import annotations
+
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+import yaml
+
+from traceback_id.adapters.base import LanguageAdapter
+from traceback_id.core.models import ErrorCategory, StructuredError
+
+RULES_PATH = Path(__file__).resolve().parent / "rules.yaml"
+
+# `  File "script.py", line 3, in <module>`
+_FRAME_RE = re.compile(r'^\s*File "(?P<file>.+?)", line (?P<line>\d+)(?:, in (?P<func>.*))?$')
+
+# Baris terakhir traceback Python, mis. `NameError: name 'x' is not defined`.
+# StopIteration/SystemExit/KeyboardInterrupt/GeneratorExit tidak selalu
+# punya prefix + pesan (mis. `StopIteration` bisa muncul sendirian tanpa
+# titik dua sama sekali), jadi didaftarkan sebagai alternatif berdiri
+# sendiri, terpisah dari pola "<prefix>Error/Exception/Warning".
+_ERROR_LINE_RE = re.compile(
+    r"^(?P<error_type>[\w.]*(?:Error|Exception|Warning)"
+    r"|StopIteration|SystemExit|KeyboardInterrupt|GeneratorExit)"
+    r":?\s*(?P<message>.*)$"
+)
+
+
+def _looks_like_traceback_line(text: str) -> bool:
+    """True kalau `text` adalah baris "File ...", baris "ErrorType: ...",
+    atau header "Traceback (most recent call last):" — dipakai untuk
+    membedakan baris source-code asli dari baris struktur traceback."""
+    return (
+        bool(_FRAME_RE.match(text))
+        or bool(_ERROR_LINE_RE.match(text))
+        or text.startswith("Traceback (most recent call last)")
+    )
+
+
+class PythonAdapter(LanguageAdapter):
+    """Adapter untuk error/traceback Python.
+
+    Selain kontrak dasar `capture()`/`parse()`, adapter ini juga dipakai
+    langsung oleh `traceback_id/hook.py` untuk mode in-process
+    (`sys.excepthook`) — satu-satunya adapter yang punya mode ini, karena
+    Python adalah bahasa implementasi library ini sendiri (ARCHITECTURE.md §4).
+    """
+
+    name = "python"
+    file_extensions = [".py", ".pyw"]
+
+    def __init__(self) -> None:
+        self._rules_cache: dict | None = None
+        self.last_returncode: int | None = None
+
+    @property
+    def rules_path(self) -> Path:
+        return RULES_PATH
+
+    def capture(self, command: list) -> str:
+        """Jalankan `command` sebagai subprocess Python, kembalikan stderr.
+
+        stdout program tetap diteruskan langsung ke terminal (real-time),
+        sedangkan stderr ditangkap untuk di-parse — kalau program tidak
+        error, stderr akan kosong dan tidak ada apa pun yang "hilang".
+        """
+        result = subprocess.run(
+            [sys.executable, *command],
+            stdout=None,
+            stderr=subprocess.PIPE,
+            text=True,
+        )
+        self.last_returncode = result.returncode
+        return result.stderr
+
+    def parse(self, raw_output: str) -> StructuredError:
+        lines = raw_output.rstrip("\n").splitlines()
+
+        frames = []
+        for i, line in enumerate(lines):
+            match = _FRAME_RE.match(line)
+            if not match:
+                continue
+            code_context = None
+            if i + 1 < len(lines):
+                candidate = lines[i + 1].strip()
+                if candidate and not _looks_like_traceback_line(candidate):
+                    code_context = candidate
+            frames.append(
+                {
+                    "file": match.group("file"),
+                    "line": int(match.group("line")),
+                    "code_context": code_context,
+                }
+            )
+
+        error_type = "UnknownError"
+        message = raw_output.strip() or "(tidak ada output error)"
+        for line in reversed(lines):
+            match = _ERROR_LINE_RE.match(line)
+            if match:
+                error_type = match.group("error_type")
+                message = match.group("message").strip()
+                break
+
+        last_frame = frames[-1] if frames else {}
+
+        return StructuredError(
+            language=self.name,
+            error_type=error_type,
+            category=self._category_for(error_type),
+            message=message,
+            file=last_frame.get("file"),
+            line=last_frame.get("line"),
+            code_context=last_frame.get("code_context"),
+            raw_output=raw_output,
+        )
+
+    def _rules(self) -> dict:
+        if self._rules_cache is None:
+            if self.rules_path.exists():
+                with open(self.rules_path, encoding="utf-8") as fh:
+                    self._rules_cache = yaml.safe_load(fh) or {}
+            else:  # pragma: no cover - seharusnya tidak terjadi di instalasi normal
+                self._rules_cache = {}
+        return self._rules_cache
+
+    def _category_for(self, error_type: str) -> ErrorCategory:
+        rule = self._rules().get(error_type)
+        if rule and "category" in rule:
+            try:
+                return ErrorCategory(rule["category"])
+            except ValueError:
+                pass
+        return ErrorCategory.UNKNOWN

traceback_id/adapters/python/rules.yaml

@@ -0,0 +1,174 @@
+# Rule khusus Python (PRD.md §4 — 15 error type MVP).
+#
+# Key setiap entri = error_type persis seperti yang muncul di traceback
+# (mis. "NameError"). Field:
+#   category    -> salah satu nilai ErrorCategory di core/models.py
+#   pattern     -> regex opsional dengan named group, dicocokkan ke
+#                  StructuredError.message untuk mengisi variabel di
+#                  template `penjelasan`/`saran` (format {nama_group})
+#   penjelasan  -> kenapa error ini terjadi
+#   saran       -> cara konkret memperbaikinya
+#
+# Kalau error_type tidak ada di sini, explainer fallback ke
+# rules/universal_categories.yaml berdasarkan `category`.
+
+NameError:
+  category: UNDEFINED_VARIABLE
+  pattern: "name '(?P<var>.+?)' is not defined"
+  penjelasan: >
+    Kode kamu mencoba memakai nama `{var}`, tapi Python belum pernah
+    melihat nama itu didefinisikan sebelumnya di titik ini.
+  saran: >
+    Periksa apakah `{var}` sudah kamu isi nilainya sebelum baris ini,
+    atau cek kemungkinan salah ketik nama variabel/fungsi.
+
+UnboundLocalError:
+  category: UNDEFINED_VARIABLE
+  pattern: "local variable '(?P<var>.+?)'"
+  penjelasan: >
+    Di dalam fungsi ini, `{var}` dianggap sebagai variabel lokal (karena
+    ada baris yang meng-assign nilai ke situ di dalam fungsi), tapi kamu
+    memakainya sebelum baris assignment itu benar-benar dijalankan.
+  saran: >
+    Pastikan `{var}` sudah diberi nilai sebelum dipakai — lewat parameter
+    fungsi, inisialisasi di awal fungsi, atau `global {var}` kalau memang
+    ingin memakai variabel dari luar fungsi.
+
+TypeError:
+  category: TYPE_MISMATCH
+  penjelasan: >
+    Kamu mencoba melakukan operasi pada nilai dengan tipe data yang tidak
+    cocok satu sama lain, atau memanggil sesuatu dengan cara yang tidak
+    sesuai tipe datanya.
+  saran: >
+    Cek tipe data tiap nilai yang terlibat (pakai `type(nilai)` kalau
+    perlu), lalu sesuaikan — misalnya ubah angka jadi teks dengan `str()`,
+    atau sebaliknya dengan `int()`/`float()`.
+
+IndexError:
+  category: INDEX_OUT_OF_BOUNDS
+  penjelasan: >
+    Kamu mencoba mengakses posisi/index pada list atau tuple yang tidak
+    ada — index yang kamu pakai berada di luar jangkauan panjang data
+    tersebut.
+  saran: >
+    Cek dulu panjang list-nya dengan `len(...)` sebelum mengakses index
+    tertentu, dan ingat index di Python dimulai dari 0.
+
+KeyError:
+  category: MISSING_KEY
+  pattern: "'(?P<key>.*)'"
+  penjelasan: >
+    Kamu mencoba mengambil nilai dari dictionary memakai key `{key}`,
+    tapi key itu tidak ada di dalam dictionary tersebut.
+  saran: >
+    Cek dulu apakah key `{key}` benar-benar ada, misalnya dengan
+    `if {key} in dict_kamu:`, atau pakai `dict_kamu.get({key})` yang
+    tidak error kalau key-nya tidak ketemu.
+
+AttributeError:
+  category: ATTRIBUTE_ERROR
+  pattern: "'(?P<tipe>.+?)' object has no attribute '(?P<atribut>.+?)'"
+  penjelasan: >
+    Kamu mencoba memakai atribut atau method `{atribut}` pada objek
+    bertipe `{tipe}`, tapi tipe data itu tidak punya atribut/method
+    dengan nama tersebut.
+  saran: >
+    Cek lagi tipe data objeknya (`type(objek)`) dan pastikan nama
+    method/atributnya benar. Ini juga sering terjadi kalau nilainya
+    ternyata `None` — misalnya karena sebuah fungsi lupa `return`.
+
+ZeroDivisionError:
+  category: DIVISION_BY_ZERO
+  penjelasan: >
+    Kode kamu mencoba membagi sebuah angka dengan 0, yang secara
+    matematika tidak terdefinisikan sehingga Python melempar error.
+  saran: >
+    Tambahkan pengecekan sebelum melakukan pembagian, misalnya
+    `if pembagi != 0:`, atau pastikan nilai pembagi memang tidak pernah
+    nol di kasus kamu.
+
+ImportError:
+  category: MODULE_NOT_FOUND
+  pattern: "cannot import name '(?P<nama>.+?)' from '(?P<modul>.+?)'"
+  penjelasan: >
+    Kamu mencoba meng-import `{nama}` dari modul `{modul}`, tapi Python
+    tidak menemukan nama tersebut di dalam modul itu.
+  saran: >
+    Cek lagi ejaan nama yang di-import, dan pastikan modul `{modul}`
+    memang punya `{nama}` — bisa jadi versi library-nya berbeda dari
+    yang kamu kira.
+
+ModuleNotFoundError:
+  category: MODULE_NOT_FOUND
+  pattern: "No module named '(?P<modul>.+?)'"
+  penjelasan: >
+    Python tidak menemukan modul/package bernama `{modul}` — kemungkinan
+    besar package itu belum ter-install, atau nama modulnya salah ketik.
+  saran: >
+    Coba install dengan `pip install {modul}` (sesuaikan nama package-nya
+    kalau beda dari nama modulnya), dan pastikan virtual environment yang
+    aktif memang sudah menginstall package tersebut.
+
+ValueError:
+  category: VALUE_ERROR
+  penjelasan: >
+    Tipe data yang kamu pakai sudah benar, tapi nilainya tidak masuk
+    akal atau tidak valid untuk operasi yang sedang dilakukan.
+  saran: >
+    Periksa nilai yang dikirim ke fungsi/operasi ini — misalnya kalau
+    ini hasil `int(teks)`, pastikan `teks` benar-benar berisi angka.
+
+FileNotFoundError:
+  category: FILE_NOT_FOUND
+  pattern: "No such file or directory: '(?P<berkas>.+?)'"
+  penjelasan: >
+    Kode kamu mencoba membuka file `{berkas}`, tapi Python tidak
+    menemukan file tersebut di lokasi yang dicari.
+  saran: >
+    Cek lagi path/nama file `{berkas}` — termasuk apakah kamu menjalankan
+    program dari folder yang benar, karena path relatif dihitung dari
+    folder tempat kamu menjalankan perintah, bukan dari lokasi file .py.
+
+IndentationError:
+  category: SYNTAX_ERROR
+  penjelasan: >
+    Python sangat bergantung pada indentasi (spasi/tab di awal baris)
+    untuk mengetahui blok kode mana yang satu level. ada baris yang
+    indentasinya tidak konsisten dengan baris di sekitarnya.
+  saran: >
+    Pastikan kode di blok yang sama (misalnya di dalam satu `if`, `for`,
+    atau fungsi) punya jumlah indentasi yang sama persis. Hindari
+    mencampur tab dan spasi.
+
+SyntaxError:
+  category: SYNTAX_ERROR
+  penjelasan: >
+    Ada bagian kode yang tidak mengikuti aturan penulisan (grammar)
+    Python, sehingga Python tidak bisa mem-parsing/membaca kodenya sama
+    sekali sebelum sempat dijalankan.
+  saran: >
+    Lihat tanda panah (^) di traceback di atas — itu menunjukkan kira-kira
+    di mana Python berhenti memahami kodenya. Cek tanda kurung, titik dua,
+    atau kutip yang mungkin belum ditutup.
+
+RecursionError:
+  category: RECURSION_ERROR
+  penjelasan: >
+    Fungsi kamu memanggil dirinya sendiri (rekursi) terlalu banyak kali
+    tanpa pernah berhenti, sampai melebihi batas kedalaman rekursi yang
+    diizinkan Python.
+  saran: >
+    Pastikan fungsi rekursifmu punya base case (kondisi berhenti) yang
+    pasti tercapai, dan cek apakah tiap pemanggilan rekursif benar-benar
+    membuat progres menuju base case itu.
+
+StopIteration:
+  category: VALUE_ERROR
+  penjelasan: >
+    Kamu memanggil `next()` pada sebuah iterator yang sudah habis — tidak
+    ada lagi elemen yang bisa diambil.
+  saran: >
+    Kalau ini terjadi di dalam loop manual dengan `next()`, tangkap
+    dengan `try/except StopIteration`, atau pertimbangkan memakai `for`
+    biasa yang otomatis berhenti saat iterator habis.

traceback_id/cli.py

@@ -0,0 +1,78 @@
+"""Mode CLI, universal lintas bahasa (ARCHITECTURE.md §2, §6; FR8).
+
+`traceback_id run script.py` mendeteksi bahasa dari ekstensi file, mengambil
+adapter dari `core/registry.py`, lalu `capture()` menjalankan file sebagai
+subprocess dan `parse()` menghasilkan `StructuredError` yang diteruskan ke
+`core/explainer.py` dan `core/formatter.py` seperti biasa.
+"""
+from __future__ import annotations
+
+import argparse
+import sys
+
+from traceback_id import __version__
+from traceback_id.core.explainer import Explainer
+from traceback_id.core.formatter import print_output
+from traceback_id.core.registry import AdapterNotFoundError, get_registry
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="traceback_id",
+        description="Jalankan sebuah file dan dapatkan penjelasan error dalam Bahasa Indonesia.",
+    )
+    parser.add_argument("--version", action="version", version=f"traceback_id {__version__}")
+
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    run_parser = subparsers.add_parser("run", help="Jalankan sebuah file dan tangkap errornya.")
+    run_parser.add_argument("file", help="Path ke file yang akan dijalankan, mis. script.py")
+    run_parser.add_argument(
+        "--lang",
+        default=None,
+        help="Paksa bahasa tertentu (default: deteksi otomatis dari ekstensi file).",
+    )
+    run_parser.add_argument(
+        "args",
+        nargs=argparse.REMAINDER,
+        help="Argumen tambahan yang diteruskan ke file/program.",
+    )
+
+    return parser
+
+
+def main(argv: list | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    if args.command == "run":
+        return _run(args)
+
+    parser.print_help()  # pragma: no cover - argparse `required=True` sudah menutup jalur ini
+    return 1
+
+
+def _run(args: argparse.Namespace) -> int:
+    registry = get_registry()
+    try:
+        adapter = registry.get_by_name(args.lang) if args.lang else registry.get_by_extension(args.file)
+    except AdapterNotFoundError as exc:
+        print(f"traceback_id: {exc}", file=sys.stderr)
+        return 2
+
+    raw_output = adapter.capture([args.file, *args.args])
+    returncode = getattr(adapter, "last_returncode", None)
+    if returncode is None:
+        returncode = 1 if raw_output.strip() else 0
+
+    if not raw_output.strip():
+        return returncode
+
+    structured = adapter.parse(raw_output)
+    explanation = Explainer().explain(structured, adapter)
+    print_output(structured, explanation)
+    return returncode
+
+
+if __name__ == "__main__":
+    sys.exit(main())

traceback_id/core/__init__.py

@@ -0,0 +1 @@
+"""Mesin inti traceback_id — language-agnostic (ARCHITECTURE.md §3)."""

traceback_id/core/explainer.py

@@ -0,0 +1,108 @@
+"""Mencocokkan StructuredError ke rule penjelasan (ARCHITECTURE.md §3, §5).
+
+Prioritas pencarian rule:
+  1. Rule spesifik-bahasa (`adapters/<lang>/rules.yaml`), key = error_type
+  2. Fallback rule universal (`rules/universal_categories.yaml`), key = category
+  3. Fallback generik kalau keduanya tidak ada
+
+Modul ini tidak tahu dan tidak perlu tahu bahasa apa yang sedang diproses —
+hanya bekerja lewat field di `StructuredError` dan `LanguageAdapter.rules_path`.
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from functools import lru_cache
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+import yaml
+
+from traceback_id.core.models import ErrorCategory, StructuredError
+
+if TYPE_CHECKING:
+    from traceback_id.adapters.base import LanguageAdapter
+
+UNIVERSAL_RULES_PATH = Path(__file__).resolve().parent.parent / "rules" / "universal_categories.yaml"
+
+
+@dataclass
+class Explanation:
+    """Hasil akhir penjelasan sebuah StructuredError, siap ditampilkan."""
+
+    penjelasan: str
+    saran: str | None = None
+    source: str = "fallback"  # "language-specific" | "universal" | "fallback"
+
+
+class _SafeDict(dict):
+    """dict yang tidak melempar KeyError saat template.format_map dipakai —
+    supaya rule.yaml yang polanya sedikit meleset tidak sampai membuat
+    traceback_id sendiri crash."""
+
+    def __missing__(self, key: str) -> str:
+        return f"<{key}>"
+
+
+@lru_cache(maxsize=None)
+def _load_yaml(path: Path) -> dict:
+    if not path.exists():
+        return {}
+    with open(path, encoding="utf-8") as fh:
+        return yaml.safe_load(fh) or {}
+
+
+def _extract_variables(pattern: str | None, message: str) -> dict:
+    if not pattern:
+        return {}
+    match = re.search(pattern, message)
+    return match.groupdict() if match else {}
+
+
+def _render(template: str | None, variables: dict) -> str | None:
+    if not template:
+        return None
+    try:
+        return template.format_map(_SafeDict(variables)).strip()
+    except Exception:
+        return template.strip()
+
+
+class Explainer:
+    """Cocokkan StructuredError ke rule & render template penjelasannya."""
+
+    def __init__(self, universal_rules_path: Path | None = None) -> None:
+        self._universal_rules_path = universal_rules_path or UNIVERSAL_RULES_PATH
+
+    def explain(self, error: StructuredError, adapter: "LanguageAdapter") -> Explanation:
+        # 1. Rule spesifik-bahasa, key = error_type native (mis. "NameError")
+        language_rules = _load_yaml(adapter.rules_path)
+        rule = language_rules.get(error.error_type)
+
+        if rule:
+            variables = _extract_variables(rule.get("pattern"), error.message)
+            penjelasan = _render(rule.get("penjelasan"), variables)
+            saran = _render(rule.get("saran"), variables)
+            if penjelasan:
+                return Explanation(penjelasan=penjelasan, saran=saran, source="language-specific")
+
+        # 2. Fallback rule universal, key = category
+        universal_rules = _load_yaml(self._universal_rules_path)
+        category_key = error.category.value if isinstance(error.category, ErrorCategory) else str(error.category)
+        universal_rule = universal_rules.get(category_key)
+
+        if universal_rule:
+            penjelasan = _render(universal_rule.get("penjelasan"), {})
+            saran = _render(universal_rule.get("saran"), {})
+            if penjelasan:
+                return Explanation(penjelasan=penjelasan, saran=saran, source="universal")
+
+        # 3. Tidak ada rule yang cocok sama sekali
+        return Explanation(
+            penjelasan=(
+                "traceback_id belum punya penjelasan khusus untuk jenis error "
+                f"'{error.error_type}' ini."
+            ),
+            saran="Coba baca pesan error asli di atas, atau cari error_type ini di dokumentasi resmi bahasa terkait.",
+            source="fallback",
+        )

traceback_id/core/formatter.py

@@ -0,0 +1,54 @@
+"""Susun raw_output asli + penjelasan jadi satu output akhir (ARCHITECTURE.md §3).
+
+Pewarnaan lewat `rich` bersifat opsional (lihat pyproject.toml) — kalau tidak
+ter-install, fallback otomatis ke teks polos.
+"""
+from __future__ import annotations
+
+import sys
+
+from traceback_id.core.explainer import Explanation
+from traceback_id.core.models import StructuredError
+
+try:
+    from rich.console import Console
+    from rich.panel import Panel
+
+    _HAS_RICH = True
+except ImportError:
+    _HAS_RICH = False
+
+
+_DIVIDER = "-" * 60
+
+
+def format_output(error: StructuredError, explanation: Explanation) -> str:
+    """Versi teks polos, deterministic — dipakai formatter tanpa `rich`
+    dan gampang di-assert langsung di test."""
+    parts = [
+        error.raw_output.rstrip("\n"),
+        _DIVIDER,
+        "penjelasan traceback_id (Bahasa Indonesia):",
+        explanation.penjelasan,
+    ]
+    if explanation.saran:
+        parts.extend(["", f"Saran: {explanation.saran}"])
+    return "\n".join(parts)
+
+
+def print_output(error: StructuredError, explanation: Explanation, use_color: bool | None = None) -> None:
+    """Cetak output akhir ke stderr — dengan warna lewat `rich` kalau
+    tersedia, fallback ke teks polos kalau tidak."""
+    if use_color is None:
+        use_color = _HAS_RICH
+
+    if use_color and _HAS_RICH:
+        console = Console(stderr=True)
+        console.print(error.raw_output.rstrip("\n"), style="dim")
+        body = f"[bold]{explanation.penjelasan}[/bold]"
+        if explanation.saran:
+            body += f"\n\n[green]Saran:[/green] {explanation.saran}"
+        console.print(Panel(body, title="penjelasan traceback_id", border_style="cyan"))
+        return
+
+    print(format_output(error, explanation), file=sys.stderr)

traceback_id/core/models.py

@@ -0,0 +1,52 @@
+"""Struktur data seragam lintas bahasa (ARCHITECTURE.md §3).
+
+`core/` (matcher, explainer, formatter) hanya boleh bergantung pada
+struktur data di file ini — tidak boleh tahu apa pun tentang Python,
+JavaScript, atau bahasa spesifik lainnya.
+"""
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from enum import Enum
+
+
+class ErrorCategory(str, Enum):
+    """Konsep error universal, dipetakan dari error_type native tiap bahasa.
+
+    Ini yang memungkinkan `rules/universal_categories.yaml` dipakai sebagai
+    fallback penjelasan lintas bahasa (lihat ARCHITECTURE.md §5).
+    """
+
+    UNDEFINED_VARIABLE = "UNDEFINED_VARIABLE"
+    TYPE_MISMATCH = "TYPE_MISMATCH"
+    INDEX_OUT_OF_BOUNDS = "INDEX_OUT_OF_BOUNDS"
+    MISSING_KEY = "MISSING_KEY"
+    DIVISION_BY_ZERO = "DIVISION_BY_ZERO"
+    MODULE_NOT_FOUND = "MODULE_NOT_FOUND"
+    SYNTAX_ERROR = "SYNTAX_ERROR"
+    ATTRIBUTE_ERROR = "ATTRIBUTE_ERROR"
+    FILE_NOT_FOUND = "FILE_NOT_FOUND"
+    RECURSION_ERROR = "RECURSION_ERROR"
+    VALUE_ERROR = "VALUE_ERROR"
+    UNKNOWN = "UNKNOWN"
+
+
+@dataclass
+class StructuredError:
+    """Hasil parsing error mentah, seragam untuk bahasa apa pun.
+
+    Field ini adalah kontrak antara adapter (yang mengisinya lewat
+    `parse()`) dan `core/explainer.py` + `core/formatter.py` (yang
+    membacanya tanpa perlu tahu bahasa asalnya).
+    """
+
+    language: str              # "python", "javascript", "java", ...
+    error_type: str            # nama native, mis. "NameError", "ReferenceError"
+    category: ErrorCategory    # konsep semantik universal, lihat ErrorCategory
+    message: str                # pesan asli dari runtime/compiler
+    file: str | None
+    line: int | None
+    column: int | None = None
+    code_context: str | None = None
+    variables: dict = field(default_factory=dict)
+    raw_output: str = ""        # traceback/stack trace asli, untuk ditampilkan utuh

traceback_id/core/registry.py

@@ -0,0 +1,81 @@
+"""Daftar adapter yang tersedia — built-in + plugin komunitas (ARCHITECTURE.md §3).
+
+Built-in didaftarkan manual di `_register_builtin_adapters()`. Plugin
+komunitas ditemukan otomatis lewat `importlib.metadata.entry_points` dengan
+grup `traceback_id.adapters`, tanpa perlu mengubah file ini (ARCHITECTURE.md
+§1, "Dibuka untuk plugin komunitas").
+"""
+from __future__ import annotations
+
+from importlib import metadata
+from pathlib import Path
+
+from traceback_id.adapters.base import LanguageAdapter
+
+ENTRY_POINT_GROUP = "traceback_id.adapters"
+
+
+class AdapterNotFoundError(Exception):
+    """Tidak ada adapter yang cocok untuk bahasa/ekstensi file yang diminta."""
+
+
+class Registry:
+    def __init__(self) -> None:
+        self._adapters: dict = {}
+        self._register_builtin_adapters()
+        self._discover_plugin_adapters()
+
+    def _register_builtin_adapters(self) -> None:
+        from traceback_id.adapters.python.adapter import PythonAdapter
+
+        self.register(PythonAdapter())
+
+    def _discover_plugin_adapters(self) -> None:
+        try:
+            entry_points = metadata.entry_points(group=ENTRY_POINT_GROUP)
+        except TypeError:
+            # Python 3.8/3.9: entry_points() tidak menerima kwarg `group`.
+            entry_points = metadata.entry_points().get(ENTRY_POINT_GROUP, [])
+
+        for ep in entry_points:
+            try:
+                adapter_cls = ep.load()
+                self.register(adapter_cls())
+            except Exception as exc:  # pragma: no cover - defensif, jangan sampai plugin rusak matikan CLI
+                print(f"[traceback_id] gagal memuat plugin adapter '{ep.name}': {exc}")
+
+    def register(self, adapter: LanguageAdapter) -> None:
+        self._adapters[adapter.name] = adapter
+
+    def get_by_name(self, name: str) -> LanguageAdapter:
+        try:
+            return self._adapters[name]
+        except KeyError as exc:
+            raise AdapterNotFoundError(
+                f"Adapter untuk bahasa '{name}' tidak ditemukan. "
+                f"Bahasa yang tersedia: {', '.join(self.available_languages()) or '(tidak ada)'}"
+            ) from exc
+
+    def get_by_extension(self, path) -> LanguageAdapter:
+        ext = Path(path).suffix.lower()
+        for adapter in self._adapters.values():
+            if ext in adapter.file_extensions:
+                return adapter
+        raise AdapterNotFoundError(
+            f"Tidak ada adapter yang mendukung ekstensi file '{ext}'. "
+            f"Bahasa yang tersedia: {', '.join(self.available_languages()) or '(tidak ada)'}"
+        )
+
+    def available_languages(self) -> list:
+        return sorted(self._adapters)
+
+
+_default_registry: Registry | None = None
+
+
+def get_registry() -> Registry:
+    """Registry singleton default, dipakai oleh cli.py."""
+    global _default_registry
+    if _default_registry is None:
+        _default_registry = Registry()
+    return _default_registry

traceback_id/hook.py

@@ -0,0 +1,53 @@
+"""Mode in-process, khusus Python (ARCHITECTURE.md §2, §6).
+
+Memasang `sys.excepthook` supaya exception yang tidak tertangani otomatis
+lewat `adapters/python/adapter.py` -> `core/explainer.py` -> `core/formatter.py`
+sebelum ditampilkan. Ini satu-satunya adapter yang punya mode in-process,
+karena Python adalah bahasa implementasi library ini sendiri.
+"""
+from __future__ import annotations
+
+import sys
+import traceback as _traceback_module
+
+from traceback_id.adapters.python.adapter import PythonAdapter
+from traceback_id.core.explainer import Explainer
+from traceback_id.core.formatter import print_output
+
+_adapter = PythonAdapter()
+_explainer = Explainer()
+_original_excepthook = None
+
+
+def _excepthook(exc_type, exc_value, exc_tb) -> None:
+    raw_output = "".join(_traceback_module.format_exception(exc_type, exc_value, exc_tb))
+    try:
+        structured = _adapter.parse(raw_output)
+        explanation = _explainer.explain(structured, _adapter)
+        print_output(structured, explanation)
+    except Exception:
+        # Kalau traceback_id sendiri gagal, jangan sampai menelan traceback
+        # asli pengguna — selalu jatuh balik ke excepthook bawaan Python.
+        sys.__excepthook__(exc_type, exc_value, exc_tb)
+
+
+def activate() -> None:
+    """Aktifkan penjelasan error otomatis untuk exception yang tidak
+    tertangani (FR4). Tidak mengubah exit code program (FR1)."""
+    global _original_excepthook
+    if _original_excepthook is not None:
+        return  # sudah aktif
+    _original_excepthook = sys.excepthook
+    sys.excepthook = _excepthook
+
+
+def deactivate() -> None:
+    """Kembalikan sys.excepthook ke behavior sebelum activate() dipanggil (FR6)."""
+    global _original_excepthook
+    if _original_excepthook is not None:
+        sys.excepthook = _original_excepthook
+        _original_excepthook = None
+
+
+def is_active() -> bool:
+    return _original_excepthook is not None

traceback_id/rules/universal_categories.yaml

@@ -0,0 +1,99 @@
+# Penjelasan generik per ErrorCategory (ARCHITECTURE.md §5), dipakai sebagai
+# fallback kalau tidak ada rule spesifik-bahasa yang cocok di
+# adapters/<lang>/rules.yaml. Karena dipakai lintas bahasa pemrograman,
+# penjelasannya sengaja netral — tidak menyebut istilah spesifik satu
+# bahasa saja.
+
+UNDEFINED_VARIABLE:
+  penjelasan: >
+    Kamu mencoba memakai sesuatu (variabel, fungsi, atau nama lain) yang
+    belum didefinisikan, atau sudah keluar dari jangkauan (scope)-nya di
+    titik kode ini.
+  saran: >
+    Periksa penulisan namanya, dan pastikan sudah didefinisikan sebelum
+    dipakai di baris ini.
+
+TYPE_MISMATCH:
+  penjelasan: >
+    Ada operasi yang dilakukan pada nilai dengan tipe data yang tidak
+    cocok atau tidak didukung untuk operasi tersebut.
+  saran: >
+    Cek tipe data nilai-nilai yang terlibat, lalu konversi ke tipe yang
+    sesuai sebelum melakukan operasinya.
+
+INDEX_OUT_OF_BOUNDS:
+  penjelasan: >
+    Kamu mencoba mengakses posisi/index pada kumpulan data (list, array,
+    dsb.) yang berada di luar jangkauan panjang data tersebut.
+  saran: >
+    Cek dulu panjang/ukuran datanya sebelum mengakses index tertentu.
+
+MISSING_KEY:
+  penjelasan: >
+    Kamu mencoba mengambil nilai dari struktur data (seperti dictionary
+    atau map) memakai kunci yang ternyata tidak ada di dalamnya.
+  saran: >
+    Pastikan kunci yang dipakai benar-benar ada sebelum mengambil
+    nilainya, atau sediakan nilai default kalau kunci tidak ditemukan.
+
+DIVISION_BY_ZERO:
+  penjelasan: >
+    Ada pembagian dengan angka 0, yang secara matematika tidak
+    terdefinisikan.
+  saran: >
+    Tambahkan pengecekan supaya pembagi tidak pernah bernilai 0 sebelum
+    melakukan pembagian.
+
+MODULE_NOT_FOUND:
+  penjelasan: >
+    Program mencoba memakai modul/package/library yang tidak ditemukan —
+    kemungkinan belum ter-install, salah nama, atau belum diimpor dengan
+    benar.
+  saran: >
+    Pastikan nama modulnya benar dan sudah ter-install di environment
+    yang kamu pakai untuk menjalankan program.
+
+SYNTAX_ERROR:
+  penjelasan: >
+    Ada bagian kode yang tidak mengikuti aturan penulisan bahasa
+    pemrogramannya, sehingga kode tidak bisa diproses sama sekali sebelum
+    sempat dijalankan.
+  saran: >
+    Periksa tanda kurung, titik dua/titik koma, kutip, dan indentasi di
+    sekitar lokasi error yang ditunjukkan.
+
+ATTRIBUTE_ERROR:
+  penjelasan: >
+    Kamu mencoba memakai atribut, properti, atau method yang tidak
+    dimiliki oleh tipe data/objek tersebut.
+  saran: >
+    Cek lagi tipe data objeknya dan pastikan nama atribut/method-nya
+    benar.
+
+FILE_NOT_FOUND:
+  penjelasan: >
+    Program mencoba membuka atau mengakses file yang tidak ditemukan di
+    lokasi yang dicari.
+  saran: >
+    Cek lagi nama dan lokasi (path) file-nya, termasuk folder tempat
+    kamu menjalankan program.
+
+RECURSION_ERROR:
+  penjelasan: >
+    Sebuah fungsi memanggil dirinya sendiri terlalu banyak kali tanpa
+    pernah berhenti, sampai melebihi batas kedalaman yang diizinkan.
+  saran: >
+    Pastikan ada kondisi berhenti (base case) yang pasti tercapai dalam
+    fungsi rekursifmu.
+
+VALUE_ERROR:
+  penjelasan: >
+    Tipe datanya sudah sesuai, tapi nilainya tidak valid atau tidak masuk
+    akal untuk operasi yang sedang dilakukan.
+  saran: >
+    Periksa lagi nilai yang dipakai, terutama kalau nilainya berasal dari
+    input pengguna atau konversi tipe data.
+
+# Sengaja tidak ada entri UNKNOWN di sini — kalau category-nya benar-benar
+# UNKNOWN (tidak ada rule bahasa maupun mapping kategori yang cocok),
+# core/explainer.py jatuh ke fallback generik bawaan kode (tier ke-3).

traceback_id-0.1.0.dist-info/METADATA

@@ -0,0 +1,191 @@
+Metadata-Version: 2.4
+Name: traceback-id
+Version: 0.1.0
+Summary: Penjelasan error/traceback pemrograman dalam Bahasa Indonesia, untuk pemula.
+Author: traceback_id contributors
+License: MIT
+Project-URL: Homepage, https://github.com/traceback-id/traceback_id
+Project-URL: Issues, https://github.com/traceback-id/traceback_id/issues
+Keywords: error,traceback,bahasa indonesia,belajar coding,education,debugging
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Intended Audience :: Education
+Classifier: Natural Language :: Indonesian
+Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Education
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyYAML>=6.0
+Provides-Extra: color
+Requires-Dist: rich>=13.0; extra == "color"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: rich>=13.0; extra == "dev"
+Dynamic: license-file
+
+# traceback_id
+
+Penjelasan error/traceback pemrograman dalam **Bahasa Indonesia**, untuk
+pemula — dimulai dari Python.
+
+
+## Kenapa traceback_id?
+
+Traceback Python (atau stack trace/compiler error di bahasa lain) ditulis
+dalam bahasa Inggris teknis yang sering bikin pemula mentok. traceback_id
+tetap menampilkan error aslinya (developer berpengalaman tetap butuh itu),
+lalu menambahkan penjelasan singkat dalam Bahasa Indonesia: **kenapa** error
+ini terjadi, dan **apa** yang bisa dicoba untuk memperbaikinya.
+
+## Instalasi
+
+```bash
+pip install -e ".[color]"
+```
+
+`rich` (untuk output berwarna) sifatnya opsional — tanpa `[color]`,
+traceback_id tetap berfungsi penuh dengan output teks polos.
+
+## Pemakaian
+
+### Mode in-process (khusus Python — DX terbaik)
+
+```python
+import traceback_id
+traceback_id.activate()
+
+print(nilai_yang_tidak_ada)
+```
+
+```
+Traceback (most recent call last):
+  File "contoh.py", line 4, in <module>
+    print(nilai_yang_tidak_ada)
+NameError: name 'nilai_yang_tidak_ada' is not defined
+------------------------------------------------------------
+penjelasan traceback_id (Bahasa Indonesia):
+Kode kamu mencoba memakai nama `nilai_yang_tidak_ada`, tapi Python belum
+pernah melihat nama itu didefinisikan sebelumnya di titik ini.
+
+Saran: Periksa apakah `nilai_yang_tidak_ada` sudah kamu isi nilainya
+sebelum baris ini, atau cek kemungkinan salah ketik nama variabel/fungsi.
+```
+
+Nonaktifkan kapan saja dengan `traceback_id.deactivate()` — traceback
+kembali ke behavior default Python, dan exit code program tidak berubah.
+
+### Mode CLI (universal — dipakai bahasa apa pun yang punya adapter)
+
+```bash
+traceback_id run script.py
+```
+
+Ekstensi file (`.py`, nanti `.js`, `.java`, dst) dipakai untuk memilih
+adapter secara otomatis, atau paksa lewat `--lang`:
+
+```bash
+traceback_id run script.mjs --lang javascript
+```
+
+### Contoh untuk dicoba
+
+```bash
+traceback_id run examples/demo_errors.py name_error
+traceback_id run examples/syntax_error_demo.py
+traceback_id run examples/indentation_error_demo.py
+```
+
+Lihat `examples/demo_errors.py` untuk daftar lengkap 15 jenis error yang
+di-cover di v0.1 (`name_error`, `type_error`, `index_error`, `key_error`,
+`attribute_error`, `zero_division_error`, `import_error`,
+`module_not_found_error`, `value_error`, `file_not_found_error`,
+`recursion_error`, `stop_iteration`, `unbound_local_error`, plus
+`syntax_error_demo.py` & `indentation_error_demo.py` yang terpisah).
+
+## Struktur Proyek
+
+```
+traceback_id/
+├── traceback_id/              # package yang diinstall
+│   ├── __init__.py            # activate() / deactivate() publik
+│   ├── hook.py                # sys.excepthook, mode in-process
+│   ├── cli.py                 # `traceback_id run <file>`
+│   ├── core/                  # mesin inti — language-agnostic
+│   │   ├── models.py          # StructuredError, ErrorCategory
+│   │   ├── explainer.py       # cocokkan rule, render template
+│   │   ├── formatter.py       # gabung traceback asli + penjelasan
+│   │   └── registry.py        # daftar adapter (built-in + plugin)
+│   ├── adapters/
+│   │   ├── base.py            # LanguageAdapter (kontrak)
+│   │   └── python/
+│   │       ├── adapter.py     # capture (hook + subprocess), parser
+│   │       └── rules.yaml     # 15 error type Python v0.1
+│   └── rules/
+│       └── universal_categories.yaml   # fallback lintas bahasa
+├── tests/
+│   ├── test_core/
+│   ├── test_adapters/
+│   └── test_contract.py       # semua adapter wajib lolos test ini
+├── examples/
+│   └── demo_errors.py
+├── pyproject.toml
+└── README.md
+```
+
+Menambah bahasa baru = buat folder `traceback_id/adapters/<bahasa>/` berisi
+`adapter.py` (implementasi `LanguageAdapter`) + `rules.yaml` — `core/` tidak
+perlu disentuh sama sekali (lihat `ARCHITECTURE.md` §7).
+
+## Menambah Rule Baru (Python)
+
+Rule ada di `traceback_id/adapters/python/rules.yaml`, key-nya = nama
+error native (mis. `NameError`). Tidak perlu ubah kode inti:
+
+```yaml
+NamaErrorBaru:
+  category: KATEGORI_UNIVERSAL_YANG_SESUAI   # lihat ErrorCategory di core/models.py
+  pattern: "regex opsional dengan (?P<nama_variabel>...)"
+  penjelasan: >
+    Penjelasan kenapa error ini terjadi. Bisa pakai {nama_variabel} yang
+    diambil dari `pattern` di atas.
+  saran: >
+    Saran konkret cara memperbaikinya.
+```
+
+## Kontribusi Adapter Bahasa Baru (fase komunitas)
+
+Setelah kontrak `LanguageAdapter` dibuka untuk plugin (roadmap Fase 3 —
+lihat `PRD.md` §10), adapter bahasa baru bisa didistribusikan sebagai
+package Python terpisah dan otomatis terdeteksi lewat `entry_points`:
+
+```toml
+# pyproject.toml package plugin kamu, mis. traceback-id-javascript
+[project.entry-points."traceback_id.adapters"]
+javascript = "traceback_id_javascript.adapter:JavaScriptAdapter"
+```
+
+Semua adapter — built-in maupun plugin — wajib lolos `tests/test_contract.py`.
+
+## Menjalankan Test
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## Status & Roadmap
+
+Draft v0.1 (MVP): arsitektur core + adapter diterapkan, adapter Python
+matang (15 jenis error, mode in-process & CLI). Roadmap lengkap
+(JavaScript di v0.3, Java + `entry_points` publik di v0.4, dst) ada di
+`PRD.md` §10 dan `ARCHITECTURE.md` §10.
+
+## Lisensi
+
+MIT — lihat [`LICENSE`](LICENSE).

traceback_id-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+traceback_id/__init__.py,sha256=22TRl9vvLO576GNgjsxdAl-5GahwcAdGV-5SzdqhQEY,555
+traceback_id/__main__.py,sha256=qkzyvM0j9bKmEouFAkHPVuhvWr92D4mWPxGqGYl5r1A,131
+traceback_id/cli.py,sha256=E_Vo0oT-NMi92dYcEINcy4h6SpOsAenNzC4aWR2X-xk,2594
+traceback_id/hook.py,sha256=KB-uOM8DY5V5FKdy-a3FbEneiJfEW69qqL64dTN84-w,1909
+traceback_id/adapters/__init__.py,sha256=w__gKur4jxqGACU_le9uDrmZO5IBZaKQeCtkaz4MyS4,69
+traceback_id/adapters/base.py,sha256=DmKesegCNvEYK5D_JncU_5XfZ6ha4g32v2wDhOfNsL0,1138
+traceback_id/adapters/python/__init__.py,sha256=yLFuuLlP94WCw8dw3H8p7TBLKaJpi-jBKxf4j91MePo,82
+traceback_id/adapters/python/adapter.py,sha256=4fbm19ZEjxCea1ZkHSUcHqWOCll3FlYtqkQ8B0fw90A,5085
+traceback_id/adapters/python/rules.yaml,sha256=162lhcpBsvOQdmeveNyKRATReuMa29AH0Qz_yvpzmL4,6990
+traceback_id/core/__init__.py,sha256=sIYlxO174AEpdCu6OsWFUNl4tHtUqBatCXwFW5J4btw,75
+traceback_id/core/explainer.py,sha256=fUBx7_ZPnlUgXiNosBj_MR0i6PmVrevDlG7BwUrA0lw,3896
+traceback_id/core/formatter.py,sha256=0EZsZ584bDy1V0PfoDeOLlYv9CpUe8Ua3y--pVGMvSU,1755
+traceback_id/core/models.py,sha256=5ZwaxPzbg-RCQWG4SlfhRBsXEYTV_LGteTWWLqX5uuc,1899
+traceback_id/core/registry.py,sha256=iPnPQSO4y-Q2cds-iRgj86pPMTqc2zE4sp8IQTWEXOA,2907
+traceback_id/rules/universal_categories.yaml,sha256=PLlSiD7lcP5RneE-l1cVl7OXXqFiJ9P6-HGi-dbuRUY,3580
+traceback_id-0.1.0.dist-info/licenses/LICENSE,sha256=s-eFVE2OqauKQO6tSOc7MbhKc5E3LDvLb2GJ1A5ARVs,1082
+traceback_id-0.1.0.dist-info/METADATA,sha256=SpxdMFgtT1FfJsxYLNL1FZFeZIiAza6gYrPE8mvqqqQ,6828
+traceback_id-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+traceback_id-0.1.0.dist-info/entry_points.txt,sha256=SYVIIM8s6dQvQjwYnyWuSO8F5lvJrnfBZSf9hL1F6hc,55
+traceback_id-0.1.0.dist-info/top_level.txt,sha256=VkG5K7QhrUMJaQO5iZOOOA6Uv1gE_mA7b2gZ9KSFS70,13
+traceback_id-0.1.0.dist-info/RECORD,,

traceback_id-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

traceback_id-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+traceback_id = traceback_id.cli:main

traceback_id-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 traceback_id contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

traceback_id-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+traceback_id