chemlab 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a222da79b20553b786775c82b01e9a84c51f068818297704426366b808e196d
-  data.tar.gz: 99a1e05b09add1236903c8bf2935d4bc3c4b69192a6e6d3fb3bb5001168f8ea3
+  metadata.gz: b8768461aba3f55a80a1ef51e13b894d8f876343abb1a402c7de72e4fbfa4a9e
+  data.tar.gz: a3a48670a730d1d873ce671d94de87198478e54bfa2f29665aa2c05bf686f328
 SHA512:
-  metadata.gz: 0eebd3ac81a76497d753ed1dedc2a26d712328b8026ddb938911a26bd8519a09646ae2ff199b094976ec9b8c9dc4114a2138ceb69ee8bcbb42e0fbbeadb0101e
-  data.tar.gz: 87cc0eb243c2ffe942f4998cde1e981f275e4d7e372aa3480100a6ba9e106847f39c6bc15f477bd00b08f2e0c2a1011eee8741f69fa78f016fe0df4f15929ff9
+  metadata.gz: 9f6b5cd6c624455c9204da1815b891f65a97725309acf4157b280df795c56f072aa905ae3d48c75a3c42c7414bee7a3408d379dcfdbbc406eb1d849f6c4da3ed
+  data.tar.gz: 5cc500d4395d6470dc19cb4e250721d600d34e2f0f561410de26437490cf83d2529122c19d7da64ed7f17fd135f3fbfd93cfd01e90a253faae8b54956a7b2092

data/lib/chemlab/cli/new_library.rb

@@ -16,7 +16,7 @@ module Chemlab
           raise %(Cannot create new library `#{library_name}` as the directory "#{library_name}" already exists)
         end
 
-        require 'active_support/core_ext/string/inflections'
+        require 'chemlab/core_ext/string/inflections'
 
         @library = {
           name: library_name,

data/lib/chemlab/cli/stubber.rb

@@ -53,7 +53,7 @@ module Chemlab
 
             library = Stubber.libraries.last # last appended library is this Page Library
 
-            require 'active_support/core_ext/string/inflections'
+            require 'chemlab/core_ext/string/inflections'
 
             stub_path = @path.gsub(@path[@path.rindex('.')..], '.stub.rb')
             File.open(stub_path, 'w') do |stub|

data/lib/chemlab/core_ext/string/inflections.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Start monkey patch of Object::String
+class String
+  # Classify a string
+  # @example
+  #   'test_class'.classify #=> TestClass
+  # @example
+  #   'testclass'.classify #=> Testclass
+  def classify
+    split('_').map(&:capitalize).join
+  end
+
+  # Underscore a multi-worded string
+  # @example
+  #   'TestClass'.underscore #=> 'test_class'
+  # @example
+  #   'Class'.underscore #=> 'class'
+  def underscore
+    chars.each_with_object(+'') do |c, str|
+      str << '_' if c.match?(/[A-Z]/) && !str.size.zero?
+      str << c.downcase
+    end
+  end
+end

data/lib/chemlab/core_ext/string/root_module.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# Start monkey patch of String
+class String
+  # Find the root module (parent module) of a class or module
+  # @example
+  #   'A::B::C'.root_module #=> A
+  #   'A::B'.root_module => A
+  # @return [Module] the root module
+  def root_module
+    Object.const_get(split('::').first)
+  end
+end

data/lib/chemlab/library.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Chemlab
+  # Application Library Definition
+  # Provides accessors for +:base_url+, +:base_url=+
+  # +base_url+ will default to Chemlab's configured base_url
+  module Library
+    def self.included(base)
+      base.module_eval do
+        class << self
+          # The Base URL where this library / application exists
+          # If you have multiple applications that Chemlab will target,
+          # this is useful for having separate base_urls.
+          #
+          # @return [String] the base_url.  +Chemlab.configuration.base_url+ by default if not set
+          #
+          # @example
+          #   Chemlab.configure do |chemlab|
+          #     A.base_url = 'https://first_app'
+          #     B.base_url = 'https://second_app'
+          #     chemlab.base_url = 'https://main_app'
+          #
+          #     chemlab.libraries = [A, B, C]
+          #
+          #     C.base_url #=> https://main_app
+          #   end
+          attr_writer :base_url
+
+          def base_url
+            @base_url ||= Chemlab.configuration.base_url
+          end
+        end
+      end
+    end
+  end
+end

data/lib/chemlab/runtime/browser.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'forwardable'
+require 'chemlab/core_ext/string/root_module'
 
 module Chemlab
   module Runtime
@@ -17,13 +18,56 @@ module Chemlab
         @session = Session.new(browser_options)
       end
 
+      # Navigate to a given Page library
+      # @param [Class<Chemlab::Page>] page_class the class of the Page to navigate to
+      # @example
+      #   Given:
+      #     module TheLibrary
+      #       def self.base_url
+      #         'https://example.com'
+      #       end
+      #       class ThePage < Chemlab::Page
+      #         path '/path'
+      #       end
+      #     end
+      #
+      #   Chemlab::Runtime::Browser.navigate_to(TheLibrary::ThePage) #=> Navigates to https://example.com/path
+      #
+      # @example
+      #   Given:
+      #     Chemlab.configure do |chemlab|
+      #       chemlab.base_url = 'https://example.com'
+      #     end
+      #
+      #     class ThePage < Chemlab::Page
+      #       path '/'
+      #     end
+      #
+      #   Chemlab::Runtime::Browser.navigate_to(ThePage) #=> Navigates to https://example.com/path
       def self.navigate_to(page_class)
-        Chemlab.configuration.browser.navigate_to(page_class.path)
+        unless page_class&.name.respond_to?(:root_module)
+          return Chemlab.configuration.browser.navigate_to(Chemlab.configuration.base_url + page_class.path)
+        end
+
+        # workaround for file:// protocol.  URI.join() does not work with URI.join('file:///Users', '/user')
+        uri = if URI(page_class.name.root_module.base_url).scheme == 'file'
+                URI(File.join(page_class.name.root_module.base_url, page_class.path))
+              else
+                URI.join(page_class.name.root_module.base_url, page_class.path)
+              end
+
+        Chemlab.configuration.browser.navigate_to(uri)
       end
 
-      def navigate_to(path)
+      # Navigate to a URI or Path
+      # @param [URI,String] uri_or_path the URI or path
+      # @return [URI,String] the URI or Path that was navigated to
+      # @example
+      #   Chemlab.configuration.browser.navigate_to('/path') #=> /path
+      #   Chemlab.configuration.browser.navigate_to(URI('https://example.com/path')) #=> URI('https://example.com/path')
+      def navigate_to(uri_or_path)
         @session ||= Chemlab.configuration.browser.session
-        @session.engine.goto(Chemlab.configuration.base_url + path)
+        @session.engine.goto(uri_or_path.to_s)
       end
 
       # The options used to create the browser session

data/lib/chemlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Chemlab
-  VERSION = '0.7.0'
+  VERSION = '0.8.0'
 end

data/lib/chemlab.rb

@@ -34,6 +34,7 @@ module Chemlab
   autoload :Element, 'chemlab/element'
   autoload :Component, 'chemlab/component'
   autoload :Page, 'chemlab/page'
+  autoload :Library, 'chemlab/library'
 
   # Runtime modules
   module Runtime

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chemlab
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - GitLab Quality
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-01 00:00:00.000000000 Z
+date: 2021-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: climate_control
@@ -122,90 +122,94 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.9.26
-- !ruby/object:Gem::Dependency
-  name: activesupport-inflector
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: colorize
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: '0.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.1
+        version: '0.8'
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.10
+        version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.10
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 13.0.3
+        version: '12'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '12'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 13.0.3
+        version: '14'
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 4.0.0.beta4
+        version: '5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0.beta4
+        version: '3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
 - !ruby/object:Gem::Dependency
   name: watir
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 7.0.0.beta4
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 7.0.0.beta4
+        version: '8'
 description:
 email:
 - quality@gitlab.com
@@ -235,7 +239,10 @@ files:
 - lib/chemlab/cli/stubber.rb
 - lib/chemlab/component.rb
 - lib/chemlab/configuration.rb
+- lib/chemlab/core_ext/string/inflections.rb
+- lib/chemlab/core_ext/string/root_module.rb
 - lib/chemlab/element.rb
+- lib/chemlab/library.rb
 - lib/chemlab/page.rb
 - lib/chemlab/runtime/browser.rb
 - lib/chemlab/runtime/env.rb
@@ -258,7 +265,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.2
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="