swarm-bat

1.2.11 • Public • Published

BAT - batter the bugs out of your apps

BAT is a simplistic blackbox testing tool. BAT is:

  • stream-based (TCP, WebSocket or local pipes, no HTTP),
  • line-based (like classic internet/Unix protocols, no JSON, no XML),
  • implementation-agnostic (just i/o, no API calls).

BAT feeds the prescribed input into a stream, then listens to the output and compares it to the expected value. The test script format is extremely simple:

; comment
>input
<expected output

BAT's predecessors have been extremely useful in testing network servers in concurrent input/output scenarios. Then, the testing tool pretends to be several clients:

; client 1 says hi, server responds
client1> Hello
client1< Hi Joe
; client 2 joins
client2> Hello
client2< Hi Mike

Blackbox testing is particularly handy when you test protocol compliance of several implementations: their APIs differ, but tests are the same.

Usage

  • bat -e command simple_script.batt
  • bat -c host:port multistream_script.batt
  • bat -l 127.0.0.1:12345 server_script.batt
  • bat -e new_version -r new_script.batt old_script.batt

see test/ for examples of API and CLI usage, .batt scripts.

Options

  • -e test an executable (stdin/stdout)
  • -r record de-facto output to a new test script
  • -i don't stop on errors, just log them
  • -v comment on every step
  • -L ignore empty lines
  • -C ignore case
  • -d max delay (let'em think); default 500ms
  • -O output lines may go in any order
  • --whitespace collapse|ignore|exact|count

Codes

  • 0 OK
  • 1 no match
  • 2 script error
  • 3 argument error
  • 4 io error

TODO

C version for billion-line tests

Readme

Keywords

none

Package Sidebar

Install

npm i swarm-bat

Weekly Downloads

1

Version

1.2.11

License

MIT

Last publish

Collaborators

  • gritzko