RubyGems - rsel - Versions diffs - 0.0.1 - Mend

rsel 0.0.1

Files changed (59) hide show

data/.gitignore +4 -0
data/.yardopts +7 -0
data/Gemfile +2 -0
data/MIT-LICENSE +22 -0
data/README.md +35 -0
data/Rakefile +75 -0
data/docs/custom.md +87 -0
data/docs/development.md +48 -0
data/docs/index.md +13 -0
data/docs/install.md +33 -0
data/docs/todo.md +15 -0
data/docs/usage.md +50 -0
data/lib/rsel.rb +4 -0
data/lib/rsel/exceptions.rb +4 -0
data/lib/rsel/selenium_test.rb +524 -0
data/rsel.gemspec +29 -0
data/spec/selenium_test_spec.rb +296 -0
data/spec/spec_helper.rb +41 -0
data/test/app.rb +34 -0
data/test/config.ru +4 -0
data/test/views/about.erb +9 -0
data/test/views/form.erb +102 -0
data/test/views/index.erb +15 -0
data/vendor/rubyslim-0.1.1/.gitignore +7 -0
data/vendor/rubyslim-0.1.1/README.md +159 -0
data/vendor/rubyslim-0.1.1/Rakefile +21 -0
data/vendor/rubyslim-0.1.1/bin/rubyslim +10 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/list_deserializer.rb +69 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/list_executor.rb +12 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/list_serializer.rb +45 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/ruby_slim.rb +61 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/slim_error.rb +3 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/slim_helper_library.rb +23 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/socket_service.rb +53 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/statement.rb +79 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/statement_executor.rb +174 -0
data/vendor/rubyslim-0.1.1/lib/rubyslim/table_to_hash_converter.rb +32 -0
data/vendor/rubyslim-0.1.1/lib/test_module/library_new.rb +13 -0
data/vendor/rubyslim-0.1.1/lib/test_module/library_old.rb +12 -0
data/vendor/rubyslim-0.1.1/lib/test_module/should_not_find_test_slim_in_here/test_slim.rb +7 -0
data/vendor/rubyslim-0.1.1/lib/test_module/simple_script.rb +9 -0
data/vendor/rubyslim-0.1.1/lib/test_module/test_chain.rb +5 -0
data/vendor/rubyslim-0.1.1/lib/test_module/test_slim.rb +86 -0
data/vendor/rubyslim-0.1.1/lib/test_module/test_slim_with_arguments.rb +23 -0
data/vendor/rubyslim-0.1.1/lib/test_module/test_slim_with_no_sut.rb +5 -0
data/vendor/rubyslim-0.1.1/rubyslim.gemspec +22 -0
data/vendor/rubyslim-0.1.1/spec/instance_creation_spec.rb +40 -0
data/vendor/rubyslim-0.1.1/spec/it8f_spec.rb +8 -0
data/vendor/rubyslim-0.1.1/spec/list_deserializer_spec.rb +66 -0
data/vendor/rubyslim-0.1.1/spec/list_executor_spec.rb +187 -0
data/vendor/rubyslim-0.1.1/spec/list_serialzer_spec.rb +38 -0
data/vendor/rubyslim-0.1.1/spec/method_invocation_spec.rb +127 -0
data/vendor/rubyslim-0.1.1/spec/slim_helper_library_spec.rb +80 -0
data/vendor/rubyslim-0.1.1/spec/socket_service_spec.rb +98 -0
data/vendor/rubyslim-0.1.1/spec/spec_helper.rb +6 -0
data/vendor/rubyslim-0.1.1/spec/statement_executor_spec.rb +50 -0
data/vendor/rubyslim-0.1.1/spec/statement_spec.rb +17 -0
data/vendor/rubyslim-0.1.1/spec/table_to_hash_converter_spec.rb +31 -0
metadata +241 -0

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+<head><title>Rsel Test Site</title></head>
+<body>
+  <h1>Welcome</h1>
+  <p>This is a Sinatra webapp for unit testing Rsel.</p>
+  <div id="links">
+    <a href="/about">About this site</a>
+    <a href="/form">Form test</a>
+  </div>
+</body>
+</html>

data/vendor/rubyslim-0.1.1/.gitignore ADDED

@@ -0,0 +1,7 @@
+.rakeTasks
+*.iml
+*.ipr
+*.iws
+.DS_Store
+.idea

data/vendor/rubyslim-0.1.1/README.md ADDED

@@ -0,0 +1,159 @@
+Ruby Slim Protocol (V0.1)
+=========================
+Setup
+-----
+Put these command in a parent of the Ruby test pages.
+    !define TEST_SYSTEM {slim}
+    !define TEST_RUNNER {<wherever you put Ruby Slim>/lib/run_ruby_slim.rb}
+    !define COMMAND_PATTERN {ruby -I %p %m}
+    !define PATH_SEPARATOR {-I}
+    !path <wherever you put Ruby Slim>/lib
+    !path <any directory where you have ruby fixtures>
+Paths can be relative. You should put the following in an appropriate SetUp page:
+    !|import|
+    |<ruby module of fixtures>|
+You can have as many rows in this table as you like, one for each module that
+contains fixtures. Note that this needs to be the *name* of the module as
+written in the Ruby code, not the filename where the module is defined.
+Ruby slim works a lot like Java slim. We tried to use ruby method naming
+conventions. So if you put this in a table:
+    |SomeDecisionTable|
+    |input|get output?|
+    |1    |2          |
+Then it will call the `set_input` and `get_output` functions of the
+`SomeDecisionTable` class.
+The `SomeDecisionTable` class would be written in a file called
+`some_decision_table.rb`, like this (the file name must correspond to the class
+name defined within, and the module name must match the one you are importing):
+    module MyModule
+      class SomeDecisionTable
+        def set_input(input)
+          @x = input
+        end
+        def get_output
+          @x
+        end
+      end
+    end
+Note that there is no type information for the arguments of these functions, so
+they will all be treated as strings. This is important to remember! All
+arguments are strings. If you are expecting integers, you will have to convert
+the strings to integers within your fixtures.
+Hashes
+------
+There is one exception to the above rule. If you pass a HashWidget in a table,
+then the argument will be converted to a Hash.
+Consider, for example, this fixtures class:
+    module TestModule
+      class TestSlimWithArguments
+        def initialize(arg)
+          @arg = arg
+        end
+        def arg
+          @arg
+        end
+        def name
+          @arg[:name]
+        end
+        def addr
+          @arg[:addr]
+        end
+        def set_arg(hash)
+          @arg = hash
+        end
+      end
+    end
+This corresponds to the following tables.
+    |script|test slim with arguments|!{name:bob addr:here}|
+    |check|name|bob|
+    |check|addr|here|
+    |script|test slim with arguments|gunk|
+    |check|arg|gunk|
+    |set arg|!{name:bob addr:here}|
+    |check|name|bob|
+    |check|addr|here|
+Note the use of the HashWidgets in the table cells. These get translated into
+HTML, which RubySlim recognizes and converts to a standard ruby `Hash`.
+System Under Test
+-----------------
+If a fixture has a `sut` method that returns an object, then if a method called
+by a test is not found in the fixture itself, then if it exists in the object
+returned by `sut` it will be called. For example:
+    !|script|my fixture|
+    |func|1|
+    class MySystem
+      def func(x)
+        #this is the function that will be called.
+      end
+    end
+    class MyFixture
+      attr_reader :sut
+      def initialize
+        @sut = MySystem.new
+      end
+    end
+Since the fixture `MyFixture` does not have a function named `func`, but it
+_does_ have a method named `sut`, RubySlim will try to call `func` on the
+object returned by `sut`.
+Library Fixtures
+----------------
+Ruby Slim supports the `|Library|` feature of FitNesse. If you declare certain
+classes to be libraries, then if a test calls a method, and the specified
+fixture does not have it, and there is no specified `sut`, then the libraries
+will be searched in reverse order (latest first). If the method is found, then
+it is called.
+For example:
+    |Library|
+    |echo fixture|
+    |script|
+    |check|echo|a|a|
+    class EchoFixture
+      def echo(x)
+        x
+      end
+    end
+Here, even though no fixture was specified for the script table, since a
+library was declared, functions will be called on it.

data/vendor/rubyslim-0.1.1/Rakefile ADDED

@@ -0,0 +1,21 @@
+require 'rake'
+#require 'rcov/rcovtask'
+require 'spec/rake/spectask'
+task :default => :spec
+desc "Run all spec tests"
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = Dir.glob('spec/**/*_spec.rb')
+  t.spec_opts = ['--color', '--format specdoc']
+end
+desc "Run all spec tests and generate coverage report"
+Spec::Rake::SpecTask.new(:rcov) do |t|
+  t.spec_files = Dir.glob('spec/**/*_spec.rb')
+  # RCov doesn't like this part for some reason
+  #t.spec_opts = ['--color', '--format specdoc']
+  t.rcov = true
+  t.rcov_opts = %w{--exclude osx\/objc,gems\/,spec\/,features\/,lib\/test_module\/}
+end

data/vendor/rubyslim-0.1.1/bin/rubyslim ADDED

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+require 'rubyslim/ruby_slim'
+require 'jcode'
+$KCODE="UTF8"
+port = ARGV[0].to_i
+rubySlim = RubySlim.new
+rubySlim.run(port)

data/vendor/rubyslim-0.1.1/lib/rubyslim/list_deserializer.rb ADDED

@@ -0,0 +1,69 @@
+require 'jcode'
+module ListDeserializer
+  class SyntaxError < Exception
+  end
+  # De-serialize the given string, and return a Ruby-native list.
+  # Raises a SyntaxError if the string is empty or badly-formatted.
+  def self.deserialize(string)
+    raise SyntaxError.new("Can't deserialize null") if string.nil?
+    raise SyntaxError.new("Can't deserialize empty string") if string.empty?
+    raise SyntaxError.new("Serialized list has no starting [") if string[0..0] != "["
+    raise SyntaxError.new("Serialized list has no ending ]") if string[-1..-1] != "]"
+    Deserializer.new(string).deserialize
+  end
+  class Deserializer
+    def initialize(string)
+      @string = string;
+    end
+    def deserialize
+      @pos = 1
+      @list = []
+      number_of_items = consume_length
+      # For each item in the list
+      number_of_items.times do
+        length_of_item = consume_length
+        item = @string[@pos...@pos+length_of_item]
+        length_in_bytes = length_of_item
+        until (item.jlength > length_of_item) do
+          length_in_bytes += 1
+          item = @string[@pos...@pos+length_in_bytes]
+        end
+        length_in_bytes -= 1
+        item = @string[@pos...@pos+length_in_bytes]
+        # Ensure the ':' list-termination character is found
+        term_char = @string[@pos+length_in_bytes,1]
+        if term_char != ':'
+          raise SyntaxError.new("List termination character ':' not found" +
+                               " (got '#{term_char}' instead)")
+        end
+        @pos += length_in_bytes+1
+        begin
+          sublist = ListDeserializer.deserialize(item)
+          @list << sublist
+        rescue ListDeserializer::SyntaxError
+          @list << item
+        end
+      end
+      @list
+    end
+    # Consume the 6-digit length prefix, and return the
+    # length as an integer.
+    def consume_length
+      length = @string[@pos...@pos+6].to_i
+      @pos += 7
+      length
+    end
+  end
+end

data/vendor/rubyslim-0.1.1/lib/rubyslim/list_executor.rb ADDED

@@ -0,0 +1,12 @@
+require "rubyslim/statement"
+require "rubyslim/statement_executor"
+class ListExecutor
+  def initialize()
+    @executor = StatementExecutor.new
+  end
+  def execute(instructions)
+    instructions.collect {|instruction| Statement.execute(instruction, @executor)}
+  end
+end

data/vendor/rubyslim-0.1.1/lib/rubyslim/list_serializer.rb ADDED

@@ -0,0 +1,45 @@
+require 'jcode'
+module ListSerializer
+  # Serialize a list according to the SliM protocol.
+  #
+  # Lists are enclosed in square-brackets '[...]'. Inside the opening
+  # bracket is a six-digit number indicating the length of the list
+  # (number of items), then a colon ':', then the serialization of each
+  # list item. For example:
+  #
+  #   []         => "[000000:]"
+  #   ["hello"]  => "[000001:000005:hello:]"
+  #   [1]        => "[000001:000001:1:]"
+  #
+  # Strings are preceded by a six-digit sequence indicating their length:
+  #
+  #   ""         => "000000:"
+  #   "hello"    => "000005:hello"
+  #   nil        => "000004:null"
+  #
+  # See spec/list_serializer_spec.rb for more examples.
+  #
+  def self.serialize(list)
+    result = "["
+    result += length_string(list.length)
+    # Serialize each item in the list
+    list.each do |item|
+      item = "null" if item.nil?
+      item = serialize(item) if item.is_a?(Array)
+      item = item.to_s
+      result += length_string(item.jlength)
+      result += item + ":"
+    end
+    result += "]"
+  end
+  # Return the six-digit prefix for an element of the given length.
+  def self.length_string(length)
+    sprintf("%06d:",length)
+  end
+end

data/vendor/rubyslim-0.1.1/lib/rubyslim/ruby_slim.rb ADDED

@@ -0,0 +1,61 @@
+require "rubyslim/socket_service"
+require "rubyslim/list_deserializer"
+require "rubyslim/list_serializer"
+require "rubyslim/list_executor"
+class RubySlim
+  def run(port)
+    @connected = true
+    @executor = ListExecutor.new
+    socket_service = SocketService.new()
+    socket_service.serve(port) do |socket|
+      serve_ruby_slim(socket)
+    end
+    while (@connected)
+      sleep(0.1)
+    end
+  end
+  # Read and execute instructions from the SliM socket, until a 'bye'
+  # instruction is reached. Each instruction is a list, serialized as a string,
+  # following the SliM protocol:
+  #
+  #   length:command
+  #
+  # Where `length` is a 6-digit indicating the length in bytes of `command`,
+  # and `command` is a serialized list of instructions that may include any
+  # of the four standard instructions in the SliM protocol:
+  #
+  #   Import: [<id>, import, <path>]
+  #   Make: [<id>, make, <instance>, <class>, <arg>...]
+  #   Call: [<id>, call, <instance>, <function>, <arg>...]
+  #   CallAndAssign: [<id>, callAndAssign, <symbol>, <instance>, <function>, <arg>...]
+  #
+  # (from http://fitnesse.org/FitNesse.UserGuide.SliM.SlimProtocol)
+  #
+  def serve_ruby_slim(socket)
+    socket.puts("Slim -- V0.3");
+    said_bye = false
+    while !said_bye
+      length = socket.read(6).to_i   # <length>
+      socket.read(1)                 # :
+      command = socket.read(length)  # <command>
+      # Until a 'bye' command is received, deserialize the command, execute the
+      # instructions, and write a serialized response back to the socket.
+      if command.downcase != "bye"
+        instructions = ListDeserializer.deserialize(command);
+        results = @executor.execute(instructions)
+        response = ListSerializer.serialize(results);
+        socket.write(sprintf("%06d:%s", response.length, response))
+        socket.flush
+      else
+        said_bye = true
+      end
+    end
+    @connected = false
+  end
+end

data/vendor/rubyslim-0.1.1/lib/rubyslim/slim_error.rb ADDED

@@ -0,0 +1,3 @@
+class SlimError < Exception
+end

data/vendor/rubyslim-0.1.1/lib/rubyslim/slim_helper_library.rb ADDED

@@ -0,0 +1,23 @@
+class SlimHelperLibrary
+  ACTOR_INSTANCE_NAME = "scriptTableActor"
+  attr_accessor :executor
+  def initialize(executor = nil)
+    @executor = executor
+    @fixtures = []
+  end
+  def get_fixture
+    executor.instance(ACTOR_INSTANCE_NAME)
+  end
+  def push_fixture
+    @fixtures << get_fixture
+    nil
+  end
+  def pop_fixture
+    executor.set_instance(ACTOR_INSTANCE_NAME, @fixtures.pop)
+    nil
+  end
+end

data/vendor/rubyslim-0.1.1/lib/rubyslim/socket_service.rb ADDED

@@ -0,0 +1,53 @@
+require 'socket'
+require 'thread'
+class SocketService
+  attr_reader :closed
+  def initialize()
+    @ropeSocket = nil
+    @group = ThreadGroup.new
+    @serviceThread = nil
+  end
+  def serve(port, &action)
+    @closed = false
+    @action = action
+    @ropeSocket = TCPServer.open(port)
+    @serviceThread = Thread.start {serviceTask}
+    @group.add(@serviceThread)
+  end
+  def pendingSessions
+    @group.list.size - ((@serviceThread != nil) ? 1 : 0)
+  end
+  def serviceTask
+    while true
+      Thread.start(@ropeSocket.accept) do |s|
+        serverTask(s)
+      end
+    end
+  end
+  def serverTask(s)
+    @action.call(s)
+    s.close
+  end
+  def close
+    @serviceThread.kill
+    @serviceThread = nil
+    @ropeSocket.close
+    waitForServers
+    @closed = true
+  end
+  def waitForServers
+    @group.list.each do |t|
+      t.join
+    end
+  end
+end