fast_rspec 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1b05996c57beb4f83fb4caf12d26f35a65fbf409c8d619d87ffce12bdde9ef80
+  data.tar.gz: 541f1dc10532f7281593d3999a9059ef97b49b736f1ae201b9d45cd132a3e474
+SHA512:
+  metadata.gz: b26c6d68981a21b2fc4e96318d7002130e72428ae3c123a5eaf7177da03f73954139c128fe3b0d19cd438f4b5754a14bfaab757dd3abc084a05b3f593fe8b975
+  data.tar.gz: 24a7e0d5a058a289d960a058a77c8ead24b9899eea9e0255c68144635c2048e818f0c5a594abc23c2f7e7b09a264079449d3b11c94a8d4bc2b7cb6ce1ac9cdc3

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## [Unreleased]
+
+- Project skeleton: gemspec, C ext + pure-Ruby twin stubs, docs/idea design set, docs/target compat specs, agent setup (.claude, .dz maintainer, CI OK gate, release-on-version-bump).

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 developerz.ai
+
+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,87 @@
+# FastRspec
+
+**One gem line. Your whole test stack. Every core.**
+
+Drop-in replacement for RSpec **and** Minitest (including Rails' `ActiveSupport::TestCase`), rebuilt lean: same API, a fraction of the overhead. Runs in parallel on all cores by default, and ships with batteries included and auto-configured: factories, Faker, VCR, WebMock, database cleaning, shoulda, time helpers, Capybara and coverage. Works with Rails and with plain Ruby. Runs on CRuby, JRuby and TruffleRuby.
+
+> **Status: design phase (2026-10).** Gem skeleton only, nothing is implemented yet. See [`docs/idea/`](docs/idea/00-seed.md).
+
+## Install
+
+```ruby
+# Gemfile
+group :development, :test do
+  gem 'fast_rspec'
+end
+```
+
+Then delete the gems it replaces:
+
+```diff
+- gem 'rspec'
+- gem 'rspec-rails'
+- gem 'factory_bot_rails'
+- gem 'faker'
+- gem 'vcr'
+- gem 'webmock'
+- gem 'database_cleaner-active_record'
+- gem 'simplecov'
+- gem 'minitest-reporters'
++ gem 'fast_rspec'
+```
+
+## Run
+
+Your commands stay the same:
+
+```bash
+bundle exec rspec          # all cores
+bin/rails test             # all cores; `parallelize` is handled for you
+bundle exec rake test      # plain Ruby + Minitest
+bundle exec fast_rspec     # auto-detects RSpec / Minitest / both
+```
+
+You don't need to change any spec, test, `spec_helper.rb`, `rails_helper.rb`, `test_helper.rb` or `test/support/**` file. If you already configured something yourself, your configuration wins.
+
+## What's included
+
+✅ = FastRspec's own lean implementation of the upstream API (zero runtime dependencies). 🔌 = keep the upstream gem in your Gemfile; FastRspec auto-configures it.
+
+| Battery | Same API as | Auto-configured |
+|---|---|---|
+| 🧪 RSpec ✅ | rspec-core, -expectations, -mocks, -rails | `.rspec` honoured, type inference on Rails |
+| 🧪 Minitest ✅ | minitest 5 + 6, `ActiveSupport::TestCase` | `parallelize` routed to our pool |
+| 🏭 Factories ✅ | factory_bot (+ rails) | definitions found, `create`/`build` included |
+| 🎲 Fake data ✅ | faker | deterministic per `--seed`, unique reset per test |
+| 📼 HTTP ✅ | vcr + webmock | cassettes in `spec/cassettes` or `test/cassettes`, real net blocked, localhost allowed |
+| 🧹 DB ✅ | transactional tests + database_cleaner | per-worker DB, cloned from a template |
+| 🔍 Matchers 🔌 | shoulda-matchers / -context | integrated with the framework in use |
+| ⏱️ Time 🔌 | ActiveSupport `TimeHelpers` | included everywhere |
+| 🌐 System 🔌 | capybara + cuprite | headless Chrome, unique port per worker |
+| 📊 Coverage ✅ | simplecov | merged across workers (`COVERAGE=1`) |
+| 🔐 Auth / jobs 🔌 | Devise, Sidekiq / Wurk, ActiveJob | test helpers, fake/inline modes, per-worker Redis DB |
+
+Turn any of them off:
+
+```ruby
+FastRspec.configure { |c| c.batteries.disable :vcr, :capybara }
+```
+
+## Parallelism
+
+| Ruby | How it runs |
+|---|---|
+| CRuby | boots once, forks N workers (copy-on-write), work-stealing queue, C extension on hot paths |
+| JRuby / TruffleRuby | a real parallel thread pool (no GVL), using the pure-Ruby implementation |
+
+`N` is the number of cores by default. Use `FAST_RSPEC_WORKERS=4` to change it, or `-n 1` for a serial run. Each worker gets its own database, Redis DB, tmp dir and ports. When a test fails, you get a one-line command that reproduces it, including the seed and the worker's files.
+
+## Docs
+
+- [`docs/idea/`](docs/idea/00-seed.md): design and roadmap
+- [`AGENTS.md`](AGENTS.md): conventions for contributors and AI agents
+- [`llms.txt`](llms.txt): one-file reference for coding agents (target contract; status per milestone)
+
+## License
+
+MIT

data/exe/fast_rspec

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'fast_rspec'
+
+abort "fast_rspec #{FastRspec::VERSION}: runner not implemented yet — see docs/idea/03-runner.md"

data/ext/fast_rspec/extconf.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Only CRuby gets the C fast path. Elsewhere write a no-op Makefile so
+# `gem install` succeeds and FastRspec::PureRuby is used.
+if RUBY_ENGINE == 'ruby'
+  require 'mkmf'
+  $CFLAGS << ' -O3 -std=c99 -Wall' # rubocop:disable Style/GlobalVars -- mkmf API
+  create_makefile('fast_rspec/fast_rspec')
+else
+  File.write('Makefile', "all:\n\ttrue\ninstall:\n\ttrue\nclean:\n\ttrue\n")
+end

data/ext/fast_rspec/fast_rspec.c

@@ -0,0 +1,11 @@
+#include <ruby.h>
+
+/* FastRspec::Native — measured hot paths only. Must match FastRspec::PureRuby byte for byte. */
+
+static VALUE engine(VALUE self) { return rb_str_new_cstr("native"); }
+
+void Init_fast_rspec(void) {
+  VALUE mFastRspec = rb_define_module("FastRspec");
+  VALUE mNative = rb_define_module_under(mFastRspec, "Native");
+  rb_define_module_function(mNative, "engine", engine, 0);
+}

data/lib/fast_rspec/configuration.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module FastRspec
+  # User-facing knobs. Defaults are the zero-config path; every field is optional.
+  class Configuration
+    attr_accessor :workers, :pool
+
+    def initialize
+      @workers = Integer(ENV.fetch('FAST_RSPEC_WORKERS', Etc.nprocessors))
+      @pool = (ENV['FAST_RSPEC_POOL'] || default_pool).to_sym
+      @disabled = []
+    end
+
+    def batteries = self
+
+    def disable(*names) = @disabled.concat(names.map(&:to_sym))
+
+    def disabled?(name) = @disabled.include?(name.to_sym)
+
+    private
+
+    # fork where it's cheap and real (CRuby); threads where there is no GVL.
+    def default_pool
+      RUBY_ENGINE == 'ruby' && Process.respond_to?(:fork) ? :fork : :thread
+    end
+  end
+end
+
+require 'etc'

data/lib/fast_rspec/detect.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module FastRspec
+  # What the host app has. Pure queries, no side effects — batteries decide what to do.
+  module Detect
+    module_function
+
+    def rails? = defined?(::Rails::Railtie) ? true : false
+    def active_record? = defined?(::ActiveRecord::Base) ? true : false
+    def rspec? = File.exist?('.rspec') || Dir.exist?('spec')
+    def minitest? = Dir.exist?('test')
+    def gem?(name) = Gem.loaded_specs.key?(name)
+  end
+end

data/lib/fast_rspec/rails/railtie.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module FastRspec
+  # Rails integration entry point. Wires batteries after the app boots.
+  class Railtie < ::Rails::Railtie
+  end
+end

data/lib/fast_rspec/render/pure_ruby.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module FastRspec
+  # Pure-Ruby twin of FastRspec::Native (JRuby, TruffleRuby, failed ext build).
+  module PureRuby
+    module_function
+
+    def engine = 'pure_ruby'
+  end
+end

data/lib/fast_rspec/render.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module FastRspec
+  # Picks the C fast path on CRuby, the pure-Ruby twin elsewhere.
+  # Both must produce byte-identical output (see test/unit/render_parity_test.rb).
+  module Render
+    begin
+      raise LoadError if ENV['FAST_RSPEC_DISABLE_EXT'] == '1' || RUBY_ENGINE != 'ruby'
+
+      require_relative 'fast_rspec'
+      IMPL = FastRspec::Native
+    rescue LoadError
+      require_relative 'render/pure_ruby'
+      IMPL = FastRspec::PureRuby
+    end
+
+    def self.native? = IMPL.name == 'FastRspec::Native'
+  end
+end

data/lib/fast_rspec/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FastRspec
+  VERSION = '0.0.1'
+end

data/lib/fast_rspec.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative 'fast_rspec/version'
+
+# One gem line replaces the whole test stack. See AGENTS.md and docs/idea/.
+module FastRspec
+  class Error < StandardError; end
+
+  autoload :Configuration, 'fast_rspec/configuration'
+  autoload :Detect,        'fast_rspec/detect'
+  autoload :Render,        'fast_rspec/render'
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield configuration
+    end
+  end
+end
+
+require_relative 'fast_rspec/rails/railtie' if defined?(Rails::Railtie)

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: fast_rspec
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- developerz.ai
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: One gem line replaces rspec-rails, factory_bot, faker, vcr, webmock,
+  database_cleaner, shoulda, capybara and simplecov. Parallel on every core by default
+  (fork on CRuby, threads on JRuby/TruffleRuby). Works with Rails and plain Ruby.
+email:
+- admin@developerz.ai
+executables:
+- fast_rspec
+extensions:
+- ext/fast_rspec/extconf.rb
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- exe/fast_rspec
+- ext/fast_rspec/extconf.rb
+- ext/fast_rspec/fast_rspec.c
+- lib/fast_rspec.rb
+- lib/fast_rspec/configuration.rb
+- lib/fast_rspec/detect.rb
+- lib/fast_rspec/rails/railtie.rb
+- lib/fast_rspec/render.rb
+- lib/fast_rspec/render/pure_ruby.rb
+- lib/fast_rspec/version.rb
+homepage: https://github.com/developerz-ai/fast_rspec
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/developerz-ai/fast_rspec
+  changelog_uri: https://github.com/developerz-ai/fast_rspec/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/developerz-ai/fast_rspec/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Lean drop-in RSpec + Minitest, parallel on every core, whole test stack bundled.
+test_files: []