# ztrue/tracerr

Golang errors with stack trace and source fragments.

Repository: https://github.com/ztrue/tracerr
Canonical: https://ross.abutalabs.com/products/tracerr
Language: Go
License: MIT
License Family: permissive
Topics: golang, go, stacktrace, debug, error-handling, errors, errors-log, source-map
Last push: 2026-04-02T00:18:58+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 75, release rhythm 35, longevity 100
- inputs: {"age_days": 2765, "days_push": 154, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1120, forks 43 (observed 2026-08-28T04:03:39.714556+00:00)

## What it is
A Go library that adds stack traces and source code fragments to errors. It wraps existing errors or creates new ones, then prints or formats them with colored source context for easier debugging.

## Use cases
- add stack traces to errors in go
- print error source code fragments
- debug uninformative error output
- wrap errors with stack trace
- get stack trace frames from an error
- format errors with color for logs

## When to choose
- you need richer error output than plain Go error strings
- you want source code context attached to stack traces
- you need a lightweight drop-in error wrapper in Go

## When to avoid
- you need error wrapping compatible with Go 1.13 errors.Is/As semantics
- performance-critical hot paths where stack capture is too costly
- you prefer structured error types like pkg/errors alternatives

## Facets
- artifact type: library
- maturity: stable
- function: error-handling, logging, developer-tools
- domain: developer-tools, backend
- platform: go, cross-platform
- tags: stacktrace, source-fragments, error-wrapping, debugging, golang

## Member repositories
- ztrue/tracerr (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:39.714556+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:41:08.143824+00:00, confidence not recorded.
  - readme: https://github.com/ztrue/tracerr (fetched 2026-08-28T04:03:39.714556+00:00, sha c95e676a8901)
- Data as of 2026-08-30T08:39:29.467469+00:00.