Contents

[![Build Status](https://travis-ci.com/glennsarti/puppetfile-resolver.svg?branch=master)](https://travis-ci.com/glennsarti/puppetfile-resolver)
[![Gem Version](https://img.shields.io/gem/v/puppetfile-resolver)](https://rubygems.org/gems/puppetfile-resolver)

# Puppetfile Resolver

The [Puppetfile](https://puppet.com/docs/pe/latest/puppetfile.html) is used by Puppet to manage the collection of modules used by a Puppet master. The Puppetfile is then used by tools like [R10K](https://github.com/puppetlabs/r10k) and [Code Manager](https://puppet.com/docs/pe/latest/code_mgr_how_it_works.html#how-code-manager-works) to download and install the required modules.

However, the Puppetfile is designed to have explicit dependencies, that is, **all** modules and **all** of the dependencies must be specified in Puppetfile. This is very different to formats like `Gemfile` (Ruby) or `package.json` (NodeJS) where dependencies are brought in as needed.

Using explicit dependencies is great in a configuration management system like Puppet, but it puts the burden on updates onto the user.

This library includes all of the code to parse a Puppetfile and then calculate a dependency graph to try and resolve all of the module dependencies and versions. The resolver can also restrict on Puppet version, for example, only Modules which support Puppet 6.

**Note** This is still in active development. Git history may be re-written until an initial version is released

## Documentation

- [About](https://glennsarti.github.io/puppetfile-resolver/)
- [Architecture](https://glennsarti.github.io/puppetfile-resolver/architecture)
- [Parsers](https://glennsarti.github.io/puppetfile-resolver/parsers)
- [Example Usage](https://glennsarti.github.io/puppetfile-resolver/example_usage)
- [Known Issues](https://glennsarti.github.io/puppetfile-resolver/known_issues)

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
puppetfile-resolver-0.4.0	README.md
puppetfile-resolver-0.3.0	README.md
puppetfile-resolver-0.2.0	README.md