constable-rails 0.1.0

data/lib/generators/constable/templates/example_case.rb.tt

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+# A worked example, so `constable test` does something the moment you install the
+# gem. Delete it once you have a real case file -- or keep it as a scratchpad for
+# checking that the harness itself still boots.
+#
+# The vocabulary is the API:
+#
+#   investigate  a test        (it / def test_)      -- a plain string description
+#   witness      a fixture     (let)                 -- memoized per test, never per process
+#   briefing     setup         (before / setup)      -- runs before every investigation
+#   docket       grouping      (nested describe)     -- scoping sugar, no shared state
+#   attest       an assertion  (expect)              -- sugar over assert_*, which still works
+class ExampleCase < UnitCase
+  # A witness is memoized inside one investigation and thrown away at the end of
+  # it. Name it five times in a test, pay for it once; the next test builds its
+  # own. That boundary is the whole reason there is no cross-test cache.
+  witness(:badge) { { number: 1, name: "Constable" } }
+
+  # A briefing runs before *every* investigation below, against a brand-new
+  # instance. There is no before(:all) to reach for, which is why nothing an
+  # investigation does here can reach the next one.
+  briefing do
+    @notes = []
+  end
+
+  investigate "runs the moment the gem is installed" do
+    @notes << badge[:name]
+
+    attest(@notes).to eq(["Constable"])
+  end
+
+  investigate "hands the next investigation a clean slate" do
+    # @notes was emptied by the briefing again, and the previous investigation's
+    # push is nowhere to be found. This passes in any order, on any machine.
+    attest(@notes).to be_empty
+  end
+
+  # Dockets group related investigations and scope setup to the group. They
+  # introduce no shared state -- each investigation inside still gets its own
+  # fresh instance, its own briefings, its own witnesses.
+  docket "with a nested docket" do
+    briefing { @notes << "on the beat" }
+
+    investigate "inherits the outer briefing before running its own" do
+      attest(@notes).to eq(["on the beat"])
+    end
+  end
+
+  # The assert_* primitives are always available alongside attest. attest is
+  # sugar, never the only road.
+  investigate "still speaks plain assertions" do
+    assert_equal 1, badge[:number]
+    assert_includes badge[:name], "Const"
+  end
+end

data/lib/generators/constable/templates/matchers.rb.tt

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Custom matchers.
+#
+# `attest(actual).to matcher` is sugar over the plain assert_* primitives, which
+# are always available too -- attest never becomes the only way to say a thing.
+# A matcher block returns truthy to pass:
+#
+#   Constable::Matchers.define(:name) { |actual, *args| ... }
+#
+# or returns [passed, message, context] when it can say something more useful
+# than "expected it to match" on failure. `context` is printed under the failure
+# in the run summary, which is where a response body or a record's attributes
+# earn their keep.
+#
+# Everything in test/support/ is loaded by test/case_helper.rb before any case
+# file, so a matcher defined here is available to every case in the suite.
+
+Constable::Matchers.define(:be_created) do |response|
+  response.status == 201
+end
+
+Constable::Matchers.define(:exist) do |model_class, attrs|
+  model_class.exists?(attrs)
+end
+
+# The richer form, for when the failure message is the difference between a
+# five-second fix and a five-minute one:
+#
+# Constable::Matchers.define(:have_role) do |user, role|
+#   [
+#     user.roles.include?(role),
+#     "expected #{user.class}##{user.id} to have role #{role.inspect}",
+#     { roles: user.roles }
+#   ]
+# end

data/lib/generators/constable/templates/rubocop.yml.tt

@@ -0,0 +1,12 @@
+# Constable's linter.
+#
+# Nondeterminism is caught here, at edit time, rather than discovered in CI three
+# weeks later: bare `sleep`, unfrozen Time.now/Date.today, unstubbed network
+# calls, shared mutable state, conditional assertions, retry helpers.
+#
+# The cops are scoped to native Constable::Case files only. A file inheriting
+# from Constable::ColdCase::* is exempt by design -- cold cases are how a legacy
+# suite adopts Constable without a rewrite, and holding them to native rules on
+# day one would defeat that entirely.
+require:
+  - rubocop-constable

metadata

@@ -0,0 +1,209 @@
+--- !ruby/object:Gem::Specification
+name: constable-rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Ray Hughes
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2026-09-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+description: |
+  Constable replaces RSpec/Minitest for Rails apps that want tests to be fast and
+  non-flaky by construction. Every test is isolated by default, nondeterminism is a
+  lint error rather than a CI surprise, and every escape hatch is reported until
+  someone deals with it. Existing RSpec and Minitest suites adopt it with a one-line
+  change per file and zero rewriting -- cold cases run verbatim through their original
+  engine while native cases run under strict rules, side by side in one run.
+
+  Ships with a case-file DSL (investigate/witness/briefing/docket), transactional
+  isolation, flake history with rename-surviving content-hash identity, a jail and
+  parole docket for legacy red suites, warrants for automatic flake detection, diff-based
+  coverage, parallel workers, git-diff test selection, and a RuboCop extension.
+
+  The gem is published as "constable-rails"; everything inside it -- the module, the
+  CLI, the config directory -- is simply "constable".
+email:
+- r.hughes2136@gmail.com
+executables:
+- constable
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- exe/constable
+- lib/constable-rails.rb
+- lib/constable.rb
+- lib/constable/case.rb
+- lib/constable/cli.rb
+- lib/constable/cold_case.rb
+- lib/constable/cold_case/minitest.rb
+- lib/constable/cold_case/rspec.rb
+- lib/constable/config.rb
+- lib/constable/coverage.rb
+- lib/constable/diff.rb
+- lib/constable/dsl.rb
+- lib/constable/identity.rb
+- lib/constable/importer.rb
+- lib/constable/importer/modernizer.rb
+- lib/constable/importer/reopener.rb
+- lib/constable/investigation.rb
+- lib/constable/isolation.rb
+- lib/constable/jail.rb
+- lib/constable/log_router.rb
+- lib/constable/matchers.rb
+- lib/constable/order_audit.rb
+- lib/constable/rails_support.rb
+- lib/constable/railtie.rb
+- lib/constable/registry.rb
+- lib/constable/reporter.rb
+- lib/constable/result.rb
+- lib/constable/runner.rb
+- lib/constable/selection.rb
+- lib/constable/storage.rb
+- lib/constable/storage/adapter.rb
+- lib/constable/storage/mysql_adapter.rb
+- lib/constable/storage/postgres_adapter.rb
+- lib/constable/storage/sqlite_adapter.rb
+- lib/constable/version.rb
+- lib/constable/warrants.rb
+- lib/generators/constable/base.rb
+- lib/generators/constable/channel/channel_generator.rb
+- lib/generators/constable/channel/templates/channel_case.rb.tt
+- lib/generators/constable/controller/controller_generator.rb
+- lib/generators/constable/controller/templates/controller_case.rb.tt
+- lib/generators/constable/generator/generator_generator.rb
+- lib/generators/constable/generator/templates/generator_case.rb.tt
+- lib/generators/constable/helper/helper_generator.rb
+- lib/generators/constable/helper/templates/helper_case.rb.tt
+- lib/generators/constable/import_generator.rb
+- lib/generators/constable/install_generator.rb
+- lib/generators/constable/integration/integration_generator.rb
+- lib/generators/constable/integration/templates/request_case.rb.tt
+- lib/generators/constable/job/job_generator.rb
+- lib/generators/constable/job/templates/job_case.rb.tt
+- lib/generators/constable/mailbox/mailbox_generator.rb
+- lib/generators/constable/mailbox/templates/mailbox_case.rb.tt
+- lib/generators/constable/mailer/mailer_generator.rb
+- lib/generators/constable/mailer/templates/mailer_case.rb.tt
+- lib/generators/constable/mailer/templates/preview.rb.tt
+- lib/generators/constable/model/model_generator.rb
+- lib/generators/constable/model/templates/model_case.rb.tt
+- lib/generators/constable/resource/resource_generator.rb
+- lib/generators/constable/scaffold/scaffold_generator.rb
+- lib/generators/constable/scaffold/templates/api_controller_case.rb.tt
+- lib/generators/constable/scaffold/templates/controller_case.rb.tt
+- lib/generators/constable/scaffold/templates/system_case.rb.tt
+- lib/generators/constable/system/system_generator.rb
+- lib/generators/constable/system/templates/system_case.rb.tt
+- lib/generators/constable/templates/authenticatable.rb.tt
+- lib/generators/constable/templates/case_helper.rb.tt
+- lib/generators/constable/templates/config.yml.tt
+- lib/generators/constable/templates/example_case.rb.tt
+- lib/generators/constable/templates/matchers.rb.tt
+- lib/generators/constable/templates/rubocop.yml.tt
+homepage: https://github.com/Ray-Hughes/constable
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/Ray-Hughes/constable
+  source_code_uri: https://github.com/Ray-Hughes/constable
+  changelog_uri: https://github.com/Ray-Hughes/constable/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/Ray-Hughes/constable/issues
+  documentation_uri: https://github.com/Ray-Hughes/constable#readme
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: A strict Rails testing framework where fast and non-flaky are structural,
+  not disciplinary.
+test_files: []