{"id":13582043,"url":"https://github.com/netzkern/butler","last_synced_at":"2025-04-06T11:32:28.816Z","repository":{"id":72687858,"uuid":"117739943","full_name":"netzkern/butler","owner":"netzkern","description":"🤵 Welcome to Butler, your personal assistent to scaffold new projects. Shipped with binaries for Mac, Win and Linux.","archived":false,"fork":false,"pushed_at":"2019-02-22T13:06:05.000Z","size":448,"stargazers_count":82,"open_issues_count":1,"forks_count":8,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-05T21:45:40.833Z","etag":null,"topics":["automation","scaffolding","team","templating"],"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/netzkern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2018-01-16T20:48:23.000Z","updated_at":"2024-07-23T12:53:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"944d80e2-847c-45be-82b0-e34a76ecf972","html_url":"https://github.com/netzkern/butler","commit_stats":null,"previous_names":[],"tags_count":50,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netzkern%2Fbutler","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netzkern%2Fbutler/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netzkern%2Fbutler/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netzkern%2Fbutler/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netzkern","download_url":"https://codeload.github.com/netzkern/butler/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247478082,"owners_count":20945256,"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":["automation","scaffolding","team","templating"],"created_at":"2024-08-01T15:02:24.065Z","updated_at":"2025-04-06T11:32:28.385Z","avatar_url":"https://github.com/netzkern.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"/logo.png\" alt=\"butler\" style=\"max-width:100%;\"\u003e\n\u003c/p\u003e\n\nButler is an automatation tool to scaffold new projects in only a few seconds.\nWe provide a powerful interactive cli. When you create a project template you\ncan create a [`Survey`](/docs/templateSurveys.md). Surveys are used to collect\ninformations from the users to generate individual templates. Beside\ntemplating we also plan to integrate common commands for popular Project Management\nTools like Jira, Confluence in Butler.\n\n\u003e Bootstraping projects should be fun!\n\n## Features\n- ✔︎ Template Surveys\n- ✔︎ Conditional files and folders\n- ✔︎ After hooks for post-processing\n- :sparkles: **Maintanance:** Auto Update, Distributed configs\n- :star2: **Confluence:** Create spaces with preconfigured page tree\n\n## Principles\n- Project Templates are simple git repositories\n- Everything is a template you don't have to deal with `/template` directories\nor `.tmpl` files\n- Required informations are asked during the bootstrapping process\n\n## Usage\n\n1. [Download here](https://github.com/netzkern/butler/releases)\n2. Install in `PATH`\n3. Run `butler`\n\n## Documentation\n\n* [**Config**](/docs/config.md)\n* [**Template Surveys**](/docs/templateSurveys.md)\n* [**Template Syntax**](/docs/templateSyntax.md)\n* [**Git Hooks**](/docs/gitHooks.md)\n* [**Confluence**](/docs/confluence.md)\n* [**Debugging**](/docs/debugging.md)\n* [**Commands**](#commands)\n\n## Commands\n\n- **Create Project:** This command will create a new project based on the selected template.\n- **Create Git Hooks:** This command will install all selected hooks.\n- **Create Confluence Space:** This command will create a public or private confluence space based on the selected template.\n- **Maintanance:**\n  - **Dump config:** Prints the final butler config in the terminal.\n  - **Auto Update:** This command will update Butler to the latest version.\n  - **Report a bug:** This command will open a new Github issue.\n  - **Version:** This command will return the current version of Butler.\n\n## Maintenance across teams\n\n- Butler is able to update itself. The latest Github release is used.\n- Stay up-to-date with new templates without to update your config manually just set the environment variable `BUTLER_CONFIG_URL` to [butler.yml on master](https://raw.githubusercontent.com/netzkern/butler/master/butler.yml) and both configs are merged.\n\n## What Butler template looks like ?\n\n[example-project-template](https://github.com/netzkern/example-project-template)\n\n## Lead Maintainers\n\n- [**Dustin Deus**](https://github.com/StarpTech), \u003chttps://twitter.com/dustindeus\u003e, \u003chttps://www.npmjs.com/~starptech\u003e\n\n## Acknowledgements\n\nThis project is kindly sponsored by [netzkern](http://netzkern.de). We're [hiring!](http://karriere.netzkern.de/)\n\n## License\n\nLicensed under [MIT](./LICENSE).\n\n### Credits\n\n\u003cdiv\u003eIcons made by \u003ca href=\"http://www.freepik.com\" title=\"Freepik\"\u003eFreepik\u003c/a\u003e from \u003ca href=\"https://www.flaticon.com/\" title=\"Flaticon\"\u003ewww.flaticon.com\u003c/a\u003e is licensed by \u003ca href=\"http://creativecommons.org/licenses/by/3.0/\" title=\"Creative Commons BY 3.0\" target=\"_blank\"\u003eCC 3.0 BY\u003c/a\u003e\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetzkern%2Fbutler","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetzkern%2Fbutler","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetzkern%2Fbutler/lists"}