KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #open-source #cli #deepseek-harness #macos #ai-agent

localroast

★ 227 Open GitHub ↗

Mock a server for development and testing

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Localroast

[![CircleCI](https://circleci.com/gh/caalberts/localroast/tree/master.svg?style=svg)](https://circleci.com/gh/caalberts/localroast/tree/master)
[![codecov](https://codecov.io/gh/caalberts/localroast/branch/master/graph/badge.svg)](https://codecov.io/gh/caalberts/localroast)
[![Go Report Card](https://goreportcard.com/badge/github.com/caalberts/localroast)](https://goreportcard.com/report/github.com/caalberts/localroast)

![localroast](https://raw.githubusercontent.com/caalberts/localroast/master/coffee.png)

## Overview

Localroast quickly stubs a HTTP server. It takes a JSON file with a list of paths and stub responses. Changes are autoloaded. Use it to develop and test an API client.

![localroast demo](https://raw.githubusercontent.com/caalberts/localroast/master/localroast_demo.gif)

## Installation

From brew:

```sh
brew install caalberts/tap/localroast
```

From source:

```sh
go get -u github.com/caalberts/localroast
```

## Usage

```sh
localroast examples/stubs.json
```

The command takes a single argument, a path to a JSON file. The JSON file must be a JSON array containing endpoint definitions. Each endpoint is represented as a JSON object with keys `method`, `path`, `status` and `response`. `response` can be any valid JSON object.
```json
[
  {
    "method": "GET",
    "path": "/",
    "status": 200,
    "response": {
        "success": true
    }
  }
]
```

See [examples/stubs.json](examples/stubs.json) for more.

## Features

- [x] json input
- [x] path variable
- [x] autoload file changes
- [ ] yml input

localroast

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README