treye-semaphore_test_boosters 2.5.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 27c22f8102f333cd7e8144fa2b4d7a17a5c7a77f
+  data.tar.gz: 779e690fb739830d6c52d9d86bbc49464d2faf6c
+SHA512:
+  metadata.gz: 1015436ed3fe5b5ff4b3ebc7b2b55069ffe7ee34138ed1e6907e154db48379df0f272a8ec0cae7dcf40ecfdb005681ea720d40e5c8b3a15ed15408bb913f8b77
+  data.tar.gz: 7d9f7b00719e7fd971925e59a2063852fbb945535c103313a86c8fc8d1722dfeb9d542bca0d6396abd507e1a126621ac2fb167a0a4959df715e390998df3931e

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.gem
+/vendor
+/coverage
+config/cucumber.yml
+/features

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,105 @@
+require: rubocop-rspec
+
+AllCops:
+  DisplayCopNames: true
+
+  Exclude:
+    - "*.gemspec"
+    - "vendor/**/*"
+    - "features/**/*"
+    - "lib/test_boosters/cucumber_booster.rb"
+    - "test_data_pass/**/*"
+    - "test_data_fail/**/*"
+    - "rspec_formatters/semaphore_rspec3_json_formatter.rb"
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/NumericLiterals:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/HashSyntax:
+  EnforcedStyle: hash_rockets
+
+Style/CollectionMethods:
+  StyleGuide: "https://github.com/bbatsov/ruby-style-guide#map-find-select-reduce-size"
+  Enabled: true
+
+Metrics/LineLength:
+  Max: 120
+
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Style/EmptyLinesAroundModuleBody:
+  Enabled: false
+
+Style/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+  IndentationWidth: 2
+
+Style/SpecialGlobalVars:
+  Enabled: false
+
+Style/PercentLiteralDelimiters:
+  Enabled: false
+
+RSpec/InstanceVariable:
+  Enabled: false
+
+RSpec/MultipleExpectations:
+  Max: 5
+
+Metrics/BlockLength:
+  Exclude:
+    - "Rakefile"
+    - "**/*.rake"
+    - "spec/**/*.rb"
+
+Style/EmptyLinesAroundBlockBody:
+  Enabled: false
+
+RSpec/BeforeAfterAll:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Enabled: false
+
+RSpec/DescribedClass:
+  Enabled: false
+
+Style/IndentArray:
+  EnforcedStyle: consistent
+
+Style/MultilineMethodCallBraceLayout:
+  Enabled: false
+
+RSpec/MessageSpies:
+  Enabled: false
+
+Style/MultilineBlockLayout:
+  Enabled: false
+
+RSpec/SubjectStub:
+  Enabled: false
+
+RSpec/DescribeClass:
+  Enabled: false
+
+RSpec/LeadingSubject:
+  Enabled: false
+
+Style/WordArray:
+  Enabled: false
+
+RSpec/NotToNot:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in test_boosters.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Rendered Text
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,226 @@
+# Test Boosters
+
+Note: This version is just an updated copy of the original with the new version number.
+
+[![Gem Version](https://badge.fury.io/rb/semaphore_test_boosters.svg)](https://badge.fury.io/rb/semaphore_test_boosters)
+[![Build Status](https://semaphoreci.com/api/v1/renderedtext/test-boosters/branches/master/badge.svg)](https://semaphoreci.com/renderedtext/test-boosters)
+
+Auto Parallelization — runs test files in multiple jobs
+
+- [Installation](#installation)
+
+Test Booster basics:
+
+  - [What are Test Boosters](#what-are-test-boosters)
+  - [Split Configuration](#split-configuration)
+  - [Leftover Files](#split-configuration)
+
+Test Boosters:
+
+  - [RSpec Booster](#rspec-booster)
+  - [Cucumber Booster](#cucumber-booster)
+  - [Minitest Booster](#minitest-booster)
+  - [ExUnit Booster](#ex-unit-booster)
+  - [GoTest Booster](#go-test-booster)
+
+## Installation
+
+``` bash
+gem install semaphore_test_boosters
+````
+
+## What are Test Boosters
+
+Test Boosters take your test suite and split the test files into multiple jobs.
+This allows you to quickly parallelize your test suite across multiple build
+machines.
+
+As an example, let's take a look at the `rspec_booster --job 1/10` command. It
+lists all the files that match the `spec/**/*_spec.rb` glob in your project,
+distributes them into 10 jobs, and execute the first job.
+
+### Split Configuration
+
+Every test booster can load a split configuration file that helps the test
+booster to make a better distribution.
+
+For example, if you have 3 RSpec Booster jobs, and you want to run:
+
+- `spec/a_spec.rb` and `spec/b_spec.rb` in the first job
+- `spec/c_spec.rb` and `spec/d_spec.rb` in the second job
+- `spec/e_spec.rb` in the third job
+
+you should put the following in your split configuration file:
+
+``` json
+[
+  { "files": ["spec/a_spec.rb", "spec/b_spec.rb"] },
+  { "files": ["spec/c_spec.rb", "spec/d_spec.rb"] },
+  { "files": ["spec/e_spec.rb"] }
+]
+```
+
+Semaphore uses Split configurations to split your test files based on their
+durations in the previous builds.
+
+### Leftover Files
+
+Files that are part of your test suite, but are not in the split
+configuration file, are called "leftover files". These files will be distributed
+based on their file size in a round robin fashion across your jobs.
+
+For example, if you have the following in your split configuration:
+
+``` json
+[
+  { "files": ["spec/a_spec.rb"] }
+  { "files": ["spec/b_spec.rb"] }
+  { "files": ["spec/c_spec.rb"] }
+]
+```
+
+and the following files in your spec directory:
+
+``` bash
+# Files from split configuration ↓
+
+spec/a_spec.rb
+spec/b_spec.rb
+spec/c_spec.rb
+
+# Leftover files ↓
+
+spec/d_spec.rb
+spec/e_spec.rb
+```
+
+When you run the `rspec_booster --job 1/3` command, the files from the
+configuration's first job and some leftover files will be executed.
+
+``` bash
+rspec_booster --job 1/3
+
+# => runs: bundle exec rspec spec/a_spec.rb spec/d_spec.rb
+```
+
+Booster will distribute your leftover files uniformly across jobs.
+
+## RSpec Booster
+
+The `rspec_booster` loads all the files that match the `spec/**/*_spec.rb`
+pattern and uses the `~/rspec_split_configuration.json` file to parallelize your
+test suite.
+
+Example of running job 4 out of 32 jobs:
+
+``` bash
+rspec_booster --job 4/32
+```
+
+Under the hood, the RSpec Booster uses the following command:
+
+``` bash
+bundle exec rspec --format documentation --format json --out /home/<user>/rspec_report.json <file_list>
+```
+
+Optionally, you can pass additional RSpec flags with the `TB_RSPEC_OPTIONS`
+environment variable. You can also set a RSpec formatter with the `TB_RSPEC_FORMATTER` environment variable.
+Default formatter is `documentation`.
+
+
+Example:
+``` bash
+TB_RSPEC_OPTIONS='--fail-fast=3' TB_RSPEC_FORMATTER=Fivemat rspec_booster --job 4/32
+
+# will execute:
+bundle exec rspec --fail-fast=3 --format Fivemat --format json --out /home/<user>/rspec_report.json <file_list>
+```
+
+## Cucumber Booster
+
+The `cucumber_booster` loads all the files that match the `features/**/*.feature`
+pattern and uses the `~/cucumber_split_configuration.json` file to parallelize
+your test suite.
+
+Example of running job 4 out of 32 jobs:
+
+``` bash
+cucumber_booster --job 4/32
+```
+
+Under the hood, the Cucumber Booster uses the following command:
+
+``` bash
+bundle exec cucumber <file_list>
+```
+
+## Minitest Booster
+
+The `minitest_booster` loads all the files that match the `test/**/*_test.rb`
+pattern and uses the `~/minitest_split_configuration.json` file to parallelize
+your test suite.
+
+Example of running job 4 out of 32 jobs:
+
+``` bash
+minitest_booster --job 4/32
+```
+
+Under the hood, the Minitest Booster uses the following command:
+
+``` bash
+ruby -e 'ARGV.each { |f| require ".#{f}" }' <file_list>
+```
+
+## ExUnit Booster
+
+The `ex_unit_booster` loads all the files that match the `test/**/*_test.exs`
+pattern and uses the `~/ex_unit_split_configuration.json` file to parallelize
+your test suite.
+
+Example of running job 4 out of 32 jobs:
+
+``` bash
+ex_unit_booster --job 4/32
+```
+
+Under the hood, the ExUnit Booster uses the following command:
+
+``` bash
+mix test <file_list>
+```
+
+## Go Test Booster
+
+The `go_test_booster` loads all the files that match the `**/*_test.go`
+pattern and uses the `~/go_test_split_configuration.json` file to parallelize
+your test suite.
+
+Example of running job 4 out of 32 jobs:
+
+``` bash
+go_test_booster --job 4/32
+```
+
+Under the hood, the Go Test Booster uses the following command:
+
+``` bash
+go test <file_list>
+```
+
+## Development
+
+### Integration testing
+
+For integration tests we use test repositories that are located in
+<https://github.com/renderedtext/test-boosters-tests.git>.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/renderedtext/test-boosters.
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "test_boosters"
+
+# 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

data/bin/setup

@@ -0,0 +1,8 @@
+#!/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

data/config.reek

@@ -0,0 +1,16 @@
+---
+IrresponsibleModule:
+  enabled: false
+
+FeatureEnvy:
+  enabled: false
+
+ControlParameter:
+  enabled: false
+
+UtilityFunction:
+  enabled: false
+
+exclude_paths:
+  - vendor
+  - .bundle

data/exe/cucumber_booster

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require "test_boosters"
+
+exit(TestBoosters::Boosters::Cucumber.new.run)