# natefinch/gorram

It's like go run for any go function

Repository: https://github.com/natefinch/gorram
Canonical: https://ross.abutalabs.com/products/gorram
Language: Go
License: MIT
License Family: permissive
Topics: go, golang, code-generation
Last push: 2025-06-13T15:10:42+00:00

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

## Adoption (not part of the score)
Stars 1050, forks 33 (observed 2026-08-28T04:03:22.985997+00:00)

## What it is
gorram is a Go CLI tool that lets you run any exported Go function from the standard library or your GOPATH directly from the command line, like 'go run' for arbitrary functions. It analyzes the function signature, generates a wrapper script, and converts CLI arguments and stdin into function arguments, printing results to stdout.

## Use cases
- pretty-print JSON from the command line using encoding/.Indent
- compute a sha256 checksum of a file without writing a Go program
- quickly test or call any stdlib or GOPATH Go function from the shell
- pipe stdin into a Go function that accepts an io.Reader
- format function output with a Go template for scripting

## When to choose
- you want to invoke a Go function ad hoc without writing a main package
- you're scripting small utilities on top of Go stdlib functions
- you want a quick REPL-like way to exercise Go code from the shell

## When to avoid
- you need to call unexported functions or methods
- you don't have a working Go toolchain installed
- you need a production-grade CLI for a specific task rather than a generic function runner

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: cli, developer-tools
- domain: developer-tools, programming-languages
- platform: cli, go, cross-platform
- tags: go-run, function-runner, reflection, code-generation, cli-helpers, command-line

## Member repositories
- natefinch/gorram (main) score 34

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:22.985997+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-30T07:00:23.473943+00:00, confidence not recorded.
  - readme: https://github.com/natefinch/gorram (fetched 2026-08-28T04:03:22.985997+00:00, sha d64cbd87f756)
- Data as of 2026-08-30T08:39:29.467469+00:00.