Some of these Python 3 scripts use libraries that have to be installed separately. It's best to use a Python Virtual Environment for that. This way you don't install the libraries in your OS itself.
Once you have activated the Virtual Environment you can install all the dependencies with pip install -r requirements.txt.
This Python 3 script takes a YAML file with multiple documents (separated by ---) and writes each of them into a new, separate file.
Use split-yaml -h for a usage overview.
The filenames of the newly created files are determined by the value of the key passed to the script.
Let's make an example for better understanding:
Every document in the YAML source file has a key model: and you want to use the value of that key for the new fielnames:
Two documents in source.yaml:
manufacturer: APC
model: ACRC301S
slug: acrc301s
---
manufacturer: APC
model: SMT1000I
slug: smt1000iCalling the script with split-yaml --file source.yaml --key model will result in two new files acrc301s.yaml and smt1000i.yaml.
important: Currently, the value of the given key must be unique for every document, otherwise you will overwrite previous files with the same key value.
If you want to run the scripts from you command line without having to specify the full path, create a symbolic link for each script in a directory that's part of your $PATH, for example:
ln -sf <repo path>/split-yaml ~/bin/split-yamlNow, reload/reopen your shell/terminal and you can use split-yaml from wherever you are.
This script removes all objects, versions and delete markers from a specified bucket.
Use empty-s3-bucket -h for usage information or have a look at the script.
Important: Currently the script fails with an exception if you pass a wrong bucket and/or profile.