# 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.

![Import Resource](md-images/import-resource.gif)

# Examples

Resources:

* [file](examples/file.yaml) [schema](internal/resource/schemas/file.jsonschema)
* [user](examples/user.yaml) [schema](internal/resource/schemas/user.jsonschema)
* [package](examples/package.yaml) [schema](internal/resource/schemas/package.jsonschema)
* [container](examples/container.yaml) [schema](internal/resource/schemas/container.jsonschema)
* [network_route](examples/network_route.yaml) [schema](internal/resource/schemas/network_route.jsonschema)