Skip to content
Mock Machines Mock Machines

Installation

Mock Machines is a single Go module. Its only build-time dependency is gopkg.in/yaml.v3; the dot (Graphviz) and duckdb CLIs are invoked on demand for optional output formats.

Prerequisites

Section titled “Prerequisites”
  • Go 1.26.4 (the toolchain the project is pinned to).
  • Optional: Graphviz (dot) for --png diagram export, and DuckDB for --duckdb conversion.
Terminal window
git clone https://github.com/jonwalls-dev/mock_machines.git
cd mock_machines
go build ./...
go run main.go -run 50 scenarios/PaymentProcessor/PaymentProcessor.yaml

Development container

Section titled “Development container”

The repo ships a sandboxed dev container with Go, Claude Code, and network isolation (all traffic routes through a domain-allowlisting proxy).

  1. Copy the environment template and fill in your keys:

    Terminal window
    cp .env.example .env
    # set LINEAR_API_KEY and GITHUB_PAT_MOCK_MACHINES

  2. Ensure Docker and Docker Compose are installed.

VS Code — open the repo and run Dev Containers: Reopen in Container (it delegates to the Docker Compose stack via .devcontainer/devcontainer.json).

Terminal:

Terminal window
make sandbox-build   # build the image
make sandbox-run     # start an interactive session
make sandbox-shell   # or drop into a plain bash shell

Rebuild after changing Dockerfile.dev, docker-compose.yml, or the proxy config with make sandbox-build. Tear down with docker compose down (or make sandbox-clean to also remove the image).