saper 0.5.0

data/spec/core/argument_spec.rb

@@ -0,0 +1,79 @@
+require './spec/spec_helper'
+
+describe Saper::Argument do
+  
+  context ".new" do
+    context "when required value is nil" do
+      it "raises InvalidArgument" do
+        expect { Saper::Argument.new(:text, :value => nil) }.to raise_error(Saper::InvalidArgument)
+      end
+    end
+    context "when required value is missing" do
+      it "raises InvalidArgument" do
+        expect { Saper::Argument.new(:text) }.to raise_error(Saper::InvalidArgument)
+      end
+    end
+    context "when required value is invalid" do
+      it "raises InvalidArgument" do
+        expect { Saper::Argument.new(:text, :value => 1) }.to raise_error(Saper::InvalidArgument)
+      end
+    end
+    context "when required value is valid" do
+      it "raises no exceptions" do
+        expect { Saper::Argument.new(:text, :value => "text") }.to_not raise_error
+      end
+    end
+    context "when optional value is missing" do
+      it "raises no exceptions" do
+        expect { Saper::Argument.new(:text, :optional => true) }.to_not raise_error
+      end
+    end
+    context "when optional value is invalid" do
+      it "raises InvalidArgument" do
+        expect { Saper::Argument.new(:text, :optional => true, :value => 1) }.to raise_error(Saper::InvalidArgument)
+      end
+    end
+    context "when optional value is valid" do
+      it "returns Action instance" do
+        expect { Saper::Argument.new(:text, :optional => true, :value => "text") }.to_not raise_error
+      end
+    end
+  end
+  
+  context "#set" do
+    context "when required value is invalid" do
+      it "raises InvalidArgument" do
+        expect { Saper::Argument.new(:text, :value => "text").set(1) }.to raise_error(Saper::InvalidArgument)
+      end
+    end
+    context "when optional value is invalid" do
+      it "raises InvalidArgument" do
+        expect { Saper::Argument.new(:text, :optional => true, :value => "text").set(1) }.to raise_error(Saper::InvalidArgument)
+      end
+    end
+    context "when value is valid" do
+      it "returns self" do
+        Saper::Argument.new(:text, :optional => true).set("text").should be_a(Saper::Argument)
+      end
+    end
+  end
+  
+  context "#value" do
+    it "returns nil by default" do
+      Saper::Argument.new(:text, :optional => true).value.should be_nil
+    end
+    it "returns stored value" do
+      Saper::Argument.new(:text, :value => "text").value.should == "text"
+    end
+  end
+  
+  context "#optional?" do
+    it "returns false by default" do
+      Saper::Argument.new(:text, :value => "text").should_not be_optional
+    end
+    it "returns true if optionality flag is set" do
+      Saper::Argument.new(:text, :optional => true).should be_optional
+    end
+  end
+  
+end

data/spec/core/browser_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Browser do
+
+  it # TODO
+  
+end

data/spec/core/dsl_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::DSL::Recipe do
+
+  it # TODO
+  
+end

data/spec/core/item_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Item do
+  
+  it # TODO
+  
+end

data/spec/core/keychain_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Keychain do
+
+  it # TODO
+  
+end

data/spec/core/logger_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Logger do
+
+  it # TODO
+  
+end

data/spec/core/namespace_spec.rb

@@ -0,0 +1,18 @@
+require './spec/spec_helper'
+
+describe Saper::Namespace do
+  
+  let(:namespace) do
+    Saper::Namespace.parse do |ns|
+      recipe :child do
+        prepend_with 'test-'
+      end
+      recipe :parent do
+        run_recipe_and_save :variable, :child
+      end
+    end
+  end
+  
+  it # TODO
+  
+end

data/spec/core/recipe_spec.rb

@@ -0,0 +1,81 @@
+require './spec/spec_helper'
+
+describe Saper::Recipe do
+  
+  context ".unserialize(Hash)" do
+    it "returns a Recipe" do
+      Saper::Recipe.unserialize({ :id => 0 }).should be_a(Saper::Recipe)
+    end
+  end
+  
+  context ".unserialize(Array)" do
+    it "returns an Array" do
+      Saper::Recipe.unserialize([{ :id => 0 }, { :id => 1 }]).should be_a(Array)
+    end
+  end
+  
+  context ".unserialize(nil)" do
+    it "raises InvalidRecipe" do
+      expect { Saper::Recipe.unserialize("invalid argument") }.to raise_error(Saper::InvalidRecipe)
+    end
+  end
+  
+  context "#id" do
+    it "returns recipe ID" do
+      subject.id.should be_a(String)
+    end
+  end
+  
+  context "#actions" do
+    it "returns an empty array by default" do
+      subject.actions.should == []
+    end
+  end
+  
+  let(:action) do
+    Saper::Action.new(:append_with, "!")
+  end
+  
+  context "#<<" do
+    it "returns self with valid action" do
+      (subject << action).should be_a(Saper::Recipe)
+    end
+    it "raises ActionExpected with invalid argument" do
+      expect { subject << 'not an action' }.to raise_error(Saper::ActionExpected)
+    end
+  end
+  
+  context "#push" do
+    it "returns self with valid action" do
+      subject.push(action).should be_a(Saper::Recipe)
+    end
+    it "raises ActionExpected with invalid argument" do
+      expect { subject.push('not an action') }.to raise_error(Saper::ActionExpected)
+    end
+  end
+  
+  context "#run" do
+    it "returns self" do
+      subject.run.should be_a(Saper::Runtime)
+    end
+  end
+  
+  context "#serialize" do
+    it "returns a Hash" do
+      subject.serialize.should be_a(Hash)
+    end
+  end
+  
+  context "#to_string" do
+    it "returns a string" do
+      subject.to_string.should be_a(String)
+    end
+  end
+  
+  context "#to_json" do
+    it "returns a string" do
+      subject.to_json.should be_a(String)
+    end
+  end
+  
+end

data/spec/core/runtime_spec.rb

@@ -0,0 +1,165 @@
+require './spec/spec_helper'
+
+describe Saper::Runtime do
+  
+  context "#browser" do
+    it "returns Browser instance" do
+      subject.browser.should be_a(Saper::Browser)
+    end
+  end
+  
+  context "#bytes_received" do
+    it "returns zero by default" do
+      subject.bytes_received.should == 0
+    end
+  end
+  
+  context "#bytes_sent" do
+    it "returns zero by default" do
+      subject.bytes_sent.should == 0
+    end
+  end
+  
+  context "#http_requests" do
+    it "returns zero by default" do
+      subject.http_requests.should == 0
+    end
+  end
+  
+  context "#keychain" do
+    it "returns Keychain instance" do
+      subject.keychain.should be_a(Saper::Keychain)
+    end
+  end
+  
+  context "#credentials" do
+    it "returns nil if serivce not found" do
+      subject.credentials(:services).should == nil
+    end
+  end
+  
+  #context "#namespace" do
+  #  it "returns nil" do
+  #    subject.namespace.should be_nil
+  #  end
+  #end
+  
+  context "#depth" do
+    it "returns zero by default" do
+      subject.depth.should == 0
+    end
+  end
+  
+  context "#descendants" do
+    it "returns self by default" do
+      subject.descendants.should == [subject]
+    end
+  end
+  
+  context "#results" do
+    it "returns nil by default" do
+      subject.results.should == nil
+    end
+  end
+  
+  context "#results" do
+    it "returns input by default" do
+      Saper::Runtime.new([], "input").results.should == "input"
+    end
+  end
+  
+  context "#[]" do
+    it "returns nil if variable is not defined" do
+      subject[:varname].should be_nil
+    end
+  end
+  
+  context "#[]=" do
+    it "stores variale value" do
+      subject[:var] = 'OK'; subject[:var].should == 'OK'
+    end
+  end
+  
+  context "#variables" do
+    it "returns list of variable names" do
+      subject[:var] = 'OK'; subject.variables.should == { :var => 'OK' }
+    end
+  end
+  
+  let(:simple_recipe) do
+    Saper::Recipe.parse do
+      convert_to_html
+      find_first "p"
+      get_contents
+      append_with "!"
+    end
+  end
+  
+  context "#results" do
+    context "with failed single-output recipe" do
+      it "returns nil" do
+        Saper::Runtime.new(simple_recipe, nil).results.should == nil
+      end
+    end
+    context "with successful single-output recipe" do
+      it "returns result" do
+        Saper::Runtime.new(simple_recipe, "<p>a</p><p>b</p>").results.should == "a!"
+      end
+    end
+  end
+  
+  let(:multiple_recipe) do
+    Saper::Recipe.parse do
+      convert_to_html
+      find "p"
+      get_contents
+      append_with "!"
+    end
+  end
+  
+  context "#results" do
+    context "with failed multiple-output recipe" do
+      it "returns empty array" do
+        Saper::Runtime.new(multiple_recipe, nil).results.should == []
+      end
+    end
+    context "with successful multiple-output recipe" do
+      it "returns array with results" do
+        Saper::Runtime.new(multiple_recipe, "<p>a</p><p>b</p>").results.should == ["a!", "b!"]
+      end
+    end
+  end
+  
+  let(:namespaced_recipes) do
+    Saper::Namespace.parse do |ns|
+      recipe :child_multiple do
+        find "p"
+        get_contents
+      end
+      recipe :child_single do
+        find_first "p"
+        get_contents
+      end
+      recipe :parent_multiple do
+        run_recipe :child_multiple
+      end
+      recipe :parent_single do
+        run_recipe :child_single
+      end
+    end
+  end
+  
+  context "#results" do
+    context "with embedded multiple-output recipe" do
+      it "returns correct ouput" do
+        Saper::Runtime.new(namespaced_recipes[:parent_multiple], "<p>a</p><p>b</p>").results.should == ['a', 'b']
+      end
+    end
+    context "with embedded single-output recipe" do
+      it "returns correct ouput" do
+        Saper::Runtime.new(namespaced_recipes[:parent_single], "<p>a</p><p>b</p>").results.should == 'a'
+      end
+    end
+  end
+  
+end

data/spec/core/type_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Type do
+
+  it # TODO
+  
+end

data/spec/items/atom_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Items::Atom do
+  
+  it # TODO
+    
+end

data/spec/items/document_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Items::Document do
+  
+  it # TODO
+    
+end

data/spec/items/html_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Items::HTML do
+  
+  it # TODO
+    
+end

data/spec/items/json_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Items::JSON do
+  
+  it # TODO
+    
+end

data/spec/items/markdown_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Items::Markdown do
+  
+  it # TODO
+    
+end

data/spec/items/nothing_spec.rb

@@ -0,0 +1,7 @@
+require './spec/spec_helper'
+
+describe Saper::Items::Nothing do
+  
+  it # TODO
+    
+end