--- name: cli-anything-wiremock-51859b5493f0 description: Python CLI harness for WireMock HTTP mock server administration version: 0.1.0 entrypoint: cli-anything-wiremock --- ## Overview `cli-anything-wiremock` is a command-line interface that wraps the WireMock Admin REST API (`/__admin/`). It allows agents and developers to manage HTTP stub mappings, inspect served requests, control stateful scenarios, and record real backend traffic — all from the terminal or from agent tool calls. WireMock is commonly used in integration testing environments to replace real HTTP backends with controllable mock responses. ## Command Groups ### `stub` — Manage HTTP stub mappings | Command | Description | |----------------------|-------------------------------------------------------| | `stub list` | List all registered stubs | | `stub get ` | Get details of a specific stub by UUID | | `stub create ` | Create a stub from a JSON string | | `stub quick M URL S` | Quickly create a stub: METHOD URL STATUS_CODE | | `stub delete ` | Delete a stub by UUID | | `stub reset` | Reset all stubs to the defaults on disk | | `stub save` | Persist in-memory stubs to disk | | `stub import ` | Import stubs from a JSON file | ### `request` — Inspect served requests | Command | Description | |----------------------------|--------------------------------------------------| | `request list` | List recent served requests | | `request find ` | Find requests matching a JSON pattern | | `request count ` | Count requests matching a JSON pattern | | `request unmatched` | List requests that matched no stub (404s) | | `request reset` | Clear the request journal | ### `scenario` — Stateful scenario management | Command | Description | |-----------------------|---------------------------------------------------| | `scenario list` | List all scenarios and current states | | `scenario set N S` | Set scenario NAME to STATE | | `scenario reset` | Reset all scenarios to their initial state | ### `record` — Record traffic from a real backend | Command | Description | |----------------------------|--------------------------------------------------| | `record start ` | Start proxying + recording to TARGET_URL | | `record stop` | Stop recording, return captured stubs | | `record status` | Check if currently recording | | `record snapshot` | Snapshot in-memory requests as stubs | ### `settings` — Global server settings | Command | Description | |--------------------|----------------------------------------| | `settings get` | Get current global WireMock settings | | `settings version` | Show WireMock server version | ### Top-level commands | Command | Description | |------------|--------------------------------------------------| | `status` | Check if WireMock is running | | `reset` | Full reset: stubs + requests + scenarios | | `shutdown` | Gracefully shut down the WireMock server | ## Key Examples ```bash # Check connectivity cli-anything-wiremock status # Create a stub using quick form cli-anything-wiremock stub quick GET /api/users 200 --body '[{"id":1}]' # Create a stub using full JSON cli-anything-wiremock stub create '{ "request": {"method": "POST", "url": "/api/orders"}, "response": {"status": 201, "body": "{\"id\":99}"} }' # Verify a POST was made exactly once cli-anything-wiremock --json request count '{"method":"POST","url":"/api/orders"}' # → {"count": 1} # Scenario: advance state cli-anything-wiremock scenario set "cart-flow" "item-added" # Record a real backend cli-anything-wiremock record start https://api.example.com # ... make requests ... cli-anything-wiremock record stop ``` ## Agent Guidance ### Always use `--json` in agent contexts Use `--json` for all invocations in scripts or agent tool calls. JSON output varies by command type (these are distinct response types, not an envelope wrapping all responses): ```bash # Data commands return raw WireMock API JSON directly: cli-anything-wiremock --json stub quick GET /api/hello 200 --body '{"hello":"world"}' # → {"id": "abc-123", "request": {...}, "response": {...}, ...} cli-anything-wiremock --json stub list # → {"mappings": [...], "total": N} # Void commands (delete, reset, save) return: # → {"status": "ok"} # Errors return: # → {"status": "error", "message": "Connection refused"} ``` ### Connection via environment Set connection params via environment variables before calling any command: ```bash export WIREMOCK_HOST=localhost export WIREMOCK_PORT=8080 ``` ### Workflow pattern for test verification 1. Set up stubs before running the system under test: ```bash cli-anything-wiremock --json stub quick POST /api/payment 200 --body '{"success":true}' ``` 2. Run the system under test. 3. Verify interactions: ```bash cli-anything-wiremock --json request count '{"method":"POST","url":"/api/payment"}' ``` 4. Clean up: ```bash cli-anything-wiremock reset ``` ### Error handling Non-zero exit code on all errors. In `--json` mode, errors return `{"status": "error", "message": "..."}`. Success returns the raw WireMock API response. --- Source attribution: HKUDS Original project: https://github.com/HKUDS/CLI-Anything License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Gabriel Moreira 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. # Mega AI Hub resource metadata Creator / publisher: HKUDS Original project: https://github.com/HKUDS/CLI-Anything Attribution basis: Upstream repository explicitly recorded in package mirror path Fields of work: Development & Engineering Roles: Backend Developer, DevOps / SRE, QA / Test Engineer Specialties: API, Testing Tools: Wiremock Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 813e4fff152b36de5852c335fa158dd63593ae93d042a9e73d42758aac7472f1