so_many_devices 0.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c89db46b332aab888e79736d583df4b7897354fa0d5eb7d400ed9518e3ea5c9
-  data.tar.gz: dd7d100ca70832f4cd6fdba1ba3c090893a08de58c7a259b08ac3636ff4bf7ab
+  metadata.gz: 15b6efb219438698be4a46e590cce66fdb663a413edd09d9cb2a1ce2e7a7ef63
+  data.tar.gz: 97ac505a5cd73539560f53732abc61c262c2a025983c54470cd97a86a0768e16
 SHA512:
-  metadata.gz: f819f293cf1f3548930378db087c0329a1d93136e29ae62213a970217622e65be0bc56fe73bf075786fea0dfdea6a9e376a5ee0c4e08cb67b8d8e0cce33c1318
-  data.tar.gz: d4ade32037dbda8691bcf4a60d93d3088cc5337994dfa1c1d63589aaa4263689e1b2d693864a93db198c55458ac3b447d3265726ad4c33bc9c8c47f96d9144cc
+  metadata.gz: 0d67c72914f145926dda6f5478fe91cb5460cd2bbe669dea37f6e9ab8c134f5aa65826de3ce2ea0acd3db4abc67787a29d8e34c354a5fb5002fc4b27237cf157
+  data.tar.gz: de20ca536bfa8216233c04c64c798ce27e9dd8ee52768ca3d196cf87f41089b865404932f361e36b00d12e5a86225712759c89ef21ed110d525215da100263ba

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [2.0.0] - 2026-11-06
+
+- **Breaking**: require Ruby 3.3 or newer.
+- **Breaking**: all drivers run Chrome with `--force-prefers-reduced-motion`.
+- Fix device drivers on Selenium 4, which no longer provides `Remote::Capabilities.chrome` and `desired_capabilities:`.
+- Register the Chrome drivers with downloads only once, instead of once per device.
+- Release from Semaphore when a version tag is pushed.
+
+## [1.0.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

@@ -43,6 +43,9 @@ config.before(:each, type: :system, js: true) do
 end
 ```
 
+All drivers run Chrome with `--force-prefers-reduced-motion`, so pages honouring `prefers-reduced-motion`
+skip their animations and transitions, which makes tests faster and less flaky.
+
 We use it to run our system tests on so many devices! Here is our standard configuration:
 
 ```ruby
@@ -76,6 +79,10 @@ 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
 ```
 
@@ -87,24 +94,60 @@ it 'can download a file', :js do
   click_link 'Download PDF'
   wait_for_download
   expect(downloads.length).to eq(1)
-  expect(download).to match(/.*\.pdf/)
+  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
 
-After checking out the repo, run `bin/setup` to install dependencies. 
-Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+After checking out the repo, run `bin/setup` to install dependencies.
+Then, run `bin/check` to run the tests and `bin/fastcheck` to run the linter.
+You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+### Release
+
+1. Bump the version in `lib/so_many_devices/version.rb`, run `bundle install`, update `CHANGELOG.md` and commit to `main`.
+2. Tag the commit with the bare version and push the tag:
+
+   ```bash
+   git tag -a 1.2.3 -m 1.2.3
+   git push origin 1.2.3
+   ```
+
+3. Create a GitHub release for the tag with the changelog section as notes.
 
-To install this gem onto your local machine, run `bundle exec rake install`. 
-To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, 
-which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+Semaphore runs the tests on the tag and, when they pass, promotes the `release` pipeline, which pushes the gem to
+[rubygems.org](https://rubygems.org). It fails when the tag does not match the gem version.
 
 ## 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).
+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? 😡
 
@@ -116,7 +159,7 @@ 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

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

@@ -11,6 +11,14 @@ module SoManyDevices
       downloads.first
     end
 
+    def first_download
+      downloads.first
+    end
+
+    def last_download
+      downloads.last
+    end
+
     def download_content
       wait_for_download
       File.read(download)

data/lib/so_many_devices/version.rb

@@ -1,3 +1,3 @@
 module SoManyDevices
-  VERSION = "0.2.0"
+  VERSION = "2.0.0"
 end

data/lib/so_many_devices.rb

@@ -1,34 +1,32 @@
 require "so_many_devices/version"
 require "so_many_devices/downloads_helper"
-require 'yaml'
-require 'capybara'
+require "yaml"
+require "capybara"
 
 module SoManyDevices
   class Error < StandardError; end
 
-  devices = YAML::load_file(File.join(__dir__, 'so_many_devices.yml'))
+  standard_args = ["--disable-site-isolation-trials", "--force-prefers-reduced-motion"]
+  headless_args = ["--headless", *standard_args]
+  headless_args << "--disable-gpu" if Gem.win_platform?
 
-  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?
+  devices = YAML.load_file(File.join(__dir__, "so_many_devices.yml"))
 
-    [[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 }
-        )
-        Capybara::Selenium::Driver.new(app, browser: :chrome, desired_capabilities: capabilities)
+  devices.each do |device_name, emulation|
+    [[device_name, standard_args], ["#{device_name}_headless", headless_args]].each do |driver_name, args|
+      Capybara.register_driver driver_name.to_sym do |app|
+        browser_options = ::Selenium::WebDriver::Chrome::Options.new(args: args, emulation: emulation)
+        Capybara::Selenium::Driver.new(app, browser: :chrome, options: browser_options)
       end
     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
+  [[:selenium_chrome_with_download, standard_args], [:selenium_chrome_with_download_headless, headless_args]].each do |driver_name, args|
+    Capybara.register_driver driver_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

data/so_many_devices.gemspec

@@ -1,29 +1,27 @@
-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.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  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 = ">= 3.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["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/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
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ spec/ logo/ .git .github .semaphore .rspec .ruby-version Gemfile])
+    end
   end
-  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_dependency "capybara", ">= 3.0"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: so_many_devices
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Alessandro Rodi
-autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2020-06-18 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -32,33 +31,22 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".rspec"
-- ".semaphore/master-deploy.yml"
-- ".semaphore/semaphore.yml"
-- ".travis.yml"
+- CHANGELOG.md
 - CODE_OF_CONDUCT.md
-- Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
-- bin/console
-- 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
 homepage: https://github.com/renuo/so_many_devices
 licenses:
 - MIT
 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
 rdoc_options: []
 require_paths:
 - lib
@@ -66,16 +54,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6.2
-signing_key: 
+rubygems_version: 4.0.23
 specification_version: 4
 summary: A list of configurations for so many devices!
 test_files: []

data/.gitignore

@@ -1,11 +0,0 @@
-/.bundle/
-/.yardoc
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/tmp/
-
-# rspec failure tracking
-.rspec_status

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---require spec_helper

data/.semaphore/master-deploy.yml

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

data/.semaphore/semaphore.yml

@@ -1,32 +0,0 @@
-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:
-      secrets:
-        - name: so_many_devices
-      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 rspec
-promotions:
-  - name: master
-    pipeline_file: master-deploy.yml

data/.travis.yml

@@ -1,6 +0,0 @@
----
-language: ruby
-cache: bundler
-rvm:
-  - 2.6.1
-before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -1,7 +0,0 @@
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in so_many_devices.gemspec
-gemspec
-
-gem "rake", "~> 12.0"
-gem "rspec", "~> 3.0"

data/Gemfile.lock

@@ -1,56 +0,0 @@
-PATH
-  remote: .
-  specs:
-    so_many_devices (0.2.0)
-      capybara (>= 3.0)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    addressable (2.7.0)
-      public_suffix (>= 2.0.2, < 5.0)
-    capybara (3.32.1)
-      addressable
-      mini_mime (>= 0.1.3)
-      nokogiri (~> 1.8)
-      rack (>= 1.6.0)
-      rack-test (>= 0.6.3)
-      regexp_parser (~> 1.5)
-      xpath (~> 3.2)
-    diff-lcs (1.3)
-    mini_mime (1.0.2)
-    mini_portile2 (2.4.0)
-    nokogiri (1.10.9)
-      mini_portile2 (~> 2.4.0)
-    public_suffix (4.0.4)
-    rack (2.2.2)
-    rack-test (1.1.0)
-      rack (>= 1.0, < 3)
-    rake (12.3.3)
-    regexp_parser (1.7.0)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    xpath (3.2.0)
-      nokogiri (~> 1.8)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  rake (~> 12.0)
-  rspec (~> 3.0)
-  so_many_devices!
-
-BUNDLED WITH
-   2.1.4

data/bin/console

@@ -1,14 +0,0 @@
-#!/usr/bin/env ruby
-
-require "bundler/setup"
-require "so_many_devices"
-
-# You can add fixtures and/or initialization code here to make experimenting
-# with your gem easier. You can also use a different console, if you like.
-
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
-require "irb"
-IRB.start(__FILE__)

data/bin/setup

@@ -1,8 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-IFS=$'\n\t'
-set -vx
-
-bundle install
-
-# Do any other automated setup that you need to do here