| # panicparse | |
| Run `make help` for available targets. Before committing, run `make fix`, | |
| `make verify`, and `make test`. Install Git hooks with `make git-hooks`. | |
| `make test` runs coverage and benchmark smoke checks. | |
| Use `make test-race` for race checks. | |
| Run Python tools and scripts with `uv run --locked`. | |
| <!-- BEGIN FILE INDEX --> | |
| ## File Index | |
| Autogenerated from first-line comments. Run scripts/update_agents_file_index.py to refresh. | |
| - `.github/workflows/test.yml`: CI checks for tests, coverage, static analysis, and generated files. | |
| - `.golangci.yml`: Go formatting and static analysis configuration. | |
| - `Makefile`: Repository development targets and pinned static analysis tools. | |
| - `README.md`: panicparse | |
| - `cmd/panic/internal/incorrect/correct.go`: Package correct is in directory incorrect. If the call stack is | |
| - `cmd/panic/internal/internal.go`: Package internal is for use for panic. | |
| - `cmd/panic/internal/utf8/utf8.go`: Package รนtf8 tests a package and function with non-ASCII names. | |
| - `cmd/panic/main.go`: panic crashes in various ways. | |
| - `cmd/panic/main_no_race.go`: Disable intentional race scenarios in builds without race instrumentation. | |
| - `cmd/panic/main_race.go`: Enable intentional race scenarios in race-instrumented builds. | |
| - `cmd/panic/main_test.go`: Tests panic scenarios and trusted executable restart behavior. | |
| - `cmd/panicweb/internal/internal.go`: Package internal implements the handlers for panicweb so they are in a | |
| - `cmd/panicweb/main.go`: panicweb implements a simulation of a web server that panics. | |
| - `cmd/panicweb/main_others.go`: Unsupported-platform fallback for the blocked-system-call scenario. | |
| - `cmd/panicweb/main_unix.go`: Create a long nanosleep system call for Unix goroutine snapshots. | |
| - `cmd/panicweb/main_windows.go`: Create a blocked system call for Windows goroutine snapshots. | |
| - `cmd/pp/main.go`: pp: analyzes stack dump of Go processes and simplifies it. | |
| - `codecov.yml`: https://docs.codecov.io/docs/codecovyml-reference | |
| - `internal/internaltest/internaltest.go`: Compile and run panic fixtures and retrieve recorded goroutine snapshots. | |
| - `internal/internaltest/static_panic_race.go`: Recorded race-detector output for stack parsing tests. | |
| - `internal/internaltest/static_panicweb.go`: Recorded panicweb goroutine output for stack parsing tests. | |
| - `internal/internaltest/static_panicweb.sh`: Capture panicweb goroutine output and normalize local toolchain paths. | |
| - `internal/main.go`: Package internal implements panicparse | |
| - `internal/main_test.go`: Tests CLI options, snapshot processing, and consecutive snapshots. | |
| - `internal/ui.go`: Format stack buckets, goroutines, paths, and colors for terminal output. | |
| - `internal/ui_test.go`: Tests terminal bucket headers, stack lines, and column widths. | |
| - `main.go`: panicparse: analyzes stack dump of Go processes and simplifies it. | |
| - `pyproject.toml`: Locked Python development tools and repository script checks. | |
| - `scripts/AGENTS.md`: Development scripts | |
| - `stack/README.md`: Templates | |
| - `stack/bucket.go`: Group goroutines by stack signatures and argument similarity. | |
| - `stack/bucket_test.go`: Tests and benchmarks goroutine grouping and argument matching. | |
| - `stack/context.go`: Read goroutine snapshots, infer source roots, and augment stack information. | |
| - `stack/context_test.go`: Tests snapshot scanning, module paths, source roots, and panic integration. | |
| - `stack/data.go`: Code generated by regen.go. DO NOT EDIT. | |
| - `stack/example_test.go`: Examples rendering text and HTML snapshots and capturing HTTP panics. | |
| - `stack/html.go`: Render snapshots and aggregated goroutines as HTML with source links. | |
| - `stack/html_test.go`: Tests HTML rendering, source links, symbol names, and snapshot output. | |
| - `stack/reader.go`: Buffered line reading for goroutine snapshot parsing. | |
| - `stack/regen.go`: Generate the embedded HTML stack template and favicon. | |
| - `stack/source.go`: This file contains the code to process sources, to be able to deduct the | |
| - `stack/source_test.go`: Tests source augmentation, argument decoding, and native panic fixtures. | |
| - `stack/stack.go`: Package stack analyzes stack dump of Go processes and simplifies it. | |
| - `stack/stack_test.go`: Tests stack functions, call signatures, arguments, and goroutine comparisons. | |
| - `stack/webstack/example_test.go`: Examples exposing goroutine snapshots through an HTTP handler. | |
| - `stack/webstack/webstack.go`: Package webstack provides a http.HandlerFunc that serves a snapshot similar | |
| - `stack/webstack/webstack_test.go`: Tests and benchmarks HTTP snapshots, errors, methods, and memory limits. | |
| <!-- END FILE INDEX --> |