{"id":13410300,"url":"https://github.com/carapace-sh/carapace-spec","last_synced_at":"2025-04-06T02:31:03.277Z","repository":{"id":40368056,"uuid":"487400813","full_name":"carapace-sh/carapace-spec","owner":"carapace-sh","description":"define simple completions using a spec file","archived":false,"fork":false,"pushed_at":"2024-10-29T15:56:34.000Z","size":2045,"stargazers_count":19,"open_issues_count":15,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-29T17:23:02.606Z","etag":null,"topics":["bash","carapace","completion","elvish","fish","ion","nushell","oil","powershell","tcsh","xonsh","xontrib","zsh"],"latest_commit_sha":null,"homepage":"https://carapace.sh","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/carapace-sh.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}},"created_at":"2022-04-30T23:13:12.000Z","updated_at":"2024-10-29T15:56:02.000Z","dependencies_parsed_at":"2023-11-14T03:36:58.522Z","dependency_job_id":"4e83d563-d3a3-4198-8dea-80c649dfc4c9","html_url":"https://github.com/carapace-sh/carapace-spec","commit_stats":{"total_commits":229,"total_committers":2,"mean_commits":114.5,"dds":0.3318777292576419,"last_synced_commit":"70c2134257dd85e12d2482e5cd334f3c480e10f8"},"previous_names":["carapace-sh/carapace-spec","rsteube/carapace-spec"],"tags_count":67,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carapace-sh%2Fcarapace-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carapace-sh%2Fcarapace-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carapace-sh%2Fcarapace-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carapace-sh%2Fcarapace-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carapace-sh","download_url":"https://codeload.github.com/carapace-sh/carapace-spec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223232648,"owners_count":17110489,"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":["bash","carapace","completion","elvish","fish","ion","nushell","oil","powershell","tcsh","xonsh","xontrib","zsh"],"created_at":"2024-07-30T20:01:06.095Z","updated_at":"2024-11-05T19:29:59.610Z","avatar_url":"https://github.com/carapace-sh.png","language":"Go","funding_links":[],"categories":["Command Line","bash"],"sub_categories":["Standard CLI"],"readme":"# carapace-spec\n\n[![PkgGoDev](https://pkg.go.dev/badge/github.com/carapace-sh/carapace-spec/pkg/actions)](https://pkg.go.dev/github.com/carapace-sh/carapace-spec)\n[![GoReportCard](https://goreportcard.com/badge/github.com/carapace-sh/carapace-spec)](https://goreportcard.com/report/github.com/carapace-sh/carapace-spec)\n[![documentation](https://img.shields.io/badge/\u0026zwnj;-documentation-blue?logo=gitbook)](https://carapace-sh.github.io/carapace-spec/)\n[![Coverage Status](https://coveralls.io/repos/github/carapace-sh/carapace-spec/badge.svg?branch=master)](https://coveralls.io/github/carapace-sh/carapace-spec?branch=master)\n[![Packaging status](https://repology.org/badge/tiny-repos/carapace-spec.svg)](https://repology.org/project/carapace-spec/versions)\n\nDefine simple completions using a spec file (based on [carapace](https://github.com/carapace-sh/carapace)).\n\nThe `carapace-spec` binary can be used to complete spec files, but [carapace-bin](https://github.com/rsteube/carapace-bin) is recommended as it supports a range of [custom macros](https://rsteube.github.io/carapace-bin/spec/macros.html).\n\n```yaml\nname: mycmd\ndescription: my command\nflags:\n  --optarg?: optarg flag\n  -r, --repeatable*: repeatable flag\n  -v=: flag with value\npersistentflags:\n  --help: bool flag\ncompletion:\n  flag:\n    optarg: [\"one\", \"two\\twith description\", \"three\\twith style\\tblue\"]\n    v: [\"$files\"]\ncommands:\n- name: sub\n  description: subcommand\n  completion:\n    positional:\n      - [\"$list(,)\", \"1\", \"2\", \"3\"]\n      - [\"$directories\"]\n```\n\n## Generators\n\n- [carapace-spec-clap](https://github.com/carapace-sh/carapace-spec-clap) spec generation for clap-rs/clap\n- [carapace-spec-kingpin](https://github.com/carapace-sh/carapace-spec-kingpin) spec generation for alecthomas/kingpin\n- [carapace-spec-kong](https://github.com/carapace-sh/carapace-spec-kong) spec generation for alecthomas/kong\n- [carapace-spec-man](https://github.com/carapace-sh/carapace-spec-man) spec generation for manpages\n- [carapace-spec-urfavecli](https://github.com/carapace-sh/carapace-spec-urfavecli) spec generation for urfave/cli\n- [carapace-spec-oclif](https://github.com/cristiand391/oclif-carapace-spec-plugin) spec generation for oclif\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarapace-sh%2Fcarapace-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarapace-sh%2Fcarapace-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarapace-sh%2Fcarapace-spec/lists"}