testcentricity 2.4.1 → 3.0.0

data/spec/testcentricity/version_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+describe 'TestCentricity::VERSION', required: true do
+  subject { TestCentricity::VERSION }
+
+  it { is_expected.to be_truthy }
+end

data/spec/testcentricity/web/browser_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Browsers, web: true do
+  before(:context) do
+    # instantiate local test environment
+    @environs ||= EnvironData
+    @environs.find_environ('LOCAL', :yaml)
+    ENV['WEB_BROWSER'] = 'chrome_headless'
+  end
+
+  context 'web browser with multiple tabs/windows' do
+    it 'returns number of browser windows/tabs' do
+      WebDriverConnect.initialize_web_driver
+      Capybara.current_session.open_new_window
+      Capybara.current_session.open_new_window
+      expect(Browsers.num_browser_instances).to eql 3
+    end
+
+    it 'closes original browser instance' do
+      WebDriverConnect.initialize_web_driver
+      Capybara.current_session.open_new_window
+      Browsers.close_old_browser_instance
+      expect(Browsers.num_browser_instances).to eql 1
+    end
+
+    it 'closes current browser instance' do
+      WebDriverConnect.initialize_web_driver
+      Capybara.current_session.open_new_window
+      Browsers.switch_to_new_browser_instance
+      Capybara.current_session.open_new_window
+      Browsers.close_current_browser_instance
+      expect(Browsers.num_browser_instances).to eql 2
+    end
+  end
+
+  after(:each) do
+    Browsers.close_all_browser_instances
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+end

data/spec/testcentricity/web/local_webdriver_spec.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+describe TestCentricity::WebDriverConnect, web: true do
+  before(:context) do
+    # instantiate local test environment
+    @environs ||= EnvironData
+    @environs.find_environ('LOCAL', :yaml)
+    ENV['SELENIUM'] = ''
+  end
+
+  context 'local web browser instances' do
+    it 'connects to a local Firefox browser' do
+      ENV['WEB_BROWSER'] = 'firefox'
+      WebDriverConnect.initialize_web_driver
+      verify_local_browser(browser = :firefox, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local Safari browser' do
+      ENV['WEB_BROWSER'] = 'safari'
+      WebDriverConnect.initialize_web_driver
+      verify_local_browser(browser = :safari, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local Chrome browser' do
+      ENV['WEB_BROWSER'] = 'chrome'
+      WebDriverConnect.initialize_web_driver
+      Browsers.suppress_js_leave_page_modal
+      verify_local_browser(browser = :chrome, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local Edge browser' do
+      ENV['WEB_BROWSER'] = 'edge'
+      WebDriverConnect.initialize_web_driver
+      Browsers.suppress_js_alerts
+      verify_local_browser(browser = :edge, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local emulated mobile web browser' do
+      ENV['WEB_BROWSER'] = 'ipad_pro_12_9'
+      ENV['HOST_BROWSER'] = 'chrome'
+      ENV['ORIENTATION'] = 'portrait'
+      WebDriverConnect.initialize_web_driver
+      Browsers.set_device_orientation('landscape')
+      verify_local_browser(browser = :ipad_pro_12_9, platform = :mobile, headless = false)
+      expect(Environ.browser_size).to eq([1366, 1024])
+    end
+  end
+
+  context 'local headless browser instances' do
+    it 'connects to a local headless Chrome browser' do
+      ENV['WEB_BROWSER'] = 'chrome_headless'
+      WebDriverConnect.initialize_web_driver
+      Browsers.maximize_browser
+      verify_local_browser(browser = :chrome_headless, platform = :desktop, headless = true)
+    end
+
+    it 'connects to a local headless Edge browser' do
+      ENV['WEB_BROWSER'] = 'edge_headless'
+      WebDriverConnect.initialize_web_driver
+      Browsers.refresh_browser
+      verify_local_browser(browser = :edge_headless, platform = :desktop, headless = true)
+    end
+
+    it 'connects to a local headless Firefox browser' do
+      ENV['WEB_BROWSER'] = 'firefox_headless'
+      WebDriverConnect.initialize_web_driver
+      Browsers.delete_all_cookies
+      verify_local_browser(browser = :firefox_headless, platform = :desktop, headless = true)
+    end
+  end
+
+  after(:each) do
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+
+  def verify_local_browser(browser, platform, headless)
+    expect(Environ.browser).to eq(browser)
+    expect(Environ.platform).to eq(platform)
+    expect(Environ.headless).to eq(headless)
+    expect(Environ.session_state).to eq(:running)
+    expect(Environ.driver).to eq(:webdriver)
+    expect(Environ.device).to eq(:web)
+    expect(Environ.is_web?).to eq(true)
+  end
+end

data/spec/testcentricity/web/mobile_webdriver_spec.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+describe TestCentricity::WebDriverConnect, web: true do
+  before(:context) do
+    # instantiate local test environment
+    @environs ||= EnvironData
+    @environs.find_environ('LOCAL', :yaml)
+    ENV['SELENIUM'] = ''
+    ENV['WEB_BROWSER'] = 'appium'
+    ENV['DEVICE_TYPE'] = 'tablet'
+    # start Appium server
+    $server = TestCentricity::AppiumServer.new
+    $server.start
+  end
+
+  context 'Mobile device simulator' do
+    it 'connects to iOS Simulator - environment variables' do
+      ENV['AUTOMATION_ENGINE'] = 'XCUITest'
+      ENV['APP_PLATFORM_NAME'] = 'ios'
+      ENV['APP_BROWSER'] = 'Safari'
+      ENV['APP_VERSION'] = '15.4'
+      ENV['APP_DEVICE'] = 'iPad Pro (12.9-inch) (5th generation)'
+      WebDriverConnect.initialize_web_driver
+      expect(Environ.browser).to eq(:appium)
+      expect(Environ.platform).to eq(:mobile)
+      expect(Environ.headless).to eq(false)
+      expect(Environ.session_state).to eq(:running)
+      expect(Environ.driver).to eq(:appium)
+      expect(Environ.device).to eq(:simulator)
+      expect(Environ.device_name).to eq('iPad Pro (12.9-inch) (5th generation)')
+      expect(Environ.device_os).to eq(:ios)
+      expect(Environ.device_type).to eq(:tablet)
+      expect(Environ.device_os_version).to eq('15.4')
+      expect(Environ.is_ios?).to eq(true)
+    end
+
+    it 'connects to iOS Simulator - desired_capabilities hash' do
+      ENV['APP_PLATFORM_NAME'] = 'ios'
+      ENV['APP_BROWSER'] = 'Safari'
+      ENV['APP_VERSION'] = '15.4'
+      ENV['APP_DEVICE'] = 'iPad Pro (12.9-inch) (5th generation)'
+
+      caps = {
+        desired_capabilities: {
+          platformName: 'ios',
+          platformVersion: '15.4',
+          browserName: 'Safari',
+          deviceName: 'iPad Pro (12.9-inch) (5th generation)',
+          automationName: 'XCUITest'
+        }
+      }
+      WebDriverConnect.initialize_web_driver(caps)
+      expect(Environ.browser).to eq(:appium)
+      expect(Environ.platform).to eq(:mobile)
+      expect(Environ.headless).to eq(false)
+      expect(Environ.session_state).to eq(:running)
+      expect(Environ.driver).to eq(:appium)
+      expect(Environ.device).to eq(:simulator)
+      expect(Environ.device_name).to eq('iPad Pro (12.9-inch) (5th generation)')
+      expect(Environ.device_os).to eq(:ios)
+      expect(Environ.device_type).to eq(:tablet)
+      expect(Environ.device_os_version).to eq('15.4')
+      expect(Environ.is_ios?).to eq(true)
+    end
+
+    it 'connects to Android Simulator - environment variables' do
+      ENV['APP_PLATFORM_NAME'] = 'Android'
+      ENV['APP_BROWSER'] = 'Chrome'
+      ENV['APP_VERSION'] = '12.0'
+      ENV['APP_DEVICE'] = 'Pixel_C_API_31'
+      WebDriverConnect.initialize_web_driver
+      expect(Environ.browser).to eq(:appium)
+      expect(Environ.platform).to eq(:mobile)
+      expect(Environ.headless).to eq(false)
+      expect(Environ.session_state).to eq(:running)
+      expect(Environ.driver).to eq(:appium)
+      expect(Environ.device).to eq(:simulator)
+      expect(Environ.device_name).to eq('Pixel_C_API_31')
+      expect(Environ.device_os).to eq(:android)
+      expect(Environ.device_type).to eq(:tablet)
+      expect(Environ.device_os_version).to eq('12.0')
+      expect(Environ.is_android?).to eq(true)
+    end
+
+    it 'connects to Android Simulator - desired_capabilities hash' do
+      ENV['APP_PLATFORM_NAME'] = 'Android'
+      ENV['APP_BROWSER'] = 'Chrome'
+      ENV['APP_VERSION'] = '12.0'
+      ENV['APP_DEVICE'] = 'Pixel_C_API_31'
+
+      caps = {
+        desired_capabilities: {
+          platformName: 'Android',
+          platformVersion: '12.0',
+          browserName: 'Chrome',
+          deviceName: 'Pixel_C_API_31',
+          automationName: 'Android'
+        }
+      }
+      WebDriverConnect.initialize_web_driver(caps)
+      expect(Environ.browser).to eq(:appium)
+      expect(Environ.platform).to eq(:mobile)
+      expect(Environ.headless).to eq(false)
+      expect(Environ.session_state).to eq(:running)
+      expect(Environ.driver).to eq(:appium)
+      expect(Environ.device).to eq(:simulator)
+      expect(Environ.device_name).to eq('Pixel_C_API_31')
+      expect(Environ.device_os).to eq(:android)
+      expect(Environ.device_type).to eq(:tablet)
+      expect(Environ.device_os_version).to eq('12.0')
+      expect(Environ.is_android?).to eq(true)
+    end
+  end
+
+  after(:each) do
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+
+  after(:context) do
+    $server.stop if Environ.driver == :appium && $server.running?
+  end
+end

data/spec/testcentricity/web/page_object_spec.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+describe TestCentricity::PageObject, web: true do
+  before :context do
+    @test_page = TestPage.new
+  end
+
+  context 'page object traits' do
+    it 'returns page name' do
+      expect(@test_page.page_name).to eq('Basic Test Page')
+    end
+
+    it 'returns page url' do
+      expect(@test_page.page_url).to eq('/basic_test_page.html')
+    end
+
+    it 'returns page locator' do
+      expect(@test_page.page_locator).to eq('form#HTMLFormElements')
+    end
+
+    it 'determines if page is secure' do
+      allow(@test_page).to receive(:secure?).and_return(false)
+      expect(@test_page.secure?).to eq(false)
+    end
+
+    it 'should display the title of the page' do
+      allow(@test_page).to receive(:title).and_return('I am the title of a page')
+      expect(@test_page.title).to eql 'I am the title of a page'
+    end
+
+    it 'responds to open_portal' do
+      expect(@test_page).to respond_to(:open_portal)
+    end
+
+    it 'responds to load_page' do
+      expect(@test_page).to respond_to(:load_page)
+    end
+
+    it 'responds to verify_page_exists' do
+      expect(@test_page).to respond_to(:verify_page_exists)
+    end
+
+    it 'responds to exists?' do
+      expect(@test_page).to respond_to(:exists?)
+    end
+  end
+
+  context 'page object with UI elements' do
+    it 'responds to element' do
+      expect(@test_page).to respond_to(:element1)
+    end
+
+    it 'responds to button' do
+      expect(@test_page).to respond_to(:button1)
+    end
+
+    it 'responds to textfield' do
+      expect(@test_page).to respond_to(:field1)
+    end
+
+    it 'responds to link' do
+      expect(@test_page).to respond_to(:link1)
+    end
+
+    it 'responds to range' do
+      expect(@test_page).to respond_to(:range1)
+    end
+
+    it 'responds to image' do
+      expect(@test_page).to respond_to(:image1)
+    end
+
+    it 'responds to radio' do
+      expect(@test_page).to respond_to(:radio1)
+    end
+
+    it 'responds to checkbox' do
+      expect(@test_page).to respond_to(:check1)
+    end
+
+    it 'responds to section' do
+      expect(@test_page).to respond_to(:section1)
+    end
+  end
+end

data/spec/testcentricity/web/page_section_object_spec.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+describe TestCentricity::PageSection, web: true do
+  before :context do
+    @test_page = TestPage.new
+    @test_section = @test_page.section1
+  end
+
+  context 'section object traits' do
+    it 'returns section name' do
+      expect(@test_section.section_name).to eq('Basic Test Section')
+    end
+
+    it 'returns section locator' do
+      expect(@test_section.get_locator).to eq('div#section')
+    end
+
+    it 'returns class' do
+      expect(@test_section.class).to eql TestPageSection
+    end
+
+    it 'returns css locator type' do
+      expect(@test_section.get_locator_type).to eql :css
+    end
+
+    it 'registers with type section' do
+      expect(@test_section.get_object_type).to eql :section
+    end
+
+    it 'returns parent list object' do
+      expect(@test_section.get_parent_list).to eql nil
+    end
+  end
+
+  context 'section object with UI elements' do
+    it 'responds to element' do
+      expect(@test_section).to respond_to(:element1)
+    end
+
+    it 'responds to button' do
+      expect(@test_section).to respond_to(:button1)
+    end
+
+    it 'responds to textfield' do
+      expect(@test_section).to respond_to(:field1)
+    end
+
+    it 'responds to link' do
+      expect(@test_section).to respond_to(:link1)
+    end
+
+    it 'responds to range' do
+      expect(@test_section).to respond_to(:range1)
+    end
+
+    it 'responds to image' do
+      expect(@test_section).to respond_to(:image1)
+    end
+
+    it 'responds to radio' do
+      expect(@test_section).to respond_to(:radio1)
+    end
+
+    it 'responds to checkbox' do
+      expect(@test_section).to respond_to(:check1)
+    end
+
+    it 'responds to section' do
+      expect(@test_section).to respond_to(:section2)
+    end
+  end
+end

data/testcentricity.gemspec

@@ -7,41 +7,42 @@ Gem::Specification.new do |spec|
   spec.name          = 'testcentricity'
   spec.version       = TestCentricity::VERSION
   spec.platform      = Gem::Platform::RUBY
-  spec.required_ruby_version = '>= 2.3.0'
+  spec.required_ruby_version = '>= 2.7.5'
   spec.authors       = ['A.J. Mrozinski']
   spec.email         = ['testcentricity@gmail.com']
-  spec.summary       = %q{A Page Object and Data Object Model Framework for desktop/mobile web and native mobile app testing}
-  spec.description   = %q{
-    The TestCentricity™ core generic framework for desktop/mobile web and native mobile app testing implements a Page Object Model DSL
-    for use with Cucumber, Capybara, Appium, and Selenium-Webdriver. The TestCentricity™ gem supports running automated tests
-    against locally hosted desktop browsers (Firefox, Chrome, Safari, or IE), locally hosted emulated mobile browsers (iOS,
-    Android, Windows Phone, Blackberry, Kindle Fire) running within a locally hosted instance of Chrome, a "headless" browser (using
-    Poltergeist and PhantomJS), mobile Safari browsers on iOS device simulators or physical iOS devices  (using Appium and XCode on
-    OS X), mobile Chrome or Android browsers on Android Studio virtual device emulators (using Appium and Android Studio on OS X),
-    or cloud hosted desktop or mobile web browsers (using the BrowserStack, Sauce Labs, CrossBrowserTesting, or TestingBot services).}
-  spec.homepage      = ''
-  spec.license       = 'BSD-3-Clause-Clear'
+  spec.summary       = %q{A Page Object Model Framework for desktop/mobile web and native mobile app testing}
+  spec.description   = '
+    The TestCentricity™ core framework for native mobile iOS and Android apps and desktop/mobile web testing implements a Page Object
+    Model DSL for use with Cucumber, Appium, Capybara, and Selenium-Webdriver v4.x. The gem also facilitates the configuration of the
+    appropriate Appium capabilities required to establish a connection with locally or cloud (using BrowserStack, Sauce Labs, or
+    TestingBot services) hosted iOS or Android devices or simulators. For more information on desktop/mobile web testing with this
+    gem, refer to docs for the TestCentricity™ Web gem (https://www.rubydoc.info/gems/testcentricity_web).'
+  spec.homepage      = 'https://github.com/TestCentricity/testcentricity'
+  spec.license       = 'BSD-3-Clause'
+  spec.metadata = {
+    'changelog_uri' => 'https://github.com/TestCentricity/testcentricity/blob/main/CHANGELOG.md',
+    'documentation_uri' => 'https://www.rubydoc.info/gems/testcentricity'
+  }
 
   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|features)/})
   spec.require_paths = ['lib']
-  spec.requirements  << 'Capybara, Appium, Selenium-WebDriver'
+  spec.requirements  << 'Appium, TestCentricity Web'
 
-  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'cucumber'
+  spec.add_development_dependency 'cuke_modeler', '~> 3.0'
+  spec.add_development_dependency 'curb'
+  spec.add_development_dependency 'json'
+  spec.add_development_dependency 'parallel_tests'
   spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'require_all', '=1.5.0'
+  spec.add_development_dependency 'rspec', '~> 3.10'
+  spec.add_development_dependency 'simplecov', ['~> 0.18']
+  spec.add_development_dependency 'yard', ['>= 0.9.0']
 
-  spec.add_dependency 'capybara', ['>= 2.15', '< 3.0']
-  spec.add_dependency 'test-unit'
-  spec.add_dependency 'selenium-webdriver', ['>= 2.50.0', '< 3.0']
-  spec.add_dependency 'poltergeist'
-  spec.add_dependency 'faker'
-  spec.add_dependency 'chronic', '0.10.2'
-  spec.add_dependency 'spreadsheet', '1.1.1'
-  spec.add_dependency 'os'
-  spec.add_dependency 'i18n'
-  spec.add_dependency 'browserstack-local'
-  spec.add_dependency 'appium_lib'
-
-  spec.add_runtime_dependency 'childprocess', '~> 0.5'
+  spec.add_runtime_dependency 'appium_lib'
+  spec.add_runtime_dependency 'testcentricity_web', '>= 4.2.2'
+  spec.add_runtime_dependency 'test-unit'
 end