menagerie 0.1.3 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b31c3981add784c6a763079af7377d26bb8a135b
-  data.tar.gz: 096b3570b9937154565628863f2da67d0b87461e
+  metadata.gz: b98fd545ddccb263db3f21023fd0dc02aad05189
+  data.tar.gz: 308c931a27d9573b6d70a8be093d6fa6ea7f44ad
 SHA512:
-  metadata.gz: 0446dc43e870b7dc802607e50a3bfc5037cff63e35c3878841b9acf9fe3bb8cb57d03a534c4bc3dcbbaebbb4aed89a439132fc518abd212828788b282ab26ade
-  data.tar.gz: 9cd913b1b8e1fdf235aa5fe6b63a5cc70161f31470235c1cabef5d5d225650dfc51b1db3ba733564a30324da648da5f7799c1ec0c3dfc27b5e79088397c4b617
+  metadata.gz: b40e70f809cd646aab6ac63b90e10477f4ffaab400a84e870fb6b93ba339fe1eea51cfd0fe3a870615ac62543e7a55d558e3acc8c033ee3f588b528128b430b2
+  data.tar.gz: ff6b695108b03b845701f6aa55d4b267c966d621edea7625fe38827f01c34140d1cf9e76152d621e862203581de942a9e96b635cb1f9d9e24a0ec01fa7e3bfbd

data/.gitignore

@@ -3,3 +3,4 @@ coverage/
 .coveralls.yml
 .bundle
 Gemfile.lock
+spec/examples/scratch/

data/.travis.yml

@@ -1,11 +1,15 @@
 language: ruby
 cache: bundler
+sudo: false
 rvm:
-- 2.1.0
-- 2.0.0
-- 1.9.3
+- 2.2.0
+- 2.1.5
+- 2.0.0-p598
+- 1.9.3-p551
 notifications:
   email: false
   irc:
     template:
-      - '%{repository}/%{branch}/%{build_number}: %{message} -- %{build_url}'
+    - '%{repository}/%{branch}/%{build_number}: %{message} -- %{build_url}'
+    channels:
+    - irc.oftc.net#akerl

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# 1.0.0 / 2015-02-14
+
+* [ENHANCEMENT] Stabilized API
+

data/README.md

@@ -8,10 +8,146 @@ menagerie
 [![Build Status](https://img.shields.io/travis/akerl/menagerie.svg)](https://travis-ci.org/akerl/menagerie)
 [![MIT Licensed](https://img.shields.io/badge/license-MIT-green.svg)](https://tldrlegal.com/license/mit-license)
 
-Simple release management tool for controlling versioned artifacts on an instance.
+Simple release management tool for controlling versioned artifacts
 
 ## Usage
 
+Menagerie manages Collections of Releases, as well as the Artifacts that are used in those Releases. A quick tl;dr:
+
+* Artifact -- a downloaded asset: a compiled Linux kernel, the python package, a picture of your cat, etc
+* Release -- a set of Artifacts at specific versions: "Python 2.7, Linux kernel 3.18.1, and the 3rd revision of your cat's picture"
+* Collection - all the Releases currently downloaded, including the "latest" release as well any previous releases
+
+Also relevant are "Orphans"; these are artifacts that are not needed by any currently tracked releases.
+
+The gem provides a simple script that will print out the contents of an existing collection:
+
+```
+Release: 0
+  initrd: 0.0.36
+  kernel: 3.19-rc7_1
+  vm_root: 0.0.73
+Release: 1
+  initrd: 0.0.36
+  kernel: 3.19-rc7_1
+  vm_root: 0.0.71
+Release: 2
+  initrd: 0.0.36
+  kernel: 3.19-rc6_1
+  vm_root: 0.0.69
+
+Orphans:
+  kernel
+    3.19-rc5_1
+```
+
+To start using Menagerie, create a collection:
+
+```
+require 'menagerie'
+my_collection = Menagerie.new
+```
+
+Initially, your collection has no releases. To add a release, call `.add_release` with the details for the artifacts you want to install:
+
+```
+new_artifacts = [
+    {
+        name: 'kernel',
+        version: '3.19-rc7_1',
+        url: 'https://github.com/dock0/kernel/releases/download/3.19-rc7_1/vmlinuz'
+    },
+    {
+        name: 'initrd',
+        version: '0.0.36',
+        url: 'https://github.com/dock0/initrd/releases/download/0.0.36/initrd.img'
+    }
+]
+my_collection.add_release(new_artifacts)
+```
+
+This will download the new artifacts into `./artifacts` and symlink them into `./releases/0`, with `./latest` linked to `./releases/0`:
+
+```
+# tree
+.
+├── artifacts
+│   ├── initrd
+│   │   └── 0.0.36
+│   └── kernel
+│       └── 3.19-rc7_1
+├── latest -> releases/0
+└── releases
+    └── 0
+        ├── initrd -> ../../artifacts/initrd/0.0.36
+        └── kernel -> ../../artifacts/kernel/3.19-rc7_1
+```
+
+Now lets say you update your kernel package, so you want to make a new releaes with your updated 3.19_1 kernel:
+
+```
+new_artifacts = [
+    {
+        name: 'kernel',
+        version: '3.19_1',
+        url: 'https://github.com/dock0/kernel/releases/download/3.19-rc7_1/vmlinuz'
+    },
+    {
+        name: 'initrd',
+        version: '0.0.36',
+        url: 'https://github.com/dock0/initrd/releases/download/0.0.36/initrd.img'
+    }
+]
+my_collection.add_release(new_artifacts)
+```
+
+Menagerie will rotate the '0' release to '1', download the new kernel, and link the correct assets into '0'. Note that it doesn't download a new copy of the initrd asset, as the version didn't change:
+
+```
+# tree
+.
+├── artifacts
+│   ├── initrd
+│   │   └── 0.0.36
+│   └── kernel
+│       ├── 3.19_1
+│       └── 3.19-rc7_1
+├── latest -> releases/0
+└── releases
+    ├── 0
+    │   ├── initrd -> ../../artifacts/initrd/0.0.36
+    │   └── kernel -> ../../artifacts/kernel/3.19_1
+    └── 1
+        ├── initrd -> ../../artifacts/initrd/0.0.36
+        └── kernel -> ../../artifacts/kernel/3.19-rc7_1
+```
+
+Menagerie will retain 5 old releases by default (for a total of 6, including the current version). Older releases will be removed, and orphaned artifacts (those no longer used in any releases) will be deleted. To change the retention or disable reaping of orphans, pass the desired options to Menagerie when you create your collection:
+
+```
+larger_collection = Menagerie.new(options: { retention: 20 }) # this will retain 20 old releases
+
+permanent_collection = Menagerie.new(options: { reap: false }) # this will not reap orphaned artifacts
+```
+
+By default, Menagerie will log to STDOUT when it manipulates releases and artifacts. You can disable this via the `verbose` option:
+
+```
+quiet_collection = Menagerie.new(options: { verbose: false })
+```
+
+You can also override the paths used for artifacts/releases and the "latest" symlink, via the `paths` parameter:
+
+```
+custom_paths = {
+    artifacts: '/srv/artifacts',
+    releases: '/opt/releases',
+    latest: '/var/latest_release'
+}
+
+my_collection = Menagerie.new(paths: custom_paths)
+```
+
 ## Installation
 
     gem install menagerie

data/lib/menagerie.rb

@@ -1,3 +1,5 @@
+require 'logger'
+
 ##
 # This module provides release collection management
 module Menagerie
@@ -8,6 +10,13 @@ module Menagerie
     def new(*args)
       self::Collection.new(*args)
     end
+
+    def get_logger(verbose = true)
+      logger = Logger.new(STDOUT)
+      logger.level = verbose ? Logger::DEBUG : Logger::WARN
+      logger.progname = 'menagerie'
+      logger
+    end
   end
 end
 

data/lib/menagerie/artifact.rb

@@ -1,31 +1,34 @@
-require 'pathname'
 require 'open-uri'
 
 module Menagerie
   ##
   # Artifacts are a stored file for a particular version of a project
   class Artifact
-    attr_reader :version, :name, :path
+    attr_reader :name, :version
 
     def initialize(params = {})
-      @config = params
-      @config[:artifact] ? create : parse
+      @options = params
+      @logger = @options[:logger] || Menagerie.get_logger
+      @options[:artifact] ? create : parse
+    end
+
+    def path
+      @path ||= "#{@options[:paths][:artifacts]}/#{@name}/#{@version}"
     end
 
     private
 
     def create
-      @name, @version, url = @config[:artifact].values_at :name, :version, :url
-      @path = "#{@config[:paths][:artifacts]}/#{@name}/#{@version}"
-      download url, path unless File.exist? path
-      File.chmod(@config[:artifact][:mode], path) if @config[:artifact][:mode]
+      artifact = @options[:artifact]
+      @name, @version = artifact.values_at(:name, :version)
+      @logger.info "Downloading artifact: #{path}"
+      download(artifact[:url], path) unless File.exist? path
+      File.chmod(artifact[:mode], path) if artifact[:mode]
     end
 
     def parse
-      link_path = @config[:path]
-      @name = Pathname.new(link_path).basename
-      @version = File.basename File.readlink(link_path)
-      @path = "#{@config[:paths][:artifacts]}/#{@name}/#{@version}"
+      @name = File.basename @options[:path]
+      @version = File.basename File.readlink(@options[:path])
     end
 
     def download(url, path)

data/lib/menagerie/collection.rb

@@ -5,16 +5,17 @@ module Menagerie
   ##
   # Connection object that contains releases
   class Collection
-    def initialize(params = nil)
+    def initialize(params = {})
       params = Cymbal.symbolize(params || {})
       @paths = default_paths.merge(params[:paths] || {})
       @options = default_options.merge(params[:options] || {})
+      @logger = Menagerie.get_logger(@options[:verbosity])
     end
 
     def releases
       Dir.glob("#{@paths[:releases]}/*").map do |x|
-        Release.new path: x, paths: @paths
-      end
+        Release.new path: x, paths: @paths, logger: @logger
+      end.sort
     end
 
     def orphans
@@ -24,9 +25,13 @@ module Menagerie
       end
     end
 
-    def create(artifacts)
+    def add_release(artifacts)
       rotate
-      Release.new artifacts: Cymbal.symbolize(artifacts), paths: @paths
+      Release.new(
+        artifacts: Cymbal.symbolize(artifacts),
+        paths: @paths,
+        logger: @logger
+      )
       reap if @options[:reap]
       link_latest
     end
@@ -41,12 +46,16 @@ module Menagerie
     end
 
     def reap
-      orphans.each { |orphan| FileUtils.rm_f orphan }
+      orphans.each do |orphan|
+        @logger.info "Reaping orphan: #{orphan}"
+        FileUtils.rm_f orphan
+      end
     end
 
     def link_latest
       FileUtils.rm_f @paths[:latest]
       FileUtils.ln_sf releases.sort.first.path, @paths[:latest]
+      @logger.debug "Linked latest release to #{@paths[:latest]}"
     end
 
     def default_paths
@@ -60,7 +69,8 @@ module Menagerie
     def default_options
       {
         retention: 5,
-        reap: true
+        reap: true,
+        verbose: true
       }
     end
   end

data/lib/menagerie/release.rb

@@ -8,14 +8,15 @@ module Menagerie
     attr_reader :id, :base, :path
 
     def initialize(params = {})
-      @config = params
-      @path = @config[:path] || create
-      @base, @id = Pathname.new(@path).split.map(&:to_s)
+      @options = params
+      @logger = @options[:logger] || Menagerie.get_logger
+      @path = @options[:path] || create
+      parse_path
     end
 
     def artifacts
       Dir.glob("#{@path}/*").map do |x|
-        Artifact.new(path: x, paths: @config[:paths])
+        Artifact.new path: x, paths: @options[:paths], logger: @logger
       end
     end
 
@@ -24,11 +25,28 @@ module Menagerie
       @id.to_i <=> other.id.to_i
     end
 
+    def rotate
+      old_path = @path
+      @path = "#{@base}/#{@id.to_i + 1}"
+      FileUtils.mv old_path, @path
+      parse_path
+    end
+
+    def delete
+      @logger.info "Deleting release: #{@path}"
+      FileUtils.rm_r @path
+    end
+
+    private
+
     def create
-      path = "#{@config[:paths][:releases]}/0"
+      path = "#{@options[:paths][:releases]}/0"
+      @logger.info "Creating release: #{path}"
       FileUtils.mkdir_p path
-      @config[:artifacts].each do |x|
-        artifact = Artifact.new artifact: x, paths: @config[:paths]
+      @options[:artifacts].each do |x|
+        artifact = Artifact.new(
+          artifact: x, paths: @options[:paths], logger: @logger
+        )
         link artifact.path, "#{path}/#{x[:name]}"
       end
       path
@@ -40,12 +58,8 @@ module Menagerie
       FileUtils.ln_s relative_source, target
     end
 
-    def rotate
-      FileUtils.mv @path, "#{@base}/#{@id.to_i + 1}"
-    end
-
-    def delete
-      FileUtils.rm_r @path
+    def parse_path
+      @base, @id = Pathname.new(@path).split.map(&:to_s)
     end
   end
 end

data/menagerie.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = 'menagerie'
-  s.version     = '0.1.3'
+  s.version     = '1.0.0'
   s.date        = Time.now.strftime("%Y-%m-%d")
 
   s.summary     = ''
@@ -14,11 +14,11 @@ Gem::Specification.new do |s|
   s.test_files  = `git ls-files spec/*`.split
   s.executables = ['menagerie']
 
-  s.add_dependency 'cymbal', '~> 0.0.1'
+  s.add_dependency 'cymbal', '~> 1.0.0'
 
-  s.add_development_dependency 'rubocop', '~> 0.26.0'
-  s.add_development_dependency 'rake', '~> 10.3.2'
+  s.add_development_dependency 'rubocop', '~> 0.29.0'
+  s.add_development_dependency 'rake', '~> 10.4.0'
   s.add_development_dependency 'coveralls', '~> 0.7.1'
-  s.add_development_dependency 'rspec', '~> 3.1.0'
+  s.add_development_dependency 'rspec', '~> 3.2.0'
   s.add_development_dependency 'fuubar', '~> 2.0.0'
 end

data/spec/menagerie/artifact_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+describe Menagerie::Artifact do
+  before(:each) do
+    FileUtils.rm_rf 'spec/examples/scratch'
+    FileUtils.cp_r 'spec/examples/existing', 'spec/examples/scratch'
+  end
+
+  let(:base_path) { 'spec/examples/scratch' }
+  let(:paths) do
+    {
+      artifacts: "#{base_path}/artifacts",
+      releases: "#{base_path}/releases",
+      latest: "#{base_path}/latest"
+    }
+  end
+  let(:new_artifact) do
+    { name: 'a', version: '2.0.0', url: 'https://goo.gl/pWew5I' }
+  end
+  let(:produce_output) do
+    output(/Downloading artifact/).to_stdout_from_any_process
+  end
+  let(:artifact) { Menagerie.new(paths: paths).releases.first.artifacts.first }
+
+  it 'has a name attribute' do
+    expect(artifact.name).to eql 'a'
+  end
+
+  it 'has a version attribute' do
+    expect(artifact.version).to eql '0.0.3'
+  end
+
+  it 'has a path attribute' do
+    expect(artifact.path).to eql "#{base_path}/artifacts/a/0.0.3"
+  end
+
+  it 'is created if it does not exist' do
+    expect(File.exist? "#{base_path}/artifacts/a/2.0.0").to be_falsey
+    params = { paths: paths, artifact: new_artifact }
+    expect { Menagerie::Artifact.new params }.to produce_output
+    expect(File.exist? "#{base_path}/artifacts/a/2.0.0").to be_truthy
+  end
+end

data/spec/menagerie/collection_spec.rb

@@ -0,0 +1,114 @@
+require 'spec_helper'
+
+require 'fileutils'
+
+describe Menagerie::Collection do
+  let(:examples) { 'spec/examples' }
+  let(:collection) { Menagerie.new }
+
+  describe '#releases' do
+    it 'parses releases in a collection' do
+      Dir.chdir("#{examples}/existing") do
+        expect(collection.releases.size).to eql 3
+        expect(collection.releases.first).to be_a Menagerie::Release
+      end
+    end
+
+    it 'parses an empty collection as empty' do
+      Dir.chdir("#{examples}/empty") do
+        expect(collection.releases.size).to eql 0
+      end
+      Dir.chdir("#{examples}/empty_with_dirs") do
+        expect(collection.releases.size).to eql 0
+      end
+    end
+
+    it 'supports an alternate path for releases' do
+      x = Menagerie.new paths: { releases: 'spec/examples/existing/releases' }
+      expect(x.releases.size).to eql 3
+    end
+  end
+
+  describe '#orphans' do
+    it 'identifies orphaned artifacts' do
+      Dir.chdir("#{examples}/orphaned") do
+        expect(collection.orphans.size).to eql 1
+        expect(collection.orphans.first).to be_a String
+      end
+    end
+
+    it 'returns an empty list if there are no orphans' do
+      Dir.chdir("#{examples}/existing") do
+        expect(collection.orphans.size).to eql 0
+      end
+    end
+  end
+
+  describe '#add_release' do
+    before(:each) do
+      FileUtils.rm_rf 'spec/examples/scratch'
+      FileUtils.cp_r 'spec/examples/existing', 'spec/examples/scratch'
+    end
+
+    let(:base_path) { 'spec/examples/scratch' }
+    let(:paths) do
+      {
+        artifacts: "#{base_path}/artifacts",
+        releases: "#{base_path}/releases",
+        latest: "#{base_path}/latest"
+      }
+    end
+    let(:artifacts) do
+      [
+        { name: 'a', version: '2.0.0', url: 'https://goo.gl/pWew5I' },
+        { name: 'b', version: '3.0.0', url: 'https://goo.gl/fkNplq' }
+      ]
+    end
+    let(:default_collection) { Menagerie.new(paths: paths) }
+
+    it 'rotates existing releases' do
+      expect(default_collection.releases.size).to eql 3
+      default_collection.add_release(artifacts)
+      expect(default_collection.releases.size).to eql 4
+    end
+
+    it 'retains a set number of old releases' do
+      10.times { default_collection.add_release(artifacts) }
+      expect(default_collection.releases.size).to eql 6
+    end
+
+    it 'can be configured to allow a differnet number of releases' do
+      collection = Menagerie.new(paths: paths, options: { retention: 8 })
+      10.times { collection.add_release(artifacts) }
+      expect(collection.releases.size).to eql 9
+    end
+
+    it 'creates a new release' do
+      default_collection.add_release(artifacts)
+      expect(default_collection.releases.first.artifacts.size).to eql 2
+    end
+
+    it 'reaps orphaned artifacts' do
+      FileUtils.touch "#{base_path}/artifacts/a/0.0.4"
+      FileUtils.mkdir "#{base_path}/artifacts/d"
+      FileUtils.touch "#{base_path}/artifacts/d/0.0.4"
+      expect(File.exist? "#{base_path}/artifacts/a/0.0.4").to be_truthy
+      expect(File.exist? "#{base_path}/artifacts/d/0.0.4").to be_truthy
+      default_collection.add_release(artifacts)
+      expect(File.exist? "#{base_path}/artifacts/a/0.0.4").to be_falsey
+      expect(File.exist? "#{base_path}/artifacts/d/0.0.4").to be_falsey
+    end
+
+    it 'can be configure to not reap orphaned artifacts' do
+      FileUtils.touch "#{base_path}/artifacts/a/0.0.4"
+      FileUtils.mkdir "#{base_path}/artifacts/d"
+      FileUtils.touch "#{base_path}/artifacts/d/0.0.4"
+      expect(File.exist? "#{base_path}/artifacts/a/0.0.4").to be_truthy
+      expect(File.exist? "#{base_path}/artifacts/d/0.0.4").to be_truthy
+      collection = Menagerie.new(paths: paths, options: { reap: false })
+      collection.add_release(artifacts)
+      expect(File.exist? "#{base_path}/artifacts/a/0.0.4").to be_truthy
+      expect(File.exist? "#{base_path}/artifacts/d/0.0.4").to be_truthy
+    end
+  end
+end

data/spec/menagerie/release_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe Menagerie::Release do
+  before(:each) do
+    FileUtils.rm_rf 'spec/examples/scratch'
+    FileUtils.cp_r 'spec/examples/existing', 'spec/examples/scratch'
+  end
+
+  let(:base_path) { 'spec/examples/scratch' }
+  let(:paths) do
+    {
+      artifacts: "#{base_path}/artifacts",
+      releases: "#{base_path}/releases",
+      latest: "#{base_path}/latest"
+    }
+  end
+  let(:release) { Menagerie.new(paths: paths).releases.first }
+
+  it 'has an id attribute' do
+    expect(release.id).to eql '0'
+  end
+
+  it 'has a base attribute' do
+    expect(release.base).to eql "#{base_path}/releases"
+  end
+
+  it 'has a path attribute' do
+    expect(release.path).to eql "#{release.base}/#{release.id}"
+  end
+
+  it 'sorts' do
+    other_release = Menagerie.new(paths: paths).releases.last
+    expect(release <=> other_release).to eql(-1)
+  end
+
+  describe '#artifacts' do
+    it 'is an array of Artifacts' do
+      expect(release.artifacts).to all(be_a Menagerie::Artifact)
+    end
+  end
+
+  describe '#rotate' do
+    it 'rotates the release path' do
+      last_release = Menagerie.new(paths: paths).releases.last
+      expect(last_release.id).to eql '2'
+      last_release.rotate
+      expect(last_release.id).to eql '3'
+    end
+  end
+
+  describe '#delete' do
+    it 'deletes the release' do
+      expect(Dir.exist? release.path).to be_truthy
+      release.delete
+      expect(Dir.exist? release.path).to be_falsey
+    end
+  end
+end

data/spec/menagerie_spec.rb

@@ -1 +1,33 @@
 require 'spec_helper'
+
+describe Menagerie do
+  describe '#new' do
+    it 'creates collection objects' do
+      expect(Menagerie.new).to be_an_instance_of Menagerie::Collection
+    end
+  end
+
+  describe '#get_logger' do
+    let(:logger) { Menagerie.get_logger }
+    let(:quiet_logger) { Menagerie.get_logger(false) }
+
+    let(:produce_output) { output(/hello/).to_stdout_from_any_process }
+
+    it 'returns a logger object' do
+      expect(logger).to be_an_instance_of Logger
+    end
+
+    it 'writes to stdout' do
+      expect { logger.warn('hello') }.to produce_output
+    end
+
+    it 'shows debugging by default' do
+      expect { logger.info('hello') }.to produce_output
+    end
+
+    it 'allows silencing debug output' do
+      expect { quiet_logger.info('hello') }.to_not produce_output
+      expect { quiet_logger.warn('hello') }.to produce_output
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: menagerie
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 1.0.0
 platform: ruby
 authors:
 - Les Aker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-26 00:00:00.000000000 Z
+date: 2015-02-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cymbal
@@ -16,42 +16,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.1
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.0.1
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.26.0
+        version: 0.29.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.26.0
+        version: 0.29.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 10.3.2
+        version: 10.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 10.3.2
+        version: 10.4.0
 - !ruby/object:Gem::Dependency
   name: coveralls
   requirement: !ruby/object:Gem::Requirement
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 3.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: fuubar
   requirement: !ruby/object:Gem::Requirement
@@ -105,6 +105,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - README.md
@@ -115,6 +116,47 @@ files:
 - lib/menagerie/collection.rb
 - lib/menagerie/release.rb
 - menagerie.gemspec
+- spec/examples/empty/.keep
+- spec/examples/empty_with_dirs/artifacts/.keep
+- spec/examples/empty_with_dirs/releases/.keep
+- spec/examples/existing/artifacts/a/0.0.1
+- spec/examples/existing/artifacts/a/0.0.2
+- spec/examples/existing/artifacts/a/0.0.3
+- spec/examples/existing/artifacts/b/1.0.0
+- spec/examples/existing/artifacts/b/1.0.1
+- spec/examples/existing/artifacts/c/0.1.1
+- spec/examples/existing/artifacts/c/0.1.2
+- spec/examples/existing/artifacts/c/0.2.0
+- spec/examples/existing/releases/0/a
+- spec/examples/existing/releases/0/b
+- spec/examples/existing/releases/0/c
+- spec/examples/existing/releases/1/a
+- spec/examples/existing/releases/1/b
+- spec/examples/existing/releases/1/c
+- spec/examples/existing/releases/2/a
+- spec/examples/existing/releases/2/b
+- spec/examples/existing/releases/2/c
+- spec/examples/orphaned/artifacts/a/0.0.1
+- spec/examples/orphaned/artifacts/a/0.0.2
+- spec/examples/orphaned/artifacts/a/0.0.3
+- spec/examples/orphaned/artifacts/b/1.0.0
+- spec/examples/orphaned/artifacts/b/1.0.1
+- spec/examples/orphaned/artifacts/c/0.1.0
+- spec/examples/orphaned/artifacts/c/0.1.1
+- spec/examples/orphaned/artifacts/c/0.1.2
+- spec/examples/orphaned/artifacts/c/0.2.0
+- spec/examples/orphaned/releases/0/a
+- spec/examples/orphaned/releases/0/b
+- spec/examples/orphaned/releases/0/c
+- spec/examples/orphaned/releases/1/a
+- spec/examples/orphaned/releases/1/b
+- spec/examples/orphaned/releases/1/c
+- spec/examples/orphaned/releases/2/a
+- spec/examples/orphaned/releases/2/b
+- spec/examples/orphaned/releases/2/c
+- spec/menagerie/artifact_spec.rb
+- spec/menagerie/collection_spec.rb
+- spec/menagerie/release_spec.rb
 - spec/menagerie_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/akerl/menagerie
@@ -137,10 +179,51 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: ''
 test_files:
+- spec/examples/empty/.keep
+- spec/examples/empty_with_dirs/artifacts/.keep
+- spec/examples/empty_with_dirs/releases/.keep
+- spec/examples/existing/artifacts/a/0.0.1
+- spec/examples/existing/artifacts/a/0.0.2
+- spec/examples/existing/artifacts/a/0.0.3
+- spec/examples/existing/artifacts/b/1.0.0
+- spec/examples/existing/artifacts/b/1.0.1
+- spec/examples/existing/artifacts/c/0.1.1
+- spec/examples/existing/artifacts/c/0.1.2
+- spec/examples/existing/artifacts/c/0.2.0
+- spec/examples/existing/releases/0/a
+- spec/examples/existing/releases/0/b
+- spec/examples/existing/releases/0/c
+- spec/examples/existing/releases/1/a
+- spec/examples/existing/releases/1/b
+- spec/examples/existing/releases/1/c
+- spec/examples/existing/releases/2/a
+- spec/examples/existing/releases/2/b
+- spec/examples/existing/releases/2/c
+- spec/examples/orphaned/artifacts/a/0.0.1
+- spec/examples/orphaned/artifacts/a/0.0.2
+- spec/examples/orphaned/artifacts/a/0.0.3
+- spec/examples/orphaned/artifacts/b/1.0.0
+- spec/examples/orphaned/artifacts/b/1.0.1
+- spec/examples/orphaned/artifacts/c/0.1.0
+- spec/examples/orphaned/artifacts/c/0.1.1
+- spec/examples/orphaned/artifacts/c/0.1.2
+- spec/examples/orphaned/artifacts/c/0.2.0
+- spec/examples/orphaned/releases/0/a
+- spec/examples/orphaned/releases/0/b
+- spec/examples/orphaned/releases/0/c
+- spec/examples/orphaned/releases/1/a
+- spec/examples/orphaned/releases/1/b
+- spec/examples/orphaned/releases/1/c
+- spec/examples/orphaned/releases/2/a
+- spec/examples/orphaned/releases/2/b
+- spec/examples/orphaned/releases/2/c
+- spec/menagerie/artifact_spec.rb
+- spec/menagerie/collection_spec.rb
+- spec/menagerie/release_spec.rb
 - spec/menagerie_spec.rb
 - spec/spec_helper.rb