Provision resources using a declarative YAML syntax.

Go to file

Matthew Rich fffcb0963e Some checks failed Lint / golangci-lint (push) Failing after 9m57s Details Declarative Tests / test (push) Failing after 59s Details add network_route schema		2024-04-09 12:51:56 -07:00
.gitea/workflows	fix release error	2024-04-03 18:41:14 -07:00
artifacts	generate coverage report	2024-03-23 13:03:42 -07:00
cmd/cli	update resource schemas	2024-04-09 12:30:05 -07:00
examples	add container example	2024-03-27 15:40:57 -07:00
internal/resource	add network_route schema	2024-04-09 12:51:56 -07:00
md-images	crop screencap	2024-03-27 12:23:22 -07:00
tests/mocks	update resource schemas	2024-04-09 12:30:05 -07:00
.gitignore	Initial commit	2024-03-09 00:12:54 +00:00
cli_test.go	add cli test	2024-04-03 11:47:55 -07:00
COPYRIGHT	initial version	2024-03-20 12:23:31 -07:00
go.mod	add encoder/decoder support for json and yaml	2024-04-03 09:54:50 -07:00
go.sum	add encoder/decoder support for json and yaml	2024-04-03 09:54:50 -07:00
LICENSE	initial version	2024-03-20 11:56:28 -07:00
Makefile	update readme with testing steps	2024-03-27 16:08:13 -07:00
README.md	fix schema path	2024-04-03 12:48:30 -07:00

README.md

decl

Purpose

These tools work with YAML descriptions of resources (E.g. files, users, containers, etc) for (de)serializing the state of the given resource. This enables more generically describing the state of a supported resource type, pipeling state transformations and enabling the use of other tools in that process.

Dependencies

Go >= 1.21.1

Testing

Testing the current version involves checking out main and building.

git clone https://gitea.rosskeen.house/Declarative/decl.git

make test

make build

Command-line

Update Resource state

decl -resource-file decl-runner.yaml

Read resource state

Read the state of an existing resource (URI) and generate a YAML representation of it.

Examples

Resources: