{"id":41454004,"url":"https://github.com/kampanosg/bakery","last_synced_at":"2026-01-23T15:33:51.732Z","repository":{"id":188749247,"uuid":"677152071","full_name":"kampanosg/bakery","owner":"kampanosg","description":"An automation tool for boring and repetitive tasks 🧁","archived":false,"fork":false,"pushed_at":"2024-09-01T15:51:32.000Z","size":4400,"stargazers_count":6,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-25T19:59:44.927Z","etag":null,"topics":["automation","golang"],"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/kampanosg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-08-10T21:48:57.000Z","updated_at":"2025-07-16T19:11:46.000Z","dependencies_parsed_at":"2024-01-20T14:43:50.884Z","dependency_job_id":null,"html_url":"https://github.com/kampanosg/bakery","commit_stats":null,"previous_names":["kampanosg/bakery"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/kampanosg/bakery","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kampanosg%2Fbakery","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kampanosg%2Fbakery/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kampanosg%2Fbakery/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kampanosg%2Fbakery/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kampanosg","download_url":"https://codeload.github.com/kampanosg/bakery/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kampanosg%2Fbakery/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28694664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-23T14:15:13.573Z","status":"ssl_error","status_checked_at":"2026-01-23T14:09:05.534Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["automation","golang"],"created_at":"2026-01-23T15:33:51.644Z","updated_at":"2026-01-23T15:33:51.711Z","avatar_url":"https://github.com/kampanosg.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bakery 🧁 \n\n![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/kampanosg/bakery/go.yml?style=for-the-badge\u0026logo=go)\n![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/kampanosg/bakery/sec.yml?style=for-the-badge\u0026logo=go\u0026label=security)\n\nBakery is an (opinionated) automation tool designed to simplify repetitive, time-consuming and error prone commands. It uses YAML instead of a propriatery language and provides handy defaults, such as `help` and `version`. Its main goal is to make the developer experience more familiar, flexible and friendly while being fast and reliable.\n\nhttps://github.com/kampanosg/bakery/assets/30287348/379cbb67-13a5-473e-992c-52209b0e2042\n\n## Installation\nBakery can be installed with the following methods:\n* [Go](#go)\n\n### Go\nUse the `go` CLI tool to install Bakery:\n```bash\ngo install github.com/kampanosg/bakery/cmd/bake@latest\n```\n\n## Usage\n\n### CLI\nTo run a `Bakefile` and its available recipes, use the `bake` CLI tool. For example:\n```bash\nbake version\nbake build\n```\n\n#### Flags\nThe CLI ships with a set of command line flags that can be used to extract information from the tool or modify its behaviour.\n\n| flag       | description                                                                     | default |\n| ---------- | ------------------------------------------------------------------------------- | ------- |\n| `-version` | prints the current version of the tool                                          |         |\n| `-verbose` | controls the verbosity. if set to `true` the tool prints a lot more to `stdout` | `false` |\n| `-help`    | prints a help message with all the available flags                              |         |\n\nTo use the flags, you can pass them directly to the CLI:\n\n```bash\nbake -version\nbake -verbose build\nbake -help\n```\n\n\u003e :information_source: The `-verbose` flag can be used with recipes\n\n### The Bakefile\nBakery, by default, looks for a `Bakefile` from the directory that is executed. The `Bakefile`, should follow the YAML structure and contain the keywords and syntax described bellow. \n\nThe `--file` flag can be passed to use a `Bakefile` in a different location. For example, `bake --file /path/to/Bakefile version`\n\n### Syntax\n#### Keywords\nBelow are the keywords that the `Bakefile` can contain\n\n| keyword    | type                | optional | description                                                                    |\n| ---------- | ------------------- | -------- | ------------------------------------------------------------------------------ |\n| `version`  | `string`            | Y        | a user-defined version that can have any format e.g: `1` or `v1.2.3`           |\n| `metadata` | `map[string]string` | Y        | any user-defined key-value pair. for example: `author: John`                   |\n| `variables`| `map[string]string` | Y        | user defined variables that can be used in the recipes with the `:var:` syntax |\n| `defaults` | `[]string`          | Y        | a list of recipes that will be called if no recipe is passed at execution      |\n| `recipes`  | `[]Recipe`          | N        | the list of recipes, see the table below how to define them                    |\n| `help`     | `string`            | Y        | a custom message that overrides the built-in `bake help`                       |\n\n#### Recipe\nThe `Recipe` syntax is defined below\n\n| keyword       | type       | optional | description                                                           |\n| ------------- | ---------- | -------- | --------------------------------------------------------------------- |\n| `description` | `string`   | Y        | a brief explanation of what the recipe does. used for the `bake help` |\n| `steps`       | `[]string` | N        | the commands that the `recipe` executes                               |\n| `private`     | `bool`     | Y        | if set to true it cannot be called directly from the command line     |\n\n\u003e :information_source: A `step` can reference a `recipe`\n\n#### Special Characters\nSome special keywords that are available to the `Bakefile`\n\n| character | usage | description                                                              |\n| --------- | ----- | ------------------------------------------------------------------------ |\n| `^`       | steps | prefix a step with this keyword to ignore errors and continue the recipe |\n\n### Builtins\nThe following builtin functions are available with `bake`\n\n| command   | description                                                                |\n| --------- | -------------------------------------------------------------------------- |\n| `version` | prints out the version of the `Bakefile` if it has been defined            |\n| `help`    | prints out the available recipes in the `Bakefile` and their `description` |\n\n\n### Example Bakefile\nThe following is an example `Bakefile` for a Go project. It includes examples for all the available syntax.\n\n```yaml\nversion: v1.2.3\nmetadata:\n  author: \"Darth Vader \u003cvader@empire.org\u003e\"\nvariables:\n  name: app\ndefaults:\n  - build\nrecipes:\n  build:\n    description: \"builds the project\"\n    steps:\n      - \"rm :name:\"\n      - \"go build -p :name: ./...\"\n  test:\n    description: \"tests the project\"\n    steps:\n      - \"go test ./...\"\n  run:\n    description: \"builds and tests the project\"\n    steps:\n      - test\n      - build\n      - \"./app\"\n  ignore-fail:\n    private: true\n    description: \"prefix a step with ^ to ignore the failure\"\n    steps:\n        - \"^lss -abcdf ./not/valid/dir\"\n        - \"echo 'i will execute fine'\"\nhelp: |\n  This is an example help message. It will override the built-in `bake help`\n\n  And it can be multiline as well!\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkampanosg%2Fbakery","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkampanosg%2Fbakery","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkampanosg%2Fbakery/lists"}