gemika 0.3.3 → 0.6.0

data/{gemfiles/Gemfile.5.0.pg → Gemfile.5.2.pg}

@@ -4,13 +4,14 @@ source 'https://rubygems.org'
 ruby '>= 2.2'
 
 # Runtime dependencies
-gem 'activerecord', '~>5.0.0'
+gem 'activerecord', '~>5.2.0'
 gem 'rspec', '~>3.5'
 gem 'pg', '~>0.18.4'
 
 # Development dependencies
 gem 'rake'
 gem 'database_cleaner'
+gem 'pry'
 
 # Gem under test
-gem 'gemika', :path => '..'
+gem 'gemika', :path => '.'

data/{gemfiles/Gemfile.5.0.pg.lock → Gemfile.5.2.pg.lock}

@@ -1,29 +1,35 @@
 PATH
-  remote: ..
+  remote: .
   specs:
-    gemika (0.3.3)
+    gemika (0.6.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (5.0.0.1)
-      activesupport (= 5.0.0.1)
-    activerecord (5.0.0.1)
-      activemodel (= 5.0.0.1)
-      activesupport (= 5.0.0.1)
-      arel (~> 7.0)
-    activesupport (5.0.0.1)
+    activemodel (5.2.3)
+      activesupport (= 5.2.3)
+    activerecord (5.2.3)
+      activemodel (= 5.2.3)
+      activesupport (= 5.2.3)
+      arel (>= 9.0)
+    activesupport (5.2.3)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (~> 0.7)
+      i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-    arel (7.1.2)
-    concurrent-ruby (1.0.2)
-    database_cleaner (1.5.3)
+    arel (9.0.0)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.5)
+    database_cleaner (1.7.0)
     diff-lcs (1.2.5)
-    i18n (0.7.0)
-    minitest (5.9.0)
+    i18n (1.5.1)
+      concurrent-ruby (~> 1.0)
+    method_source (0.9.2)
+    minitest (5.11.3)
     pg (0.18.4)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
     rake (11.3.0)
     rspec (3.5.0)
       rspec-core (~> 3.5.0)
@@ -38,18 +44,19 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.5.0)
     rspec-support (3.5.0)
-    thread_safe (0.3.5)
-    tzinfo (1.2.2)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
       thread_safe (~> 0.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  activerecord (~> 5.0.0)
+  activerecord (~> 5.2.0)
   database_cleaner
   gemika!
   pg (~> 0.18.4)
+  pry
   rake
   rspec (~> 3.5)
 
@@ -57,4 +64,4 @@ RUBY VERSION
    ruby 2.2.4p230
 
 BUNDLED WITH
-   1.16.1
+   2.2.15

data/{gemfiles/Gemfile.5.0.sqlite3 → Gemfile.5.2.sqlite3}

@@ -4,13 +4,14 @@ source 'https://rubygems.org'
 ruby '>= 2.2'
 
 # Runtime dependencies
-gem 'activerecord', '~>5.0.0'
+gem 'activerecord', '~>5.2.0'
 gem 'rspec', '~>3.5'
 gem 'sqlite3'
 
 # Development dependencies
 gem 'rake'
 gem 'database_cleaner'
+gem 'pry'
 
 # Gem under test
-gem 'gemika', :path => '..'
+gem 'gemika', :path => '.'

data/{gemfiles/Gemfile.5.0.sqlite3.lock → Gemfile.5.2.sqlite3.lock}

@@ -1,29 +1,34 @@
 PATH
-  remote: ..
+  remote: .
   specs:
-    gemika (0.3.3)
+    gemika (0.6.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (5.0.7)
-      activesupport (= 5.0.7)
-    activerecord (5.0.7)
-      activemodel (= 5.0.7)
-      activesupport (= 5.0.7)
-      arel (~> 7.0)
-    activesupport (5.0.7)
+    activemodel (5.2.3)
+      activesupport (= 5.2.3)
+    activerecord (5.2.3)
+      activemodel (= 5.2.3)
+      activesupport (= 5.2.3)
+      arel (>= 9.0)
+    activesupport (5.2.3)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-    arel (7.1.4)
-    concurrent-ruby (1.0.5)
+    arel (9.0.0)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.5)
     database_cleaner (1.7.0)
     diff-lcs (1.3)
-    i18n (1.0.1)
+    i18n (1.5.1)
       concurrent-ruby (~> 1.0)
+    method_source (0.9.2)
     minitest (5.11.3)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
     rake (12.3.1)
     rspec (3.7.0)
       rspec-core (~> 3.7.0)
@@ -47,9 +52,10 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  activerecord (~> 5.0.0)
+  activerecord (~> 5.2.0)
   database_cleaner
   gemika!
+  pry
   rake
   rspec (~> 3.5)
   sqlite3
@@ -58,4 +64,4 @@ RUBY VERSION
    ruby 2.2.4p230
 
 BUNDLED WITH
-   1.16.1
+   2.2.15

data/Gemfile.6.1.pg

@@ -0,0 +1,17 @@
+source 'https://rubygems.org'
+
+# Ruby
+ruby '>= 2.2'
+
+# Runtime dependencies
+gem 'activerecord', '~>6.1.0'
+gem 'rspec', '~>3.5'
+gem 'pg'
+
+# Development dependencies
+gem 'rake'
+gem 'database_cleaner'
+gem 'pry'
+
+# Gem under test
+gem 'gemika', :path => '.'

data/Gemfile.6.1.pg.lock

@@ -0,0 +1,66 @@
+PATH
+  remote: .
+  specs:
+    gemika (0.6.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activerecord (6.1.3.1)
+      activemodel (= 6.1.3.1)
+      activesupport (= 6.1.3.1)
+    activesupport (6.1.3.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
+    coderay (1.1.2)
+    concurrent-ruby (1.1.8)
+    database_cleaner (1.7.0)
+    diff-lcs (1.3)
+    i18n (1.8.10)
+      concurrent-ruby (~> 1.0)
+    method_source (0.9.2)
+    minitest (5.14.4)
+    pg (1.2.3)
+    pry (0.12.2)
+      coderay (~> 1.1.0)
+      method_source (~> 0.9.0)
+    rake (12.3.3)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.2)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.4)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.2)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    zeitwerk (2.4.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord (~> 6.1.0)
+  database_cleaner
+  gemika!
+  pg
+  pry
+  rake
+  rspec (~> 3.5)
+
+RUBY VERSION
+   ruby 2.2.4p230
+
+BUNDLED WITH
+   2.2.15

data/README.md

@@ -1,4 +1,4 @@
-# Gemika [![Build Status](https://travis-ci.org/makandra/gemika.svg?branch=master)](https://travis-ci.org/makandra/gemika)
+# Gemika  [![Tests](https://github.com/makandra/gemika/workflows/Tests/badge.svg)](https://github.com/makandra/gemika/actions)
 
 ## Test a Ruby gem against multiple versions of everything
 
@@ -16,8 +16,9 @@ Here's what Gemika can give your test's development setup (all features are opt-
 - Compute a matrix of all possible dependency permutations (Ruby, runtime gems, database type). Manually exclude incompatible dependency permutations (e.g. Rails 5.0 does not work with Ruby 2.1).
 - Let developers enter their local credentials for MySQL and PostgreSQL in a `database.yml` file.
 - Define default Ruby version, gem dependencies and database for developers who don't care about every possible permutation for everyday work.
-- Help configure a [Travis CI](https://travis-ci.org/) build that tests every dependency permutation after each `git push`.
-- Share your Ruby / gem dependeny / database permutation between local development and Travis CI.
+- Help configure a [Travis CI](https://travis-ci.org/) or Github Actions build that tests every dependency permutation after each `git push`.
+- Share your Ruby / gem dependeny / database permutation between local development and Travis CI / Github Actions.
+- Migrate your Travis CI config to a Github Actions config.
 - Define an [ActiveRecord database migration](http://api.rubyonrails.org/classes/ActiveRecord/Migration.html) that sets up your test database.
 - Automatically drop and re-create your test database before each run of your test suite.
 - Work around breaking changes in RSpec, Ruby and other gems
@@ -27,9 +28,9 @@ Here's what Gemika can give your test's development setup (all features are opt-
 
 Gemika currently supports the following dependency versions:
 
-- Ruby: 1.8.7, 2.1, 2.2, 2.3
+- Ruby: 2.3, 2.6, 3.0
 - RSpec: Versions 1, 2, 3
-- ActiveRecord: Versions 2.3, 3.2, 4.2, 5.0
+- ActiveRecord: Versions 3.2, 4.2, 5.2, 6.1
 - Databases: PostgreSQL (with `pg` gem), MySQL or MariaDB (with `mysql2` gem), or sqlite3 (with `sqlite3` gem)
 
 Gemika also makes some assumption about your Gem:
@@ -43,14 +44,14 @@ Gemika also makes some assumption about your Gem:
 Below you can see the directory of a gem with a completed Gemika testing setup. The next section describes how to get there:
 
 ```shell
-gemfiles/Gemfile.set1                       # First dependency set. Should include development dependencies and gemika.
-gemfiles/Gemfile.set1.lock                  # Generated by `rake matrix:install`
-gemfiles/Gemfile.set2                       # Second dependency set. Should include development dependencies and gemika.
-gemfiles/Gemfile.set2.lock                  # Generated by `rake matrix:install`
-gemfiles/Gemfile.set3                       # Third dependency set. Should include development dependencies and gemika.
-gemfiles/Gemfile.set3.lock                  # Generated by `rake matrix:install`
-Gemfile -> gemfiles/Gemfile.set2            # Symlink to default Gemfile for development
-Gemfile.lock -> gemfiles/Gemfile.set2.lock  # Symlink to default Gemfile.lock for development
+Gemfile.set1                                # First dependency set. Should include development dependencies and gemika.
+Gemfile.set1.lock                           # Generated by `rake matrix:install`
+Gemfile.set2                                # Second dependency set. Should include development dependencies and gemika.
+Gemfile.set2.lock                           # Generated by `rake matrix:install`
+Gemfile.set3                                # Third dependency set. Should include development dependencies and gemika.
+Gemfile.set3.lock                           # Generated by `rake matrix:install`
+Gemfile -> Gemfile.set2                     # Symlink to default Gemfile for development
+Gemfile.lock -> Gemfile.set2.lock           # Symlink to default Gemfile.lock for development
 .ruby-version                               # Default Ruby version for development
 .gitignore                                  # Should ignore spec/support/database.yml
 .travis.yml                                 # Configures all tested Ruby / gemfile combinations, for both local development and Travis CI
@@ -65,6 +66,7 @@ spec/support/database.rb                    # Database schema for test database
 spec/support/database.yml                   # Database credentials for local development (not checked in)
 spec/support/database.sample.yml            # Sample database credentials for new developers
 spec/support/database.travis.yml            # Database credentials for Travis CI
+spec/support/database.github.yml            # Alternatively: Database credentials for Github Actions
 spec/my_gem/my_class_spec.rb                # Tests for your gem
 ```
 
@@ -136,28 +138,23 @@ task :default => 'matrix:spec'
 ### Define multiple dependency sets
 
 We are now creating one `Gemfile` for each set of gems and database type you'd like to test again.
+Your gemfiles should be placed directly in your project's root directory.
 
-First, create a directory for the gemfiles:
-
-```shell
-mkdir gemfiles
-```
-
-For each dependency set, create a `Gemfile` in the `gemfiles` directory that contains:
+For each dependency set, create a `Gemfile` in the project root directory that contains:
 
 1. The runtime dependencies you'd like to test against (e.g. Rails 5)
-2. The development dependencies for that set (e.g. `rspec`) in a version that is compatible with these runtime gependencies.
+2. The development dependencies for that set (e.g. `rspec`) in a version that is compatible with these runtime dependencies.
 3. The `gemika` gem
-4. Your own gem from path `..`
- 
-For instance, if one dependency set is Rails 3.2 with a MySQL database, we would create `gemfiles/Gemfile.4.2.mysql2` with these contents:
+4. Your own gem from path `.`
+
+For instance, if one dependency set is Rails 3.2 with a MySQL database, we would create `./Gemfile.4.2.mysql2` with these contents:
 
 ```ruby
 source 'https://rubygems.org'
 
 # Runtime dependencies
 gem 'rails', '~>3.2.22'
-gem 'mysql2', '= 0.3.17'
+gem 'mysql2', '= 0.4.10'
 
 # Development dependencies
 gem 'rspec', '~> 3.4'
@@ -166,10 +163,10 @@ gem 'byebug'
 gem 'gemika'
 
 # Gem under test
-gem 'my_gem', :path => '..'
+gem 'my_gem', :path => '.'
 ```
 
-If a second dependency is Rails 5.0 with a PostgreSQL database, we would create `gemfiles/Gemfile.5.0.pg` with these contents:
+If a second dependency is Rails 5.0 with a PostgreSQL database, we would create `./Gemfile.5.0.pg` with these contents:
 
 ```ruby
 source 'https://rubygems.org'
@@ -185,14 +182,14 @@ gem 'byebug'
 gem 'gemika'
 
 # Gem under test
-gem 'my_gem', :path => '..'
+gem 'my_gem', :path => '.'
 ```
 
-In this example, your `gemfiles` directory should now look like this:
+In this example, your project directory should now also contain:
 
 ```
-gemfiles/Gemfile.4.2.mysql2
-gemfiles/Gemfile.5.0.pg
+Gemfile.4.2.mysql2
+Gemfile.5.0.pg
 ```
 
 
@@ -200,7 +197,7 @@ gemfiles/Gemfile.5.0.pg
 
 We will now define a test matrix that contains all permutations of gemfiles and tested Ruby versions.
 
-We store the matrix in a `.travis.yml` file, **even if the project is not using Travis CI**. This allows us to configure the matrix once and us it for both local developent and Travis CI builds.
+We store the matrix in a `.travis.yml` file, **even if the project is not using Travis CI**. This allows us to configure the matrix once and us it for both local development and Travis CI builds.
 
 Create a `.travis.yml` that lists all gemfiles and Ruby versions you'd like to test against:
 
@@ -211,16 +208,19 @@ rvm:
   - 2.3.1
 
 gemfile:
-  - gemfiles/Gemfile.3.2.mysql2
-  - gemfiles/Gemfile.4.2.mysql2
-  - gemfiles/Gemfile.4.2.pg
-  - gemfiles/Gemfile.5.0.mysql2
-  - gemfiles/Gemfile.5.0.pg
+  - Gemfile.3.2.mysql2
+  - Gemfile.4.2.mysql2
+  - Gemfile.4.2.pg
+  - Gemfile.5.0.mysql2
+  - Gemfile.5.0.pg
 ```
 
 Don't mind the `rvm` key if you're using a different version manager locally (like rbenv). Things will still work.
 
 
+Alternatively, create a Github Actions file like [this](/.github/workflows/test.yml).
+
+
 #### Excluding incompatible matrix rows
 
 There might be incompatible combinations of gemfiles and Rubies, e.g. Rails 5.0 does not work with Ruby 2.1 or lower. In this case, add an `matrix`/`exclude` key to your `.travis.yml`:
@@ -228,12 +228,38 @@ There might be incompatible combinations of gemfiles and Rubies, e.g. Rails 5.0
 ```yaml
 matrix:
   exclude:
-    - gemfile: gemfiles/Gemfile.5.0.mysql2
+    - gemfile: Gemfile.5.0.mysql2
       rvm: 2.1.8
-    - gemfile: gemfiles/Gemfile.5.0.pg
+    - gemfile: Gemfile.5.0.pg
       rvm: 2.1.8
 ```
 
+For `.github/workflows/test.yml`, it looks similar:
+
+```yaml
+jobs:
+  my_job:
+    strategy:
+      matrix:
+        exclude:
+          - gemfile: Gemfile.5.0.mysql2
+            ruby: 2.1.8
+          - gemfile: Gemfile.5.0.pg
+            ruby: 2.1.8
+```
+
+
+Alternatively, you can instead explicitly list all Ruby / Gemfile combinations with
+
+```
+matrix:
+  include:
+  - gemfile: Gemfile.5.0.mysql2
+    rvm: 2.3.8
+  - gemfile: Gemfile.5.2.mysql2
+    rvm: 2.3.8
+```
+
 ### Generate lockfiles
 
 Generate lockfiles for each bundle by running:
@@ -242,13 +268,13 @@ Generate lockfiles for each bundle by running:
 rake matrix:install
 ```
 
-In this example, your `gemfiles` directory should now contain a lockfile for each gemfile:
+In this example, your project directory should now contain a lockfile for each gemfile:
 
 ```
-gemfiles/Gemfile.4.2.mysql2
-gemfiles/Gemfile.4.2.mysql2.lock
-gemfiles/Gemfile.5.0.pg
-gemfiles/Gemfile.5.0.pg.lock
+Gemfile.4.2.mysql2
+Gemfile.4.2.mysql2.lock
+Gemfile.5.0.pg
+Gemfile.5.0.pg.lock
 ```
 
 Gemfiles and lockfiles should be committed to your repo.
@@ -269,8 +295,8 @@ Create a `.ruby-version` file with the default Ruby version:
 Choose a default dependency set and symlink both gemfile and lockfile to your project root:
 
 ```
-ln -s gemfiles/Gemfile.4.2.mysql2 Gemfile
-ln -s gemfiles/Gemfile.4.2.mysql2.lock Gemfile.lock
+ln -s Gemfile.4.2.mysql2 Gemfile
+ln -s Gemfile.4.2.mysql2.lock Gemfile.lock
 ```
 
 Commit both `.ruby-version` and symlinks to your repo.
@@ -295,6 +321,9 @@ postgresql:
   database: minidusen_test
   user:
   password:
+
+sqlite:
+  database: ":memory:"
 ```
 
 We don't want to commit our local credentials, so add a line to your `.gitignore`:
@@ -334,6 +363,25 @@ Dir["#{File.dirname(__FILE__)}/support/*.rb"].sort.each {|f| require f}
 Now you have a great place for code snippets that need to run before specs (factories, VCR configuration, etc.).
 
 
+To have your database work with Github Actions, add a database file `spec/support/database.github.yml`.
+
+```
+mysql:
+  database: test
+  username: root
+  password: password
+  host: 127.0.0.1
+  port: 3306
+
+postgresql:
+  database: test
+  host: localhost
+  username: postgres
+  password: postgres
+  port: 5432
+```
+
+
 #### Test database schema
 
 If your gem is talking to the database, you probably need to create some example tables.
@@ -390,6 +438,25 @@ Gemika::RSpec.configure_clean_database_before_example
 Note that you also need `require 'gemika'` in your `spec_helper.rb`.
 
 
+#### Migrate from Travis CI to Github Actions
+
+To help in your migrations, you can ask Gemika to generate a Github Actions config from an existing `.travis-ci.yml`.
+
+To do this, call
+
+```
+bundle exec rake gemika:generate_github_actions_workflow
+```
+
+Copy the resulting file to `.github/workflows/test.yml`.
+
+Make sure you have a `spec/support/database.github.yml` if you use databases. See above how this is supposed to look like.
+
+You may have to fix a few things manually though. For example, Github Actions will only allow certain Ruby versions (but show you a list of supported versions when it fails).
+
+Also, when you run on a Ubuntu 20.04 container, you might have issues with the mysql2 gem. See [this guide](https://makandracards.com/makandra/486428-installing-old-versions-of-mysql2-on-ubuntu-20-04+) for a potential solution.
+
+
 ### Try it out
 
 Check if you can install development dependencies for each row in the test matrix:
@@ -431,8 +498,8 @@ rake matrix:spec
 Note that if your current Ruby version is *very* far away from your [default Ruby](#default-ruby-and-default-gemfile) in `.ruby-version`, you might need to run `rake` with a gemfile that has compatible dependencies:
 
 ```shell
-BUNDLE_GEMFILE=gemfiles/Gemfile.2.3 bundle exec rake matrix:install
-BUNDLE_GEMFILE=gemfiles/Gemfile.2.3 bundle exec rake matrix:spec
+BUNDLE_GEMFILE=Gemfile.2.3 bundle exec rake matrix:install
+BUNDLE_GEMFILE=Gemfile.2.3 bundle exec rake matrix:spec
 ```
 
 We recommend to setup Travis CI to check the entire test matrix after each push, including all Rubies. This way developers can stay on the [default Ruby and gemfile](#default-ruby-and-default-gemfile) most of the time while Travis CI checks make sure that nothing broken gets merged.
@@ -628,9 +695,10 @@ Here are some hints when you try to make changes to Gemika itself:
 
 There are tests in `spec`. We only accept PRs with tests. To run tests:
 
-- Install Ruby 2.2.4
+- Install Ruby 2.6.4
 - Create a local test database `gemika_test` in both MySQL and PostgreSQL
 - Copy `spec/support/database.sample.yml` to `spec/support/database.yml` and enter your local credentials for the test databases
+- Create the databases specified in `database.yml`
 - Install development dependencies using `bundle install`
 - Run tests using `bundle exec rspec`