symbiont 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 909f262fd052acea8c09b4e9fade5afe56e8df9d
-  data.tar.gz: 3d74dd205296b3d460bb7fe1e3c0568bac6951e2
+  metadata.gz: bd01188718c924a7aa3c99657e0298949e8f0e7d
+  data.tar.gz: cfe062617af607bd769e130bc5ae758a35ed9238
 SHA512:
-  metadata.gz: d2989aeabb707e31b9dfdbee20e12bbb40b81bad1a1acc0262128f79aee5da69e277bf255cf4132e087e889d460d6c3da79fdc06d83c2b3fdc314ccb8fd6258c
-  data.tar.gz: 852920c422df630f4175b061cc17e8dee682486dc33e3f77b69ad2a9601020af509624fc6e4e48d8e1d05e14f50478b2bc05d10094518468624c3b1a56e42391
+  metadata.gz: 2d3dbcda06fad22a7e0aec22fa05bd7ad55bba73d0b9b4145650cc75a376baa08dcc3af81647ec3232e6e57f6d6e7e256a8d776c98fb02cf5076f9bc75c89d31
+  data.tar.gz: 37bc5b36c3f0288d4a2e301afe0572d1f5b9502549a4e94ec4c1f1aaf93e4932c9fb42449b887f08a4cefd3bca1f717b49b953d9b2b35f4013c5ed3ef8b6e668

data/.gitignore

@@ -20,5 +20,9 @@ tmp
 *.so
 *.o
 *.a
+._*
 mkmf.log
 .DS_Store
+.DS_Store?
+.Trashes
+.thumbs.db

data/Gemfile

@@ -1,6 +1,6 @@
 source 'https://rubygems.org'
 
-gem 'simplecov', '~> 0.9.0', require: false
+gem 'simplecov', '~> 0.10.0', require: false
 gem 'coveralls', require: false
 
 gemspec

data/README.md

@@ -1,17 +1,16 @@
 # Symbiont
 
+[ ![Codeship Status for jnyman/symbiont](https://codeship.com/projects/9cd74720-bba9-0132-db22-7ae602eb521b/status?branch=master)](https://codeship.com/projects/72247)
+
+[![Coverage Status](https://coveralls.io/repos/jnyman/symbiont/badge.svg?branch=master)](https://coveralls.io/r/jnyman/symbiont?branch=master)
 [![Gem Version](https://badge.fury.io/rb/symbiont.svg)](http://badge.fury.io/rb/symbiont)
-[![Build Status](https://secure.travis-ci.org/jnyman/symbiont.png)](http://travis-ci.org/jnyman/symbiont)
-[![Coverage Status](https://coveralls.io/repos/jnyman/symbiont/badge.png?branch=master)](https://coveralls.io/r/jnyman/symbiont?branch=master)
-[![Code Climate](https://codeclimate.com/github/jnyman/symbiont.png)](https://codeclimate.com/github/jnyman/symbiont)
 [![Dependency Status](https://gemnasium.com/jnyman/symbiont.png)](https://gemnasium.com/jnyman/symbiont)
+[![Code Climate](https://codeclimate.com/github/jnyman/symbiont/badges/gpa.svg)](https://codeclimate.com/github/jnyman/symbiont)
 
 Symbiont provides a semantic domain-specific language that can be used to construct a fluent interface for test execution libraries. The initial focus will be on using the [watir-webdriver](https://github.com/watir/watir-webdriver) API as the underlying driver library.
 
 [![Gitter chat](https://badges.gitter.im/jnyman/symbiont.png)](https://gitter.im/jnyman/symbiont)
 [![endorse](https://api.coderwall.com/jnyman/endorsecount.png)](https://coderwall.com/jnyman)
-[![Stories in Ready](https://badge.waffle.io/jnyman/symbiont.png?label=ready&title=Ready)](https://waffle.io/jnyman/symbiont)
-
 
 ## What is this?
 
@@ -40,7 +39,7 @@ You can also install Symbiont just as you would any other gem:
 
 ## Usage
 
-To learn how to use the framework, you can check out my [blog posts on Symbiont](http://testerstories.com/category/symbiont/).
+To learn how to use the framework, you can check out my [blog posts on Symbiont](http://testerstories.com/category/symbiont/) and for the most up to date information, you can check out the [Symbiont Wiki](https://github.com/jnyman/symbiont/wiki).
 
 You can check out the [Symbiont test script](https://github.com/jnyman/symbiont/blob/master/test/symbiont-script.rb) for an idea of how the library can be interacted with. Do note that the test script requires a local copy of [Dialogic](https://github.com/jnyman/dialogic) to be running. To execute the test script:
 
@@ -48,6 +47,8 @@ You can check out the [Symbiont test script](https://github.com/jnyman/symbiont/
 
 ## Why call it Symbiont?
 
+If you are a comic book reader, particularly in the Marvel Universe, you will know of the [Klyntar](http://marvel.wikia.com/Klyntar), a race of symbiotic creatures. While those creatures have been a mixed bag in terms of good and evil, they are symbionts, which are organisms that exist in a partnership with something else. The terms comes from the Greek _symbiōtēs_ ("companion"), from an earlier term _symbioun_ ("to live together").
+
 A "symbiont" is an organism in a symbiotic (mutually beneficial) relationship. Some of these relationships are called _obligate_, which means that both organisms need each other in order to survive. Other such relationships are called _facultative_, meaning that both organisms don't strictly need each other to survive, but they stand a better chance if they do.
 
 Symbiotic relationships include associations in which one organism lives on another organism -- _ectosymbiosis_ -- or where one organism lives inside the other -- _endosymbiosis_.
@@ -56,16 +57,21 @@ So, with that bit of context, think of this library as a facultative, endosymbio
 
 ## Contributing
 
-1. [Fork the project](http://gun.io/blog/how-to-github-fork-branch-and-pull-request/).
-2. Create a feature branch. (`git checkout -b my-new-feature`)
+1. [Fork the project](http://gun.io/blog/how-to-github-fork-branch-and-pull-request/) ( https://github.com/[my-github-username]/symbiont/fork ).
+2. Create your feature branch. (`git checkout -b my-new-feature`)
 3. Commit your changes. (`git commit -am 'new feature'`)
 4. Push the branch. (`git push origin my-new-feature`)
 5. Create a new [pull request](https://help.github.com/articles/using-pull-requests).
 
-## Credits
+## Author
 
-Thanks to Jeff Morgan ([http://www.cheezyworld.com/](http://www.cheezyworld.com/)) for his [page-object](https://github.com/cheezy/page-object) gem, Alister Scott ([http://watirmelon.com](http://watirmelon.com)) for his [watir-page-helper](https://github.com/alisterscott/watir-page-helper) gem, Alex Rodionov ([(http://p0deje.blogspot.com/](http://p0deje.blogspot.com/)) for his [watirsome](https://github.com/p0deje/watirsome) gem, and Nat Ritmeyer ([http://www.natritmeyer.com/](http://www.natritmeyer.com/)) for his [SitePrism](https://github.com/natritmeyer/site_prism/) gem.
+* [Jeff Nyman](http://testerstories.com)
 
-## Copyright
+## License
+
+Symbiont is distributed under the [MIT](http://www.opensource.org/licenses/MIT) license.
+See the [LICENSE](https://github.com/jnyman/symbiont/blob/master/LICENSE.txt) file for details.
+
+## Credits
 
-Symbiont is distributed under the MIT license. See the [LICENSE](https://github.com/jnyman/symbiont/blob/master/LICENSE.txt) file for details.
+Thanks to Jeff Morgan ([http://www.cheezyworld.com/](http://www.cheezyworld.com/)) for his [page-object](https://github.com/cheezy/page-object) gem, Alister Scott ([http://watirmelon.com](http://watirmelon.com)) for his [watir-page-helper](https://github.com/alisterscott/watir-page-helper) gem, Alex Rodionov ([http://p0deje.blogspot.com/](http://p0deje.blogspot.com/)) for his [watirsome](https://github.com/p0deje/watirsome) gem, and Nat Ritmeyer ([http://www.natritmeyer.com/](http://www.natritmeyer.com/)) for his [SitePrism](https://github.com/natritmeyer/site_prism/) gem.

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'symbiont'
+
+require 'pry'
+Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install

data/lib/symbiont/data_reader.rb

@@ -8,6 +8,7 @@ module Symbiont
     def data_path
       return @data_path if @data_path
       return default_data_path if self.respond_to? :default_data_path
+      nil
     end
 
     # The data_source name here must match the name used for the

data/lib/symbiont/errors.rb

@@ -3,5 +3,7 @@ module Symbiont
     class NoUrlForDefinition < StandardError; end
     class NoUrlMatchForDefinition < StandardError; end
     class NoTitleForDefinition < StandardError; end
+    class WorkflowPathNotFound < StandardError; end
+    class WorkflowActionNotFound < StandardError; end
   end
 end

data/lib/symbiont/factory.rb

@@ -1,5 +1,7 @@
 module Symbiont
   module Factory
+    include Workflow
+
     # Creates a definition context for actions. If an existing context
     # exists, that context will be re-used.
     #

data/lib/symbiont/service_objects.rb

@@ -0,0 +1,78 @@
+require 'savon'
+require 'symbiont/soap_methods'
+
+module Symbiont
+  module SoapObject
+    attr_reader :response
+
+    def self.included(caller)
+      caller.extend SoapMethods
+    end
+
+    def initialize
+      @client = Savon.client(client_properties)
+    end
+
+    def connected?
+      not @client.nil?
+    end
+
+    def operations
+      @client.operations
+    end
+
+    def doc
+      response.doc
+    end
+
+    def body
+      response.body
+    end
+
+    def xpath(node)
+      response.xpath(node)
+    end
+
+    def to_xml
+      response.to_xml
+    end
+
+    def to_hash
+      response.hash
+    end
+
+    private
+
+    def method_missing(*args)
+      operation = args.shift
+      message = args.shift
+      type = message.is_a?(String) ? :xml : :message
+      call(operation, { type => message })
+    end
+
+    def call(operation, data)
+      @response = @client.call(operation, data)
+      response.to_xml
+    end
+
+    def client_properties
+      properties = { log: false, ssl_version: :SSLv3, ssl_verify_mode: :none }
+      [
+          :has_wsdl,
+          :has_proxy,
+          :has_basic_auth,
+          :has_digest_auth,
+          :has_encoding,
+          :has_soap_header,
+          :has_open_timeout,
+          :has_read_timeout,
+          :has_log_level,
+          :has_ssl_version,
+          :has_ssl_verification
+      ].each do |sym|
+        properties = properties.merge(self.send sym) if self.respond_to? sym
+      end
+      properties
+    end
+  end
+end

data/lib/symbiont/soap_methods.rb

@@ -0,0 +1,72 @@
+module Symbiont::SoapObject
+  module SoapMethods
+    def wsdl(url)
+      define_method(:has_wsdl) do
+        @wsdl ||= url
+        { wsdl: @wsdl }
+      end
+    end
+
+    def proxy(url)
+      define_method(:has_proxy) do
+        { proxy: url }
+      end
+    end
+
+    def basic_auth(*creds)
+      define_method(:has_basic_auth) do
+        { basic_auth: creds }
+      end
+    end
+
+    def digest_auth(*creds)
+      define_method(:has_digest_auth) do
+        { digest_auth: creds }
+      end
+    end
+
+    def soap_header(header)
+      define_method(:has_soap_header) do
+        { soap_header: header }
+      end
+    end
+
+    def encoding(enc)
+      define_method(:has_encoding) do
+        { encoding: enc }
+      end
+    end
+
+    def open_timeout(timeout)
+      define_method(:has_open_timeout) do
+        { open_timeout: timeout }
+      end
+    end
+
+    def read_timeout(timeout)
+      define_method(:has_read_timeout) do
+        { read_timeout: timeout }
+      end
+    end
+
+    def log_level(level)
+      define_method(:has_log_level) do
+        { log: true, log_level: level, pretty_print_xml: true }
+      end
+    end
+
+    def ssl_version(version)
+      define_method(:has_ssl_version) do
+        { ssl_version: version }
+      end
+    end
+
+    def ssl_verification(enable)
+      if enable
+        define_method(:has_ssl_verification) do
+          { ssl_verify_mode: true }
+        end
+      end
+    end
+  end
+end

data/lib/symbiont/version.rb

@@ -1,3 +1,3 @@
 module Symbiont
-  VERSION = '0.10.0'
+  VERSION = '0.11.0'
 end

data/lib/symbiont/workflows.rb

@@ -0,0 +1,88 @@
+module Symbiont
+  module WorkflowPaths
+    def paths
+      @paths
+    end
+
+    def paths=(path)
+      @paths = path
+    end
+
+    def path_data
+      @path_data
+    end
+
+    def path_data=(data)
+      @path_data = data
+    end
+  end
+
+  module Workflow
+    def self.included(caller)
+      caller.extend WorkflowPaths
+      @def_caller = caller
+    end
+
+    def self.def_caller
+      @def_caller
+    end
+
+    # Provides a workflow for a given workflow path, using a specific
+    # definition that is part of that workflow path.
+    #
+    # @param definition [Object] definition object using the workflow
+    # @param path_name [Hash] the name of the path to be used
+    # @param block [Proc] a block to be executed as part of the workflow
+    # @return [Object] the definition being interacted with
+    def workflow_for(definition, path_name = {:using => :default}, &block)
+      path_name[:using] = :default unless path_name[:using]
+      path_workflow = workflow_path_for(path_name)
+
+      workflow_goal = work_item_index_for(path_workflow, definition) - 1
+
+      if workflow_goal == -1
+        return on(definition, &block)
+      else
+        workflow_start = path_name[:from] ? path_workflow.find_index { |item| item[0] == path_name[:from] } : 0
+        perform_workflow(path_workflow[workflow_start..workflow_goal])
+      end
+
+      on(definition, &block)
+    end
+
+    private
+
+    def perform_workflow(definitions)
+      definitions.each do |definition, action, *args|
+        active = on(definition)
+
+        raise Symbiont::Errors::WorkflowActionNotFound,
+            "Workflow action '#{action}' not defined on #{definition}." unless active.respond_to? action
+
+        active.send action unless args
+        active.send action, *args if args
+      end
+    end
+
+    def workflow_path_for(path_name)
+      # Since I'm dealing with an array that contains a hash that, in turn,
+      # contains an array of arrays, I need to make sure that I index into
+      # the array before keying into the hash. That's the purpose of the [0].
+      path = Workflow.def_caller.paths[path_name[:using]]
+
+      raise Symbiont::Errors::WorkflowPathNotFound,
+          "Workflow path '#{path_name[:using].to_s}' not found." unless path
+
+      if Workflow.def_caller.path_data
+        file_to_load = Workflow.def_caller.path_data[path_name[:using]]
+        DataBuilder.load "#{file_to_load.to_s}.yml" if file_to_load
+      end
+
+      path
+    end
+
+    def work_item_index_for(path_workflow, definition)
+      path_workflow.find_index { |item| item[0] == definition }
+    end
+  end
+end

data/lib/symbiont.rb

@@ -12,12 +12,15 @@ require 'symbiont/assertions'
 require 'symbiont/pages'
 require 'symbiont/elements'
 require 'symbiont/accessor'
+require 'symbiont/workflows'
 require 'symbiont/factory'
 
 require 'symbiont/data_reader'
 require 'symbiont/data_setter'
 require 'symbiont/data_builder'
 
+require 'symbiont/service_objects'
+
 module Symbiont
   # @param caller [Class] the class including the framework
   def self.included(caller)

data/symbiont.gemspec

@@ -21,15 +21,15 @@ Gem::Specification.new do |spec|
     reuse, and less repetition.
 
     You can use Symbiont directly as an automated test library or you can
-    use it with other tools such as RSpec, Cucumber, or my own Lucid tool.
+    use it with other tools such as RSpec, Cucumber, or my own Specify tool.
   }
   spec.homepage      = 'https://github.com/jnyman/symbiont'
   spec.license       = 'MIT'
 
-  spec.files         = `git ls-files -z`.split("\x0")
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|specs|features)/})
-  spec.require_paths = %w(lib)
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
 
   spec.required_ruby_version     = '>= 2.0'
   spec.required_rubygems_version = '>= 1.8.29'
@@ -37,11 +37,13 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler', '~> 1.7'
   spec.add_development_dependency 'rake', '~> 10.0'
   spec.add_development_dependency 'rspec', '~> 3.1'
+  spec.add_development_dependency 'pry'
 
   spec.add_runtime_dependency 'colorize', '~> 0.7'
   spec.add_runtime_dependency 'watir-webdriver', '~> 0.6'
   spec.add_runtime_dependency 'watir-dom-wait'
   spec.add_runtime_dependency 'watir-scroll'
+  spec.add_runtime_dependency 'savon'
 
   spec.post_install_message = %{
 (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: symbiont
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Jeff Nyman
 autorequire: 
-bindir: bin
+bindir: exe
 cert_chain: []
-date: 2014-12-07 00:00:00.000000000 Z
+date: 2015-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: colorize
   requirement: !ruby/object:Gem::Requirement
@@ -108,6 +122,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: "\n    Symbiont is a framework that allows you to describe your application
   in\n    terms of activity and page definitions. Those definitions can then be\n
   \   referenced by test libraries using the DSL that Symbiont provides. The\n    DSL
@@ -116,20 +144,20 @@ description: "\n    Symbiont is a framework that allows you to describe your app
   fluent interface promotes the idea of\n    compressibility of your test logic, allowing
   for more factoring, more\n    reuse, and less repetition.\n\n    You can use Symbiont
   directly as an automated test library or you can\n    use it with other tools such
-  as RSpec, Cucumber, or my own Lucid tool.\n  "
+  as RSpec, Cucumber, or my own Specify tool.\n  "
 email:
 - jeffnyman@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".coveralls.yml"
 - ".gitignore"
-- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- bin/console
+- bin/setup
 - lib/symbiont.rb
 - lib/symbiont/accessor.rb
 - lib/symbiont/assertions.rb
@@ -141,28 +169,17 @@ files:
 - lib/symbiont/factory.rb
 - lib/symbiont/helpers.rb
 - lib/symbiont/pages.rb
+- lib/symbiont/service_objects.rb
+- lib/symbiont/soap_methods.rb
 - lib/symbiont/version.rb
-- spec/fixtures/default.yml
-- spec/fixtures/element_definitions.rb
-- spec/fixtures/mock_data.yml
-- spec/fixtures/mock_drivers.rb
-- spec/fixtures/page_definitions.rb
-- spec/spec_helper.rb
-- spec/symbiont/assertion_spec.rb
-- spec/symbiont/data_builder_spec.rb
-- spec/symbiont/data_setter_spec.rb
-- spec/symbiont/driver_spec.rb
-- spec/symbiont/element_spec.rb
-- spec/symbiont/factory_spec.rb
-- spec/symbiont/page_spec.rb
+- lib/symbiont/workflows.rb
 - symbiont.gemspec
-- test/symbiont-script.rb
 homepage: https://github.com/jnyman/symbiont
 licenses:
 - MIT
 metadata: {}
 post_install_message: "\n(::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::) (::)\n\n
-  \ Symbiont 0.10.0 has been installed.\n\n(::) (::) (::) (::) (::) (::) (::) (::)
+  \ Symbiont 0.11.0 has been installed.\n\n(::) (::) (::) (::) (::) (::) (::) (::)
   (::) (::) (::) (::)\n  "
 rdoc_options: []
 require_paths:
@@ -179,22 +196,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: 1.8.29
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
 summary: An Endosymbiotic Facultative Semantically Clean Fluent Interface Test Framework
-test_files:
-- spec/fixtures/default.yml
-- spec/fixtures/element_definitions.rb
-- spec/fixtures/mock_data.yml
-- spec/fixtures/mock_drivers.rb
-- spec/fixtures/page_definitions.rb
-- spec/spec_helper.rb
-- spec/symbiont/assertion_spec.rb
-- spec/symbiont/data_builder_spec.rb
-- spec/symbiont/data_setter_spec.rb
-- spec/symbiont/driver_spec.rb
-- spec/symbiont/element_spec.rb
-- spec/symbiont/factory_spec.rb
-- spec/symbiont/page_spec.rb
-- test/symbiont-script.rb
+test_files: []

data/.coveralls.yml

@@ -1 +0,0 @@
-service_name: 'travis-ci'

data/.travis.yml

@@ -1,24 +0,0 @@
-language: ruby
-
-rvm:
-  - 2.0.0
-  - 2.1.1
-  - jruby-19mode
-
-branches:
-  except:
-    - experimental
-
-branches:
-  only:
-    - master
-    - develop
-
-notifications:
-  recipients:
-    - jeffnyman@gmail.com
-
-matrix:
-  fast_finish: true
-  allow_failures:
-    - rvm: jruby-19mode

data/spec/fixtures/default.yml

@@ -1,3 +0,0 @@
-valid:
-  bank: BankCo
-  name: Jeff