metasploit-model 0.28.0 → 0.29.0

data/spec/support/shared/examples/metasploit/model/authority.rb

@@ -1,124 +0,0 @@
-Metasploit::Model::Spec.shared_examples_for 'Authority' do
-  full_authority_factory = "full_#{authority_factory}"
-  obsolete_authority_factory = "obsolete_#{authority_factory}"
-
-  context 'factories' do
-    context authority_factory do
-      subject(authority_factory) do
-        FactoryGirl.build(authority_factory)
-      end
-
-      it { should be_valid }
-    end
-
-    context full_authority_factory do
-      subject(full_authority_factory) do
-        FactoryGirl.build(full_authority_factory)
-      end
-
-      it { should be_valid }
-
-      its(:summary) { should_not be_nil }
-      its(:url) { should_not be_nil }
-    end
-
-    context obsolete_authority_factory do
-      subject(obsolete_authority_factory) do
-        FactoryGirl.build(obsolete_authority_factory)
-      end
-
-      it { should be_valid }
-
-      its(:obsolete) { should be_true }
-    end
-  end
-
-  context 'mass assignment security' do
-    it { should allow_mass_assignment_of(:abbreviation) }
-    it { should allow_mass_assignment_of(:obsolete) }
-    it { should allow_mass_assignment_of(:summary) }
-    it { should allow_mass_assignment_of(:url) }
-  end
-
-  context 'search' do
-    context 'attributes' do
-      it_should_behave_like 'search_attribute', :abbreviation, :type => :string
-    end
-  end
-
-  context 'seeds' do
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'BID',
-                          :extension_name => 'Metasploit::Model::Authority::Bid',
-                          :obsolete => false,
-                          :summary => 'BuqTraq ID',
-                          :url => 'http://www.securityfocus.com/bid'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'CVE',
-                          :extension_name => 'Metasploit::Model::Authority::Cve',
-                          :obsolete => false,
-                          :summary => 'Common Vulnerabilities and Exposures',
-                          :url => 'http://cvedetails.com'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'MIL',
-                          :extension_name => nil,
-                          :obsolete => true,
-                          :summary => 'milw0rm',
-                          :url => 'https://en.wikipedia.org/wiki/Milw0rm'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'MSB',
-                          :extension_name => 'Metasploit::Model::Authority::Msb',
-                          :obsolete => false,
-                          :summary => 'Microsoft Security Bulletin',
-                          :url => 'http://www.microsoft.com/technet/security/bulletin'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'OSVDB',
-                          :extension_name => 'Metasploit::Model::Authority::Osvdb',
-                          :obsolete => false,
-                          :summary => 'Open Sourced Vulnerability Database',
-                          :url => 'http://osvdb.org'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'PMASA',
-                          :extension_name => 'Metasploit::Model::Authority::Pmasa',
-                          :obsolete => false,
-                          :summary => 'phpMyAdmin Security Announcement',
-                          :url => 'http://www.phpmyadmin.net/home_page/security/'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'SECUNIA',
-                          :extension_name => 'Metasploit::Model::Authority::Secunia',
-                          :obsolete => false,
-                          :summary => 'Secunia',
-                          :url => 'https://secunia.com/advisories'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'US-CERT-VU',
-                          :extension_name => 'Metasploit::Model::Authority::UsCertVu',
-                          :obsolete => false,
-                          :summary => 'United States Computer Emergency Readiness Team Vulnerability Notes Database',
-                          :url => 'http://www.kb.cert.org/vuls'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          :abbreviation => 'waraxe',
-                          :extension_name => 'Metasploit::Model::Authority::Waraxe',
-                          :obsolete => false,
-                          :summary => 'Waraxe Advisories',
-                          :url => 'http://www.waraxe.us/content-cat-1.html'
-
-    it_should_behave_like 'Metasploit::Model::Authority seed',
-                          abbreviation: 'ZDI',
-                          extension_name: 'Metasploit::Model::Authority::Zdi',
-                          obsolete: false,
-                          summary: 'Zero Day Initiative',
-                          url: 'http://www.zerodayinitiative.com/advisories'
-  end
-
-  context 'validations' do
-    it { should validate_presence_of(:abbreviation) }
-  end
-end

data/spec/support/shared/examples/metasploit/model/authority/seed.rb

@@ -1,49 +0,0 @@
-shared_examples_for 'Metasploit::Model::Authority seed' do |attributes={}|
-  attributes.assert_valid_keys(:abbreviation, :extension_name, :obsolete, :summary, :url)
-
-  abbreviation = attributes.fetch(:abbreviation)
-
-  context "with #{abbreviation}" do
-    subject(:seed) do
-      seed_with_abbreviation(abbreviation)
-    end
-
-    it 'should exist' do
-      seed.should_not be_nil
-    end
-
-    its(:obsolete) { should == attributes.fetch(:obsolete) }
-    its(:summary) { should == attributes.fetch(:summary) }
-    its(:url) { should == attributes.fetch(:url) }
-
-    extension_name = attributes.fetch(:extension_name)
-
-    if extension_name
-      context 'with extension' do
-        let(:designation) do
-          double('Designation')
-        end
-
-        let(:extension) do
-          extension_name.constantize
-        end
-
-        its(:extension) { should == extension }
-
-        it 'should have extension be a defined class' do
-          expect {
-            extension
-          }.to_not raise_error
-        end
-
-        it 'should delegate #designation_url to extension' do
-          extension.should_receive(:designation_url).with(designation)
-
-          seed.designation_url(designation)
-        end
-      end
-    else
-      its(:extension) { should be_nil }
-    end
-  end
-end

data/spec/support/shared/examples/metasploit/model/email_address.rb

@@ -1,220 +0,0 @@
-Metasploit::Model::Spec.shared_examples_for 'EmailAddress' do
-  context 'derivations' do
-    context 'with #full derived' do
-      before(:each) do
-        email_address.full = email_address.derived_full
-      end
-
-      it_should_behave_like 'derives', :domain, :validates => true
-      it_should_behave_like 'derives', :local, :validates => true
-    end
-
-    it_should_behave_like 'derives', :full, :validates => true
-  end
-
-  context 'factories' do
-    context email_address_factory do
-      subject(email_address_factory) do
-        FactoryGirl.build(email_address_factory)
-      end
-
-      it { should be_valid }
-    end
-  end
-
-  context 'mass assignment security' do
-    it { should allow_mass_assignment_of(:domain) }
-    it { should allow_mass_assignment_of(:full) }
-    it { should allow_mass_assignment_of(:local) }
-  end
-
-  context 'search' do
-    context 'attributes' do
-      it_should_behave_like 'search_attribute', :domain, :type => :string
-      it_should_behave_like 'search_attribute', :full, :type => :string
-      it_should_behave_like 'search_attribute', :local, :type => :string
-    end
-  end
-
-  context 'validations' do
-    it { should validate_presence_of :domain }
-    it { should validate_presence_of :local }
-  end
-
-  context '#derived_domain' do
-    subject(:derived_domain) do
-      email_address.derived_domain
-    end
-
-    before(:each) do
-      email_address.full = full
-    end
-
-    context 'with #full' do
-      let(:domain) do
-        FactoryGirl.generate :metasploit_model_email_address_domain
-      end
-
-      let(:local) do
-        FactoryGirl.generate :metasploit_model_email_address_local
-      end
-
-      context "with '@'" do
-        let(:full) do
-          "#{local}@#{domain}"
-        end
-
-
-        context 'with local before @' do
-          it "should be portion after '@'" do
-            derived_domain.should == domain
-          end
-        end
-
-        context 'without local before @' do
-          let(:local) do
-            ''
-          end
-
-          it "should be portion after '@'" do
-            derived_domain.should == domain
-          end
-        end
-      end
-
-      context "without '@'" do
-        let(:full) do
-          local
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without #full' do
-      let(:full) do
-        ''
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_full' do
-    subject(:derived_full) do
-      email_address.derived_full
-    end
-
-    before(:each) do
-      email_address.domain = domain
-      email_address.local = local
-    end
-
-    context 'with domain' do
-      let(:domain) do
-        FactoryGirl.generate :metasploit_model_email_address_domain
-      end
-
-      context 'with #local' do
-        let(:local) do
-          FactoryGirl.generate :metasploit_model_email_address_local
-        end
-
-        it 'should <local>@<domain>' do
-          derived_full.should == "#{local}@#{domain}"
-        end
-      end
-
-      context 'without #local' do
-        let(:local) do
-          ''
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without #domain' do
-      let(:domain) do
-        ''
-      end
-
-      context 'with #local' do
-        let(:local) do
-          FactoryGirl.generate :metasploit_model_email_address_local
-        end
-
-        it { should be_nil }
-      end
-
-      context 'without #local' do
-        let(:local) do
-          ''
-        end
-
-        it { should be_nil }
-      end
-    end
-  end
-
-  context '#derived_local' do
-    subject(:derived_local) do
-      email_address.derived_local
-    end
-
-    before(:each) do
-      email_address.full = full
-    end
-
-    context 'with #full' do
-      let(:domain) do
-        FactoryGirl.generate :metasploit_model_email_address_domain
-      end
-
-      let(:local) do
-        FactoryGirl.generate :metasploit_model_email_address_local
-      end
-
-      context "with '@'" do
-        let(:full) do
-          "#{local}@#{domain}"
-        end
-
-
-        context "with domain after '@'" do
-          it "should be portion before '@'" do
-            derived_local.should == local
-          end
-        end
-
-        context "without domain after '@'" do
-          let(:local) do
-            ''
-          end
-
-          it "should be portion before '@'" do
-            derived_local.should == local
-          end
-        end
-      end
-
-      context "without '@'" do
-        let(:full) do
-          local
-        end
-
-        it 'should be entirety of #full' do
-          derived_local.should == full
-        end
-      end
-    end
-
-    context 'without #full' do
-      let(:full) do
-        ''
-      end
-
-      it { should be_nil }
-    end
-  end
-end

data/spec/support/shared/examples/metasploit/model/module/action.rb

@@ -1,26 +0,0 @@
-Metasploit::Model::Spec.shared_examples_for 'Module::Action' do
-  context 'factories' do
-    context module_action_factory do
-      let(module_action_factory) do
-        FactoryGirl.build(module_action_factory)
-      end
-
-      it { should be_valid }
-    end
-  end
-
-  context 'mass assignment security' do
-    it { should allow_mass_assignment_of(:name) }
-  end
-
-  context 'search' do
-    context 'attributes' do
-      it_should_behave_like 'search_attribute', :name, :type => :string
-    end
-  end
-
-  context 'validations' do
-    it { should validate_presence_of(:module_instance) }
-    it { should validate_presence_of(:name) }
-  end
-end

data/spec/support/shared/examples/metasploit/model/module/ancestor.rb

@@ -1,2004 +0,0 @@
-Metasploit::Model::Spec.shared_examples_for 'Module::Ancestor' do
-  #
-  # Module::Ancestor factories
-  #
-
-  payload_module_ancestor_factory = "payload_#{module_ancestor_factory}".to_sym
-  single_payload_module_ancestor_factory = "single_#{payload_module_ancestor_factory}".to_sym
-  stage_payload_module_ancestor_factory = "stage_#{payload_module_ancestor_factory}".to_sym
-  stager_payload_module_ancestor_factory = "stager_#{payload_module_ancestor_factory}".to_sym
-
-  #
-  # Module::Path factories
-  #
-
-  module_path_factory = "#{factory_namespace}_module_path".to_sym
-
-  it_should_behave_like 'Metasploit::Model::RealPathname' do
-    let(:base_instance) do
-      FactoryGirl.build(module_ancestor_factory)
-    end
-  end
-
-  context 'CONSTANTS' do
-    context 'DIRECTORY_BY_MODULE_TYPE' do
-      subject(:directory_by_module_type) do
-        described_class::DIRECTORY_BY_MODULE_TYPE
-      end
-
-      its(['auxiliary']) { should == 'auxiliary' }
-      its(['encoder']) { should == 'encoders' }
-      its(['exploit']) { should == 'exploits' }
-      its(['nop']) { should == 'nops' }
-      its(['payload']) { should == 'payloads' }
-      its(['post']) { should == 'post' }
-
-      it 'should have same module types as Metasploit::Model::Module::Type::ALL' do
-        directory_by_module_type.keys.should =~ Metasploit::Model::Module::Type::ALL
-      end
-    end
-
-    context 'EXTENSION' do
-      subject(:extension) do
-        described_class::EXTENSION
-      end
-
-      it 'should be ruby source extension' do
-        extension.should == '.rb'
-      end
-
-      it "should start with '.'" do
-        extension.should start_with('.')
-      end
-    end
-
-    context 'HANDLED_TYPES' do
-      subject(:handled_types) do
-        described_class::HANDLED_TYPES
-      end
-
-      it { should include('single') }
-      it { should_not include('stage') }
-      it { should include('stager') }
-
-      it 'should be a subset of PAYLOAD_TYPES' do
-        handled_type_set = Set.new(handled_types)
-        payload_type_set = Set.new(described_class::PAYLOAD_TYPES)
-
-        handled_type_set.should be_a_subset(payload_type_set)
-      end
-    end
-
-    context 'MODULE_TYPE_BY_DIRECTORY' do
-      subject(:module_type_by_directory) do
-        described_class::MODULE_TYPE_BY_DIRECTORY
-      end
-
-      its(['auxiliary']) { should == 'auxiliary' }
-      its(['encoders']) { should == 'encoder' }
-      its(['exploits']) { should == 'exploit' }
-      its(['nops']) { should == 'nop' }
-      its(['payloads']) { should == 'payload' }
-      its(['post']) { should == 'post' }
-
-      it 'should have same module types as Metasploit::Model::Module::Type::ALL' do
-        module_type_by_directory.values.should =~ Metasploit::Model::Module::Type::ALL
-      end
-    end
-
-    context 'PAYLOAD_TYPES' do
-      subject(:payload_types) do
-        described_class::PAYLOAD_TYPES
-      end
-
-      it { should include('single') }
-      it { should include('stage') }
-      it { should include('stager') }
-    end
-
-    # pattern is tested in validation tests below
-    it 'should define REFERENCE_NAME_REGEXP' do
-      described_class::REFERENCE_NAME_REGEXP.should be_a Regexp
-    end
-
-    context 'REFERENCE_NAME_SEPARATOR' do
-      subject(:reference_name_separator) do
-        described_class::REFERENCE_NAME_SEPARATOR
-      end
-
-      it { should == '/' }
-    end
-
-    # pattern is tested in validation tests below
-    it 'should define SHA_HEX_DIGEST_REGEXP' do
-      described_class::SHA1_HEX_DIGEST_REGEXP.should be_a Regexp
-    end
-  end
-
-  context 'derivation' do
-    def attribute_type(attribute)
-      type_by_attribute = {
-          :full_name => :text,
-          :module_type => :string,
-          :payload_type => :string,
-          :real_path => :text,
-          :real_path_modified_at => :datetime,
-          :real_path_sha1_hex_digest => :string,
-          :reference_name => :text
-      }
-
-      type_by_attribute.fetch(attribute)
-    end
-
-    it_should_behave_like 'derives', :full_name, :validates => true
-    it_should_behave_like 'derives', :real_path, :validates => true
-
-    context 'with only module_path and real_path' do
-      subject(:module_ancestor) do
-        # make sure real_path is derived
-        real_path_creator.should be_valid
-
-        module_ancestor = module_ancestor_class.new
-
-        # work-around mass-assignment security
-        module_ancestor.parent_path = real_path_creator.parent_path
-        module_ancestor.real_path = real_path_creator.real_path
-
-        module_ancestor
-      end
-
-      before(:each) do
-        # run before validation callbacks to trigger derivations
-        module_ancestor.valid?
-      end
-
-      context 'with payload' do
-        let(:real_path_creator) do
-          FactoryGirl.build(
-              module_ancestor_factory,
-              module_type: 'payload',
-              payload_type: payload_type
-          )
-        end
-
-        context 'with single' do
-          let(:payload_type) do
-            'single'
-          end
-
-          it 'should be handled' do
-            module_ancestor.should be_handled
-          end
-
-          it { should_not be_valid }
-
-          it 'should be valid for loading' do
-            module_ancestor.valid?(:loading)
-          end
-        end
-
-        context 'with stage' do
-          let(:payload_type) do
-            'stage'
-          end
-
-          it 'should not be handled' do
-            module_ancestor.should_not be_handled
-          end
-
-          it { should be_valid }
-
-          it 'should be valid for loading' do
-            module_ancestor.valid?(:loading)
-          end
-        end
-
-        context 'with stager' do
-          let(:payload_type) do
-            'stager'
-          end
-
-          it 'should be handled' do
-            module_ancestor.should be_handled
-          end
-
-          it { should_not be_valid }
-
-          it 'should be valid for loading' do
-            module_ancestor.valid?(:loading)
-          end
-        end
-      end
-
-      context 'without payload' do
-        let(:real_path_creator) do
-          FactoryGirl.build(
-              module_ancestor_factory,
-              module_type: module_type
-          )
-        end
-
-        let(:module_type) do
-          FactoryGirl.generate :metasploit_model_non_payload_module_type
-        end
-
-        it 'should not be handled' do
-          module_ancestor.should_not be_handled
-        end
-
-        it { should be_valid }
-
-        it 'should be valid for loading' do
-          module_ancestor.valid?(:loading)
-        end
-      end
-    end
-
-    context 'with payload' do
-      subject(:module_ancestor) do
-        FactoryGirl.build(
-            module_ancestor_factory,
-            # {Mdm::Module::Ancestor#derived_payload_type} will be `nil` unless {Mdm::Module::Ancestor#module_type} is
-            # `'payload'`
-            :module_type => 'payload',
-            # Ensure {Mdm::Module::Ancestor#derived_payload} will be a valid {Mdm::Module::Ancestor#payload_type}.
-            :reference_name => reference_name
-        )
-      end
-
-      let(:reference_name) do
-        FactoryGirl.generate :metasploit_model_module_ancestor_payload_reference_name
-      end
-
-      it_should_behave_like 'derives', :payload_type, :validates => true
-    end
-
-    context 'with real_path' do
-      before(:each) do
-        # {Metasploit::Model::Module::Ancestor#derived_real_path_modified_at} and
-        # {Metasploit::Model::Module::Ancestor#derived_real_path_sha1_hex_digest} both depend on real_path being
-        # populated or they will return nil, so need set real_path = derived_real_path before testing as would happen
-        # with the normal order of before validation callbacks.
-        module_ancestor.real_path = module_ancestor.derived_real_path
-
-        # blank out {Metasploit::Model::Module::Ancestor#module_type} and
-        # {Metasploit::Model::Module::Ancestor#reference_name} so they will be rederived from
-        # {Metasploit::Model::Module::Ancestor#real_path} to simulate module cache construction usage.
-        module_ancestor.module_type = nil
-        module_ancestor.reference_name = nil
-      end
-
-      it_should_behave_like 'derives', :module_type, :validates => false
-      it_should_behave_like 'derives', :real_path_modified_at, :validates => false
-      it_should_behave_like 'derives', :real_path_sha1_hex_digest, :validates => false
-      it_should_behave_like 'derives', :reference_name, :validates => false
-    end
-  end
-
-  context 'factories' do
-    context module_ancestor_factory.to_s do
-      subject(module_ancestor_factory) do
-        FactoryGirl.build(module_ancestor_factory)
-      end
-
-      it { should be_valid }
-
-      context 'contents' do
-        include_context 'Metasploit::Model::Module::Ancestor factory contents'
-
-        let(:module_ancestor) do
-          send(module_ancestor_factory)
-        end
-
-        context 'metasploit_module' do
-          include_context 'Metasploit::Model::Module::Ancestor factory contents metasploit_module'
-
-          # Classes are Modules, so this checks that it is either a Class or a Module.
-          it { should be_a Module }
-
-          context '#module_type' do
-            let(:module_ancestor) do
-              FactoryGirl.build(
-                  module_ancestor_factory,
-                  module_type: module_type
-              )
-            end
-
-            context 'with payload' do
-              let(:module_type) do
-                Metasploit::Model::Module::Type::PAYLOAD
-              end
-
-              it { should_not be_a Class }
-
-              it 'should define #initalize that takes an option hash' do
-                begin
-                  unbound_method = metasploit_module.instance_method(:initialize)
-                rescue NameError
-                  unbound_method = nil
-                end
-
-                unbound_method.should_not be_nil
-                unbound_method.should have(1).parameters
-                unbound_method.parameters[0][0].should == :opt
-              end
-            end
-
-            context 'without payload' do
-              let(:module_type) do
-                FactoryGirl.generate :metasploit_model_non_payload_module_type
-              end
-
-              it { should be_a Class }
-
-              context '#initialize' do
-                subject(:instance) do
-                  metasploit_module.new(attributes)
-                end
-
-                context 'with :framework' do
-                  let(:attributes) do
-                    {
-                        framework: framework
-                    }
-                  end
-
-                  let(:framework) do
-                    double('Msf::Framework')
-                  end
-
-                  it 'should set #framework' do
-                    instance.framework.should == framework
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-
-    context payload_module_ancestor_factory.to_s do
-      subject(payload_module_ancestor_factory) do
-        FactoryGirl.build(payload_module_ancestor_factory)
-      end
-
-      it { should be_valid }
-
-      its(:derived_payload_type) { should_not be_nil }
-
-      it_should_behave_like 'Metasploit::Model::Module::Ancestor payload factory' do
-        let(:module_ancestor) do
-          send(payload_module_ancestor_factory)
-        end
-      end
-    end
-
-    context single_payload_module_ancestor_factory.to_s do
-      subject(single_payload_module_ancestor_factory) do
-        FactoryGirl.build(single_payload_module_ancestor_factory)
-      end
-
-      it { should be_valid }
-
-      its(:derived_payload_type) { should == 'single' }
-
-      it_should_behave_like 'Metasploit::Model::Module::Ancestor payload factory', handler_type: true do
-        let(:module_ancestor) do
-          send(single_payload_module_ancestor_factory)
-        end
-      end
-    end
-
-    context stage_payload_module_ancestor_factory.to_s do
-      subject(stage_payload_module_ancestor_factory) do
-        FactoryGirl.build(stage_payload_module_ancestor_factory)
-      end
-
-      it { should be_valid }
-
-      its(:derived_payload_type) { should == 'stage' }
-
-      it_should_behave_like 'Metasploit::Model::Module::Ancestor payload factory', handler_type: false do
-        let(:module_ancestor) do
-          send(stage_payload_module_ancestor_factory)
-        end
-      end
-    end
-
-    context 'stager_payload_module_ancestor_factory' do
-      subject(stager_payload_module_ancestor_factory) do
-        FactoryGirl.build(stager_payload_module_ancestor_factory)
-      end
-
-      it { should be_valid }
-
-      its(:derived_payload_type) { should == 'stager' }
-
-      it_should_behave_like 'Metasploit::Model::Module::Ancestor payload factory', handler_type: true do
-        let(:module_ancestor) do
-          send(stager_payload_module_ancestor_factory)
-        end
-      end
-    end
-  end
-
-  context 'mass assignment security' do
-    it 'should not allow mass assignment of full_name since it must match derived_full_name' do
-      module_ancestor.should_not allow_mass_assignment_of(:full_name)
-    end
-
-    it { should allow_mass_assignment_of(:handler_type) }
-    it { should allow_mass_assignment_of(:module_type) }
-
-    it 'should not allow mass assignment of payload_type since it must match derived_payload_type' do
-      module_ancestor.should_not allow_mass_assignment_of(:payload_type)
-    end
-
-    it 'should allow mass assignment of real_path to allow derivation of module_type and reference_name' do
-      module_ancestor.should allow_mass_assignment_of(:real_path)
-    end
-
-    it 'should not allow mass assignment of real_path_modified_at since it is derived' do
-      module_ancestor.should_not allow_mass_assignment_of(:real_path_modified_at)
-    end
-
-    it 'should not allow mass assignment of real_path_sha1_hex_digest since it is derived' do
-      module_ancestor.should_not allow_mass_assignment_of(:real_path_sha1_hex_digest)
-    end
-
-    it { should_not allow_mass_assignment_of(:parent_path_id) }
-  end
-
-  context 'validations' do
-    subject(:module_ancestor) do
-      # Don't use factory so that nil values can be tested without the nil being replaced with derived value
-      module_ancestor_class.new
-    end
-
-    context 'handler_type' do
-      subject(:module_ancestor) do
-        FactoryGirl.build(
-            module_ancestor_factory,
-            :handler_type => handler_type,
-            :module_type => module_type,
-            :payload_type => payload_type
-        )
-      end
-
-      context 'with payload' do
-        let(:module_type) do
-          'payload'
-        end
-
-        context 'with payload_type' do
-          context 'single' do
-            let(:payload_type) do
-              'single'
-            end
-
-            context 'with handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it { should be_valid }
-            end
-
-            context 'without handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              context 'with :loading validation_context' do
-                let(:validation_context) do
-                  :loading
-                end
-
-                it 'should be valid' do
-                  module_ancestor.valid?(validation_context).should be_true
-                end
-              end
-
-              context 'without validation_context' do
-                it { should_not be_valid }
-
-                it 'should record error on handler_type' do
-                  module_ancestor.valid?
-
-                  module_ancestor.errors[:handler_type].should include(I18n.translate!('errors.messages.blank'))
-                end
-              end
-            end
-          end
-
-          context 'stage' do
-            let(:payload_type) do
-              'stage'
-            end
-
-            context 'with handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it { should_not be_valid }
-
-              it 'should record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should include('must be nil')
-              end
-            end
-
-            context 'without handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              it { should be_valid }
-            end
-          end
-
-          context 'stager' do
-            let(:payload_type) do
-              'stager'
-            end
-
-            context 'with handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it { should be_valid }
-            end
-
-            context 'without handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              it { should_not be_valid }
-
-              it 'should record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should include(I18n.translate!('errors.messages.blank'))
-              end
-            end
-          end
-        end
-      end
-
-      context 'without payload' do
-        let(:module_type) do
-          FactoryGirl.generate :metasploit_model_non_payload_module_type
-        end
-
-        context 'with payload_type' do
-          # force payload_type to NOT be derived to check invalid setups
-          before(:each) do
-            module_ancestor.payload_type = payload_type
-          end
-
-          context 'single' do
-            let(:payload_type) do
-              'single'
-            end
-
-            context 'with handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it { should be_invalid }
-
-              it 'should record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should include('must be nil')
-              end
-            end
-
-            context 'without handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              it 'should not record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should be_empty
-              end
-            end
-          end
-
-          context 'stage' do
-            let(:payload_type) do
-              'stage'
-            end
-
-            context 'with handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it { should_not be_valid }
-
-              it 'should record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should include('must be nil')
-              end
-            end
-
-            context 'without handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              it 'should not record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should be_empty
-              end
-            end
-          end
-
-          context 'stager' do
-            let(:payload_type) do
-              'stager'
-            end
-
-            context 'with handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it { should_not be_valid }
-
-              it 'should record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should include('must be nil')
-              end
-            end
-
-            context 'without handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              it 'should not record error on handler_type' do
-                module_ancestor.valid?
-
-                module_ancestor.errors[:handler_type].should be_empty
-              end
-            end
-          end
-        end
-
-        context 'without payload_type' do
-          let(:payload_type) do
-            nil
-          end
-
-          context 'with handler_type' do
-            let(:handler_type) do
-              FactoryGirl.generate :metasploit_model_module_handler_type
-            end
-
-            it { should_not be_valid }
-
-            it 'should record error on handler_type' do
-              module_ancestor.valid?
-
-              module_ancestor.errors[:handler_type].should include('must be nil')
-            end
-          end
-
-          context 'without handler_type' do
-            let(:handler_type) do
-              nil
-            end
-
-            it { should be_valid }
-          end
-        end
-      end
-    end
-
-    it { should ensure_inclusion_of(:module_type).in_array(Metasploit::Model::Module::Type::ALL) }
-    it { should validate_presence_of(:parent_path) }
-
-    context 'payload_type' do
-      subject(:module_ancestor) do
-        FactoryGirl.build(
-            module_ancestor_factory,
-            :module_type => module_type,
-            :reference_name => reference_name
-        )
-      end
-
-      before(:each) do
-        # payload is ignored in metasploit_model_module_ancestor trait so need set it directly
-        module_ancestor.payload_type = payload_type
-      end
-
-      context 'with payload?' do
-        let(:module_type) do
-          'payload'
-        end
-
-        context 'with payload_type' do
-          Metasploit::Model::Module::Ancestor::PAYLOAD_TYPES.each do |allowed_payload_type|
-            context "with #{allowed_payload_type}" do
-              let(:payload_type) do
-                nil
-              end
-
-              let(:payload_type_directory) do
-                allowed_payload_type.pluralize
-              end
-
-              let(:reference_name) do
-                "#{payload_type_directory}/name"
-              end
-
-              it { should be_valid }
-            end
-          end
-        end
-
-        context 'without payload_type' do
-          let(:payload_type) do
-            nil
-          end
-
-          let(:reference_name) do
-            FactoryGirl.generate :metasploit_model_module_ancestor_non_payload_reference_name
-          end
-
-          it { should_not be_valid }
-
-          it 'should record error on payload_type' do
-            module_ancestor.valid?
-
-            module_ancestor.errors[:payload_type].should include('is not included in the list')
-          end
-        end
-      end
-
-      context 'without payload?' do
-        let(:module_type) do
-          FactoryGirl.generate :metasploit_model_non_payload_module_type
-        end
-
-        context 'with payload_type' do
-          # force payload to not be nil so that derive_payload_type is not called.
-          let(:payload_type) do
-            FactoryGirl.generate :metasploit_model_module_ancestor_payload_type
-          end
-
-          let(:reference_name) do
-            "#{payload_type.pluralize}/name"
-          end
-
-          it { should_not be_valid }
-
-          it 'should record error on payload_type' do
-            module_ancestor.valid?
-
-            module_ancestor.errors[:payload_type].should include('must be nil')
-          end
-        end
-
-        context 'without payload_type' do
-          let(:payload_type) do
-            nil
-          end
-
-          let(:reference_name) do
-            FactoryGirl.generate :metasploit_model_module_ancestor_non_payload_reference_name
-          end
-
-          it { should be_valid }
-        end
-      end
-    end
-
-    it { should validate_presence_of(:real_path_modified_at) }
-
-    context 'real_path_sha1_hex_digest' do
-      context 'validates format with SHA1_HEX_DIGEST_REGEXP' do
-        let(:hexdigest) do
-          Digest::SHA1.hexdigest('')
-        end
-
-        it 'should allow a Digest::SHA1.hexdigest' do
-          module_ancestor.should allow_value(hexdigest).for(:real_path_sha1_hex_digest)
-        end
-
-        it 'should not allow a truncated Digest::SHA1.hexdigest' do
-          module_ancestor.should_not allow_value(hexdigest[0, 39]).for(:real_path_sha1_hex_digest)
-        end
-
-        it 'should not allow upper case hex to maintain normalization' do
-          module_ancestor.should_not allow_value(hexdigest.upcase).for(:real_path_sha1_hex_digest)
-        end
-
-        it { should_not allow_value(nil).for(:real_path_sha1_hex_digest) }
-      end
-    end
-
-    context 'reference_name' do
-      context 'validates format with REFERENCE_NAME_REGEXP' do
-        context 'without slashes' do
-          context 'first character' do
-            it 'should not allow space' do
-              module_ancestor.should_not allow_value(' ').for(:reference_name)
-            end
-
-            it 'should allow dash' do
-              module_ancestor.should allow_value('-').for(:reference_name)
-            end
-
-            it 'should allow digit' do
-              module_ancestor.should allow_value('0').for(:reference_name)
-            end
-
-            it 'should allow uppercase letter' do
-              module_ancestor.should allow_value('A').for(:reference_name)
-            end
-
-            it 'should allow underscore' do
-              module_ancestor.should allow_value('_').for(:reference_name)
-            end
-
-            it 'should allow lowercase letter' do
-              module_ancestor.should allow_value('a').for(:reference_name)
-            end
-          end
-
-          context 'later letters' do
-            let(:lowercase_letters) do
-              ('a'..'z').to_a
-            end
-
-            let(:first_letter) do
-              lowercase_letters.sample
-            end
-
-            it 'should not allow space' do
-              module_ancestor.should_not allow_value("#{first_letter} ").for(:reference_name)
-            end
-
-            it 'should allow dash' do
-              module_ancestor.should allow_value("#{first_letter}-").for(:reference_name)
-            end
-
-            it 'should allow digit' do
-              module_ancestor.should allow_value("#{first_letter}1").for(:reference_name)
-            end
-
-            it 'should allow uppercase letter' do
-              module_ancestor.should allow_value("#{first_letter}A").for(:reference_name)
-            end
-
-            it 'should allow underscore' do
-              module_ancestor.should allow_value("#{first_letter}_").for(:reference_name)
-            end
-
-            it 'should allow lowercase letter' do
-              module_ancestor.should allow_value("#{first_letter}a").for(:reference_name)
-            end
-          end
-        end
-
-        context 'with slashes' do
-          let(:section) do
-            "-_0a"
-          end
-
-          context 'leading' do
-            it "should not allow '/'" do
-              module_ancestor.should_not allow_value("/#{section}").for(:reference_name)
-            end
-
-            it "should not allow '\\'" do
-              module_ancestor.should_not allow_value("\\#{section}").for(:reference_name)
-            end
-          end
-
-          context 'infix' do
-            it "should allow '/'" do
-              module_ancestor.should allow_value("#{section}/#{section}").for(:reference_name)
-            end
-
-            it "should not allow '\\'" do
-              module_ancestor.should_not allow_value("#{section}\\#{section}").for(:reference_name)
-            end
-          end
-
-          context 'trailing' do
-            it "should not allow '/'" do
-              module_ancestor.should_not allow_value("#{section}/").for(:reference_name)
-            end
-
-            it "should not allow '\\'" do
-              module_ancestor.should_not allow_value("#{section}\\").for(:reference_name)
-            end
-          end
-        end
-
-        context 'real-world examples' do
-          it { should allow_value('admin/2wire/xslt_password_reset').for(:reference_name) }
-          it { should allow_value('dos/http/3com_superstack_switch').for(:reference_name) }
-          it { should allow_value('windows/brightstor/tape_engine_8A').for(:reference_name) }
-          it { should allow_value('windows/fileformat/a-pdf_wav_to_mp3').for(:reference_name) }
-          it { should allow_value('windows/ftp/32bitftp_list_reply').for(:reference_name) }
-          it { should allow_value('windows/ftp/3cdaemon_ftp_user').for(:reference_name) }
-        end
-      end
-    end
-  end
-
-  context '#contents' do
-    subject(:contents) do
-      module_ancestor.contents
-    end
-
-    before(:each) do
-      module_ancestor.real_path = real_path
-    end
-
-    context 'with #real_path' do
-      let(:real_path) do
-        module_ancestor.derived_real_path
-      end
-
-      context 'with file' do
-        let(:file_contents) do
-          "# Contents"
-        end
-
-        before(:each) do
-          File.open(real_path, 'wb') do |f|
-            f.write(file_contents)
-          end
-        end
-
-        it 'should be contents of file' do
-          contents.should == file_contents
-        end
-      end
-
-      context 'without file' do
-        before(:each) do
-          File.delete(real_path)
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without #real_path' do
-      let(:real_path) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_full_name' do
-    subject(:derived_full_name) do
-      module_ancestor.derived_full_name
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(
-          module_ancestor_factory,
-          :module_type => module_type,
-          # don't create parent_path since it's unneeded for tests
-          :parent_path => nil
-      )
-    end
-
-    context 'with module_type' do
-      let(:module_type) do
-        FactoryGirl.generate :metasploit_model_module_type
-      end
-
-      it "should equal <module_type>/<reference_name>" do
-        derived_full_name.should == "#{module_ancestor.module_type}/#{module_ancestor.reference_name}"
-      end
-    end
-
-    context 'without module_type' do
-      let(:module_type) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_module_type' do
-    subject(:derived_module_type) do
-      module_ancestor.derived_module_type
-    end
-
-    before(:each) do
-      module_ancestor.real_path = real_path
-    end
-
-    context 'with #real_path' do
-      let(:real_path) do
-        module_ancestor.derived_real_path
-      end
-
-      before(:each) do
-        module_ancestor.parent_path = module_path
-      end
-
-      context 'with Metasploit::Model::Module::Path' do
-        let(:module_path) do
-          module_ancestor.parent_path
-        end
-
-        before(:each) do
-          module_path.real_path = module_path_real_path
-        end
-
-        context 'with Metasploit::Model::Module::Path#real_path' do
-          let(:module_path_real_path) do
-            module_path.real_path
-          end
-
-          it { should_not be_nil }
-        end
-
-        context 'without Metasploit::Model::Module::Path#real_path' do
-          let(:module_path_real_path) do
-            nil
-          end
-
-          it { should be_nil }
-        end
-      end
-
-      context 'without Metasploit::Model::Module::Path' do
-        let(:module_path) do
-          nil
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without #real_path' do
-      let(:real_path) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_payload_type' do
-    subject(:derived_payload_type) do
-      module_ancestor.derived_payload_type
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(
-          module_ancestor_factory,
-          :module_type => module_type
-      )
-    end
-
-    context 'with payload' do
-      let(:module_type) do
-        'payload'
-      end
-
-      it 'should singularize payload_type_directory' do
-        derived_payload_type.should == module_ancestor.payload_type_directory.singularize
-      end
-    end
-
-    context 'without payload' do
-      let(:module_type) do
-        FactoryGirl.generate :metasploit_model_non_payload_module_type
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_real_path' do
-    subject(:derived_real_path) do
-      module_ancestor.derived_real_path
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(
-          module_ancestor_factory,
-          :module_type => module_type,
-          :parent_path => parent_path,
-          :reference_name => reference_name
-      )
-    end
-
-    let(:module_type) do
-      nil
-    end
-
-    let(:parent_path) do
-      nil
-    end
-
-    let(:reference_name) do
-      nil
-    end
-
-    context 'with parent_path' do
-      let(:parent_path) do
-        FactoryGirl.build(
-            module_path_factory,
-            :real_path => parent_path_real_path
-        )
-      end
-
-      context 'with parent_path.real_path' do
-        let(:parent_path_real_path) do
-          FactoryGirl.generate :metasploit_model_module_path_real_path
-        end
-
-        context 'with module_type' do
-          let(:module_type) do
-            FactoryGirl.generate :metasploit_model_module_type
-          end
-
-          context 'with reference_name' do
-            let(:reference_name) do
-              FactoryGirl.generate :metasploit_model_module_ancestor_non_payload_reference_name
-            end
-
-            it 'should be full path including parent_path.real_path, type_directory, and reference_path' do
-              derived_real_path.should == File.join(
-                  parent_path_real_path,
-                  module_ancestor.module_type_directory,
-                  module_ancestor.reference_path
-              )
-            end
-          end
-
-          context 'without reference_name' do
-            let(:reference_name) do
-              nil
-            end
-
-            it { should be_nil }
-          end
-        end
-
-        context 'without module_type' do
-          let(:module_type) do
-            nil
-          end
-
-          it { should be_nil }
-        end
-      end
-
-      context 'without parent_path.real_path' do
-        let(:parent_path_real_path) do
-          nil
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without parent_path' do
-      let(:parent_path) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_real_path_modified_at' do
-    subject(:derived_real_path_modified_at) do
-      module_ancestor.derived_real_path_modified_at
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(module_ancestor_factory)
-    end
-
-    context 'with real_path' do
-      before(:each) do
-        module_ancestor.real_path = real_path
-      end
-
-      context 'that exists' do
-        let(:real_path) do
-          # derived real path will have been created by factory's after(:build)
-          module_ancestor.derived_real_path
-        end
-
-        it 'should be modification time of file' do
-          derived_real_path_modified_at.should == File.mtime(real_path)
-        end
-
-        it 'should be in UTC' do
-          derived_real_path_modified_at.zone.should == 'UTC'
-        end
-      end
-
-      context 'that does not exist' do
-        let(:real_path) do
-          'non/existent/path'
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without real_path' do
-      before(:each) do
-        module_ancestor.real_path = nil
-      end
-
-      it 'should have nil for real_path' do
-        module_ancestor.real_path.should be_nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_real_path_sha1_hex_digest' do
-    subject(:derived_real_path_sha1_hex_digest) do
-      module_ancestor.derived_real_path_sha1_hex_digest
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(module_ancestor_factory)
-    end
-
-    context 'with real_path' do
-      before(:each) do
-        module_ancestor.real_path = module_ancestor.derived_real_path
-      end
-
-      context 'that exists' do
-        it 'should read the using Digest::SHA1.file' do
-          Digest::SHA1.should_receive(:file).with(module_ancestor.real_path).and_call_original
-
-          derived_real_path_sha1_hex_digest
-        end
-
-        context 'with content' do
-          let(:content_sha1_hex_digest) do
-            Digest::SHA1.hexdigest(content)
-          end
-
-          before(:each) do
-            File.open(module_ancestor.real_path, 'wb') do |f|
-              f.write(content)
-            end
-          end
-
-          context 'that is empty' do
-            let(:content) do
-              ''
-            end
-
-            it 'should have empty file at real_path' do
-              File.size(module_ancestor.real_path).should be_zero
-            end
-
-            it 'should have SHA1 hex digest for empty string' do
-              derived_real_path_sha1_hex_digest.should == content_sha1_hex_digest
-            end
-          end
-
-          context 'that is not empty' do
-            let(:content) do
-              "# Non-empty content"
-            end
-
-            it 'should have SHA1 hex digest for content' do
-              derived_real_path_sha1_hex_digest.should == content_sha1_hex_digest
-            end
-          end
-        end
-      end
-
-      context 'that does not exist' do
-        before(:each) do
-          File.delete(module_ancestor.real_path)
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without real_path' do
-      before(:each) do
-        module_ancestor.real_path = nil
-      end
-
-      it 'should have nil for real_path' do
-        module_ancestor.real_path.should be_nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#derived_reference_name' do
-    subject(:derived_reference_name) do
-      module_ancestor.derived_reference_name
-    end
-
-    before(:each) do
-      module_ancestor.stub(relative_file_names: relative_file_names)
-    end
-
-    context 'with empty #relative_file_names' do
-      let(:relative_file_names) do
-        Enumerator.new { }
-      end
-
-      it { should be_nil }
-    end
-
-    context 'without empty #relative_file_names' do
-      context 'with one element' do
-        let(:relative_file_names) do
-          ['a'].each
-        end
-      end
-
-      context 'with more than one element' do
-        context 'with EXTENSION' do
-          let(:relative_file_names) do
-            ['a', 'b', "c#{described_class::EXTENSION}"].each
-          end
-
-          it 'should not include first file name' do
-            derived_reference_name.split(described_class::REFERENCE_NAME_SEPARATOR).should_not include('a')
-          end
-
-          it 'should match REFERENCE_NAME_REGEXP' do
-            derived_reference_name.should match(described_class::REFERENCE_NAME_REGEXP)
-          end
-
-          it 'should not include EXTENSION' do
-            derived_reference_name.should_not end_with(described_class::EXTENSION)
-          end
-
-          it 'should be all file names except the first joined with the REFERENCE_NAME_SEPARATOR with EXTENSION' do
-            derived_reference_name.should == "b#{described_class::REFERENCE_NAME_SEPARATOR}c"
-          end
-        end
-
-        context 'without EXTENSION' do
-          let(:relative_file_names) do
-            ['a', 'b', 'c'].each
-          end
-
-          it { should be_nil }
-        end
-      end
-    end
-  end
-
-  # class method
-  context 'handled?' do
-    subject(:handled?) do
-      module_ancestor_class.handled?(
-          :module_type => module_type,
-          :payload_type => payload_type
-      )
-    end
-
-    context 'with module_type' do
-      context 'payload' do
-        let(:module_type) do
-          'payload'
-        end
-
-        context 'with payload_type' do
-          context 'single' do
-            let(:payload_type) do
-              'single'
-            end
-
-            it { should be_true }
-          end
-
-          context 'stage' do
-            let(:payload_type) do
-              'stage'
-            end
-
-            it { should be_false }
-          end
-
-          context 'stager' do
-            let(:payload_type) do
-              'stager'
-            end
-
-            it { should be_true }
-          end
-        end
-
-        context 'without payload_type' do
-          let(:payload_type) do
-            nil
-          end
-
-          it { should be_false }
-        end
-      end
-
-      context 'non-payload' do
-        let(:module_type) do
-          FactoryGirl.generate :metasploit_model_non_payload_module_type
-        end
-
-        context 'with payload_type' do
-          context 'single' do
-            let(:payload_type) do
-              'single'
-            end
-
-            it { should be_false }
-          end
-
-          context 'stage' do
-            let(:payload_type) do
-              'stage'
-            end
-
-            it { should be_false }
-          end
-
-          context 'stager' do
-            let(:payload_type) do
-              'stager'
-            end
-
-            it { should be_false }
-          end
-        end
-
-        context 'without payload_type' do
-          let(:payload_type) do
-            nil
-          end
-
-          it { should be_false }
-        end
-      end
-    end
-
-    context 'without module_type' do
-      let(:module_type) do
-        nil
-      end
-
-      context 'with payload_type' do
-        context 'single'  do
-          let(:payload_type) do
-            'single'
-          end
-
-          it { should be_false }
-        end
-
-        context 'stage' do
-          let(:payload_type) do
-            'stage'
-          end
-
-          it { should be_false }
-        end
-
-        context 'stager' do
-          let(:payload_type) do
-            'stager'
-          end
-
-          it { should be_false }
-        end
-      end
-
-      context 'without payload_type' do
-        let(:payload_type) do
-          nil
-        end
-
-        it { should be_false }
-      end
-    end
-  end
-
-  # instance method
-  context '#handled?' do
-    subject(:handled?) do
-      module_ancestor.handled?
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(
-          module_ancestor_factory,
-          :module_type => module_type,
-          :payload_type => payload_type
-      )
-    end
-
-    let(:module_type) do
-      'payload'
-    end
-
-    let(:payload_type) do
-      FactoryGirl.generate :metasploit_model_module_ancestor_payload_type
-    end
-
-    before(:each) do
-      module_ancestor.payload_type = module_ancestor.derived_payload_type
-    end
-
-    it 'should delegate to class method' do
-      module_ancestor_class.should_receive(:handled?).with(
-          :module_type => module_type,
-          :payload_type => payload_type
-      )
-
-      handled?
-    end
-  end
-
-  context '#loading_context?' do
-    subject(:loading_context?) do
-      module_ancestor.send(:loading_context?)
-    end
-
-    context 'with valid?' do
-      it 'should be false' do
-        module_ancestor.should_receive(:run_validations!) do
-          loading_context?.should be_false
-        end
-
-        module_ancestor.valid?
-      end
-    end
-
-    context 'with valid?(:loading)' do
-      it 'should be true' do
-        module_ancestor.should_receive(:run_validations!) do
-          loading_context?.should be_true
-        end
-
-        module_ancestor.valid?(:loading)
-      end
-    end
-  end
-
-  context '#payload?' do
-    subject(:module_ancestor) do
-      module_ancestor_class.new(:module_type => module_type)
-    end
-
-    context "with 'payload' module_type" do
-      let(:module_type) do
-        'payload'
-      end
-
-      it { should be_payload }
-    end
-
-    context "without 'payload' module_type" do
-      let(:module_type) do
-        FactoryGirl.generate :metasploit_model_non_payload_module_type
-      end
-
-      it { should_not be_payload }
-    end
-  end
-
-  context '#payload_name' do
-    subject(:payload_name) do
-      module_ancestor.payload_name
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(
-          module_ancestor_factory,
-          handler_type: handler_type,
-          module_type: module_type,
-          payload_type: payload_type
-      )
-    end
-
-    context '#module_type' do
-      context 'with payload' do
-        #
-        # Shared examples
-        #
-
-        shared_examples_for 'prefix payload_name' do
-          let(:handler_type) do
-            nil
-          end
-
-          context 'with #reference_name' do
-            #
-            # lets
-            #
-
-            let(:expected_payload_name) do
-              'expected/payload/name'
-            end
-
-            let(:reference_name) do
-              "#{payload_type_directory}/#{expected_payload_name}"
-            end
-
-            #
-            # Callbacks
-            #
-
-            before(:each) do
-              module_ancestor.reference_name = reference_name
-            end
-
-            it "strips #payload_type_directory and '/' from #reference_name" do
-              expect(payload_name).to eq(expected_payload_name)
-            end
-          end
-
-          context 'without #reference_name' do
-            before(:each) do
-              module_ancestor.reference_name = nil
-            end
-
-            it { should be_nil }
-          end
-        end
-
-        #
-        # lets
-        #
-
-        let(:module_type) do
-          'payload'
-        end
-
-        context '#payload_type' do
-          context 'with single' do
-            let(:payload_type) do
-              'single'
-            end
-
-            it_should_behave_like 'prefix payload_name' do
-              let(:payload_type_directory) do
-                'singles'
-              end
-            end
-          end
-
-          context 'with stage' do
-            let(:payload_type) do
-              'stage'
-            end
-
-            it_should_behave_like 'prefix payload_name' do
-              let(:payload_type_directory) do
-                'stages'
-              end
-            end
-          end
-
-          context 'with stager' do
-            let(:payload_type) do
-              'stager'
-            end
-
-            context 'with #handler_type' do
-              let(:handler_type) do
-                FactoryGirl.generate :metasploit_model_module_handler_type
-              end
-
-              it 'uses #handler_type' do
-                expect(payload_name).to eq(handler_type)
-              end
-            end
-
-            context 'without #handler_type' do
-              let(:handler_type) do
-                nil
-              end
-
-              it { should be_nil }
-            end
-          end
-
-          context 'with other' do
-            let(:handler_type) do
-              nil
-            end
-
-            let(:payload_type) do
-              'unknown_payload_type'
-            end
-
-            it { should be_nil }
-          end
-        end
-      end
-
-      context 'without payload' do
-        let(:handler_type) do
-          nil
-        end
-
-        let(:module_type) do
-          FactoryGirl.generate :metasploit_model_non_payload_module_type
-        end
-
-        let(:payload_type) do
-          nil
-        end
-
-        it { should be_nil }
-      end
-    end
-  end
-
-  context '#payload_type_directory' do
-    subject(:payload_type_directory) do
-      module_ancestor.payload_type_directory
-    end
-
-    let(:module_ancestor) do
-      FactoryGirl.build(
-          module_ancestor_factory,
-          module_type: module_type
-      )
-    end
-
-    context 'with payload' do
-      let(:module_type) do
-        'payload'
-      end
-
-      before(:each) do
-        module_ancestor.reference_name = reference_name
-      end
-
-      context 'with #reference_name' do
-        let(:expected_payload_type_directory) do
-          payload_type_directories.sample
-        end
-
-        let(:payload_type_directories) do
-          [
-              'singles',
-              'stages',
-              'stagers'
-          ]
-        end
-
-        let(:reference_name) do
-          "#{expected_payload_type_directory}/reference/name/tail"
-        end
-
-        it 'is name before REFERENCE_NAME_SEPARATOR' do
-          expect(payload_type_directory).to eq(expected_payload_type_directory)
-        end
-      end
-
-      context 'without #reference_name' do
-        let(:reference_name) do
-          nil
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without payload' do
-      let(:module_type) do
-        FactoryGirl.generate :metasploit_model_non_payload_module_type
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#relative_file_names' do
-    subject(:relative_file_names) do
-      module_ancestor.relative_file_names
-    end
-
-    before(:each) do
-      module_ancestor.stub(relative_pathname: relative_pathname)
-    end
-
-    context 'with #relative_pathnames' do
-      let(:file_names) do
-        [
-            'a',
-            'b',
-            'c'
-        ]
-      end
-
-      let(:relative_pathname) do
-        Pathname.new(file_names.join('/'))
-      end
-
-      it { should be_an Enumerator }
-
-      it 'should include all file names, in order' do
-        relative_file_names.to_a.should == file_names
-      end
-    end
-
-    context 'without #relative_pathnames' do
-      let(:relative_pathname) do
-        nil
-      end
-
-      it { should be_an Enumerator }
-      its(:to_a) { should be_empty }
-    end
-  end
-
-  context '#relative_pathname' do
-    subject(:relative_pathname) do
-      module_ancestor.relative_pathname
-    end
-
-    before(:each) do
-      module_ancestor.stub(real_pathname: real_pathname)
-    end
-
-    context 'with #real_pathname' do
-      let(:real_pathname) do
-        Pathname.new('a/b/c')
-      end
-
-      before(:each) do
-        module_ancestor.parent_path = parent_path
-      end
-
-      context 'with #parent_path' do
-        let(:parent_path) do
-          module_ancestor.parent_path
-        end
-
-        before(:each) do
-          parent_path.stub(real_pathname: parent_path_real_pathname)
-        end
-
-        context 'with Metasploit::Model::Module::Path#real_pathname' do
-          let(:parent_path_real_pathname) do
-            Pathname.new('a')
-          end
-
-          it { should be_a Pathname }
-          it { should be_relative }
-
-          it 'should be relative to parent_path.real_pathname' do
-            relative_pathname.should == Pathname.new('b/c')
-          end
-        end
-
-        context 'without Metasploit::Model::Module::Path#real_pathname' do
-          let(:parent_path_real_pathname) do
-            nil
-          end
-
-          it { should be_nil }
-        end
-      end
-
-      context 'without #parent_path' do
-        let(:parent_path) do
-          nil
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without #real_pathname' do
-      let(:real_pathname) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#reference_path' do
-    subject(:reference_path) do
-      module_ancestor.reference_path
-    end
-
-    let(:module_ancestor) do
-      module_ancestor_class.new(
-          :reference_name => reference_name
-      )
-    end
-
-    context 'with reference_name' do
-      let(:reference_name) do
-        FactoryGirl.generate :metasploit_model_module_ancestor_non_payload_reference_name
-      end
-
-      it 'should be reference_name + EXTENSION' do
-        reference_path.should == "#{reference_name}#{Metasploit::Model::Module::Ancestor::EXTENSION}"
-      end
-    end
-
-    context 'without reference_name' do
-      let(:reference_name) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-
-  context '#module_type_directory' do
-    subject(:module_type_directory) do
-      module_ancestor.module_type_directory
-    end
-
-    let(:module_ancestor) do
-      module_ancestor_class.new(
-          :module_type => module_type
-      )
-    end
-
-    context 'with module_type' do
-      context 'in known types' do
-        let(:module_type) do
-          FactoryGirl.generate :metasploit_model_module_type
-        end
-
-        it 'should use Metasploit::Model::Module::Ancestor::DIRECTORY_BY_MODULE_TYPE' do
-          module_type_directory.should == Metasploit::Model::Module::Ancestor::DIRECTORY_BY_MODULE_TYPE[module_type]
-        end
-      end
-
-      context 'in unknown types' do
-        let(:module_type) do
-          'not_a_type'
-        end
-
-        it { should be_nil }
-      end
-    end
-
-    context 'without module_type' do
-      let(:module_type) do
-        nil
-      end
-
-      it { should be_nil }
-    end
-  end
-end