hastci 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c539e7bbcfc1e63ae87f60a4802989e13917dfd260c90f5b4ae034790351bfc5
-  data.tar.gz: 3246b32dbd057b5435404c37d1938049e96bbcb27643df0a69cb1f07c4b6d2d6
+  metadata.gz: ea7c58f1b590502ae7258d6ded75619b5389d602ca474de3626de52ef65c1580
+  data.tar.gz: 8fe736f73a92b44e7d9f6a3e6b8fe569f48a3cf9114890e89e128132886cc2b4
 SHA512:
-  metadata.gz: 6fbd3844f3a7791f4ca01a315bce6e999b5431dbe7aeb89e70e897c1ba467664d985943bd50bcd7b71854e4c563624a8fe54001da2f22424371857a71af800c1
-  data.tar.gz: 86d5796be2b12d15b5a5b26b9ec57ad8c7862a88cf4d57af663db85164608a49483048eb747c99a4799326d788aa881eed99059c7f3236a24455a077f68f9f32
+  metadata.gz: 69d3a81ad390852e5c28d4caf6900b4429a7d4d7d6781fd2eef97d8589b2027baef9b1241861fd7bf3001d5ecebc628aad4bf1c7373bcc92f51909798970df20
+  data.tar.gz: 54e1101e729ebf74cfbc06e857970c1d6966205f522d79b59e22ab93bd752c84ce74bc986c6cd05a6915253a2885ec0196ea0f9fe17ee74c88f543ad568f9b81

data/.rubocop.yml

@@ -0,0 +1,7 @@
+inherit_gem:
+  standard: config/base.yml
+
+AllCops:
+  NewCops: disable
+  TargetRubyVersion: 3.1
+  SuggestExtensions: false

data/README.md

@@ -1,43 +1,91 @@
-# HastCI
+# HastCI RSpec
 
-TODO: Delete this and the text below, and describe your gem
-
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/hastci`. To experiment with that code, run `bin/console` for an interactive prompt.
+Distributed test execution for RSpec. Workers pull tests from a central queue, so faster workers automatically run more tests.
 
 ## Installation
 
-TODO: Replace `UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG` with your gem name right after releasing it to RubyGems.org. Please do not do it earlier due to security reasons. Alternatively, replace this section with instructions to install your gem from git if you don't plan to release to RubyGems.org.
+Add to your Gemfile:
 
-Install the gem and add to the application's Gemfile by executing:
+```ruby
+group :development, :test do
+  gem "hastci-rspec"
+end
+```
 
-```bash
-bundle add UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+## Usage
+
+### GitHub Actions
+
+HastCI auto-detects GitHub Actions and configures itself from the environment.
+
+```yaml
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ci_node_index: [0, 1, 2, 3]
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec hastci-rspec
+        env:
+          CI_NODE_INDEX: ${{ matrix.ci_node_index }}
+          HASTCI_API_KEY: ${{ secrets.HASTCI_API_KEY }}
+```
+
+For matrix builds with multiple dimensions (e.g., Ruby versions), use `HASTCI_SUBRUN_ID` to create separate test queues:
+
+```yaml
+strategy:
+  matrix:
+    ruby-version: ["3.2", "3.3", "3.4"]
+    ci_node_index: [0, 1]
+
+# ...
+
+env:
+  CI_NODE_INDEX: ${{ matrix.ci_node_index }}
+  HASTCI_API_KEY: ${{ secrets.HASTCI_API_KEY }}
+  HASTCI_SUBRUN_ID: ruby-${{ matrix.ruby-version }}
 ```
 
-If bundler is not being used to manage dependencies, install the gem by executing:
+### Generic CI
+
+For other CI systems, set the required environment variables:
 
 ```bash
-gem install UPDATE_WITH_YOUR_GEM_NAME_IMMEDIATELY_AFTER_RELEASE_TO_RUBYGEMS_ORG
+export HASTCI_API_KEY="your-api-key"
+export HASTCI_RUN_KEY="unique-run-identifier"  # e.g., build-123-abc
+export CI_NODE_INDEX="0"  # 0, 1, 2... for each parallel worker
+
+bundle exec hastci-rspec
 ```
 
-## Usage
+## Configuration
 
-TODO: Write usage instructions here
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `HASTCI_API_KEY` | Yes | API key for HastCI |
+| `HASTCI_RUN_KEY` | Generic CI only | Unique identifier for this test run |
+| `CI_NODE_INDEX` | Yes | Worker index (0, 1, 2...) |
+| `HASTCI_WORKER_ID` | No | Custom worker ID (overrides `CI_NODE_INDEX`) |
+| `HASTCI_SUBRUN_ID` | No | Distinguishes matrix variations (GitHub Actions) |
+| `HASTCI_API_URL` | No | Custom API endpoint |
 
 ## 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.
-
-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 the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/wojtodzio/hastci. 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/wojtodzio/hastci/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/wojtodzio/hastci.
 
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## Code of Conduct
-
-Everyone interacting in the HastCI project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/wojtodzio/hastci/blob/main/CODE_OF_CONDUCT.md).

data/bin/hastci-rspec

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
-require 'hastci'
+require "hastci"
 
 exit HastCI.run_rspec(argv: ARGV, env: ENV)

data/lib/hastci/adapters/rspec/runner.rb

@@ -25,6 +25,7 @@ module HastCI
           @clock = clock
 
           @options = ::RSpec::Core::ConfigurationOptions.new(argv)
+          add_default_path_if_needed(@options, configuration)
           @configuration = configuration
           @world = world
         end
@@ -190,6 +191,16 @@ module HastCI
           end
           # :nocov:
         end
+
+        def add_default_path_if_needed(options, configuration)
+          files = options.options[:files_or_directories_to_run]
+          return unless files.empty?
+
+          default_path = configuration.default_path
+          return unless default_path
+
+          files << default_path
+        end
       end
     end
   end

data/lib/hastci/config.rb

@@ -5,7 +5,7 @@ require "securerandom"
 module HastCI
   class Config
     DEFAULT_API_BASE_URL = "https://hastci.com"
-    DEFAULT_CLAIM_BATCH_SIZE = 3
+    DEFAULT_CLAIM_BATCH_SIZE = 2
     DEFAULT_HEARTBEAT_INTERVAL = 15
     DEFAULT_SEEDING_TIMEOUT = 300
     DEFAULT_LOG_LEVEL = "INFO"
@@ -33,12 +33,16 @@ module HastCI
       run_attempt = env.fetch("GITHUB_RUN_ATTEMPT")
       commit_sha = env.fetch("GITHUB_SHA")
       node_index = env.fetch("CI_NODE_INDEX")
+      subrun_id = env["HASTCI_SUBRUN_ID"]
+
+      base_run_key = "gha-#{run_id}-#{run_attempt}-#{commit_sha}"
+      run_key = subrun_id ? "#{base_run_key}-#{subrun_id}" : base_run_key
 
       new(
         api_key: env.fetch("HASTCI_API_KEY"),
         api_base_url: env.fetch("HASTCI_API_URL", DEFAULT_API_BASE_URL),
         api_max_retries: env["HASTCI_API_MAX_RETRIES"]&.to_i,
-        run_key: "gha-#{run_id}-#{run_attempt}-#{commit_sha}",
+        run_key: run_key,
         worker_id: "gha-worker-#{node_index}",
         commit_sha: commit_sha,
         claim_batch_size: env.fetch("HASTCI_CLAIM_BATCH_SIZE", DEFAULT_CLAIM_BATCH_SIZE).to_i,

data/lib/hastci/session.rb

@@ -4,7 +4,7 @@ module HastCI
   class Session
     DEFAULT_POLL_INTERVAL = 0.5
     DEFAULT_BUFFER_MIN_SIZE = 1
-    DEFAULT_BUFFER_MAX_SIZE = 3
+    DEFAULT_BUFFER_MAX_SIZE = 2
     DEFAULT_SEEDING_POLL_INTERVAL = 1.0
 
     STOP_REASONS = %i[user_interrupt server_cancelled].freeze

data/lib/hastci/version.rb

@@ -2,6 +2,6 @@
 
 # :nocov:
 module HastCI
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end
 # :nocov:

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hastci
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Wojciech Wrona
@@ -46,6 +46,7 @@ extra_rdoc_files: []
 files:
 - ".envrc"
 - ".rspec"
+- ".rubocop.yml"
 - ".standard.yml"
 - ".zed/settings.json"
 - CHANGELOG.md