{"id":14965270,"url":"https://github.com/salt-extensions/salt-extension-copier","last_synced_at":"2025-07-01T13:39:25.245Z","repository":{"id":206974651,"uuid":"718127198","full_name":"salt-extensions/salt-extension-copier","owner":"salt-extensions","description":"Create and maintain Salt extensions using Copier","archived":false,"fork":false,"pushed_at":"2024-10-24T03:53:21.000Z","size":628,"stargazers_count":9,"open_issues_count":5,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-24T20:15:47.774Z","etag":null,"topics":["copier-template","salt-extension","saltstack","saltstack-extension"],"latest_commit_sha":null,"homepage":"https://salt-extensions.github.io/salt-extension-copier/","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/salt-extensions.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2023-11-13T12:46:18.000Z","updated_at":"2024-10-24T03:53:24.000Z","dependencies_parsed_at":"2023-11-13T13:45:15.992Z","dependency_job_id":"0d51a9d0-b68c-49cd-85bb-b0f6554fbc50","html_url":"https://github.com/salt-extensions/salt-extension-copier","commit_stats":{"total_commits":191,"total_committers":4,"mean_commits":47.75,"dds":0.1465968586387435,"last_synced_commit":"04e4abb814fa0688227ecb3759ad78531325598d"},"previous_names":["lkubb/salt-extension-copier","salt-extensions/salt-extension-copier"],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-extensions%2Fsalt-extension-copier","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-extensions%2Fsalt-extension-copier/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-extensions%2Fsalt-extension-copier/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salt-extensions%2Fsalt-extension-copier/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/salt-extensions","download_url":"https://codeload.github.com/salt-extensions/salt-extension-copier/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238128542,"owners_count":19421053,"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":["copier-template","salt-extension","saltstack","saltstack-extension"],"created_at":"2024-09-24T13:34:30.611Z","updated_at":"2025-02-10T14:32:07.212Z","avatar_url":"https://github.com/salt-extensions.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Create \u0026 Maintain Salt Extensions\n\nA [Copier](https://github.com/copier-org/copier) template that initializes a project structure for developing [Salt](https://github.com/saltstack/salt) [extension modules][saltext-def].\n\n## Why\nFor individual extension creators, this template allows to [quickly get started with developing][saltext-creation], [testing][saltext-testing] and [releasing][saltext-release] new Salt functionality.\n\nFor extension maintainers and the [`salt-extensions` organization][gh-org-ref], it ensures that there is a frictionless way of keeping the necessary boilerplate [up to date][saltext-update].\n\n## How\n\nFor comprehensive instructions on all aspects of Salt extension development with this template, please refer to the [user documentation][docs].\n\n![Preview](./docs/rec.svg)\n\n### Migration from the [deprecated tool][create-salt-extension]\nExisting projects can be migrated to this template by simply running the [creation commands][saltext-creation] on top of a repo clone. Ensure you additionally pass `--vcs-ref=0.0.2` to Copier since this template diverges from the last official release (`0.24.0`) after that.\n\n```bash\ngit clone https://github.com/salt-extensions/saltext-example\ncopier copy --trust --vcs-ref=0.0.2 https://github.com/salt-extensions/salt-extension-copier saltext-example\n```\n\nDuring this process, Copier asks about conflict resolutions. There have likely been several modifications to the boilerplate since the extension was generated, so this can require some attention and could even reintroduce older dependencies. Afterwards, you should [update the project][saltext-update] to the latest template version.\n\n## References\n* [User documentation][docs] for this template\n* An overview of [modular systems in Salt][salt-modules]\n* [Salt-specific `pytest` docs][pytest-salt-factories]\n* [`salt-extensions` organization][gh-org]\n* [Copier docs][copier-docs]\n\n[docs]: https://salt-extensions.github.io/salt-extension-copier/\n[saltext-def]: https://salt-extensions.github.io/salt-extension-copier/ref/concepts.html#saltext-ref\n[saltext-creation]: https://salt-extensions.github.io/salt-extension-copier/topics/creation.html\n[saltext-testing]: https://salt-extensions.github.io/salt-extension-copier/topics/testing/writing.html\n[saltext-release]: https://salt-extensions.github.io/salt-extension-copier/topics/publishing.html\n[gh-org-ref]: https://salt-extensions.github.io/salt-extension-copier/ref/concepts.html#gh-org-ref\n[saltext-update]: https://salt-extensions.github.io/salt-extension-copier/topics/updating.html\n[create-salt-extension]: https://github.com/saltstack/salt-extension\n[copier-docs]: https://copier.readthedocs.io/en/stable/\n[salt-modules]: https://docs.saltproject.io/en/latest/topics/development/modules/index.html\n[pytest-salt-factories]: https://pytest-salt-factories.readthedocs.io/en/latest/\n[gh-org]: https://github.com/salt-extensions/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalt-extensions%2Fsalt-extension-copier","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsalt-extensions%2Fsalt-extension-copier","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalt-extensions%2Fsalt-extension-copier/lists"}