• API testing command for containers and CIs.
• Simplest, Fastest, Smallest API test tool.
• BDD like YAML Testing format: Readable and Writable.
• Smallest docker image (It will be about 10MB)
• JSON Format support.
• Mock support(developping)
• IT only supports single repo testing.
• Other servers are all mocks.

• I want to use Automatic Sequential API Testing Tool in docker or CI.
• I can't find any docker friendly API Testing tools.
• I don't need GUI, I don't need multifunctional testing.

So I develop apitest, which is small, docker friendly and minimum.

• When you develop an API server, try apitest with CI.
• apitest provides your development automatic continuous testing.
• It brings you more safety and faster development.

• Testing Frameworks with GUI: apitest is a minimal simple command for CI.
• Karate: Karate is great tool so apitest is sub-choise when you want to do minimum test in CI.
• Manual Testing: apitest has Repeatablity and doesn't have human errors.

Feature: Sample Yaml

Scenarios:
  - Scenario: Normal
    description: Normal
    Given:
      host: http://server:8080
    Tests:
      - When:
          method: GET
          path: /api
        Then:
          status: 200
          format: "empty"
      - When:
          path: "/api/users/"
          method: POST
          body: '{"Token": "Foo", "Name": "Foo"}'
        Then:
          status: 200
          format: application/json
          require:
            - 'match {"name": "Foo", "Info": "#String"}'
      - When:
          path: /api/users/
          method: POST
          body: '{"Token": "Foo"}'
        Then:
          status: 200
          format: application/json
          require:
            - 'match {"users": "#Array"}'
  

please run test.sh.

• using locally
• using in docker

Requirements: Go 1.12.x

go get -u github.com/aimof/apitest/cmd/apitest
# workdir: $GOPATH/src/github.com/aimof/cmd/apitest
go install

See cmd/apitest/README.md

apitest /path/to/test.yaml

• Only Json support.

NumberType = "#Number"
StringType = "#String"
BoolType   = "#Bool"
ObjectType = "#Object"
ArrayType  = "#Array"
NullType   = "#Null"

# in the repository root
go test ./...
./test.sh

1. Change YAML Format to BDD like Style (Destructive change): Done
2. Make Docker Image: Trial is done.
3. Support Single Mock (Destructive change)
4. Support Multiple Mock (Destructive change)

Please feel free to make Issues or PRs but I will plan some destructive changes.

MIT