librarian-puppet-maestrodev 0.9.7.5 → 0.9.8.1

data/vendor/librarian/CHANGELOG.md

@@ -1,185 +0,0 @@
-# Change Log
-
-## 0.0.24
-
-* \#15. A remembered configuration system.
-
-* \#16. Configure, and remember configuration for, chef install paths.
-
-* \#38. Configure, and remember configuration for, stripping out `.git`
-  directories from git-sources chef dependencies.
-
-* \#76. Support git annotated tags.
-
-* \#80. Ignore directories in the `PATH` named `git` when looking for the `git`
-  bin.
-
-* \#85. Provide a helpful message when running the `show` command without a
-  lockfile present.
-
-## 0.0.23
-
-* \#41. Build gems with a built gemspec.
-
-* \#67. Cache remote objects at the latest possible moments, and only when they
-  are needed.
-
-* \#68. Fix unpacking chef site-sourced packages on Windows by pivoting from a
-  Librarian-managed scratch space, rather than pivoting from Windows' temp
-  directory. There were unexplained problems with using the Windows temp
-  directory in certain cases, possibly related to the temp directory and the
-  Librarian cache directory being on different volumes.
-
-* \#69. Fix invoking Librarian with git-sourced dependencies from git hooks by
-  unsetting `GIT_DIR` around shelling out to git.
-
-* Print general environment information when running with `--verbose`.
-
-## 0.0.22
-
-* Fix the `outdated` CLI command.
-
-## 0.0.21
-
-* \#64. Sources now raise when given unrecognized options in the specfile.
-
-* A new `show` CLI command.
-
-* Changed the `clean` CLI command no longer to delete the lockfile.
-
-* Simplify the architecture of `Librarian::Manifest` vis-a-vis sources. It is no
-  longer a base class for adapters to inherit. Now, sources expose a small
-  interface, which `Librarian::Manifest` can call, for delay-loading attributes.
-
-* The git source now resolves the `git` binary before `chdir`ing.
-
-* Test on Rubinius.
-
-## 0.0.20
-
-* A command to print outdated dependencies.
-
-## 0.0.19
-
-* Fix breakage on 1.8.
-
-## 0.0.18
-
-* \#57. Include existing manifests' dependencies in resolution.
-
-* Permit the update action even with a changed specfile.
-
-## 0.0.17
-
-* Use a pure-Ruby implementation of tar/gz. Helps with Windows support, since
-  Windows boxes are less likely than *NIX boxes to have the `tar` executable.
-
-* Fix an issue where the chef site source considers uncached manifests to be
-  cached, and skips caching them, causing the install action to fail.
-
-* Fail fast if the resolver produces an inconsistent resolution. It is a known
-  issue that the resolver will sometimes (deterministically, not randomly)
-  produce an inconsistent resolution when performing an update action (#57).
-  Start debugging this by failing fast at this point and spitting out gobs of
-  debug-level log details.
-
-## 0.0.16
-
-* Recache site-sourced dependency metadata per each run.
-
-* \#46. Always install.
-
-* \#53. Abstract versions & requirements from rubygems.
-
-* Own the install path. Recreate it on each install.
-    WARNING: If you have your own content in the install path, it will be deleted without mercy.
-
-## 0.0.15
-
-* Rewrite the README.
-
-* \#44, \#49. Better updating of cached git sources without using local merges.
-
-## 0.0.14
-
-* \#39 Fixes a regression induced by using `git reset --hard SHA`.
-
-## 0.0.13
-
-* \#36 Fixes an issue where, if a dependency has a git source (the upstream), and the upstream is updated,
-    then attempting to update that dependency in the local resolution would not update that dependency so
-    long as that git source were cached (@databus23).
-
-* More immediate detection of, and better error messages for, cases of blank dependency or manifest names
-    or cases of names that are otherwise insensible, such as names that are untrimmed.
-
-## 0.0.12
-
-* Fixes an issue where, if a dependency has a git source with a ref, re-resolving may fail.
-
-## 0.0.11
-
-* Fix a regression where the cli command "version" failed.
-
-## 0.0.10
-
-This release focuses on refactoring some of the internals. There are no functional changes.
-
-## 0.0.9
-
-* \#11 Fixes a problem where, if the repo is in a path where a component has a space, attempting to resolve a
-    site-sourced dependency fails.
-
-## 0.0.8
-
-* A `version` task.
-
-* A change log.
-
-* \#10 Fixes the problem with bouncing the lockfile when updating, when using a git source with the default ref.
-
-## 0.0.7
-
-* \#8 Add highline temporarily as a runtime dependency of `librarian` (@fnichol).
-  When the project is split into `librarian` and `librarian-chef`, the `chef` runtime dependency will
-    be moved to `librarian-chef`. If the project is further split into a knife plugin, the dependency
-    will be moved there.
-
-## 0.0.6
-
-* \#7 Show a better error message when a cookbook is missing the required metadata file.
-
-* Miscellaneous bugfixes.
-
-## 0.0.5
-
-* \#4 An `init` task for `librarian-chef`.
-  This task creates a nearly-blank `Cheffile` with just the default Opscode Community Site source.
-
-* Automatically create the `cookbooks` directory, if it's missing, when running the `install` task.
-
-* \#3 Add `chef` temporarily as a runtime dependency of `librarian` (@fnichol).
-  When the project is split into `librarian` and `librarian-chef`, the `chef` runtime dependency will
-    be moved to `librarian-chef`.
-
-## 0.0.4
-
-* A simple knife integration.
-  This integration allows you to specify a `librarian-chef`-managed tempdir as a `cookbook_path`.
-  This is useful to force knife only to upload the exact cookbooks that `librarian-chef` knows
-    about, rather than whatever happens to be found in the `cookbooks` directory.
-
-## 0.0.3
-
-* Miscellaneous bugfixes.
-
-## 0.0.2
-
-* An optional `:path` attribute for `:git` sources.
-  This allows you to specify exactly where within a git repository a given cookbook is to be found.
-
-* A full example of a Cheffile and its usage in the readme.
-
-## 0.0.1
-
-* Initial release.

data/vendor/librarian/Gemfile

@@ -1,6 +0,0 @@
-source "http://rubygems.org"
-
-# Specify your gem's dependencies in librarian.gemspec
-gemspec
-
-gem "fakefs", :require => "fakefs/safe"

data/vendor/librarian/MIT-LICENSE

@@ -1,20 +0,0 @@
-Copyright (c) 2011 ApplicationsOnline, LLC.
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/vendor/librarian/README.md

@@ -1,403 +0,0 @@
-Librarian [![Build Status](https://secure.travis-ci.org/applicationsonline/librarian.png)](http://travis-ci.org/applicationsonline/librarian)
-=========
-
-Librarian is a framework for writing bundlers, which are tools that resolve,
-fetch, install, and isolate a project's dependencies, in Ruby.
-
-Librarian ships with Librarian-Chef, which is a bundler for your Chef-based
-infrastructure repositories. In the future, Librarian-Chef will be a separate
-project.
-
-A bundler written with Librarian will expect you to provide a specfile listing
-your project's declared dependencies, including any version constraints and
-including the upstream sources for finding them. Librarian can resolve the spec,
-write a lockfile listing the full resolution, fetch the resolved dependencies,
-install them, and isolate them in your project.
-
-A bundler written with Librarian will be similar in kind to [Bundler](http://gembundler.com),
-the bundler for Ruby gems that many modern Rails applications use.
-
-Librarian-Chef
----------------
-
-Librarian-Chef is a tool that helps you manage the cookbooks that your chef-repo
-depends on. Here are some more details.
-
-Librarian-Chef is a bundler for infrastructure repositories using Chef. You can
-use Librarian-Chef to resolve your infrastructure's cookbook dependencies, fetch
-them, and install them into your infrastructure repository.
-
-Librarian-Chef can resolve and fetch third-party, publicly-released cookbooks,
-and install them into your infrastructure repository. It can also source
-cookbooks directly from their own source control repositories.
-
-Librarian-Chef can also deal with cookbooks you may actively be working on
-outside your infrastructure repository. For example, it can deal with cookbooks
-directly from their own private source control repositories, whether they are
-remote or local to your machine, and it can deal with cookbooks released to and
-hosted on a private cookbooks server.
-
-Librarian-Chef is not primarily intended for dealing with the cookbooks you are
-actively working on *within* your infrastructure repository. In such a case, you
-can still use Librarian-Chef, but it is likely unnecessary.
-
-Librarian-Chef *takes over* your `cookbooks/` directory and manages it for you
-based on your `Cheffile`. Your `Cheffile` becomes the authoritative source for
-the cookbooks your infrastructure repository depends on. You should not modify
-the contents of your `cookbooks/` directory when using Librarian-Chef. If you
-have cookbooks which are, rather than being separate projects, inherently part
-of your infrastructure repository, then they should go in a separate directory,
-like your `site-cookbooks/` directory, and you do not need to use Librarian-Chef
-to manage them.
-
-### The Cheffile
-
-Every infrastruture repository that uses Librarian-Chef will have a file named
-`Cheffile` in the root directory of that repository. The full specification for
-which third-party, publicly-released cookbooks your infrastructure repository
-depends will go here.
-
-Here's an example `Cheffile`:
-
-    site "http://community.opscode.com/api/v1"
-
-    cookbook "ntp"
-    cookbook "timezone", "0.0.1"
-
-    cookbook "rvm",
-      :git => "https://github.com/fnichol/chef-rvm",
-      :ref => "v0.7.1"
-
-    cookbook "cloudera",
-      :path => "vendor/cookbooks/cloudera-cookbook"
-
-Here's how it works:
-
-We start off by declaring the *default source* for this `Cheffile`.
-
-    site "http://community.opscode.com/api/v1"
-
-This default source in this example is the Opscode Community Site API. This is
-most likely what you will want for your default source. However, you can
-certainly set up your own API-compatible HTTP endpoint if you want more control.
-
-Any time we declare a cookbook dependency without also declaring a source for
-that cookbook dependency, Librarian-Chef assumes we want it to look for that
-cookbook in the default source.
-
-Any time we declare a cookbook dependency that has subsidiary cookbook
-dependencies of its own, Librarian-Chef assumes we want it to look for the
-subsidiary cookbook dependencies in the default source.
-
-    cookbook "ntp"
-
-Our infrastructure repository depends on the `ntp` cookbook from the default
-source. Any version of the `ntp` cookbook will fulfill our requirements.
-
-    cookbook "timezone", "0.0.1"
-
-Our infrastructure repository depends on the `timezone` cookbook from the
-default source. But only version `0.0.1` of that cookbook will do.
-
-    cookbook "rvm",
-      :git => "https://github.com/fnichol/chef-rvm",
-      :ref => "v0.7.1"
-
-Our infrastructure repository depends on the `rvm` cookbook, but not the one
-from the default source. Instead, the cookbook is to be fetched from the
-specified Git repository and from the specified Git tag only.
-
-When using a Git source, we do not have to use a `:ref =>`. If we do not,
-then Librarian-Chef will assume we meant the `master` branch. (In the future,
-this will be changed to whatever branch is the default branch according to
-the Git remote, which may not be `master`.)
-
-If we use a `:ref =>`, we can use anything that Git will recognize as a ref.
-This includes any branch name, tag name, SHA, or SHA unique prefix. If we use a
-branch, we can later ask Librarian-Chef to update the cookbook by fetching the
-most recent version of the cookbook from that same branch.
-
-The Git source also supports a `:path =>` option. If we use the path option,
-Librarian-Chef will navigate down into the Git repository and only use the
-specified subdirectory. Many people have the habit of having a single repository
-with many cookbooks in it. If we need a cookbook from such a repository, we can
-use the `:path =>` option here to help Librarian-Chef drill down and find the
-cookbook subdirectory.
-
-    cookbook "cloudera",
-      :path => "vendor/cookbooks/cloudera-cookbook"
-
-Our infrastructure repository depends on the `cloudera` cookbook, which we have
-downloaded and copied into our repository. In this example, `vendor/cookbooks/`
-is only for use with Librarian-Chef. This directory should not appear in the
-`.chef/knife.rb`. Librarian-Chef will, instead, copy this cookbook from where
-we vendored it in our repository into the `cookbooks/` directory for us.
-
-The `:path =>` source won't be confused with the `:git =>` source's `:path =>`
-option.
-
-### How to Use
-
-Install Librarian-Chef:
-
-    $ gem install librarian
-
-Prepare your infrastructure repository:
-
-    $ cd ~/path/to/chef-repo
-    $ git rm -r cookbooks
-    $ echo /cookbooks >> .gitignore
-    $ echo /tmp >> .gitignore
-
-Librarian-Chef takes over your `cookbooks/` directory, and will always reinstall
-the cookbooks listed the `Cheffile.lock` into your `cookbooks/` directory. Hence
-you do not need your `cookbooks/` directory to be tracked in Git. If you
-nevertheless want your `cookbooks/` directory to be tracked in Git, simple don't
-`.gitignore` the directory.
-
-If you are manually tracking/vendoring outside cookbooks within the repository,
-put them in another directory such as `vendor/cookbooks/` and use the `:path =>`
-source when declaring these cookbooks in your `Cheffile`. Most people will
-typically not be manually tracking/vendoring outside cookbooks.
-
-Librarian-Chef uses your `tmp/` directory for tempfiles and caches. You do not
-need to track this directory in Git.
-
-Make a Cheffile:
-
-    $ librarian-chef init
-
-This creates an empty `Cheffile` with the Opscode Community Site API as the
-default source.
-
-Add dependencies and their sources to the `Cheffile`:
-
-    $ cat Cheffile
-        site 'http://community.opscode.com/api/v1'
-        cookbook 'ntp'
-        cookbook 'timezone', '0.0.1'
-        cookbook 'rvm',
-          :git => 'https://github.com/fnichol/chef-rvm',
-          :ref => 'v0.7.1'
-        cookbook 'cloudera',
-          :path => 'vendor/cookbooks/cloudera-cookbook'
-
-This is the same `Cheffile` we saw above.
-
-    $ librarian-chef install [--clean] [--verbose]
-
-This command looks at each `cookbook` declaration and fetches the cookbook from
-the source specified, or from the default source if none is provided.
-
-Each cookbook is inspected, its dependencies are determined, and each dependency
-is also fetched. For example, if you declare `cookbook 'nagios'`, which
-depends on other cookbooks such as `'php'`, then those other cookbooks
-including `'php'` will be fetched. This goes all the way down the chain of
-dependencies.
-
-This command writes the complete resolution into `Cheffile.lock`.
-
-This command then copies all of the fetched cookbooks into your `cookbooks/`
-directory, overwriting whatever was there before. You can then use `knife
-cookbook upload -all` to upload the cookbooks to your chef-server, if you are
-using the client-server model.
-
-Check your `Cheffile` and `Cheffile.lock` into version control:
-
-    $ git add Cheffile
-    $ git add Cheffile.lock
-    $ git commit -m "I want these particular versions of these particular cookbooks from these particular."
-
-Make sure you check your `Cheffile.lock` into version control. This will ensure
-dependencies do not need to be resolved every run, greatly reducing dependency
-resolution time.
-
-Get an overview of your `Cheffile.lock` with:
-
-    $ librarian-chef show
-
-Inspect the details of specific resolved dependencies with:
-
-    $ librarian-chef show NAME1 [NAME2, ...]
-
-Update your `Cheffile` with new/changed/removed constraints/sources/dependencies:
-
-    $ cat Cheffile
-        site 'http://community.opscode.com/api/v1'
-        cookbook 'ntp'
-        cookbook 'timezone', '0.0.1'
-        cookbook 'rvm',
-          :git => 'https://github.com/fnichol/chef-rvm',
-          :ref => 'v0.7.1'
-        cookbook 'monit' # new!
-    $ git diff Cheffile
-    $ librarian-chef install [--verbose]
-    $ git diff Cheffile.lock
-    $ git add Cheffile
-    $ git add Cheffile.lock
-    $ git commit -m "I also want these additional cookbooks."
-
-Find out which dependencies are outdated and may be updated:
-
-    $ librarian-chef outdated [--verbose]
-
-Update the version of a dependency:
-
-    $ librarian-chef update ntp timezone monit [--verbose]
-    $ git diff Cheffile.lock
-    $ git add Cheffile.lock
-    $ git commit -m "I want updated versions of these cookbooks."
-
-Push your changes to the git repository:
-
-    $ git push origin master
-
-Upload the cookbooks to your chef-server:
-
-    $ knife cookbook upload --all
-
-### Configuration
-
-Configuration comes from three sources with the following highest-to-lowest
-precedence:
-
-* The local config (`./.librarian/chef/config`)
-* The environment
-* The global config (`~/.librarian/chef/config`)
-
-You can inspect the final configuration with:
-
-    $ librarian-chef config
-
-You can find out where a particular key is set with:
-
-    $ librarian-chef config KEY
-
-You can set a key at the global level with:
-
-    $ librarian-chef config KEY VALUE --global
-
-And remove it with:
-
-    $ librarian-chef config KEY --global --delete
-
-You can set a key at the local level with:
-
-    $ librarian-chef config KEY VALUE --local
-
-And remove it with:
-
-    $ librarian-chef config KEY --local --delete
-
-You cannot set or delete environment-level config keys with the CLI.
-
-Configuration set at either the global or local level will affect subsequent
-invocations of `librarian-chef`. Configurations set at the environment level are
-not saved and will not affect subsequent invocations of `librarian-chef`.
-
-You can pass a config at the environment level by taking the original config key
-and transforming it: replace hyphens (`-`) with underscores (`_`) and periods
-(`.`) with doubled underscores (`__`), uppercase, and finally prefix with
-`LIBRARIAN_CHEF_`. For example, to pass a config in the environment for the key
-`part-one.part-two`, set the environment variable
-`LIBRARIAN_CHEF_PART_ONE__PART_TWO`.
-
-Configuration affects how various commands operate.
-
-* The `path` config sets the cookbooks directory to install to. If a relative
-  path, it is relative to the directory containing the `Cheffile`. The
-  equivalent environment variable is `LIBRARIAN_CHEF_PATH`.
-
-* The `install.strip-dot-git` config causes the `.git/` directory to be stripped
-  out when installing cookbooks from a git source. This must be set to exactly
-  "1" to cause this behavior. The equivalent environment variable is
-  `LIBRARIAN_CHEF_INSTALL__STRIP_DOT_GIT`.
-
-Configuration can be set by passing specific options to other commands.
-
-* The `path` config can be set at the local level by passing the `--path` option
-  to the `install` command. It can be unset at the local level by passing the
-  `--no-path` option to the `install` command. Note that if this is set at the
-  environment or global level then, even if `--no-path` is given as an option,
-  the environment or global config will be used.
-
-* The `install.strip-dot-git` config can be set at the local level by passing
-  the `--strip-dot-git` option to the `install` command. It can be unset at the
-  local level by passing the `--no-strip-dot-git` option.
-
-### Knife Integration
-
-You can integrate your `knife.rb` with Librarian-Chef.
-
-Stick the following in your `knife.rb`:
-
-    require 'librarian/chef/integration/knife'
-    cookbook_path Librarian::Chef.install_path,
-                  "/path/to/chef-repo/site-cookbooks"
-
-In the above, do *not* to include the path to your `cookbooks/` directory. If
-you have additional cookbooks directories in your chef-repo that you use for
-vendored cookbooks (where you use the `:path =>` source in your `Cheffile`),
-make sure *not* to include the paths to those additional cookbooks directories
-either.
-
-You still need to include your `site-cookbooks/` directory in the above list.
-
-What this integration does is whenever you use any `knife` command, it will:
-
-* Enforce that your `Cheffile` and `Cheffile.lock` are in sync
-* Install the resolved cookbooks to a temporary directory
-* Configure Knife to look in the temporary directory for the installed cookbooks
-  and not in the normal `cookbooks/` directory.
-
-When you use this integration, any changes you make to anything in the
-`cookbooks/` directory will be ignored by Knife, because Knife won't look in
-that directory for your cookbooks.
-
-How to Contribute
------------------
-
-### Running the tests
-
-    # Either
-    $ rspec spec
-    $ cucumber
-
-    # Or
-    $ rake
-
-You will probably need some way to isolate gems. Librarian provides a `Gemfile`,
-so if you want to use bundler, you can prepare the directory with the usual
-`bundle install` and run each command prefixed with the usual `bundle exec`, as:
-
-    $ bundle install
-    $ bundle exec rspec spec
-    $ bundle exec cucumber
-    $ bundle exec rake
-
-### Installing locally
-
-    $ rake install
-
-You should typically not need to install locally, if you are simply trying to
-patch a bug and test the result on a test case. Instead of installing locally,
-you are probably better served by:
-
-    $ cd $PATH_TO_INFRASTRUCTURE_REPO
-    $ $PATH_TO_LIBRARIAN_CHECKOUT/bin/librarian-chef install [--verbose]
-
-### Reporting Issues
-
-Please include relevant `Cheffile` and `Cheffile.lock` files. Please run the
-`librarian-chef` commands in verbose mode by using the `--verbose` flag, and
-include the verbose output in the bug report as well.
-
-License
--------
-
-Written by Jay Feldblum.
-
-Copyright (c) 2011-2012 ApplicationsOnline, LLC.
-
-Released under the terms of the MIT License. For further information, please see
-the file `MIT-LICENSE`.