turbo_rspec 1.6.0 → 1.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3211f811cbd7919d35f8b918260ea97346668fb2ef3213f189d91c642a014b53
-  data.tar.gz: dda8641bcf4d6cb1a8ebc6de4ee5d7622f90bcec3a79b8180444b6e4bfcd2c38
+  metadata.gz: a307e4f793b6394100ac49bfe9e360cf1ca378e3204dfeb4070a839781eb6e1b
+  data.tar.gz: 7d0bf9057477f2c5188c050c0f90ea1be1a7732f016d5b86180f4cdde51f0073
 SHA512:
-  metadata.gz: 352e59c5604c6362263a51d6b0eb9903b1b7c7b337bca65a05e01c15b42bae5e121def5d638ed66f8b73d06fda382460a85dce4d15ab7a3bff234fb26c310759
-  data.tar.gz: 1243fc05f3fc0256f3e028c66d505a0cbf8335108238c6fde0c0b4e6a0fc97f630bd2ae59c51cb37e64a0ce81265fb20b2d8c9be2e850ef7b29a3442c18f6991
+  metadata.gz: ff66bd9fcee4b8feca948ec65598f98ee54be6dd7a8bb23fd1d71632d1c93ec11b9589648d50256da25ac7022c1414d7351c0021738318ce9b296a743c893d38
+  data.tar.gz: bb0efb7f7b138f5052eb7cc2fc5cbed38f97799c0aceaff6420e4df01502aab436527eb53606f0fa0d10a0442320c4552bf6b7506f7ac42495a29c2f6120052f

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## [Unreleased]
 
+## [1.6.1] - 2026-06-07
+
+### Fixed
+
+- `shared_examples.rb` now guards on `RSpec.respond_to?(:shared_examples)` in addition to `defined?(RSpec)`, preventing errors when the `rspec` meta-gem is required but `rspec-core` is not yet fully initialized (e.g. during `rails assets:precompile` in the test environment)
+
 ## [1.6.0] - 2026-06-02
 
 ### Added

data/CONTRIBUTING.md

@@ -0,0 +1,90 @@
+# Contributing to turbo_rspec
+
+Bug reports and pull requests are welcome. This guide covers everything you need to get up and running.
+
+## Setup
+
+```bash
+git clone https://github.com/eclectic-coding/turbo_rspec.git
+cd turbo_rspec
+bin/setup          # installs gems and wires up the pre-push hook
+```
+
+## Running the suite
+
+```bash
+bundle exec rake                        # full suite: lint + tests (what CI runs)
+bundle exec rspec                       # tests only
+bundle exec rspec spec/path/to/foo_spec.rb       # single file
+bundle exec rspec spec/path/to/foo_spec.rb:42    # single example
+bundle exec standardrb --no-fix        # lint only
+```
+
+CI requires **100% line and branch coverage** — SimpleCov will exit non-zero if either drops below that threshold.
+
+## Branch workflow
+
+Always work on a feature or chore branch — never commit directly to `main`:
+
+```
+feat/short-description    # new matchers, new API
+chore/short-description   # docs, tooling, dependency bumps
+fix/short-description     # bug fixes
+```
+
+## CHANGELOG
+
+Add an entry under `## [Unreleased]` **on your branch before opening a PR**, not after merging. Use these section headers in order (omit any that have no entries):
+
+```markdown
+### Added
+### Changed
+### Fixed
+```
+
+CHANGELOG entries are **user-facing only** — document changes to the public API. Pure internal refactors, docs updates, and CI fixes don't need an entry.
+
+## Pre-push hook
+
+`bin/setup` installs a pre-push hook that runs automatically on every push:
+
+- **Blocks** the push if `lib/` files changed but `CHANGELOG.md` has no new entry under `## [Unreleased]`.
+- **Warns** (advisory, doesn't block) if `README.md` or `ROADMAP.md` look untouched.
+
+To bypass when the push genuinely doesn't need a CHANGELOG entry (tooling-only changes):
+
+```bash
+git push --no-verify
+```
+
+## Pull requests
+
+1. Open a PR against `main`.
+2. All CI checks must pass: lint, security audit, and the full test matrix (Ruby 3.3–4.0 × Rails 7.2–8.1).
+3. Link the relevant GitHub issue in the PR description (`Closes #N`).
+
+## Code conventions
+
+- **StandardRB** enforces style — run `bundle exec rake standard:fix` to auto-correct before pushing.
+- Match the surrounding style for failure messages: use `✓`/`✗` indicators and a "closest match" section when showing constraint diffs.
+- New public methods need YARD `@param` and `@return` tags, and an entry in `sig/turbo_rspec.rbs`.
+- Private helpers don't need YARD docs.
+
+## Custom Turbo actions
+
+If a spec needs to assert a custom Turbo stream action, register it in the test setup rather than using `--no-verify` to bypass the `ArgumentError`:
+
+```ruby
+before { TurboRspec.register_action(:my_action) }
+after  { TurboRspec.reset_configuration! }
+```
+
+## Releasing (maintainers only)
+
+Releases are cut from `main` using the release script:
+
+```bash
+bin/release 1.2.0
+```
+
+This bumps the version, updates `CHANGELOG.md` and `Gemfile.lock`, commits, tags, and pushes. CI picks up the tag and publishes to RubyGems via Trusted Publishing.

data/README.md

@@ -445,7 +445,7 @@ refute_broadcasted_turbo_stream_to("notifications") { MyJob.perform_now }
 
 ## Contributing
 
-Bug reports and pull requests are welcome on [GitHub](https://github.com/eclectic-coding/turbo_rspec).
+Bug reports and pull requests are welcome on [GitHub](https://github.com/eclectic-coding/turbo_rspec). See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, branch conventions, CHANGELOG requirements, and the PR checklist.
 
 ## License
 

data/lib/turbo_rspec/shared_examples.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # :nocov:
-if defined?(RSpec)
+if defined?(RSpec) && RSpec.respond_to?(:shared_examples)
   # :nocov:
   RSpec.shared_examples "a turbo stream response" do |action: nil, target: nil, targets: nil, content: nil, partial: nil|
     it "responds with a turbo stream" do

data/lib/turbo_rspec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TurboRspec
-  VERSION = "1.6.0"
+  VERSION = "1.6.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.6.1
 platform: ruby
 authors:
 - Chuck Smith
@@ -41,6 +41,7 @@ files:
 - ".yardopts"
 - CHANGELOG.md
 - CLAUDE.md
+- CONTRIBUTING.md
 - LICENSE.txt
 - README.md
 - ROADMAP.md