heirloom 0.8.1 → 0.8.2

data/CHANGELOG

@@ -1,3 +1,10 @@
+## 0.8.2:
+
+* Updated docs based on feedback from mint.
+* Added check for other account owning a given bucket.
+* Fixed config to read CLI variables and override file config.
+* When delete bucket raise not found, return true (eventually consistent)
+
 ## v0.8.1:
 
 * Moving verification on entry exists into catalog class

data/README.md

@@ -7,13 +7,19 @@ The goal of Heirloom is to securely and easily transport data to cloud hosted ap
 
 Heirloom creates archives from directories. Their archives are versioned and hosted in geographic distributed locations. Heirloom tracks metadata about those archives, both about the archive locations, as well as arbitrary tags which can be set by an engineer or process. It supports encryption and authorization to allow for securely transporting sensitive data over cloud storage services.
 
+Prerequisites
+-------------
+
+* Ruby version 1.9.2 or higher installed.
+* AWS account access key and secret key.
+
 Installation
 ------------
 
 Install the gem
 
 ```
-gem install heirloom
+gem install heirloom --no-ri --no-rdoc
 ```
 
 To get started copy the sample below into ~/.heirloom.yml and update the specified fields.
@@ -22,25 +28,20 @@ To get started copy the sample below into ~/.heirloom.yml and update the specifi
 aws:
   access_key: UPDATE_ME
   secret_key: UPDATE_ME
+  metadata_region: us-west-1
 ```
 
 Proxy Support
 -------------
 
-Heirloom uses the http_proxy & https_proxy variables.
+Heirloom supports accessing AWS API endpoint throught a proxy.  This can be set via the http_proxy and https_proxy variables.
 
 ```
 export http_proxy=http://1.2.3.4:80
 export http_proxys=http://1.2.3.4:80
 ```
 
-Platforms
----------
-
-Currently I support AWS S3 for object storage and AWS SimpleDB for metadata management.  One day I'd like to expand to other providers.
-
-
 Documentation
 -------------
 
-For more information, please view the [Heirloom Wiki](https://github.com/live-community/heirloom/wiki).
+For more information, please view the [Heirloom Wiki](https://github.com/intuit/heirloom/wiki).

data/lib/heirloom/archive.rb

@@ -10,6 +10,7 @@ require 'heirloom/archive/writer.rb'
 require 'heirloom/archive/authorizer.rb'
 require 'heirloom/archive/destroyer.rb'
 require 'heirloom/archive/verifier.rb'
+require 'heirloom/archive/checker.rb'
 
 module Heirloom
 

data/lib/heirloom/archive/checker.rb

@@ -0,0 +1,30 @@
+module Heirloom
+
+  class Checker
+
+    def initialize(args)
+      @config = args[:config]
+      @logger = @config.logger
+    end
+
+    def bucket_name_available?(args)
+      bucket_prefix = args[:bucket_prefix]
+      regions       = args[:regions]
+      result        = true
+
+      regions.each do |region|
+        s3 = AWS::S3.new :config => @config,
+                         :region => region
+        bucket = "#{bucket_prefix}-#{region}"
+
+        unless s3.bucket_name_available? bucket
+          @logger.warn "#{bucket} unavailable in #{region}."
+          result = false
+        end
+      end
+
+      result
+    end
+
+  end
+end

data/lib/heirloom/aws/s3.rb

@@ -7,6 +7,7 @@ module Heirloom
       def initialize(args)
         @config = args[:config]
         @region = args[:region]
+        @logger = @config.logger
 
         @s3 = Fog::Storage.new :provider              => 'AWS',
                                :aws_access_key_id     => @config.access_key,
@@ -22,8 +23,46 @@ module Heirloom
         @s3.directories.get bucket
       end
 
+      def bucket_exists?(bucket)
+        get_bucket(bucket) != nil
+      rescue Excon::Errors::Forbidden
+        false
+      end
+
+      def bucket_exists_in_another_region?(bucket)
+        if bucket_exists? bucket
+          get_bucket(bucket).location != @region
+        else
+          false
+        end
+      rescue Excon::Errors::Forbidden
+        false
+      end
+
+      def bucket_owned_by_another_account?(bucket)
+        get_bucket bucket
+        false
+      rescue Excon::Errors::Forbidden
+        @logger.warn "#{bucket} owned by another account."
+        true
+      end
+
+      def bucket_name_available?(bucket)
+        @logger.info "Checking for #{bucket} availability in #{@region}."
+
+        if bucket_owned_by_another_account?(bucket) ||
+           bucket_exists_in_another_region?(bucket)
+           false
+        else
+          true
+        end
+      end
+
       def delete_bucket(bucket)
         @s3.delete_bucket bucket
+      rescue Excon::Errors::NotFound
+        @logger.info "#{bucket} already destroyed."
+        true
       end
 
       def get_object(bucket_name, object_name)

data/lib/heirloom/cli/setup.rb

@@ -29,6 +29,9 @@ module Heirloom
                              :config  => @config
         ensure_metadata_in_upload_region :config  => @config, 
                                          :regions => @opts[:region]
+        ensure_buckets_available :config        => @config,
+                                 :bucket_prefix => @opts[:bucket_prefix],
+                                 :regions       => @opts[:region]
 
         @catalog.create_catalog_domain
 

data/lib/heirloom/cli/shared.rb

@@ -170,6 +170,25 @@ module Heirloom
         end
       end
 
+      def ensure_buckets_available(args)
+        config        = args[:config]
+        regions       = args[:regions]
+        bucket_prefix = args[:bucket_prefix]
+        logger  = config.logger
+
+        checker = Heirloom::Checker.new :config => config
+
+        available = checker.bucket_name_available? :bucket_prefix => bucket_prefix,
+                                                   :regions       => regions,
+                                                   :config        => config
+        if available
+          true
+        else
+          logger.error "Bucket prefix #{bucket_prefix} not available across regions #{regions.join}."
+          exit 1
+        end
+      end
+
       def latest_id(args)
         archive = Archive.new :name   => args[:name],
                               :config => args[:config]

data/lib/heirloom/config.rb

@@ -3,26 +3,32 @@ module Heirloom
 
     attr_accessor :access_key, :secret_key, :metadata_region, :logger
 
-    def initialize(args = {})
-      @config = args.fetch :config, load_config_file
+    def initialize(args={})
+      @opts       = args[:opts] ||= Hash.new
+      @config     = load_config_file
       self.logger = args[:logger] ||= HeirloomLogger.new
       load_config
     end
 
     def load_config
-      aws = @config['aws']
-      self.access_key = aws['access_key']
-      self.secret_key = aws['secret_key']
-      self.metadata_region = aws['metadata_region']
+      self.access_key      = @opts.fetch :aws_access_key, 
+                                         @config['access_key']
+      self.secret_key      = @opts.fetch :aws_secret_key, 
+                                         @config['secret_key']
+      self.metadata_region = @opts.fetch :metadata_region, 
+                                         @config['metadata_region']
     end
 
+    private
+
     def load_config_file
       config_file = "#{ENV['HOME']}/.heirloom.yml"
 
       if File.exists? config_file
-        YAML::load File.open(config_file)
+        data = YAML::load File.open(config_file)
+        data['aws']
       else
-        { 'aws' => Hash.new }
+        { }
       end
     end
 

data/lib/heirloom/version.rb

@@ -1,3 +1,3 @@
 module Heirloom
-  VERSION = "0.8.1"
+  VERSION = "0.8.2"
 end

data/spec/archive/checker_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe Heirloom do
+
+  before do
+    @config_mock = double 'config'
+    @logger_stub = stub 'logger', :debug => true, 
+                                  :info  => true,
+                                  :warn  => true
+    @config_mock.stub :logger => @logger_stub
+    @checker = Heirloom::Checker.new :config => @config_mock
+    @regions = ['us-west-1', 'us-west-2']
+  end
+
+  it "should return true if all bucket names are available" do
+    s3_mock = mock 's3'
+    Heirloom::AWS::S3.should_receive(:new).
+                      with(:config => @config_mock,
+                           :region => 'us-west-1').
+                      and_return s3_mock
+    Heirloom::AWS::S3.should_receive(:new).
+                      with(:config => @config_mock,
+                           :region => 'us-west-2').
+                      and_return s3_mock
+    s3_mock.should_receive(:bucket_name_available?).
+            with('bp-us-west-1').
+            and_return true
+    s3_mock.should_receive(:bucket_name_available?).
+            with('bp-us-west-2').
+            and_return true
+    @checker.bucket_name_available?(:bucket_prefix => 'bp',
+                                    :regions       => @regions).
+                                   should be_true
+  end
+
+  it "should return false if any buckets are unavailable" do
+    s3_mock = mock 's3'
+    Heirloom::AWS::S3.should_receive(:new).
+                      with(:config => @config_mock,
+                           :region => 'us-west-1').
+                      and_return s3_mock
+    Heirloom::AWS::S3.should_receive(:new).
+                      with(:config => @config_mock,
+                           :region => 'us-west-2').
+                      and_return s3_mock
+    s3_mock.should_receive(:bucket_name_available?).
+            with('bp-us-west-1').
+            and_return false
+    s3_mock.should_receive(:bucket_name_available?).
+            with('bp-us-west-2').
+            and_return true
+    @checker.bucket_name_available?(:bucket_prefix => 'bp',
+                                    :regions       => @regions).
+                                   should be_false
+  end
+
+end

data/spec/archive/verifier_spec.rb

@@ -22,6 +22,7 @@ describe Heirloom do
                              :region => 'us-east-1').
                         and_return @s3_mock
     end
+
     it "should return false if a bucket does not exist in a region" do
       @s3_mock.should_receive(:get_bucket).with('bucket123-us-west-1').
                and_return nil

data/spec/aws/s3_spec.rb

@@ -2,15 +2,89 @@ require 'spec_helper'
 
 describe Heirloom do
   before do
+    @directories_mock = mock 'directories'
+    @bucket_mock = mock 'bucket'
+    @logger_stub = stub 'logger', :debug => true, 
+                                  :info  => true,
+                                  :warn  => true
     @config_mock = mock 'config'
-    @config_mock.should_receive(:access_key).and_return 'the-key'
-    @config_mock.should_receive(:secret_key).and_return 'the-secret'
+    @config_mock.stub :access_key => 'the-key',
+                      :secret_key => 'the-secret',
+                      :logger     => @logger_stub
     @fog_mock = mock 'fog'
+    @fog_mock.stub :directories => @directories_mock
     Fog::Storage.should_receive(:new).and_return @fog_mock
     @s3 = Heirloom::AWS::S3.new :config => @config_mock,
                                 :region => 'us-west-1'
+  end
+
+  context "bucket_exists?" do
+    it "should return true if the bucket exists" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').and_return @bucket_mock
+      @s3.bucket_exists?('bucket').should be_true
+    end
+
+    it "should return false if the bucket does not exist" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').and_return nil
+      @s3.bucket_exists?('bucket').should be_false
+    end
+
+    it "should return false if bucket owned by another account" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').
+                        and_raise Excon::Errors::Forbidden.new('msg')
+      @s3.bucket_exists?('bucket').should be_false
+    end
+  end
+
+  context "bucket_exists_in_another_region?" do
+    it "should return true if the bucket exists in another region" do
+      @bucket_mock.stub :location => 'us-east-1'
+      @directories_mock.should_receive(:get).
+                        with('bucket').at_least(:once).
+                        and_return @bucket_mock
+      @s3.bucket_exists_in_another_region?('bucket').should be_true
+    end
+
+    it "should return false if the bucket exists in the curren region" do
+      @bucket_mock.stub :location => 'us-west-1'
+      @directories_mock.should_receive(:get).
+                        with('bucket').at_least(:once).
+                        and_return @bucket_mock
+      @s3.bucket_exists_in_another_region?('bucket').should be_false
+    end
+
+    it "should return false if bucket owned by another account" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').
+                        and_raise Excon::Errors::Forbidden.new('msg')
+      @s3.bucket_exists_in_another_region?('bucket').should be_false
+    end
+  end
+
+  context "bucket_owned_by_another_account?" do
+    it "should return false if bucket owned by this account" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').
+                        and_return @bucket_mock
+      @s3.bucket_owned_by_another_account?('bucket').should be_false
+    end
 
+    it "should return false if bucket does not exist" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').
+                        and_return nil
+      @s3.bucket_owned_by_another_account?('bucket').should be_false
+    end
 
+    it "should return true if bucket is not owned by another account" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').
+                        and_raise Excon::Errors::Forbidden.new('msg')
+      @s3.bucket_owned_by_another_account?('bucket').should be_true
+    end
   end
 
   it "should delete an object from s3" do
@@ -20,18 +94,56 @@ describe Heirloom do
   end
 
   it "should get a bucket from s3" do
-    directories_mock = mock 'directories'
-    @fog_mock.should_receive(:directories).
-              and_return directories_mock
-    directories_mock.should_receive(:get).with 'bucket'
+    @directories_mock.should_receive(:get).with 'bucket'
     @s3.get_bucket 'bucket'
   end
 
+  context "testing bucket availability" do
+
+    it "should return false if the bucket is forbidden" do
+      @directories_mock.should_receive(:get).
+                  with('bucket').
+                  and_raise Excon::Errors::Forbidden.new('msg')
+      @s3.bucket_name_available?('bucket').should be_false
+    end
+
+    it "should return false if bucket in different region" do
+      @directories_mock.should_receive(:get).
+                  with('bucket').at_least(:once).
+                  and_return @bucket_mock
+      @bucket_mock.stub :location => 'us-east-1'
+      @s3.bucket_name_available?('bucket').should be_false
+    end
+
+    it "should return true if the bucket is in this account / region" do
+      @directories_mock.should_receive(:get).
+                with('bucket').at_least(:once).
+                and_return @bucket_mock
+      @bucket_mock.stub :location => 'us-west-1'
+      @s3.bucket_name_available?('bucket').should be_true
+    end
+
+    it "should return true if the bucket is not found" do
+      @directories_mock.should_receive(:get).
+                        with('bucket').at_least(:once).
+                        and_return nil
+      @s3.bucket_name_available?('bucket').should be_true
+    end
+
+  end
+
   it "should delete a bucket from s3" do
     @fog_mock.should_receive(:delete_bucket).with 'bucket'
     @s3.delete_bucket 'bucket'
   end
 
+  it "should return true if Excon::Errors::NotFound raised when deleting bucket" do
+    @fog_mock.should_receive(:delete_bucket).
+              with('bucket').
+              and_raise Excon::Errors::NotFound.new 'Bucket does not exist.'
+    @s3.delete_bucket 'bucket'
+  end
+
   it "should get an object from s3" do
     body_mock = mock 'body'
     @fog_mock.should_receive(:get_object).

data/spec/cli/setup_spec.rb

@@ -19,6 +19,7 @@ describe Heirloom do
                       :metadata_region => 'us-west-1'
     @archive_mock = mock 'archive'
     @catalog_mock = mock 'catalog'
+    @checker_mock = mock 'checker'
     Trollop.stub(:options).and_return options
     Heirloom::HeirloomLogger.should_receive(:new).with(:log_level => 'info').
                              and_return @logger_stub
@@ -34,10 +35,18 @@ describe Heirloom do
                       with(:name => 'archive_name',
                            :config => @config_mock).
                       and_return @catalog_mock
+    Heirloom::Checker.should_receive(:new).
+                      with(:config => @config_mock).
+                      and_return @checker_mock
     @setup = Heirloom::CLI::Setup.new
   end
 
   it "should setup s3 buckets, catalog and simpledb domain" do
+    @checker_mock.should_receive(:bucket_name_available?).
+                  with(:bucket_prefix => "bp", 
+                       :regions       => @regions, 
+                       :config        => @config_mock).
+                  and_return true
     @catalog_mock.should_receive(:create_catalog_domain)
     @catalog_mock.stub :entry_exists_in_catalog? => false
     @catalog_mock.should_receive(:add_to_catalog).

data/spec/cli/shared_spec.rb

@@ -318,4 +318,39 @@ describe Heirloom do
     end
 
   end
+
+  context "ensure buckets are available or owned by account" do
+    before do
+      @logger_stub  = stub 'logger', :error => true
+      @config_stub  = stub 'config', :logger => @logger_stub
+      @checker_mock = mock 'checker'
+      @args = { :config        => @config_stub,
+                :bucket_prefix => 'intu-lc',
+                :regions       => ['us-west-1', 'us-west-2'] }
+      @object = Object.new
+      @object.extend Heirloom::CLI::Shared
+      Heirloom::Checker.should_receive(:new).
+                        with(:config => @config_stub).
+                        and_return @checker_mock
+    end
+
+    it "should return true if buckets available in all regions" do
+      @checker_mock.should_receive(:bucket_name_available?).
+                    with(:bucket_prefix => 'intu-lc', 
+                         :regions       => ['us-west-1', 'us-west-2'],
+                         :config        => @config_stub).
+                    and_return true
+      @object.ensure_buckets_available(@args).should be_true
+    end
+
+    it "should return raise and error if any bucket un-available in all regions" do
+      @checker_mock.should_receive(:bucket_name_available?).
+                    with(:bucket_prefix => 'intu-lc', 
+                         :regions       => ['us-west-1', 'us-west-2'],
+                         :config        => @config_stub).
+                    and_return false
+      lambda { @object.ensure_buckets_available(@args) }.
+               should raise_error SystemExit
+    end
+  end
 end

data/spec/config_spec.rb

@@ -3,38 +3,47 @@ require 'spec_helper'
 describe Heirloom do
 
   before do
-    @config = { 'aws' => 
-                { 'access_key '     => 'key',
-                  'secret_key '     => 'secret',
-                  'metadata_region' => 'us-west-2'
-                }
-              }
+    @config_file = { 'aws' => 
+                     { 'access_key'      => 'key',
+                       'secret_key'      => 'secret',
+                       'metadata_region' => 'us-west-2'
+                     }
+                   }
+    @opts = { :aws_access_key  => 'optkey',
+              :aws_secret_key  => 'optsec',
+              :metadata_region => 'optmd' }
+                 
   end
 
   it "should create a new config object from the hash passed as config" do
-    config = Heirloom::Config.new :config => @config,
+    File.stub :exists? => false
+    File.should_receive(:open).never
+    config = Heirloom::Config.new :opts   => @opts,
                                   :logger => 'da-logger'
-    config.access_key.should == @config['aws']['access_key']
-    config.secret_key.should == @config['aws']['secret_key']
-    config.metadata_region.should == @config['aws']['metadata_region']
+    config.access_key.should == @opts[:aws_access_key]
+    config.secret_key.should == @opts[:aws_secret_key]
+    config.metadata_region.should == @opts[:metadata_region]
     config.logger.should == 'da-logger'
   end
 
   it "should create a new config object and read from ~/.heirloom.yml" do
     File.stub :exists? => true
     File.should_receive(:open).with("#{ENV['HOME']}/.heirloom.yml").
-                               and_return(@config.to_yaml)
+                               and_return(@config_file.to_yaml)
     config = Heirloom::Config.new
-    config.access_key.should == @config['aws']['access_key']
-    config.secret_key.should == @config['aws']['secret_key']
-    config.metadata_region.should == @config['aws']['metadata_region']
+    config.access_key.should == @config_file['aws']['access_key']
+    config.secret_key.should == @config_file['aws']['secret_key']
+    config.metadata_region.should == @config_file['aws']['metadata_region']
   end
-
-  it "should return nil if metadata_region not present in config" do
-    @config['aws'] = {}
-    config = Heirloom::Config.new :config => @config,
-                                  :logger => 'da-logger'
-    config.metadata_region.should == nil
+  
+  it "should override config settings in file from opts" do
+    File.stub :exists? => true
+    File.should_receive(:open).with("#{ENV['HOME']}/.heirloom.yml").
+                               and_return(@config_file.to_yaml)
+    config = Heirloom::Config.new :opts => @opts
+    config.access_key.should == @opts[:aws_access_key]
+    config.secret_key.should == @opts[:aws_secret_key]
+    config.metadata_region.should == @opts[:metadata_region]
   end
 
   it "should load a blank config if the file does not exist and no config passed" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: heirloom
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-09 00:00:00.000000000 Z
+date: 2012-11-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70142193190000 !ruby/object:Gem::Requirement
+  requirement: &70116641456840 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -21,10 +21,10 @@ dependencies:
         version: 2.11.0
   type: :development
   prerelease: false
-  version_requirements: *70142193190000
+  version_requirements: *70116641456840
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70142193189180 !ruby/object:Gem::Requirement
+  requirement: &70116641456000 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70142193189180
+  version_requirements: *70116641456000
 - !ruby/object:Gem::Dependency
   name: fog
-  requirement: &70142193188060 !ruby/object:Gem::Requirement
+  requirement: &70116641455120 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: 1.5.0
   type: :runtime
   prerelease: false
-  version_requirements: *70142193188060
+  version_requirements: *70116641455120
 - !ruby/object:Gem::Dependency
   name: grit
-  requirement: &70142193187120 !ruby/object:Gem::Requirement
+  requirement: &70116641469900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: 2.5.0
   type: :runtime
   prerelease: false
-  version_requirements: *70142193187120
+  version_requirements: *70116641469900
 - !ruby/object:Gem::Dependency
   name: trollop
-  requirement: &70142193185780 !ruby/object:Gem::Requirement
+  requirement: &70116641467720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - =
@@ -65,7 +65,7 @@ dependencies:
         version: '2.0'
   type: :runtime
   prerelease: false
-  version_requirements: *70142193185780
+  version_requirements: *70116641467720
 description: I help build and manage building tar.gz files and deploying them into
   the cloud
 email:
@@ -91,6 +91,7 @@ files:
 - lib/heirloom/archive.rb
 - lib/heirloom/archive/authorizer.rb
 - lib/heirloom/archive/builder.rb
+- lib/heirloom/archive/checker.rb
 - lib/heirloom/archive/destroyer.rb
 - lib/heirloom/archive/downloader.rb
 - lib/heirloom/archive/lister.rb
@@ -144,6 +145,7 @@ files:
 - spec/acl/s3_spec.rb
 - spec/archive/authorizer_spec.rb
 - spec/archive/builder_spec.rb
+- spec/archive/checker_spec.rb
 - spec/archive/destroyer_spec.rb
 - spec/archive/downloader_spec.rb
 - spec/archive/lister_spec.rb
@@ -200,7 +202,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -107270664148118049
+      hash: 3388616083800809289
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -209,7 +211,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -107270664148118049
+      hash: 3388616083800809289
 requirements: []
 rubyforge_project: heirloom
 rubygems_version: 1.8.16
@@ -220,6 +222,7 @@ test_files:
 - spec/acl/s3_spec.rb
 - spec/archive/authorizer_spec.rb
 - spec/archive/builder_spec.rb
+- spec/archive/checker_spec.rb
 - spec/archive/destroyer_spec.rb
 - spec/archive/downloader_spec.rb
 - spec/archive/lister_spec.rb