Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .dz/maintainer/reviewer.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

## Stack

Ruby >= 3.2 (development pin `3.4` in `mise.toml` and `apps/fast-rspec/.ruby-version`),
Ruby >= 3.2 (development pin `4.0` in `mise.toml` and `apps/fast-rspec/.ruby-version`),
Bundler, Rake, rake-compiler, a C extension (`apps/fast-rspec/ext/fast_rspec/`) with a
pure-Ruby twin, RuboCop with the minitest/performance/rake plugins. The gem lives under
`apps/fast-rspec/`. The gate is `bin/check` (lint, compile, unit, forced-PureRuby unit,
Expand Down Expand Up @@ -82,7 +82,7 @@ planned (`AGENTS.md` § Stack and status, `docs/idea/11-roadmap.md`).
- Dead code, speculative abstractions or backwards-compat shims.
- RuboCop `TargetRubyVersion` (`apps/fast-rspec/.rubocop.yml`) out of step with the
gemspec's `required_ruby_version`.
- An exact-patch Ruby pin (`3.4.7`) in `mise.toml` or `.ruby-version`: CI images only build
- An exact-patch Ruby pin (`4.0.10`) in `mise.toml` or `.ruby-version`: CI images only build
the latest patch per series.

**Public tree and release**
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ jobs:
steps:
- uses: actions/checkout@v7
- uses: ruby/setup-ruby@v1
with: { ruby-version: '3.4', bundler-cache: true }
with: { ruby-version: '4.0', bundler-cache: true }
- run: bundle exec rubocop --parallel
- name: Public tree
env:
Expand All @@ -46,7 +46,7 @@ jobs:
strategy:
fail-fast: false
matrix:
ruby: ['3.2', '3.4', 'jruby', 'truffleruby']
ruby: ['3.2', '3.4', '4.0', 'jruby', 'truffleruby']
steps:
- uses: actions/checkout@v7
- uses: ruby/setup-ruby@v1
Expand All @@ -65,7 +65,7 @@ jobs:
steps:
- uses: actions/checkout@v7
- uses: ruby/setup-ruby@v1
with: { ruby-version: '3.4', bundler-cache: true }
with: { ruby-version: '4.0', bundler-cache: true }
- run: bundle exec rake smoke

demo:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ jobs:
steps:
- uses: actions/checkout@v7
- uses: ruby/setup-ruby@v1
with: { ruby-version: '3.4', bundler-cache: true }
with: { ruby-version: '4.0', bundler-cache: true }

- name: Verify
run: bundle exec rake compile test smoke
Expand Down
4 changes: 2 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Canonical guide for AI coding agents working on this repository.

| Area | Current stack / intended contract |
|---|---|
| Runtime | Ruby >= 3.2; development pin Ruby 3.4 (`mise.toml`, `apps/fast-rspec/.ruby-version`); no runtime gem dependencies |
| Runtime | Ruby >= 3.2; development pin Ruby 4.0 (`mise.toml`, `apps/fast-rspec/.ruby-version`); no runtime gem dependencies |
| Tooling | Bundler, Rake, rake-compiler on CRuby, RuboCop with Minitest/performance/Rake plugins |
| Existing scaffold | Configuration/autoload entrypoint, detection, conditional Railtie, native/pure rendering, bootstrap tests and CLI scaffold |
| Planned frameworks | Clean RSpec + Minitest implementations on one engine, including `ActiveSupport::TestCase`; Rails 7.1+ |
Expand Down Expand Up @@ -77,7 +77,7 @@ This heading preserves the `#layout-planned` design-document link. The gem lives
- Before wiring anything, check for user configuration. Log automatic wiring at `FAST_RSPEC_DEBUG=1`.
- Use frozen string literals everywhere. Comments explain non-obvious reasons, not the code itself.
- Minimize allocations/syscalls in scheduler/reporter loops: one IPC message per file, not per example; no per-test process spawn.
- Pin the Ruby series, not an exact patch (`3.4`, not `3.4.7`) in `mise.toml` and `apps/fast-rspec/.ruby-version`: CI runner images build only the latest patch of each series, so an exact-patch pin 404s in `ruby/setup-ruby`.
- Pin the Ruby series, not an exact patch (`4.0`, not `4.0.10`) in `mise.toml` and `apps/fast-rspec/.ruby-version`: CI runner images build only the latest patch of each series, so an exact-patch pin 404s in `ruby/setup-ruby`.
- C sources include `<stdbool.h>` before `<ruby.h>`: Ruby 3.2's `ruby/internal/stdbool.h` defines `bool` only when the installed `ruby/config.h` carries `HAVE_STDBOOL_H` (3.3+ includes the header itself), so the 3.2 floor needs it explicitly.

## Testing rules
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ The gem lives in `apps/fast-rspec/`; the repository root holds the shared toolin

### Prerequisites and setup

- Bash, Ruby and Bundler, plus access to RubyGems to install the development bundle. The gem requires Ruby >= 3.2; `mise.toml` and `apps/fast-rspec/.ruby-version` both select Ruby 3.4.
- Bash, Ruby and Bundler, plus access to RubyGems to install the development bundle. The gem requires Ruby >= 3.2; `mise.toml` and `apps/fast-rspec/.ruby-version` both select Ruby 4.0.
- With `mise` installed, setup installs and selects the configured toolchain. Without `mise`, setup uses the Ruby already on `PATH`; provide a supported Ruby and Bundler yourself.
- CRuby needs a C compiler, make and Ruby development headers for the native extension. Setup's build-tool provisioning uses Debian/Ubuntu's `dpkg` and `apt-get`; if `build-essential` is missing, it requires passwordless `sudo` and package-repository access. This is not a portable OS provisioning script.

Expand Down
2 changes: 1 addition & 1 deletion apps/fast-rspec/.ruby-version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
3.4
4.0
2 changes: 1 addition & 1 deletion bin/setup
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ if ! dpkg -s build-essential >/dev/null 2>&1; then
sudo -n apt-get update && sudo -n apt-get install -y --no-install-recommends build-essential
fi

# Ruby comes from mise (mise.toml pins 3.4); a box without mise keeps the system Ruby.
# Ruby comes from mise (mise.toml pins 4.0); a box without mise keeps the system Ruby.
if command -v mise >/dev/null 2>&1; then
mise install
mise_env="$(mise env --shell bash)"
Expand Down
2 changes: 1 addition & 1 deletion demo/rails/.ruby-version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
3.4
4.0
2 changes: 1 addition & 1 deletion demo/rails/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ BUNDLE_GEMFILE=gemfiles/upstream.gemfile bundle exec rspec spec/models
`config/boot.rb` and `bin/rspec` map `STACK` to `BUNDLE_GEMFILE` (an explicit `BUNDLE_GEMFILE`
wins). The root `Gemfile` just `eval_gemfile`s the chosen stack so a plain `bundle install` works.

Needs Ruby 3.4, SQLite, and Chrome/Chromium for the one JS test (found on `PATH` or via
Needs Ruby 4.0, SQLite, and Chrome/Chromium for the one JS test (found on `PATH` or via
`BROWSER_PATH`; skipped cleanly when absent or `DEMO_JS=0`).

## Matrix (2026-10-31, 12 cores, Chrome present)
Expand Down
2 changes: 1 addition & 1 deletion mise.toml
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Toolchain as text. Keep in lock-step with .github/workflows/ci.yml.
[tools]
ruby = "3.4"
ruby = "4.0"