metasploit-model 0.24.1.pre.semantic.pre.versioning.pre.2.pre.0

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

@@ -0,0 +1,25 @@
+shared_examples_for 'Metasploit::Model::Architecture seed' do |attributes={}|
+  attributes.assert_valid_keys(:abbreviation, :bits, :endianness, :family, :summary)
+
+  context_abbreviation = attributes.fetch(:abbreviation)
+
+  context "with #{context_abbreviation}" do
+    subject do
+      seed
+    end
+
+    # put in a let so that `let(:seed)` has access to abbreviation.
+    let(:abbreviation) do
+      context_abbreviation
+    end
+
+    it 'should exist' do
+      seed.should_not be_nil
+    end
+
+    its(:bits) { should == attributes.fetch(:bits) }
+    its(:endianness) { should == attributes.fetch(:endianness) }
+    its(:family) { should == attributes.fetch(:family) }
+    its(:summary) { should == attributes.fetch(:summary) }
+  end
+end

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

@@ -0,0 +1,27 @@
+Metasploit::Model::Spec.shared_examples_for 'Author' do
+  context 'factories' do
+    context author_factory do
+      subject(author_factory) do
+        FactoryGirl.build(author_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
+    context 'name' do
+      it { should validate_presence_of :name }
+    end
+  end
+end

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

@@ -0,0 +1,124 @@
+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

@@ -0,0 +1,49 @@
+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/configuration/parent/child.rb

@@ -0,0 +1,60 @@
+shared_examples_for 'Metasploit::Model::Configuration::Parent#child' do |name, options={}|
+  options.assert_valid_keys(:class)
+
+  klass = options.fetch(:class)
+  class_attribute_name = "#{name}_class"
+
+  context "##{name}" do
+    subject(:child) do
+      configuration.send(name)
+    end
+
+    context "with default ##{class_attribute_name}" do
+      it { should be_a klass }
+    end
+
+    context "without default ##{class_attribute_name}" do
+      #
+      # lets
+      #
+
+      let(:non_default_class) do
+        Class.new do
+          attr_accessor :configuration
+        end
+      end
+
+      #
+      # Callbacks
+      #
+
+      before(:each) do
+        configuration.send("#{class_attribute_name}=", non_default_class)
+      end
+
+      it "is instance of ##{class_attribute_name}" do
+        expect(child).to be_a non_default_class
+      end
+    end
+
+    context '#configuration' do
+      subject(:child_configuration) do
+        child.configuration
+      end
+
+      it 'is this configuration' do
+        expect(child_configuration).to eq(configuration)
+      end
+    end
+  end
+
+  context "#{class_attribute_name}" do
+    subject(:child_class) do
+      configuration.send(class_attribute_name)
+    end
+
+    context 'default' do
+      it { should be klass }
+    end
+  end
+end

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

@@ -0,0 +1,220 @@
+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