ht

module

v3.3.0+incompatible Latest Latest Go to latest Published: Jan 24, 2017 License: BSD-3-Clause

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/vdobler/ht

Links

Open Source Insights

README ¶

HT: HTTP Testing Made Easy

End-to-end testing of HTTP requests/responses is easy with Go.

Writing and maintaining high level test is even easier with ht.

Goals

ht tries to achieve the following:

Make generating all common HTTP requests easy.
Provide high- and low-level checks on the received response.
Make measuring response times easy.

Non-Goals

ht is not the jack of all trades in testing web applications:

Simulating different browsers is not done.
Simulating interactions in a browser is not done.

Installation

Installing ht should be simple if Go 1.5 and git are available and working:

Run GO15VENDOREXPERIMENT=1 go get github.com/vdobler/ht/cmd/ht which should download, compile and install everything.
Run $GOPATH/bin/ht help to get you started.
For a quick check of a HTML page do a

$GOPATH/bin/ht quick <URL-of-HTML-page>

and check the generated Report.html file.

If you want to run checks on rendered HTML pages you need a local installation of PhantomJS in version >= 2.0. See http://phantomjs.org .

Documentation

For a start have a look at the

Tutorial https://github.com/vdobler/ht/blob/master/cmd/ht/Tutorial.md

or the

Showcase here https://github.com/vdobler/ht/tree/master/showcase

The showcase is pretty nonsensical but show almost all features in just a few files. You might want to $ go run showcase.go to have a dummy server listening on localhost:8080 to run the tests against: $ ht exec showcase.suite

For details see the the godoc for reference:

Tests, Checks and their options: https://godoc.org/github.com/vdobler/ht/ht
Details to Conditions used in Checks: https://godoc.org/github.com/vdobler/ht/condition
Image fingerprinting: https://godoc.org/github.com/vdobler/ht/fingerprint
The ht command itself: https://godoc.org/github.com/vdobler/ht/cmd/ht Run ht help for details
An example test suite can be found in https://github.com/vdobler/ht/blob/master/testdata/sample.suite

Copyright

Attribution

Ht includes open source from the following sources:

Go Libraries. Copyright 2012 The Go Authors. Licensed under the BSD license (http://golang.org/LICENSE).
Bender. Copyright 2014 Pinterest.com. Licensed under the Apache License, Version 2.0
Cascadia. Copyright (c) 2011 Andy Balholm. Licensed under the BSD 2-clasue license.
Gojee. Copyright (c) 2013 The New York Times Company. Licensed under the Apache License, Version 2.0
Gojsonexplode. Copyright (c) 2013 The New York Times Company. Licensed under the Apache License, Version 2.0
Xmlpath. Copyright (c) 2013-2014 Canonical Inc. Licensed under the LGPLv3. See https://gopkg.in/xmlpath.v2
Sourcemap. Copyright (c) 2016 The github.com/go-sourcemap/sourcemap Contributors. Licensed under the BSD 2-clasue license.

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
ht command ht generates HTTP requests and checks the received responses.	ht generates HTTP requests and checks the received responses.
cookiejar Package cookiejar implements an in-memory RFC 6265-compliant http.CookieJar.	Package cookiejar implements an in-memory RFC 6265-compliant http.CookieJar.
fingerprint Package fingerprint provides fingerprinting of images.	Package fingerprint provides fingerprinting of images.
ht Package ht provides functions for easy testing of HTTP based protocols.	Package ht provides functions for easy testing of HTTP based protocols.
internal
bender Package bender makes it easy to build load testing applications for services using protocols like HTTP, Thrift, Protocol Buffers and many others.	Package bender makes it easy to build load testing applications for services using protocols like HTTP, Thrift, Protocol Buffers and many others.
hist Package hist provides spark-line type histograms	Package hist provides spark-line type histograms
hjson
hjson/hjson-cli command
tempfile
loghist Package loghist provides integer histograms with exponentially growing bucket sizes.	Package loghist provides integer histograms with exponentially growing bucket sizes.
mime Package mime provides a map of mime types to file extensions.	Package mime provides a map of mime types to file extensions.
populate Package populate provides function to populate Go values from an untyped interface{} soup.	Package populate provides function to populate Go values from an untyped interface{} soup.
recorder Package recorder allows to capture request/response pairs via a reverse proxy and generate tests for these pairs.	Package recorder allows to capture request/response pairs via a reverse proxy and generate tests for these pairs.
sanitize Package sanitize contains functions to sanitize filenames.	Package sanitize contains functions to sanitize filenames.
showcase showcase implements a server to run the showcase.suite against	showcase implements a server to run the showcase.suite against
suite Package suite contains functions to input tests from disk and execute suites of tests in a controlled way.	Package suite contains functions to input tests from disk and execute suites of tests in a controlled way.