cy
compose_yml
cargo install compose_yml
cy

compose_yml

WIP: Read and write docker-compose.yml files using Rust

by Eric Kidd

0.0.59 (see all)License:CC0-1.0 AND Apache-2.0
cargo install compose_yml
Readme

compose_yml: Support for working with docker-compose.yml files

Latest version License Build Status Build status Documentation Gitter

This is a work in progress! Most of services: is supported, but I'm still refining the APIs as higher-level tools get build around this.

Goals

docker-compose.yml is a very useful format, but it's hard to parse and transform correctly. This library aims to offer:

  • High-level, type-safe APIs for anything you can find in a docker-compose.yml file.
  • Parsing of individual string fields into real objects.
  • Support for working with strings that might contain variable interpolations, and leaving them unparsed when necessary.
  • Canonical representations of fields which may have multiple formats.
  • Easy updates when docker-compose.yml gets extended.

Building

You can build this library using stable Rust version 1.11. But if you want to develop it, you will get much better error messages using a nightly build of Rust.

# Install Rust stable and nightly using rustup.
curl -sSf https://static.rust-lang.org/rustup.sh | sh
rustup toolchain install nightly

# Build unit tests using nightly Rust.
rustup run nightly cargo test --no-default-features --features unstable

License

This library is in the public domain as described by LICENSE.txt, except for the files src/v2/validate/config_schema_v2.*.json, which are copyright Docker, Inc., and distributed under the Apache License, version 2.0.

Part of the work on compose_yml has been generously sponsored by Faraday for use in their cage tool, which is designed to go beyond docker-compose and provide support for large, multi-pod apps.

GitHub Stars

15

LAST COMMIT

2yrs ago

MAINTAINERS

1

CONTRIBUTORS

5

OPEN ISSUES

2

OPEN PRs

4
VersionTagPublished
0.0.59
2yrs ago
0.0.58
2yrs ago
0.0.57
2yrs ago
0.0.56
2yrs ago
No alternatives found
No tutorials found
Add a tutorial