so_many_devices 0.1.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4563bbece97b6bd3ec50f380fc87a52098e4fc70b80bfe6c894e3e3fe1d7d22
-  data.tar.gz: ffcfe67293875045e902364d374786ee67bdcaa1b00125dbb52146785bfdfca3
+  metadata.gz: 2083f8748f8786c8ec499d5f9a67b6d97d5fc5080c3c7bfb82ee2217bb9ae515
+  data.tar.gz: '09eb90cbaac0a1ae8d4f2c4dac0dc5e96306bd03bea6d2f6dd8b24fc0b475f7f'
 SHA512:
-  metadata.gz: 9d3ab569ad319c3ed04f50d614041bc40500e7116145be28df9ad49565c28fd3a34bafc6d3f88f09e12a26d1f7a44656279863bd757f7f44480d04c49a81de2d
-  data.tar.gz: e77cb90c14a71bcf687ed62895601ce862daeaac9b17f236973b0f69c08c989a7d268d979fc5de25fe9e41c49ae76d9b759a6f50e58c3290afa556918cc1ec45
+  metadata.gz: ef4f46954c438c4be338b370918fed154e2f9dde3d51e765d40ec5ed489c63c827af69f3eb3c432f003deb028dcd58b117ba57fc7d9754599d10e2dbc3e4622b
+  data.tar.gz: 2b2509f8b113fea58f28010997f90f58d7d73f365e49b45db826a3dc0a80e5261b04fd1ee5729410cf0c9532ee9ae4d3ab4f04f1e7af80a57e999b7e53950e23

data/.gitignore

@@ -9,3 +9,4 @@
 
 # rspec failure tracking
 .rspec_status
+Gemfile.lock

data/.semaphore/main-deploy.yml

@@ -0,0 +1,19 @@
+version: v1.0
+name: main-deploy
+agent:
+  machine:
+    type: e1-standard-2
+    os_image: ubuntu1804
+
+blocks:
+  - name: main-deploy
+    task:
+      secrets:
+        - name: rubygems-deploy
+      jobs:
+        - name: main-deploy
+          commands:
+            - checkout --use-cache
+            - gem build so_many_devices
+            - chmod 0600 ~/.gem/credentials
+            - gem push so_many_devices-*.gem

data/.semaphore/semaphore.yml

@@ -0,0 +1,31 @@
+version: "v1.0"
+name: so_many_devices
+agent:
+  machine:
+    type: e1-standard-2
+    os_image: ubuntu1804
+auto_cancel:
+  running:
+    when: "true"
+
+blocks:
+  - name: tests
+    execution_time_limit:
+      minutes: 10
+    dependencies: []
+    task:
+      env_vars:
+        - name: RAILS_ENV
+          value: test
+      jobs:
+        - name: tests
+          commands:
+            - checkout --use-cache
+            - cache restore
+            - bundle install -j 4 --path vendor/bundle
+            - cache store
+            - bundle exec standardrb
+            - bundle exec rspec
+promotions:
+  - name: main
+    pipeline_file: main-deploy.yml

data/CHANGELOG.md

@@ -0,0 +1,13 @@
+## [0.3.0] - 2023-01-25
+
+- Added two new methods `first_download` and `last_download`.
+- Added more instructions to the README for Chrome with downloads options, in particular to clean up folders.
+- Added an example to read a downloaded file
+
+## [0.2.0] - 2020-06-18
+
+- Add chrome with downloads capabilities to the list of already so many devices
+
+## [0.1.0] - 2020-03-02
+
+- Initial release

data/README.md

@@ -1,5 +1,7 @@
 # So Many Devices! 🕺
 
+[![status](https://renuo.semaphoreci.com/badges/so_many_devices.svg)](https://renuo.semaphoreci.com/projects/so_many_devices)
+
 This gem provides a list of Capybara Selenium configurations that you can use.
 Probably useful to run your system tests on different devices.
 
@@ -29,7 +31,7 @@ In your `rails_helper.rb` you can configure your preferred device for tests:
 
 ```ruby
 config.before(:each, type: :system, js: true) do
-    driven_by :iphone_6_7_8
+  driven_by :iphone_6_7_8
 end
 ```
 
@@ -37,7 +39,7 @@ You can always use the headless version of each device by appending `_headless`
 
 ```ruby
 config.before(:each, type: :system, js: true) do
-    driven_by :iphone_6_7_8_headless
+  driven_by :iphone_6_7_8_headless
 end
 ```
 
@@ -45,7 +47,7 @@ We use it to run our system tests on so many devices! Here is our standard confi
 
 ```ruby
 config.before(:each, type: :system, js: true) do
-    driven_by ENV['SELENIUM_DRIVER'].to_sym
+  driven_by ENV['SELENIUM_DRIVER'].to_sym
 end
 ```
 
@@ -60,7 +62,63 @@ of course, your tests need to run on so many devices!
  
 ## Available devices
 
-Check [the YML file containing all the devices](./lib/so_many_devices/so_many_devices.yml). So many!
+Check [the YML file containing all the devices](./lib/so_many_devices.yml). So many!
+
+## Chrome with downloads capabilities
+
+We provide also an instance of Chrome already configured with 
+Downloads capabilities and a `SoManyDevices::DownloadsHelper` that you can use in your project.
+
+Use the following:
+
+```ruby
+config.before(:each, type: :system, js: true) do
+  driven_by :selenium_chrome_with_download_headless # or non-headless version
+end
+
+config.after(:each, type: :system, js: true) do
+  clear_downloads
+end
+
+config.include SoManyDevices::DownloadsHelper, type: :system
+```
+
+and in your test (just an example...):
+
+```ruby
+it 'can download a file', :js do
+  visit funny_page_path
+  click_link 'Download PDF'
+  wait_for_download
+  expect(downloads.length).to eq(1)
+  expect(last_download).to match(/.*\.pdf/)
+  last_pdf = File.read(last_download)
+end
+```
+
+If you prefer to use this driver only on selected tests, you can use the following:
+
+```ruby
+config.before(:each, type: :system, js: true, with_downloads: true) do
+  driven_by :selenium_chrome_with_download_headless
+end
+
+config.after(:each, type: :system, js: true, with_downloads: true) do
+  clear_downloads
+end
+
+config.include SoManyDevices::DownloadsHelper, type: :system
+```
+
+and in your test (just an example...):
+
+```ruby
+it 'can download a file', :js, :with_downloads do
+end
+```
+
+The call to `clear_downloads` makes sure that all the downloads are removed from the downloads folder.
+All downloads are performed in the `tmp/downloads` folder of your project.
 
 ## Development
 
@@ -73,8 +131,8 @@ which will create a git tag for the version, push git commits and tags, and push
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/renuo/so_many_devices. 
-This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/renuo/so_many_devices/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at <https://github.com/renuo/so_many_devices>. 
+This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/renuo/so_many_devices/blob/main/CODE_OF_CONDUCT.md).
 
 Do you think our devices are not that many? 😡
 
@@ -86,9 +144,9 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the SoManyDevices project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/renuo/so_many_devices/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the SoManyDevices project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/renuo/so_many_devices/blob/main/CODE_OF_CONDUCT.md).
 
 
 ## Special Thanks
 
-[![Renuo AG](/logo/renuo.png)](https://renuo.ch)
+[![Renuo AG](./logo/renuo.png)](https://www.renuo.ch)

data/Rakefile

@@ -3,4 +3,4 @@ require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task :default => :spec
+task default: :spec

data/lib/so_many_devices/downloads_helper.rb

@@ -0,0 +1,45 @@
+module SoManyDevices
+  module DownloadsHelper
+    TIMEOUT = 10
+    PATH = "#{Dir.pwd}/tmp/downloads"
+
+    def downloads
+      Dir["#{PATH}/*"]
+    end
+
+    def download
+      downloads.first
+    end
+
+    def first_download
+      downloads.first
+    end
+
+    def last_download
+      downloads.last
+    end
+
+    def download_content
+      wait_for_download
+      File.read(download)
+    end
+
+    def wait_for_download
+      Timeout.timeout(TIMEOUT) do
+        sleep 0.1 until downloaded?
+      end
+    end
+
+    def downloaded?
+      !downloading? && downloads.any?
+    end
+
+    def downloading?
+      downloads.grep(/\.crdownload$/).any?
+    end
+
+    def clear_downloads
+      FileUtils.rm_f(downloads)
+    end
+  end
+end

data/lib/so_many_devices/version.rb

@@ -1,3 +1,3 @@
 module SoManyDevices
-  VERSION = "0.1.0"
+  VERSION = "1.0.0"
 end

data/lib/so_many_devices.rb

@@ -1,23 +1,34 @@
 require "so_many_devices/version"
+require "so_many_devices/downloads_helper"
+require "yaml"
+require "capybara"
 
 module SoManyDevices
-  class Error < StandardError;
-  end
+  class Error < StandardError; end
 
-  devices = YAML::load_file(File.join(__dir__, 'so_many_devices.yml'))
+  devices = YAML.load_file(File.join(__dir__, "so_many_devices.yml"))
 
   devices.each do |device_name, options|
-    standard_args = ['--disable-site-isolation-trials']
-    headless_args = ['--headless', '--disable-site-isolation-trials']
-    headless_args << '--disable-gpu' if Gem.win_platform?
+    standard_args = ["--disable-site-isolation-trials"]
+    headless_args = ["--headless", "--disable-site-isolation-trials"]
+    headless_args << "--disable-gpu" if Gem.win_platform?
 
-    [[device_name.to_sym, standard_args], ["#{device_name}_headless".to_sym, headless_args]].each do |device_name, args|
+    [[device_name, standard_args], ["#{device_name}_headless", headless_args]].each do |device_name, args|
       Capybara.register_driver device_name.to_sym do |app|
         capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
-            'goog:chromeOptions' => { args: args, mobileEmulation: options }
+          "goog:chromeOptions" => {args: args, mobileEmulation: options}
         )
         Capybara::Selenium::Driver.new(app, browser: :chrome, desired_capabilities: capabilities)
       end
     end
+
+    [[:selenium_chrome_with_download, standard_args], [:selenium_chrome_with_download_headless, headless_args]].each do |device_name, args|
+      Capybara.register_driver device_name do |app|
+        browser_options = ::Selenium::WebDriver::Chrome::Options.new(args: args)
+        browser_options.add_preference(:download, prompt_for_download: false, default_directory: SoManyDevices::DownloadsHelper::PATH.to_s)
+        browser_options.add_preference(:browser, set_download_behavior: {behavior: "allow"})
+        Capybara::Selenium::Driver.new(app, browser: :chrome, options: browser_options)
+      end
+    end
   end
 end

data/so_many_devices.gemspec

@@ -1,27 +1,30 @@
-require_relative 'lib/so_many_devices/version'
+require_relative "lib/so_many_devices/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = "so_many_devices"
-  spec.version       = SoManyDevices::VERSION
-  spec.authors       = ["Alessandro Rodi"]
-  spec.email         = ["coorasse@gmail.com"]
+  spec.name = "so_many_devices"
+  spec.version = SoManyDevices::VERSION
+  spec.authors = ["Alessandro Rodi"]
+  spec.email = ["coorasse@gmail.com"]
 
-  spec.summary       = %q{A list of configurations for so many devices!}
-  spec.description   = %q{This incomplete but very satisfying list of devices, will help you run your app on so many devices!}
-  spec.homepage      = "https://github.com/renuo/so_many_devices"
-  spec.license       = "MIT"
+  spec.summary = "A list of configurations for so many devices!"
+  spec.description = "This incomplete but very satisfying list of devices, will help you run your app on so many devices!"
+  spec.homepage = "https://github.com/renuo/so_many_devices"
+  spec.license = "MIT"
   spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
 
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/renuo/so_many_devices"
-  spec.metadata["changelog_uri"] = "https://github.com/renuo/so_many_devices/CHANGELOG.md"
+  spec.metadata["changelog_uri"] = "https://github.com/renuo/so_many_devices/blob/main/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
+
+  spec.add_dependency "capybara", ">= 3.0"
+  spec.add_development_dependency "standard"
 end

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: so_many_devices
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Alessandro Rodi
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-03-02 00:00:00.000000000 Z
-dependencies: []
+date: 2023-01-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: standard
+  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'
 description: This incomplete but very satisfying list of devices, will help you run
   your app on so many devices!
 email:
@@ -20,7 +48,10 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".semaphore/main-deploy.yml"
+- ".semaphore/semaphore.yml"
 - ".travis.yml"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
@@ -30,6 +61,7 @@ files:
 - bin/setup
 - lib/so_many_devices.rb
 - lib/so_many_devices.yml
+- lib/so_many_devices/downloads_helper.rb
 - lib/so_many_devices/version.rb
 - logo/renuo.png
 - so_many_devices.gemspec
@@ -39,8 +71,8 @@ licenses:
 metadata:
   homepage_uri: https://github.com/renuo/so_many_devices
   source_code_uri: https://github.com/renuo/so_many_devices
-  changelog_uri: https://github.com/renuo/so_many_devices/CHANGELOG.md
-post_install_message: 
+  changelog_uri: https://github.com/renuo/so_many_devices/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -55,8 +87,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 3.3.10
+signing_key:
 specification_version: 4
 summary: A list of configurations for so many devices!
 test_files: []