melkerton/adm-server

A language agnostic mock server written in Dart.

A Dart Mock Server (adms)

This is primarily a way for me to learn Dart, CI/CD, and reStructured Text, use at you own risk.

Cheers.

---

See ReadtheDocs for user documentation (v0.0.1-alpha).

Example

A simple example is available for download, which includes:

1. an exe compiled on

   Linux host 5.10.0-20-amd64 #1 SMP Debian 5.10.158-2 (2022-12-13) x86_64 GNU/Linux.

2. an example demonstrating (a) a data response and (b) a pipe response on http://127.0.0.1:7777.

adm-server's Issues

review and refine current

• needs clearer comments
• needs Error name review
• needs comparison with v0.0.1 documentation

add pipe support

mvp v0.0.1

All endpoints must respond with a FULL http message.

abstract algo

Output (Response)

http-data
http-pipe

will add later
yaml-data
yaml-pipe

Input (Request, Matching)

today get path matching against command extension

v0.0.2 planning

add features required for keycloak functionality

• body contains:
• path data:, exec: otherwise as string

read the docs

connect coverage cicd

codecov
circleci

define minimum requirements for keycloak

This is needed for testing with Keycloak.

Must

• be able to return valid jwt tokens that can be tested against

Might

v0-1-0 preview testing

replace HttpServer with Shelf

issues related to testing withj HttpRequest

v0.0.0.1-alpha release

includes adms-v0.0.1-alpha-linux-amd64.exe binary

v010 planning

• changing behavior for resource will break 0.0.1 definitions

Goals for this release

index.yaml.Entry config changes

• resource file references are now prefixed
  • flat: for flat file, exec: for current pipe, pipe: (not implemented) for true piped response
• body matches are exact or prefix contains:
• path exact is default,
• query exact is default + contains:

add query params to matching

• Add query params to the matching system.
• wrap request uri in double quotes for first argument to a pipe.

v0.0.1 Road Test Log

• default response is a string
  • add flat- prefix (pipe-) for flat files

replace HttpServer with Shelf

see #15

Find a way to mock FS

Can we mock a directory virtually so all Objects read that instead of the real FS?

response default to string

• response: HttpMessage

is the default

add flat- prefix for flat files

create a single test case and connect to cicd

start end to end comm

add args to system for user defined sourcesDirtPath

merge to main verify clean up branches

v0.0.1 user documentation

use minimal usage on README.md
include a concrete usable example for P.O.C.

Fix README.md