Repository files navigation

Simple and efficient HTTP mock server with specification written inyaml,edn,OpenAPI orPostman Collection.

💾 Download the.jar file with the latest version of moclojer to test on your computerhere.

📖 See the complete documentation for moclojer here, if you want to contribute (or complement) the documentation, it ishere.

YAML example

# This mock register route: GET /hello/:username-endpoint:# Note: the method could be omitted because GET is the defaultmethod:GETpath:/hello/:usernameresponse:# Note: the status could be omitted because 200 is the defaultstatus:200headers:Content-Type:application/json# Note: the body will receive the value passed in the url using the# :username placeholderbody:>        {          "hello": "{{path-params.username}}!"        }

Postman Collection Support

Moclojer can directly use Postman Collection v2.1 exports as mock specifications. Simply export your Postman collection and use it:

# Using environment variableCONFIG=my-collection.json moclojer# Using CLI parametermoclojer --config my-collection.json

How to export from Postman:

1. Open your Postman collection
2. Click the three dots menu → Export
3. Select "Collection v2.1" format
4. Save the JSON file
5. Use it directly with moclojer!

The converter automatically:

• Detects Postman Collection format
• Extracts HTTP methods, paths, and response examples
• Processes nested folders
• Converts path variables (:id,:username, etc.)
• Includes headers and status codes from examples

WebSocket Support

Moclojer also supports WebSocket connections with a simple configuration approach:

# WebSocket echo server-websocket:path:/ws/echoon-connect:# Message sent when client connectsresponse:'{"status": "connected", "message": "Welcome to WebSocket Echo!"}'on-message:# Simple echo for "ping" message      -pattern:"ping"response:"pong"# Echo back any JSON content with an "echo" field      -pattern:'{"echo": "{{json-params.echo}}"}'response:'{"echoed": "{{json-params.echo}}"}'

You can test the WebSocket connection using tools likewebsocat:

websocat"ws://localhost:8000/ws/echo" --text

• image:ghcr.io/moclojer/moclojer:latest
• port(default):8000, if you want to change the port set the environment variablePORT

docker run -it \  -p 8000:8000 -v$(pwd)/moclojer.yml:/app/moclojer.yml \  ghcr.io/moclojer/moclojer:latest

We have two versions available:

• dev: main branch docker image
• latest: latest stable version image

We distribute via the.jar file, you need to have Java installed on your operating system.

bash<<(curl -s https://raw.githubusercontent.com/moclojer/moclojer/main/install.sh)

If you are using Linux you maybe needsudo.

• clj -M:run [OPTIONS]
• java -jar moclojer.jar [OPTIONS]
• moclojer_Linux [OPTIONS]

sentry: set environment varSENTRY_DSN (sentry doc), automatic send backtrace to <sentry.io>

Config usesXDG_CONFIG_HOME to fetch the default moclojer configuration file, if you want to set a different directory you must use the-c or environment variableCONFIG

moclojer is written inClojure, to run the commands below we assume you have clojureinstalled on your operating system.

run:

clj -M:run

test:

clj -M:test

if you want to run a specific test:clj -M:test -n com.moclojer.external-body.excel-test

moclojer.jar generate:

clj -A:dev -M --report stderr -m com.moclojer.build

This project includes anAGENTS.md file with guidelines for AI coding assistants (Claude Code, Cursor, GitHub Copilot, etc.). It documents architecture decisions, code patterns, extension points, and common pitfalls to help both humans and AI tools understand and contribute to the codebase effectively.

Windows users: This project uses symlinks for AI tool config files. Git on Windows disables symlinks by default. Enable them withgit config --global core.symlinks true before cloning (may require Developer Mode or admin privileges).

We distribute the library viaClojars.

com.moclojer/moclojer {:mvn/version"0.3.1"}

[com.moclojer/moclojer"0.3.1"]

{:deps {com.moclojer/moclojer {:git/url"https://github.com/moclojer/moclojer.git":git/tag"v0.3.1":git/sha"c4ca0f2cfcfbe47de6eb0c601b26106190e20793"}}}

(nsmy-app.core  (:require [com.moclojer.adapters:as adapters]            [com.moclojer.server:as server]))(def*router"create a router from a config map"  (adapters/generate-routes   [{:endpoint     {:method"GET":path"/example":response {:status200:headers {:Content-Type"application/json"}:body {:id123}}}}]))(defn-main"start the server"  [& args]  (server/start-server! *router))