SemanticPuppet

Library of useful tools for working with Semantic Versions and module dependencies.

Description

Library of tools used by Puppet to parse, validate, and compare Semantic Versions and Version Ranges and to query and resolve module dependencies.

For sparse, but accurate documentation, please see the docs directory.

Note that this is a 0 release version, and things can change. Expect that the version and version range code to stay relatively stable, but the module dependency code is expected to change.

This library is used by a number of Puppet Labs projects, including Puppet and r10k.

Requirements

Semantic_puppet will work on several ruby versions, including 1.9.3, 2.0.0, and 2.1.0. Ruby 1.8.7 is immediately deprecated as it is in r10k.

No gem/library requirements.

Installation

Rubygems

For general use, you should install semantic_puppet from Ruby gems:

gem install semantic_puppet

Github

If you have more specific needs or plan on modifying semantic_puppet you can install it out of a git repository:

git clone git://github.com/puppetlabs/semantic_puppet

Usage

SemanticPuppet is intended to be used as a library.

Version Range Operator Support

SemanticPuppet will support the same version range operators as those used when publishing modules to Puppet Forge which is documented at Publishing Modules on the Puppet Forge.

i18n

When adding new error or log messages please follow the instructions for writing translatable code.

The SemanticPuppet gem will default to outputing all error messages in English, but you may set the locale using the FastGettext.set_locale method. If translations do not exist for the language you request then the gem will default to English. The set_locale method will return the locale, as a string, that FastGettext will now use to report PuppetForge errors.

# Assuming the German translations exist, this will set the reporting language
# to German

locale = FastGettext.set_locale "de_DE"

# If it successfully finds Germany's locale, locale will be "de_DE"
# If it fails to find any German locale, locale will be "en"

Contributors

Pieter van de Bruggen wrote the library originally, with additions by Alex Dreyer, Jesse Scott and Anderson Mills.

Maintenance

Maintainers:

Tickets: File at https://tickets.puppet.com/browse/FORGE