HTTEST(1)

📦
version 2.4.23 · 6 versions
, in ubuntu questing

✨ HTTEST ✨

okay bestie, so this is the manual page for httest — a User Commands situation, and honestly? it's giving "I test web stuff for a living and I'm not sorry about it." 🎀

💖 NAME 💖

httest — test HTTP driven application. that's it, that's the whole job. she tests HTTP-driven applications and she does it well. 💅

🌸 SYNOPSIS 🌸

httest [OPTIONS] scripts

that's the shape of it: some OPTIONS, then your scripts. simple. elegant. slay. ✨

🦋 DESCRIPTION 🦋

so httest is a script based tool for testing and benchmarking web applications, web servers, proxy servers and web browsers. like, all of them. no cap. 💯

and here's the part that's highkey iconic: httest can emulate clients and servers in the same test script. same. script. which is very useful for testing proxys. yes proxys, that's what it says, don't look at me, I don't make the spelling rules around here. 🫶

💅 OPTIONS 💅

one bullet per flag, no skips, no shortcuts, we eat the whole menu:

  • -V, --version — Print version number and exit. short, sweet, gone. 👋
  • -h, --help — Display usage information (this message). it's literally this. hi. 🌈
  • -n, --suppress — do no print start and OK|FAILED. that's the original wording bestie, I'm not touching it, but yeah: it suppresses the start and the OK|FAILED lines. 🤫
  • -s, --silent — silent mode. the quietest of girls. 🙈
  • -e, --error — log level error. only the errors get to speak. 😭
  • -i, --info — log level info. ✨
  • -d, --debug — log level debug for script debugging. 🔍
  • -p, --debug-system — log level debug-system to log more details. more details. MORE. 🧚
  • -L, --list-commands — List all available script commands. 👑
  • -C, --help-command — Print help for specific command. just the one you're beefing with. 💜
  • -t, --duration — Print test duration. clock it. ⏱️
  • -T, --timestamp — Time stamp on every run. 🕰️
  • -S, --shell — Shell mode. 🐚
  • -S, --shell — Shell mode. 🐚 (yes. she's here twice. the manpage said it twice and I am nothing if not faithful to the source. periodt.)
  • -D, --define — Define variables. 🎀
  • -l, --log-thread-number — Show the thread number for every printed line. so you always know which thread is yapping. 🧵
  • -b, --color — Colored output. rainbow mode activated 🌈🔥

🍓 SCRIPTS 🍓

httest is script based. meaning: no script, no vibes, no test. 😌

the following script examples can be but into a scripte i.e. sample.htt and can be called like

httest sample.htt

(again: "but into a scripte" is the original's exact energy and I refuse to correct her. she's perfect. 💀)

🧚 SIMPLE SCRIPT 🧚

Get a page and do expect return code 200 OK. the classic. the blueprint. the main character move. 👑

CLIENT
_REQ www.google.ch 80
__GET /search?q=apache HTTP/1.1
__Host: www.google.ch
__
_EXPECT headers "HTTP/1.1 200 OK"
_WAIT
END

✂️ CUT AND PAST SCRIPT ✂️

Cut and past from a HTTP stream, i.e we cut the apache host to access it in the second request. it's giving "steal her host, use her host." 😌

CLIENT
_REQ www.google.ch 80
__GET /search?q=apache HTTP/1.1
__Host: www.google.ch
__
_MATCH body '\<a href="http://([^\/]*)/" class=l\>Welcome! - The \<em\>Apache\</em\> HTTP Server Project' APACHE_HOST
_WAIT

_REQ $APACHE_HOST 80
__GET / HTTP/1.1
__Host: $APACHE_HOST
__
_WAIT
END

🌈 CLIENT SERVER SCRIPT 🌈

We can hold client and server in the same host. Actually multiple client and multiple server. Very useful to test forward or reverse proxies. Or a webapplication which communicat itself with third party servers i.e. mail server. (yes "communicat." she said what she said. 💅)

This is a very basic selfcontained test you can run on any maschine. 🖥️✨

CLIENT
_REQ localhost 8080
__GET /foo HTTP/1.1
__Host: localhost
__
_WAIT
END

SERVER 8080
_RES
_EXPECT headers "/foo"
_WAIT
__HTTP/1.1 200 OK
__Content-Length: AUTO
__
__Hello World
END

🔒 SSL SCRIPT 🔒

Of course SSL do also work with httest, just put "SSL:" before port. that's the whole trick. go off, queen. 👑

CLIENT
_REQ localhost SSL:8080
__GET /foo HTTP/1.1
__Host: localhost
__
_WAIT
END

SERVER SSL:8080
_RES
_EXPECT headers "/foo"
_WAIT
__HTTP/1.1 200 OK
__Content-Length: AUTO
__
__Hello World
END

⭐ EXAMPLES ⭐

look at her go:

httest script.htt
httest -Ts script.htt

two whole moods. -T and -s living their best combined life. 🫶

👑 AUTHOR 👑

Written by Christian Liesch. thank you for your service, king. 🫡

😭 REPORTING BUGS 😭

Report bugs to http://sourceforge.net/projects/htt

bestie if something breaks, tell the sourceforge, not me, I'm just the messenger with the good hair. 💁‍♀️

Copyright © 2006 Free Software Foundation, Inc.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

like NO warranty. none. zero. nada. if it eats your config, that's between you and the universe. 😭💀

and that's the whole page, bestie — every flag, every script, every warning, all of it. nothing skipped, nothing invented, just vibes + facts. iykyk. 🎀

httest 2.4.23 — February 2025 — mwah, kisses, go run your tests 💋✨🦋

📦 where this page comes from