{"id":15686378,"url":"https://github.com/brittonhayes/roll","last_synced_at":"2025-05-07T18:41:21.939Z","repository":{"id":40306992,"uuid":"491321666","full_name":"brittonhayes/roll","owner":"brittonhayes","description":"A simple Go package and CLI for dice rolling 🎲","archived":false,"fork":false,"pushed_at":"2023-12-18T23:02:03.000Z","size":658,"stargazers_count":10,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-31T12:58:09.799Z","etag":null,"topics":["cli","docker","dungeons-and-dragons","go","rpg"],"latest_commit_sha":null,"homepage":"","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/brittonhayes.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}},"created_at":"2022-05-12T01:15:54.000Z","updated_at":"2024-12-07T23:53:38.000Z","dependencies_parsed_at":"2024-06-19T11:15:15.805Z","dependency_job_id":"b017c6ba-5470-4c39-8f4d-dc864840b7f7","html_url":"https://github.com/brittonhayes/roll","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittonhayes%2Froll","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittonhayes%2Froll/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittonhayes%2Froll/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittonhayes%2Froll/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brittonhayes","download_url":"https://codeload.github.com/brittonhayes/roll/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252936124,"owners_count":21828084,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cli","docker","dungeons-and-dragons","go","rpg"],"created_at":"2024-10-03T17:39:02.408Z","updated_at":"2025-05-07T18:41:21.918Z","avatar_url":"https://github.com/brittonhayes.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎲 Roll\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/brittonhayes/roll.svg)](https://pkg.go.dev/github.com/brittonhayes/roll)\n![Latest Release](https://img.shields.io/github/v/release/brittonhayes/roll?label=latest%20release)\n[![Lint](https://github.com/brittonhayes/roll/actions/workflows/lint.yml/badge.svg)](https://github.com/brittonhayes/roll/actions/workflows/lint.yml)\n[![Test](https://github.com/brittonhayes/roll/actions/workflows/test.yml/badge.svg)](https://github.com/brittonhayes/roll/actions/workflows/test.yml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/brittonhayes/roll)](https://goreportcard.com/report/github.com/brittonhayes/roll)\n\nA simple Go package and CLI for dice rolling.\n\n## ⚡ Usage\n\nHow to use Roll as a CLI or a library\n\n### CLI\n\nInstallation via Go or Docker\n\n```bash\n# Go\ngo install github.com/brittonhayes/roll/cmd/roll\n```\n\n```bash\n# Docker\ndocker run --rm -it ghcr.io/brittonhayes/roll:latest 1d6+2\n```\n\nUsing the command line tool\n\n```bash\n# Run the CLI\nUsage: roll \u003cdice\u003e\n\nA simple CLI for dice rolling\n\nArguments:\n  \u003cdice\u003e    Dice to roll +/- modifiers e.g. 'roll 1d6', 'roll 2d12+20', or 'roll 1d20-5'\n\nFlags:\n  -h, --help            Show context-sensitive help.\n  -v, --verbose         Display verbose log output ($VERBOSE)\n  -s, --skip-spinner    Skip loading spinner ($SKIP_SPINNER)\n\n# Roll a D6\nroll 1d6\n\n# Roll with modifiers\nroll 1d6+2\n```\n\n## 📺 Preview\n\n![roll.gif](./roll.gif)\n\n### Package\n\nUsing the package\n\n```go\nfunc main() {\n\t// Create a new d6\n\td := roll.NewD6()\n\n\t// Roll the die\n\tfmt.Println(\"Rolling\", d)\n\tresult := d.Roll()\n\n\t// Print the result\n\tfmt.Println(result)\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrittonhayes%2Froll","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrittonhayes%2Froll","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrittonhayes%2Froll/lists"}