capybara-ng 0.0.3

data/lib/angular/locator.rb

@@ -0,0 +1,347 @@
+module Angular
+module Locator
+  def binding
+<<-FN
+/**
+ * Find an element by binding.
+ *
+ * @view
+ * <span>{{person.name}}</span>
+ * <span ng-bind="person.email"></span>
+ *
+ * @example
+ * var span1 = element(by.binding('person.name'));
+ * expect(span1.getText()).toBe('Foo');
+ *
+ * var span2 = element(by.binding('person.email'));
+ * expect(span2.getText()).toBe('foo@bar.com');
+ *
+ * @param {string} bindingDescriptor
+ * @return {{findElementsOverride: findElementsOverride, toString: Function|string}}
+ */
+function(bindingDescriptor) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+          webdriver.By.js(clientSideScripts.findBindings,
+              bindingDescriptor, false, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.binding("' + bindingDescriptor + '")';
+    }
+  };
+};
+FN
+  end
+
+
+  def exactBinding
+<<-FN
+/**
+ * Find an element by exact binding.
+ *
+ * @view
+ * <span>{{ person.name }}</span>
+ * <span ng-bind="person-email"></span>
+ * <span>{{person_phone|uppercase}}</span>
+ *
+ * @example
+ * expect(element(by.exactBinding('person.name')).isPresent()).toBe(true);
+ * expect(element(by.exactBinding('person-email')).isPresent()).toBe(true);
+ * expect(element(by.exactBinding('person')).isPresent()).toBe(false);
+ * expect(element(by.exactBinding('person_phone')).isPresent()).toBe(true);
+ * expect(element(by.exactBinding('person_phone|uppercase')).isPresent()).toBe(true);
+ * expect(element(by.exactBinding('phone')).isPresent()).toBe(false);
+ *
+ * @param {string} bindingDescriptor
+ * @return {{findElementsOverride: findElementsOverride, toString: Function|string}}
+ */
+function(bindingDescriptor) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+          webdriver.By.js(clientSideScripts.findBindings,
+              bindingDescriptor, true, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.exactBinding("' + bindingDescriptor + '")';
+    }
+  };
+};
+FN
+  end
+
+  def model
+<<-FN
+/**
+ * Find an element by ng-model expression.
+ *
+ * @alias by.model(modelName)
+ * @view
+ * <input type="text" ng-model="person.name"/>
+ *
+ * @example
+ * var input = element(by.model('person.name'));
+ * input.sendKeys('123');
+ * expect(input.getAttribute('value')).toBe('Foo123');
+ *
+ * @param {string} model ng-model expression.
+ */
+function(model) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+          webdriver.By.js(
+              clientSideScripts.findByModel, model, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.model("' + model + '")';
+    }
+  };
+};
+FN
+  end
+
+  def buttonText
+<<-FN
+/**
+ * Find a button by text.
+ *
+ * @view
+ * <button>Save</button>
+ *
+ * @example
+ * element(by.buttonText('Save'));
+ *
+ * @param {string} searchText
+ * @return {{findElementsOverride: findElementsOverride, toString: Function|string}}
+ */
+function(searchText) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+          webdriver.By.js(clientSideScripts.findByButtonText,
+              searchText, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.buttonText("' + searchText + '")';
+    }
+  };
+};
+FN
+  end
+
+  def partialButtonText
+<<-FN
+/**
+ * Find a button by partial text.
+ *
+ * @view
+ * <button>Save my file</button>
+ *
+ * @example
+ * element(by.partialButtonText('Save'));
+ *
+ * @param {string} searchText
+ * @return {{findElementsOverride: findElementsOverride, toString: Function|string}}
+ */
+function(searchText) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+          webdriver.By.js(clientSideScripts.findByPartialButtonText,
+              searchText, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.partialButtonText("' + searchText + '")';
+    }
+  };
+};
+FN
+  end
+
+  def repeater
+<<-FN
+/**
+ * Find elements inside an ng-repeat.
+ *
+ * @view
+ * <div ng-repeat="cat in pets">
+ *   <span>{{cat.name}}</span>
+ *   <span>{{cat.age}}</span>
+ * </div>
+ *
+ * <div class="book-img" ng-repeat-start="book in library">
+ *   <span>{{$index}}</span>
+ * </div>
+ * <div class="book-info" ng-repeat-end>
+ *   <h4>{{book.name}}</h4>
+ *   <p>{{book.blurb}}</p>
+ * </div>
+ *
+ * @example
+ * // Returns the DIV for the second cat.
+ * var secondCat = element(by.repeater('cat in pets').row(1));
+ *
+ * // Returns the SPAN for the first cat's name.
+ * var firstCatName = element(by.repeater('cat in pets').
+ *     row(0).column('{{cat.name}}'));
+ *
+ * // Returns a promise that resolves to an array of WebElements from a column
+ * var ages = element.all(
+ *     by.repeater('cat in pets').column('{{cat.age}}'));
+ *
+ * // Returns a promise that resolves to an array of WebElements containing
+ * // all top level elements repeated by the repeater. For 2 pets rows resolves
+ * // to an array of 2 elements.
+ * var rows = element.all(by.repeater('cat in pets'));
+ *
+ * // Returns a promise that resolves to an array of WebElements containing all
+ * // the elements with a binding to the book's name.
+ * var divs = element.all(by.repeater('book in library').column('book.name'));
+ *
+ * // Returns a promise that resolves to an array of WebElements containing
+ * // the DIVs for the second book.
+ * var bookInfo = element.all(by.repeater('book in library').row(1));
+ *
+ * // Returns the H4 for the first book's name.
+ * var firstBookName = element(by.repeater('book in library').
+ *     row(0).column('{{book.name}}'));
+ *
+ * // Returns a promise that resolves to an array of WebElements containing
+ * // all top level elements repeated by the repeater. For 2 books divs
+ * // resolves to an array of 4 elements.
+ * var divs = element.all(by.repeater('book in library'));
+ */
+function(repeatDescriptor) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+        webdriver.By.js(clientSideScripts.findAllRepeaterRows,
+            repeatDescriptor, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.repeater("' + repeatDescriptor + '")';
+    },
+    row: function(index) {
+      return {
+        findElementsOverride: function(driver, using, rootSelector) {
+          return driver.findElements(
+            webdriver.By.js(clientSideScripts.findRepeaterRows,
+                repeatDescriptor, index, using, rootSelector));
+        },
+        toString: function toString() {
+          return 'by.repeater(' + repeatDescriptor + '").row("' + index + '")"';
+        },
+        column: function(binding) {
+          return {
+            findElementsOverride: function(driver, using, rootSelector) {
+              return driver.findElements(
+                  webdriver.By.js(clientSideScripts.findRepeaterElement,
+                      repeatDescriptor, index, binding, using, rootSelector));
+            },
+            toString: function toString() {
+              return 'by.repeater("' + repeatDescriptor + '").row("' + index +
+                '").column("' + binding + '")';
+            }
+          };
+        }
+      };
+    },
+    column: function(binding) {
+      return {
+        findElementsOverride: function(driver, using, rootSelector) {
+          return driver.findElements(
+              webdriver.By.js(clientSideScripts.findRepeaterColumn,
+                  repeatDescriptor, binding, using, rootSelector));
+        },
+        toString: function toString() {
+          return 'by.repeater("' + repeatDescriptor + '").column("' +
+            binding + '")';
+        },
+        row: function(index) {
+          return {
+            findElementsOverride: function(driver, using, rootSelector) {
+              return driver.findElements(
+                  webdriver.By.js(clientSideScripts.findRepeaterElement,
+                      repeatDescriptor, index, binding, using, rootSelector));
+            },
+            toString: function toString() {
+              return 'by.repeater("' + repeatDescriptor + '").column("' +
+                binding + '").row("' + index + '")';
+            }
+          };
+        }
+      };
+    }
+  };
+};
+FN
+  end
+
+  def cssContainingText
+<<-FN
+/**
+ * Find elements by CSS which contain a certain string.
+ *
+ * @view
+ * <ul>
+ *   <li class="pet">Dog</li>
+ *   <li class="pet">Cat</li>
+ * </ul>
+ *
+ * @example
+ * // Returns the DIV for the dog, but not cat.
+ * var dog = element(by.cssContainingText('.pet', 'Dog'));
+ */
+function(cssSelector, searchText) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+        webdriver.By.js(clientSideScripts.findByCssContainingText,
+        cssSelector, searchText, using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.cssContainingText("' + cssSelector + '", "' + searchText + '")';
+    }
+  };
+};
+FN
+  end
+
+  def options
+<<-FN
+/**
+ * Find an element by ng-options expression.
+ *
+ * @alias by.options(optionsDescriptor)
+ * @view
+ * <select ng-model="color" ng-options="c for c in colors">
+ *   <option value="0" selected="selected">red</option>
+ *   <option value="1">green</option>
+ * </select>
+ *
+ * @example
+ * var allOptions = element.all(by.options('c for c in colors'));
+ * expect(allOptions.count()).toEqual(2);
+ * var firstOption = allOptions.first();
+ * expect(firstOption.getText()).toEqual('red');
+ *
+ * @param {string} optionsDescriptor ng-options expression.
+ */
+function(optionsDescriptor) {
+  return {
+    findElementsOverride: function(driver, using, rootSelector) {
+      return driver.findElements(
+          webdriver.By.js(clientSideScripts.findByOptions, optionsDescriptor,
+              using, rootSelector));
+    },
+    toString: function toString() {
+      return 'by.option("' + optionsDescriptor + '")';
+    }
+  };
+};
+FN
+  end
+end
+end

data/lib/angular/setup.rb

@@ -0,0 +1,79 @@
+module Angular
+  class Setup
+    attr_reader :page
+
+    def initialize(page)
+      @page = page
+    end
+
+    def ng_wait
+      install
+      Waiter.new(self).wait_until_ready
+    end
+
+    def make_call(method, params, nodes)
+      ng_wait
+
+      js_params = params.map do |p|
+        if p.nil?
+          'null'
+        elsif p.is_a? String
+          escaped = p.gsub(/'/, "\\\\'").gsub(/"/, '\\\\"')
+          "'#{escaped}'"
+        else
+          p.to_s
+        end
+      end
+
+      js = "#{method}(#{js_params.join(', ')});"
+      logger.info js
+
+      js_result = page.evaluate_script(js);
+      logger.info js_result
+
+      if nodes
+        make_result method, params, js_result
+      else
+        js_result
+      end
+    end
+
+
+    def make_result(method, params, js_result)
+      if js_result.nil? || js_result.empty?
+        raise NotFound.new("#{method}: #{params.inspect}")
+      end
+
+      js_result.map do |el|
+        el ? Capybara::Selenium::Node.new(page.driver, el) : nil
+      end
+    end
+
+    def angular_app?
+      begin
+        js = "(typeof angular !== 'undefined') && "
+        js += "angular.element(document.querySelector('[ng-app], [data-ng-app]')).length > 0"
+        @page.evaluate_script js
+      rescue Capybara::NotSupportedByDriverError
+        false
+      end
+    end
+
+    def page_reloaded?
+      @page.evaluate_script("window.ngInstalled === undefined")
+    end
+
+    def mark_installed
+      @page.evaluate_script("window.ngInstalled = true")
+    end
+
+    def install
+      if page_reloaded?
+        ClientScript.window_scripts.each do |f|
+          @page.evaluate_script(f)
+        end
+        mark_installed
+      end
+    end
+  end
+end

data/lib/angular/version.rb

@@ -0,0 +1,3 @@
+module Angular
+  VERSION = "0.0.3"
+end

data/lib/angular/waiter.rb

@@ -0,0 +1,58 @@
+module Angular
+  class Waiter
+    def initialize(setup)
+      @setup = setup
+      @page = @setup.page
+    end
+
+    def wait_until_ready
+      return unless @setup.angular_app?
+
+      setup_waiter
+      start = Time.now
+      until ready?
+        timeout! if timeout?(start)
+        setup_waiter if @setup.page_reloaded?
+        sleep(0.01)
+      end
+    end
+
+    private
+
+    def timeout?(start)
+      Time.now - start > Capybara.default_wait_time
+    end
+
+    def timeout!
+      raise TimeoutError.new("timeout while waiting for angular")
+    end
+
+    def ready?
+      @page.evaluate_script("window.ngReady")
+    end
+
+    def setup_waiter
+      script = <<-JS
+        window.ngReady = false;
+        (function() {
+          var app = angular.element(document.querySelector('[ng-app], [data-ng-app]'));
+          var injector = app.injector();
+          var callback = function() {
+            window.ngReady = true;
+          };
+
+          try {
+            if (angular.getTestability) {
+              angular.getTestability(el).whenStable(callback);
+            } else {
+              injector.get('$browser').notifyWhenNoOutstandingRequests(callback);
+            }
+          } catch (e) {
+            callback(e);
+          }
+        })();
+      JS
+      @page.execute_script script
+    end
+  end
+end

data/lib/angular.rb

@@ -0,0 +1,11 @@
+require "angular/version"
+
+module Angular
+  class NotFound < StandardError
+  end
+end
+
+require 'angular/client_script'
+require 'angular/dsl'
+require 'angular/setup'
+require 'angular/waiter'

data/lib/capybara-ng.rb

@@ -0,0 +1 @@
+require_relative 'angular'

data/test/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gem 'capybara-ng', path: '..'

data/test/test.rb

@@ -0,0 +1,6 @@
+require 'capybara-ng'
+
+
+#puts Angular::ClientScript::functions.keys
+#puts Angular::ClientScript::format_scripts
+#puts Angular::ClientScript::window_scripts

metadata

@@ -0,0 +1,108 @@
+--- !ruby/object:Gem::Specification
+name: capybara-ng
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- kari
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+description: AngularJS bindings for capybara.
+email:
+- mr.kari.ikonen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-gemset"
+- ".ruby-version"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- capybara-ng.gemspec
+- lib/angular.rb
+- lib/angular/client_script.rb
+- lib/angular/driver.rb
+- lib/angular/dsl.rb
+- lib/angular/element_helper.rb
+- lib/angular/locator.rb
+- lib/angular/setup.rb
+- lib/angular/version.rb
+- lib/angular/waiter.rb
+- lib/capybara-ng.rb
+- test/Gemfile
+- test/test.rb
+homepage: https://github.com/kikonen/capybara-ng
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: AngularJS for capybara.
+test_files:
+- test/Gemfile
+- test/test.rb