{"id":34175154,"url":"https://github.com/dio/run","last_synced_at":"2026-03-11T02:03:42.739Z","repository":{"id":310906880,"uuid":"1041725561","full_name":"dio/run","owner":"dio","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-20T23:59:03.000Z","size":54,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-18T09:28:03.837Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-20T23:31:36.000Z","updated_at":"2025-08-20T23:37:54.000Z","dependencies_parsed_at":"2025-08-21T00:28:50.221Z","dependency_job_id":"d269f466-6ef1-4bb7-9a8f-75b924ee54dc","html_url":"https://github.com/dio/run","commit_stats":null,"previous_names":["dio/run"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/dio/run","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dio%2Frun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dio%2Frun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dio%2Frun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dio%2Frun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dio","download_url":"https://codeload.github.com/dio/run/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dio%2Frun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30367810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"online","status_checked_at":"2026-03-11T02:00:07.027Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-12-15T12:05:38.775Z","updated_at":"2026-03-11T02:03:42.731Z","avatar_url":"https://github.com/dio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# run\n\n[![CI](https://github.com/dio/run/actions/workflows/ci.yml/badge.svg)](https://github.com/dio/run/actions/workflows/ci.yml)\n[![Go Reference](https://pkg.go.dev/badge/github.com/dio/run.svg)](https://pkg.go.dev/github.com/dio/run)\n[![Go Report Card](https://goreportcard.com/badge/github.com/dio/run)](https://goreportcard.com/report/github.com/dio/run)\n\nA drop-in replacement for [oklog/run](https://github.com/oklog/run) with automatic panic recovery.\n\n## Features\n\n- **Drop-in replacement**: Compatible with `oklog/run.Group` API\n- **Automatic panic recovery**: All panics in actors are caught and converted to errors\n- **Custom panic handlers**: Optional custom handling of panic situations\n- **Zero dependencies**: Only depends on `oklog/run`\n- **100% test coverage**: Thoroughly tested with comprehensive test suite\n\n## Installation\n\n```bash\ngo get github.com/dio/run\n```\n\n## Quick Start\n\n```go\npackage main\n\nimport (\n    \"errors\"\n    \"fmt\"\n    \"log\"\n\n    \"github.com/dio/run\"\n)\n\nfunc main() {\n    g := run.New()\n\n    // Add an actor that might panic\n    g.Add(func() error {\n        // This panic will be caught and converted to an error\n        panic(\"something went wrong\")\n    }, func(err error) {\n        log.Printf(\"Actor interrupted: %v\", err)\n    })\n\n    // Add a normal actor\n    g.Add(func() error {\n        return errors.New(\"normal error\")\n    }, func(err error) {\n        log.Printf(\"Actor interrupted: %v\", err)\n    })\n\n    if err := g.Run(); err != nil {\n        log.Printf(\"Group failed: %v\", err)\n    }\n}\n```\n\n## Usage\n\n### Basic Usage\n\nThe `run.Group` works exactly like `oklog/run.Group` but with automatic panic recovery:\n\n```go\ng := run.New()\n\ng.Add(execute, interrupt)\n\nerr := g.Run()\n```\n\n### Custom Panic Handler\n\nYou can provide a custom panic handler to process panics in your own way:\n\n```go\ng := run.NewWithHandler(func(panicValue any, stackTrace string) error {\n    // Log the panic with custom formatting\n    log.Printf(\"PANIC: %v\\nStack trace:\\n%s\", panicValue, stackTrace)\n\n    // Return a custom error\n    return fmt.Errorf(\"actor panicked: %v\", panicValue)\n})\n```\n\n### Error Handling\n\nWhen an actor panics, it's automatically converted to a `PanicError`:\n\n```go\nerr := g.Run()\nif err != nil {\n    if panicErr, ok := err.(*run.PanicError); ok {\n        fmt.Printf(\"Actor panicked with value: %v\\n\", panicErr.Value)\n        fmt.Printf(\"Stack trace:\\n%s\\n\", panicErr.StackTrace)\n    }\n}\n```\n\n## API Reference\n\n### Types\n\n#### Group\n\n```go\ntype Group struct {\n    // PanicHandler is called when an actor panics.\n    // If nil, panics are converted to PanicError and returned.\n    PanicHandler func(panicValue any, stackTrace string) error\n}\n```\n\n#### PanicError\n\n```go\ntype PanicError struct {\n    Value      any    // The panic value\n    StackTrace string // Stack trace at panic time\n}\n```\n\n### Functions\n\n#### New\n\n```go\nfunc New() *Group\n```\n\nCreates a new Group with panic recovery enabled.\n\n#### NewWithHandler\n\n```go\nfunc NewWithHandler(handler func(panicValue any, stackTrace string) error) *Group\n```\n\nCreates a new Group with a custom panic handler.\n\n### Methods\n\n#### Add\n\n```go\nfunc (g *Group) Add(execute func() error, interrupt func(error))\n```\n\nAdd an actor to the group. This is a drop-in replacement for `oklog/run.Group.Add()`.\n\n#### Run\n\n```go\nfunc (g *Group) Run() error\n```\n\nExecute all actors. This is identical to `oklog/run.Group.Run()`.\n\n## Development\n\n### Prerequisites\n\n- Go 1.24+\n- golangci-lint (installed via `go tool`)\n\n### Building\n\n```bash\ngo build ./...\n```\n\n### Testing\n\n```bash\ngo test -v -race -coverprofile=coverage.out ./...\ngo tool cover -html=coverage.out\n```\n\n### Linting\n\n```bash\ngo tool golangci-lint run\n```\n\n### Formatting\n\n```bash\ngo tool golangci-lint fmt\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Add tests for your changes\n5. Ensure all tests pass (`go test ./...`)\n6. Run linting (`go tool golangci-lint run`)\n7. Commit your changes (`git commit -am 'Add amazing feature'`)\n8. Push to the branch (`git push origin feature/amazing-feature`)\n9. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [oklog/run](https://github.com/oklog/run) - The original actor model implementation\n- Inspired by the need for safer concurrent programming in Go\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdio%2Frun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdio%2Frun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdio%2Frun/lists"}