From a91a8d6bc400dfec42214c2742be9787d099ca3f Mon Sep 17 00:00:00 2001
From: 3v0k4 <riccardo.odone@gmail.com>
Date: Thu, 6 Jun 2024 14:57:50 +0200
Subject: [PATCH] chore: knapsack to knapsack_pro

---
 .github/assets/knapsack-diamonds.png         | Bin 0 -> 17632 bytes
 MIGRATE_TO_KNAPSACK_PRO.md                   |  77 +++++++++++++++++++
 README.md                                    |  60 ++++++++-------
 spec/knapsack/adapters/rspec_adapter_spec.rb |   2 +
 4 files changed, 113 insertions(+), 26 deletions(-)
 create mode 100644 .github/assets/knapsack-diamonds.png
 create mode 100644 MIGRATE_TO_KNAPSACK_PRO.md

diff --git a/.github/assets/knapsack-diamonds.png b/.github/assets/knapsack-diamonds.png
new file mode 100644
index 0000000000000000000000000000000000000000..e9cce59be7560013515d89705923706a41f7deaa
GIT binary patch
literal 17632
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

literal 0
HcmV?d00001

diff --git a/MIGRATE_TO_KNAPSACK_PRO.md b/MIGRATE_TO_KNAPSACK_PRO.md
new file mode 100644
index 0000000..d811689
--- /dev/null
+++ b/MIGRATE_TO_KNAPSACK_PRO.md
@@ -0,0 +1,77 @@
+# Migration steps: from Knapsack to Knapsack Pro
+
+Follow these steps to migrate from `knapsack` to `knapsack_pro` in 10 minutes.
+
+Commands are provided to help you with each step.
+
+On Linux, you need to remove the `''` part from the `sed` commands. Also, you can ignore the `sed: no input files` warning that is printed when there's no substitution to perform.
+
+## Steps
+
+- [ ] Remove the `knapsack` gem:
+   ```bash
+   bundle remove knapsack
+   ```
+
+- [ ] Remove `Knapsack.load_tasks` from the `Rakefile` if present:
+   ```bash
+   sed -i '' '/Knapsack\.load_tasks/d' Rakefile
+   ```
+
+- [ ] Replace `require "knapsack"` with `require "knapsack_pro"`:
+   ```bash
+   grep --files-with-matches --recursive "require.*knapsack" . | xargs sed -i '' "s/'knapsack'/'knapsack_pro'/g"
+   grep --files-with-matches --recursive "require.*knapsack" . | xargs sed -i '' 's/"knapsack"/"knapsack_pro"/g'
+   ```
+
+- [ ] Remove the following code from the test runner configuration:
+   ```diff
+   - Knapsack.tracker.config({
+   -  enable_time_offset_warning: true,
+   -  time_offset_in_seconds: 30
+   - })
+
+   - Knapsack.report.config({
+   -  test_file_pattern: 'spec/**{,/*/**}/*_spec.rb', # ⬅️ Take note of this one for later
+   -  report_path: 'knapsack_custom_report.json'
+   - })
+   ```
+
+- [ ] Replace `Knapsack` with `KnapsackPro`:
+   ```bash
+   grep --files-with-matches --recursive "Knapsack\." . | xargs sed -i '' 's/Knapsack\./KnapsackPro./g'
+   grep --files-with-matches --recursive "Knapsack::" . | xargs sed -i '' 's/Knapsack::/KnapsackPro::/g'
+   ```
+
+- [ ] Rename `KnapsackPro::Adapters::RspecAdapter` to `KnapsackPro::Adapters::RSpecAdapter`:
+   ```bash
+   grep --files-with-matches --recursive "KnapsackPro::Adapters::RspecAdapter" . | xargs sed -i '' 's/RspecAdapter/RSpecAdapter/g'
+   ```
+
+- [ ] Remove any line that mentions `KNAPSACK_GENERATE_REPORT` or `KNAPSACK_REPORT_PATH`:
+   ```bash
+   grep --files-with-matches --recursive "KNAPSACK_GENERATE_REPORT" . | xargs sed -i '' '/KNAPSACK_GENERATE_REPORT/d'
+   grep --files-with-matches --recursive "KNAPSACK_REPORT_PATH" . | xargs sed -i '' '/KNAPSACK_REPORT_PATH/d'
+   ```
+
+- [ ] Rename ENVs from `KNAPSACK_X` to `KNAPSACK_PRO_X`:
+   ```bash
+   grep --files-with-matches --recursive "KNAPSACK_" . | xargs sed -i '' 's/KNAPSACK_/KNAPSACK_PRO_/g'
+   ```
+
+- [ ] Remove all the reports:
+   ```bash
+   rm knapsack_*_report.json
+   ```
+
+- [ ] [Configure Knapsack Pro](https://docs.knapsackpro.com/knapsack_pro-ruby/guide/)
+
+- [ ] Ensure all the CI commands are updated:
+   ```bash
+   grep --files-with-matches --recursive "knapsack:spinach" . | xargs sed -i '' 's/knapsack:spinach/knapsack_pro:spinach/g'
+   grep --files-with-matches --recursive "knapsack:" . | xargs sed -i '' 's/knapsack:/knapsack_pro:queue:/g'
+   grep --files-with-matches --recursive "CI_NODE_TOTAL" . | xargs sed -i '' 's/CI_NODE_TOTAL/KNAPSACK_PRO_CI_NODE_TOTAL/g'
+   grep --files-with-matches --recursive "CI_NODE_INDEX" . | xargs sed -i '' 's/CI_NODE_INDEX/KNAPSACK_PRO_CI_NODE_INDEX/g'
+   ```
+
+- [ ] If you removed `test_file_pattern` when deleting `Knapsack.report.config`, use [`KNAPSACK_PRO_TEST_FILE_PATTERN`](https://docs.knapsackpro.com/ruby/reference/#knapsack_pro_test_file_pattern) instead
diff --git a/README.md b/README.md
index 96ca099..2b84e70 100644
--- a/README.md
+++ b/README.md
@@ -1,36 +1,44 @@
-# knapsack gem
+# Knapsack
 
-Knapsack splits tests evenly across parallel CI nodes to run fast CI build and save you time.
+<p align="center">
+  <a href="https://knapsackpro.com?utm_source=github&utm_medium=readme&utm_campaign=knapsack_gem&utm_content=hero_logo">
+    <img alt="Knapsack" src="./.github/assets/knapsack-diamonds.png" width="300" height="300" style="max-width: 100%;" />
+  </a>
+</p>
 
-|                                              | knapsack gem | knapsack_pro gem |
-| -------------------------------------------- | ------------ | ---------------- |
-| __Is free__                                  | ✓ Yes        | ✓ Yes, [free plan](https://knapsackpro.com?utm_source=github&utm_medium=readme&utm_campaign=knapsack_gem&utm_content=free_plan) |
-| __Regular Mode - a static tests split__      | ✓ Yes        | ✓ Yes |
-| __Queue Mode - a dynamic tests split__ <br>([ensures all CI nodes finish work at the same time](https://docs.knapsackpro.com/2020/how-to-speed-up-ruby-and-javascript-tests-with-ci-parallelisation))       | No           | ✓ Yes |
-| __Auto [split slow RSpec test file](https://knapsackpro.com/faq/question/how-to-split-slow-rspec-test-files-by-test-examples-by-individual-it) between parallel CI nodes__ <br>(a single test file can be auto split by test examples between parallel jobs) | No           | ✓ Yes |
-| Tracking tests timing per commit, branch     | No           | ✓ Yes |
-| Support for other programming languages      | No           | ✓ Yes |
-| Support for CI providers                     | limited      | ✓ Yes |
-| __Installation README__                      | [Install README](http://docs.knapsackpro.com/ruby/knapsack) | [Install README](https://docs.knapsackpro.com) |
+<h3 align="center">Speed up your tests</h3>
+<p align="center">Run your 1-hour test suite in 2 minutes with optimal parallelisation on your existing CI infrastructure</p>
 
-[Features of knapsack vs knapsack_pro Ruby gem](https://knapsackpro.com/features/ruby_knapsack_pro_vs_knapsack?utm_source=github&utm_medium=readme&utm_campaign=knapsack_gem&utm_content=ruby_knapsack_pro_vs_knapsack)
+---
 
-# Do you use Heroku?
+<div align="center">
+  <a href="https://rubygems.org/gems/knapsack">
+    <img alt="Gem Version" src="https://badge.fury.io/rb/knapsack.svg" />
+  </a>
+</div>
 
-Do you know Knapsack Pro Ruby gem is available as Heroku add-on? It works with your current CI server.
-https://elements.heroku.com/addons/knapsack-pro
+<br />
+<br />
 
-Knapsack Pro has Queue Mode that will split Ruby & JS tests in a dynamic way across parallel CI nodes to ensure each parallel job takes a similar time. Thanks to that there is no bottleneck in your CI pipelines.
+Knapsack wraps your current test runner and works with your existing CI infrastructure to split tests optimally.
 
-__See introduction how the Knapsack Pro add-on works__
-https://youtu.be/rmXES2N0_QU
+It comes in two flavors, `knapsack` and `knapsack_pro`:
 
-You may also find useful article how to run parallel dynos on Heroku CI to complete tests faster
-https://docs.knapsackpro.com/2019/how-to-run-tests-faster-on-heroku-ci-with-parallel-dynos
+|                                 | `knapsack` | `knapsack_pro`                          |
+| ------------------------------- | ---------- | --------------------------------------- |
+| Free                            | ✅         | ✅ [Free plan](https://knapsackpro.com?utm_source=github&utm_medium=readme&utm_campaign=knapsack_gem&utm_content=free_plan) |
+| Static split                    | ✅         | ✅                                      |
+| [Dynamic split](https://docs.knapsackpro.com/overview/#queue-mode-dynamic-split)       | ❌ | ✅ |
+| [Split by test examples](https://docs.knapsackpro.com/ruby/split-by-test-examples/)    | ❌ | ✅ |
+| Graphs, metrics, and stats      | ❌         | ✅                                      |
+| Programming languages           | 🤞 (Ruby)  | ✅ (Ruby, Cypress, Jest, SDK/API)       |
+| CI providers                    | 🤞 Limited | ✅ (All)                                |
+| [Heroku add-on](https://elements.heroku.com/addons/knapsack-pro)                       | ❌ | ✅ |
+| Additional features             | ❌         | 🤘 ([Overview](https://docs.knapsackpro.com/overview/)) |
+|                                 | [Install](http://docs.knapsackpro.com/ruby/knapsack) | [Install](https://docs.knapsackpro.com) |
 
-## Do you know
+[`knapsack` vs `knapsack_pro` full comparison](https://knapsackpro.com/features/ruby_knapsack_pro_vs_knapsack?utm_source=github&utm_medium=readme&utm_campaign=knapsack_gem&utm_content=ruby_knapsack_pro_vs_knapsack)
 
-* Knapsack Pro is risk-free integration! Knapsack Pro runs tests in Fallback Mode if your CI servers can't reach our API for any reason.
-* We don't need access to your repository. Knapsack Pro is just wrapper around test runner like RSpec, Cucumber, Minitest etc.
-* Hundreds of developers use Knapsack Pro every day to run fast CI builds.
-* It works with other programming languages.
+# Migrate from `knapsack` to `knapsack_pro`
+
+If you are already using `knapsack` and want to give `knapsack_pro` a try, here's [how to migrate in 10 minutes](./MIGRATE_TO_KNAPSACK_PRO.md).
diff --git a/spec/knapsack/adapters/rspec_adapter_spec.rb b/spec/knapsack/adapters/rspec_adapter_spec.rb
index 91f3823..0ae29b4 100644
--- a/spec/knapsack/adapters/rspec_adapter_spec.rb
+++ b/spec/knapsack/adapters/rspec_adapter_spec.rb
@@ -1,3 +1,5 @@
+require 'ostruct'
+
 describe Knapsack::Adapters::RSpecAdapter do
   context do
     before { expect(::RSpec).to receive(:configure) }