#yaml #fs #cli #root-directory

bin+lib fsyaml

Store large, unmanageable yaml files as multiple, manageable ones across your file system

6 stable releases

1.0.5 Jun 17, 2022
1.0.4 Jun 13, 2022
1.0.2 Jun 12, 2022
1.0.1 Jun 10, 2022

#820 in Filesystem


126 lines


Store large, unmanageable yaml files as multiple, manageable ones across your file system.

Crates.io Crates.io GitHub License

Dual-licensed under MIT or Apache-2.0


Before using this tool, you should know the basics of yaml.

How It Works

fsyaml allows you to split up your large yaml files into multiple ones, and then easily compile them back into one file when needed.

For example, consider the following yaml:

  b: 1
    e: 2

It could be restructured in your file system as:


Where a.yaml is:

b: 1

and d.yaml is:

e: 2

This allows you to separate out your file, and can make huge files much more maintainable.

To see the above example in action, you can visit tests/readme_example.

For more examples, see tests, which each contain a root directory and the expected.yaml output.


Once you've set up your file system of yaml files, you'll need to eventually combine them all back into one.

To do this, you'll install fsyaml.

Through Releases

One way is by release binary from the latest release.

On windows, you can add it to any folder as long as you add that folder to the path.

On linux, simply add it to your bin folder.

With Cargo

Another way is using cargo, which you can install by following these instructions.

After that, you can run a simple command in your terminal:

cargo install fsyaml


Once you've installed fsyaml, you can use it like so:

Output to a file:

fsyaml path/to/root output.yaml

Output as a stream:

fsyaml path/to/root > output.yaml

Disclaimer: This will not work on windows, and will output with UTF-16 LE encoding (Read more here)


This is a list of limitations to fsyaml that are not currently supported. If you'd like to tackle one of them, feel free to open a pull request!

  • Lists by file structure is not supported (only maps)
  • Symbolic linking is not supported


~63K SLoC