page_magic 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4acdbbbed10c450234259833ff79fc6fe45ba7f8
-  data.tar.gz: 3167a8d0be893169dac91a1f449f9713a057189e
+  metadata.gz: 5de023c943b2c64e2b8bf0a74d4c3875be2b74c5
+  data.tar.gz: 2d3d1baf2f1f14965f7ac9d7825663cc3e329105
 SHA512:
-  metadata.gz: cd8232c273a46b22c349e8819da69f3d12680443bf3493334f0ab549698656d27ab98ddbd0ec0d2957b93038e7ec7735c9dfbfcef831aa20823b0f7cbf39ca18
-  data.tar.gz: be986a4a47b5645fb9629a6c695d090de31c0c969a82bff6f23cbef482cca57ca504acc27002a3de98fe6eafd432726a1d3f41197855e8023a9362c65f718526
+  metadata.gz: 60c8b45cc4c56a0aac851a892b30710e8bfd0ccb962f985813289ca397d031b2ce68592558b56972f1538abd6cbcaeb44b82f459b32a866fe5a0e17e9fd779bc
+  data.tar.gz: 0e6222727b66e406d2dd1f365af3c46591f3189633b337832242209b9db41aaf0c3be39a12b4f1fca3fbcba6bd40102553bcf498b19907d23f65c2ffc36cd3a0

data/README.md

@@ -39,6 +39,7 @@ we are not aware of so your feedback/pull requests are greatly appreciated!
 - [Page mapping](#page-mapping)
   - [Mapping against query string parameters](#mapping-against-query-string-parameters)
   - [Mapping against fragment identifiers](#mapping-against-fragment-identifiers)
+- [Loading pages from source](#loading-pages-from-source)
 - [Watchers](#watchers)
   - [Method watchers](#method-watchers)
   - [Simple watchers](#simple-watchers)
@@ -316,6 +317,18 @@ against URL fragments.
 browser.define_page_mappings PageMagic.mapping(fragment: string_or_regex) => ResultsPage                            
 ```
 
+# Loading pages from source
+PageMagic supports loading page objects using html source. This technique can be useful for getting quick feedback that 
+your templates correctly render based on your view objects. I.e you can test your templates in isolation.
+```ruby
+class MyPage
+  include PageMagic
+  #element definitions
+end
+
+page_instance = Page.load(html_string)
+```
+
 # Watchers
 PageMagic lets you set a watcher on any element. Use watchers to decide when things have changed. The `watch` method can be called from anywhere within an element definition. For PageObjects it can only be called from within hooks and helper methods.
 

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

data/lib/page_magic/class_methods.rb

@@ -4,6 +4,13 @@ module PageMagic
     # Default block to be run when a page is loaded. This is used if a specific handler is not registered
     DEFAULT_ON_LOAD = proc {}
 
+    # create an new page object instance based on top of the source supplied
+    # @param [String] source html source code
+    # @return [Object<InstanceMethods>] instance of class with all the same methods as normal PageMagic page objects.
+    def load(source)
+      new(Session.new(Capybara::Node::Simple.new(source)))
+    end
+
     # sets block to run when page has loaded
     # if one has not been set on the page object class it will return a default block that does nothing
     def on_load(&block)

data/page_magic.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: page_magic 1.1.0 ruby lib
+# stub: page_magic 1.2.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "page_magic"
-  s.version = "1.1.0"
+  s.version = "1.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Leon Davis"]
-  s.date = "2015-11-25"
+  s.date = "2015-11-26"
   s.description = "Framework for modeling and interacting with webpages which wraps capybara"
   s.email = "info@lad-tech.com"
   s.extra_rdoc_files = [
@@ -86,7 +86,7 @@ Gem::Specification.new do |s|
   s.homepage = "https://github.com/ladtech/page_magic"
   s.licenses = ["ruby"]
   s.required_ruby_version = Gem::Requirement.new(">= 2.1")
-  s.rubygems_version = "2.2.2"
+  s.rubygems_version = "2.4.8"
   s.summary = "Framework for modeling and interacting with webpages"
 
   if s.respond_to? :specification_version then

data/spec/page_magic/class_methods_spec.rb

@@ -7,6 +7,21 @@ module PageMagic
       end
     end
 
+    describe '#load' do
+      let(:page_title) { 'page title' }
+      let(:page_source) do
+        <<-HTML
+          <html>
+            <head><title>#{page_title}</title></head>
+          </html>
+        HTML
+      end
+
+      it 'returns an instance using that source' do
+        expect(subject.load(page_source).title).to eq(page_title)
+      end
+    end
+
     describe 'on_load' do
       context 'block not set' do
         it 'returns a default block' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: page_magic
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Leon Davis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-25 00:00:00.000000000 Z
+date: 2015-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -199,7 +199,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Framework for modeling and interacting with webpages