http_decoy 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1e30669122e0653b4327cc91460096cfc2a560004188b0bf8e678fb475a2ba8f
+  data.tar.gz: 3258d93287f014e00dff0795c0a217203c24ed3d877e2d3fb0cfebd75ff574bb
+SHA512:
+  metadata.gz: 0a63f8490e679a0e8909fdaadd8db7f94af4751c076d5119bf5e8246587551c28f3b5bb16778b3a7ded2cae1d2b65a1ec9da04d881d8395042c55616d391570d
+  data.tar.gz: 2930b0ac10c72d3f2a5c65cfb7de35ee6d6bd1c01c261a0a6478c2bda7c700f409c7f937abfbf8c30d544be77c2703598dbbd967bd65e2d0a02fcea3ed4b01cc

data/.rubocop.yml

@@ -0,0 +1,102 @@
+require:
+  - rubocop-rspec
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.1
+  Exclude:
+    - "bin/**/*"
+    - "sig/**/*"
+    - "coverage/**/*"
+    - "pkg/**/*"
+    - "vendor/**/*"
+
+# ── Style ──────────────────────────────────────────────────────────────────
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+  EnforcedStyle: always
+
+Style/Documentation:
+  Enabled: false   # internal gem, module-level docs live in README
+
+Style/OpenStructUse:
+  Enabled: false
+
+# Allow one-line method definitions (e.g. def port = @port)
+Style/EndlessMethod:
+  Enabled: true
+  EnforcedStyle: allow_single_line
+
+# ── Layout ─────────────────────────────────────────────────────────────────
+
+Layout/LineLength:
+  Max: 120
+  AllowedPatterns:
+    - '^\s*#'     # comments can be longer
+    - '^\s*it '   # long RSpec descriptions
+
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
+# ── Metrics ────────────────────────────────────────────────────────────────
+
+Metrics/MethodLength:
+  Max: 30
+  Exclude:
+    - "spec/**/*"
+
+Metrics/BlockLength:
+  Max: 60
+  Exclude:
+    - "spec/**/*"
+    - "httpfake.gemspec"
+
+Metrics/AbcSize:
+  Max: 40
+
+Metrics/ClassLength:
+  Max: 150
+
+Metrics/CyclomaticComplexity:
+  Max: 12
+
+Metrics/PerceivedComplexity:
+  Max: 12
+
+# ── RuboCop-RSpec path convention ──────────────────────────────────────────
+# Our module is HttpFake but the gem/dir is httpfake (no underscore).
+# RSpec/SpecFilePathFormat expects http_fake/ — disable it.
+RSpec/SpecFilePathFormat:
+  Enabled: false
+
+# ── Lint ───────────────────────────────────────────────────────────────────
+# We intentionally use === for matcher duck-typing in the have_received_request
+# matcher (e.g. RSpec matchers, Ranges, Regexps all respond to ===).
+Style/CaseEquality:
+  Exclude:
+    - "lib/httpfake/rspec.rb"
+
+# Entry uses :http_method not :method, so this is moot — kept for awareness.
+Lint/StructNewOverride:
+  Enabled: true
+
+# ── RSpec ──────────────────────────────────────────────────────────────────
+
+RSpec/ExampleLength:
+  Max: 20
+
+RSpec/MultipleExpectations:
+  Max: 5
+
+RSpec/NestedGroups:
+  Max: 4
+
+RSpec/DescribeClass:
+  Enabled: false   # integration specs don't always describe a class
+
+RSpec/IndexedLet:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] — 2026-06-02
+
+### Added
+
+- `HttpFake.define` — declare a named fake service with a DSL block
+- `HttpFake::RouteMap` — route definition DSL (`get`, `post`, `put`, `patch`, `delete`)
+- `HttpFake::Router` — path matching with `:param` template segments
+- `HttpFake::Server` — real WEBrick HTTP server on OS-assigned port (port 0); starts in a background thread, stops cleanly
+- `HttpFake::RequestLog` — thread-safe store of every received request; powers assertion helpers
+- `HttpFake::HandlerContext` — `instance_eval` DSL surface inside handler blocks:
+  - `respond(status, json:, text:, headers:)` — build a response
+  - `respond_sequence(*entries)` — return different responses on successive calls
+  - `requires_body(*keys)` — assert required fields are present; raises `ContractError` with descriptive message if not
+  - `validates(key, type:, min:, max:, inclusion:)` — type and range validation
+  - `raise_error(:timeout | :reset | :refused)` — simulate transport-level failures
+  - `body`, `path_params`, `query_params` — request data accessors
+  - Lambdas in JSON response values are resolved at request time (`-> { body[:amount] }`)
+- `fake_server(name) { ... }` — class-level RSpec macro; starts a fresh server per example, tears it down after
+- `HttpFake.define(:name) { ... }.rspec_helpers` — suite-wide helper module pattern
+- `with_scenario(:name) { ... }` — activate a named failure/alternate scenario in a test block
+- `have_received_request(method, path)` — RSpec matcher with `.once`, `.twice`, `.times(n)`, `.with(body:)` chains
+- WebMock auto-detection: if WebMock is loaded and `base_url` is declared, requests are intercepted automatically; teardown removes only httpfake's stub
+- `HttpFake.configure { |c| c.auto_intercept = false }` — opt out of automatic WebMock interception
+- Supports `application/json`, `application/x-www-form-urlencoded`, and raw bodies
+- Compatible with Rack 2.x and Rack 3.x
+- Ruby 3.1+ support
+- 92% test coverage (SimpleCov), 66 examples
+
+[Unreleased]: https://github.com/jibranusman/httpfake/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/jibranusman/httpfake/releases/tag/v0.1.0

data/CONTRIBUTING.md

@@ -0,0 +1,67 @@
+# Contributing to httpfake
+
+Thanks for taking the time. Bug reports, documentation improvements, and feature proposals are all welcome.
+
+## Setup
+
+```bash
+git clone https://github.com/jibranusman/httpfake
+cd httpfake
+bundle install
+```
+
+## Running the tests
+
+```bash
+bundle exec rspec          # full suite
+bundle exec rspec spec/httpfake/server_spec.rb   # single file
+```
+
+## Linting
+
+```bash
+bundle exec rubocop        # check
+bundle exec rubocop -a     # autocorrect safe offenses
+```
+
+Both must be green before a PR can be merged. CI enforces this on every push.
+
+## Submitting a pull request
+
+1. Fork the repo and create a branch from `main`
+2. Write a failing test that describes the bug or feature
+3. Make it pass
+4. Run `bundle exec rspec` and `bundle exec rubocop` — both must be clean
+5. Update `CHANGELOG.md` under `[Unreleased]`
+6. Open a PR with a clear description of what and why
+
+## What we're looking for
+
+- Bug fixes with a reproducing spec
+- New DSL features (propose in an issue first if it's non-trivial)
+- Additional body content-type support
+- Better error messages
+- Real-world usage examples in the README
+
+## Good first issues
+
+Check the [`good first issue`](https://github.com/jibranusman/httpfake/issues?q=label%3A%22good+first+issue%22) label for beginner-friendly tasks.
+
+## Code style
+
+- `frozen_string_literal: true` on every file
+- Follow the existing RuboCop config (`.rubocop.yml`)
+- Keep handler blocks and DSL methods small and focused
+- No clever metaprogramming without a comment explaining why
+
+## Reporting bugs
+
+Open a GitHub issue with:
+- Ruby version (`ruby --version`)
+- httpfake version
+- Minimal reproduction case (ideally a failing RSpec example)
+- What you expected vs what happened
+
+## Security issues
+
+Do not open a public issue for security vulnerabilities. Email the maintainer directly (address in the gemspec).

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jibran Usman
+
+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.