Mini Server

This is a template repository which has the intention to make it quick and easy to build small servers with the help of the Dart programming language.

Dependencies

• Dart: Required to configure and run the mock server
• Docker: (Optional) Required to package and publish the mock server

Init

With Git repo

The intended usage is that you copy this repository and then adapt it.

PROJECT_NAME=example
DEFAULT_BRANCH=master

{
git clone git@github.com:experimental-software/mock_server.git $PROJECT_NAME
cd $PROJECT_NAME
git checkout --orphan $DEFAULT_BRANCH
git add .
git commit -m "Initial commit"
}

Within Git repo

PROJECT_NAME=example
{
git clone git@github.com:experimental-software/mock_server.git /tmp/$PROJECT_NAME || exit 1
rm -rf /tmp/$PROJECT_NAME/.git
cp -r /tmp/$PROJECT_NAME .
}

Run server via Dart VM

# Run server on default port 8080
dart bin/server.dart

# Run server on specific port
dart bin/server.dart 9876

Run server via Docker

# Build docker image
docker build . -t example_mock_server

# Run in daemon mode
docker run -d -p 7777:8080 example_mock_server

# Run with attached terminal
docker run -it -p 7777:8080 example_mock_server

# Try request
curl localhost:7777/

Development

Generate routes

dart run build_runner build

Snippets

GET request*

@Route.get('/echo/<message>')
Future<Response> getMessage(Request request, String message) async {
  return Response.ok('$message\n$message\n$message\n');
}

Post request

@Route.post('/create/<id>/something')
Future<Response> createSomething(Request request, String id) async {
  var body = await request.jsonBody;
  body['msg'] = '${body['msg']} $id ${body['msg']}';
  return Response(201, body: json.encode(body));
}

Content type header

var headers = {'content-type': 'application/json'};