{"id":21869676,"url":"https://github.com/swvanbuuren/simple-cdd-yaml","last_synced_at":"2025-04-14T23:41:44.153Z","repository":{"id":155343502,"uuid":"614521256","full_name":"swvanbuuren/simple-cdd-yaml","owner":"swvanbuuren","description":"Preprocessor for Simple-CDD using YAML input files","archived":false,"fork":false,"pushed_at":"2024-12-01T14:34:38.000Z","size":773,"stargazers_count":4,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-14T23:41:35.166Z","etag":null,"topics":["build-linux","debian","debian-build","debos","simple-cdd","yaml"],"latest_commit_sha":null,"homepage":"https://swvanbuuren.github.io/simple-cdd-yaml/","language":"Python","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/swvanbuuren.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-03-15T18:54:15.000Z","updated_at":"2025-04-04T18:21:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"ea275a1b-6212-4cef-9d37-09e2b1e0d1e0","html_url":"https://github.com/swvanbuuren/simple-cdd-yaml","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swvanbuuren%2Fsimple-cdd-yaml","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swvanbuuren%2Fsimple-cdd-yaml/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swvanbuuren%2Fsimple-cdd-yaml/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swvanbuuren%2Fsimple-cdd-yaml/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swvanbuuren","download_url":"https://codeload.github.com/swvanbuuren/simple-cdd-yaml/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248981257,"owners_count":21193143,"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":["build-linux","debian","debian-build","debos","simple-cdd","yaml"],"created_at":"2024-11-28T06:08:43.704Z","updated_at":"2025-04-14T23:41:44.143Z","avatar_url":"https://github.com/swvanbuuren.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simple-CDD-YAML\n\nPreprocessor for [Simple-CDD](https://wiki.debian.org/Simple-CDD) using\nYAML input files (so-called recipes), as inspired by\n[debos](https://github.com/go-debos/debos).\n\nSimple-CDD is a tool for creating customized debian-installer CDs.\n\n## Introduction\n\nSimple-CDD-YAML uses YAML recipes to generate the profile files required by\nSimple-CDD. A recipe consists of actions, that generate or append files in the\nSimple-CDD profile. Simple-CDD-YAML features the following actions (for an\nexemplary profile called `\u003cprofile\u003e`):\n\n- `recipe` action: embed another recipe\n- `conf` action: compose a `\u003cprofile\u003e.conf` file by supplying (environment)\n  variables\n- `preseed` action: define a preseed file\n- `apt` action: add packages\n- `run` action: add a command or script (to `\u003cprofile\u003e.postinst`)\n- `overlay` action: add an overlay (an overlay is a file structure that is\n  compressed into one single file and automatically added to the file\n  `\u003cprofile\u003e.extra`. A corresponding command to decompress the overlay is added\n  to `\u003cprofile\u003e.postinst`)\n- `extra` action: add extra file\n- `downloads` action: add extra packages\n- `debos` action: [only in debos mode] add pre- and post-action to debos recipe\n  output\n\nSome of the actions support substitutions using\n[jinja](https://palletsprojects.com/p/jinja/) notation, making it easier to\nreuse scripts, preseeds and recipes. By defining variables with default values\nat the top of a recipe it becomes easy to reuse and nest recipes.\n\nA few actions also support different roles: by default scripts are executed and\noverlays are deployed as root, but you can also specify to have this done by a\ngiven user.\n\nPlease refer to the [documentation on\nactions](https://swvanbuuren.github.io/simple-cdd-yaml/actions/) for detailed\ndocumentation for each action.\n\n## Installation\n\nSimple-CDD-YAML can be directly installed from [PyPi](https://pypi.org) using\n`pip`:\n\n```bash\npip install simple-cdd-yaml\n```\n\nDetailed instructions are found in the documentation's [installation\nsection](https://swvanbuuren.github.io/simple-cdd-yaml/installation/).\n\n## Usage\n\nAfter installation use the command `simple-cdd-yaml` to create Simple-CDD\nprofiles from YAML files. Issue `simple-cdd-yaml --help` to get help.\n\nDetailed usage instructions are found in the [getting\nstarted](https://swvanbuuren.github.io/simple-cdd-yaml/getting_started/) guide.\n\n## Examples\n\n Refer to the documentation's [examples\n page](https://swvanbuuren.github.io/simple-cdd-yaml/examples/) for a detailed\n recipe explanation. The repository\n [simple-cdd-yaml-recipes](https://github.com/swvanbuuren/simple-cdd-yaml-recipes)\n contains more example recipes.\n\n## Documentation\n\nCheck out the [documentation](https://swvanbuuren.github.io/simple-cdd-yaml/) to\nget started, find more background information and query the code reference.\n\n## Pre-commit hooks\n\nThis repository comes with pre-commit hooks, which are stored in\n[`.hooks`](.hooks). To enable the hooks issue:\n\n```bash\ngit config --local core.hooksPath .hooks/\n```\n\n## License\n\nAn MIT style license applies for Simple-CDD-YAML, see the [LICENSE](LICENSE)\nfile for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswvanbuuren%2Fsimple-cdd-yaml","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswvanbuuren%2Fsimple-cdd-yaml","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswvanbuuren%2Fsimple-cdd-yaml/lists"}