Unit Tests

Netcap has tests for its core functionality

Prerequisites

Some of the tests operate on a dump file that is not in the repository.

You can download it with:

$ zeus download-test-pcap

which will basically just invoke:

wget https://weberblog.net/wp-content/uploads/2020/02/The-Ultimate-PCAP.7z

Now unpack the file and move it to the tests folder in the project root.

Unit Tests

Unit tests have been implemented for parts of the core functionality. Currently there are basic tests for reading pcap data from files and traffic live from an interface, as well as tests and benchmarks for common utility functions, such progress displaying and time conversions.

The tests and benchmarks can be executed from the repository root by executing the following from the project root:

$ go test -v ./...
=== RUN   TestCountRecords
--- PASS: TestCountRecords (0.18s)
=== RUN   TestReader
--- PASS: TestReader (0.01s)
=== RUN   TestWriter
--- PASS: TestWriter (0.06s)
PASS
ok  	github.com/dreadl0ck/netcap	0.862s
?   	github.com/dreadl0ck/netcap/cmd	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/agent	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/capture	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/collect	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/dump	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/export	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/label	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/proxy	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/split	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/transform	[no test files]
?   	github.com/dreadl0ck/netcap/cmd/util	[no test files]
=== RUN   TestCollectPCA
done in 2.595847118s
--- PASS: TestCollectPCAP (2.60s)
PASS
ok  	github.com/dreadl0ck/netcap/collector	3.242s
=== RUN   TestCorruptedWriter
    TestCorruptedWriter: delimited_test.go:46: Put record returned expected error: BAD
--- PASS: TestCorruptedWriter (0.00s)
=== RUN   TestGoodWriter
--- PASS: TestGoodWriter (0.00s)
=== RUN   TestCorruptedReader
    TestCorruptedReader: delimited_test.go:87: Next record returned expected error: unexpected EOF
--- PASS: TestCorruptedReader (0.00s)
=== RUN   TestGoodReader
--- PASS: TestGoodReader (0.00s)
=== RUN   TestRoundTrip
    TestRoundTrip: delimited_test.go:136: After writing: buffer="\x04Some\x02of\x04what\x01a\x04fool\x06thinks\x05often\bremains." len=42
--- PASS: TestRoundTrip (0.00s)
PASS
ok  	github.com/dreadl0ck/netcap/delimited	0.526s
?   	github.com/dreadl0ck/netcap/dpi	[no test files]
?   	github.com/dreadl0ck/netcap/encoder	[no test files]
?   	github.com/dreadl0ck/netcap/io	[no test files]
?   	github.com/dreadl0ck/netcap/label	[no test files]
?   	github.com/dreadl0ck/netcap/maltego	[no test files]
?   	github.com/dreadl0ck/netcap/metrics	[no test files]
?   	github.com/dreadl0ck/netcap/resolvers	[no test files]
=== RUN   TestMarshal
--- PASS: TestMarshal (0.00s)
PASS
ok  	github.com/dreadl0ck/netcap/types	0.668s
=== RUN   TestTimeToString
--- PASS: TestTimeToString (0.00s)
=== RUN   TestStringToTime
--- PASS: TestStringToTime (0.00s)
PASS
ok  	github.com/dreadl0ck/netcap/utils	0.932s

Benchmarks

Run the benchmarks using:

$ go test -bench=. ./... | grep -E "Bench|pkg"
pkg: github.com/dreadl0ck/netcap/collector
BenchmarkReadPcapNG-12            	 1265539	       844 ns/op	    1249 B/op	       1 allocs/op
BenchmarkReadPcapNGZeroCopy-12    	 2028283	       640 ns/op	       0 B/op	       0 allocs/op
BenchmarkReadPcap-12              	 7557667	       137 ns/op	     106 B/op	       1 allocs/op
pkg: github.com/dreadl0ck/netcap/types
BenchmarkMarshal-12      	 9817819	       110 ns/op	      64 B/op	       1 allocs/op
BenchmarkUnmarshal-12    	 8703766	       134 ns/op	      40 B/op	       2 allocs/op
pkg: github.com/dreadl0ck/netcap/utils
BenchmarkTimeToStringOld-12           	 5283726	       229 ns/op	      64 B/op	       4 allocs/op
BenchmarkTimeToString-12              	 8273997	       136 ns/op	      80 B/op	       3 allocs/op
BenchmarkStringToTime-12              	 8842005	       137 ns/op	      32 B/op	       1 allocs/op
BenchmarkStringToTimeFieldsFunc-12    	 6809409	       185 ns/op	      32 B/op	       1 allocs/op
BenchmarkProgressOld-12               	54425902	        21.0 ns/op	       0 B/op	       0 allocs/op
BenchmarkProgress-12                  	23389420	        45.9 ns/op	      16 B/op	       2 allocs/op

Race Detection Tests

Run the tests with race detection enabled:

$ go test -race -v ./...