A super basic http tool that makes only GET request to given URL and returns
status code of the response. Well, if you are curl or http (httpie) user,
you can make the same kind of request and get a kind-of same response since
statoo is way better simple :)
statoo injects Accept-Encoding: gzip request header to every http request!
You can install from the source;
go install github.com/vigo/statoo/v2@latestor, you can install from brew:
brew tap vigo/statoo
brew install statoostatoo -husage: ./statoo [-flags] URL
flags:
-version display version information (%s)
-verbose verbose output (default: false)
-request-header request header, multiple allowed, "Key: Value", case sensitive
-response-header response header for lookup -json is set, multiple allowed, "Key: Value"
-t, -timeout default timeout in seconds (default: %d, min: %d, max: %d)
-h, -help display help
-j, -json provides json output
-f, -find find text in response body if -json is set, case sensitive
-a, -auth basic auth "username:password"
-s, -skip skip certificate check and hostname in that certificate (default: false)
-commithash displays current build/commit hash (%s)
examples:
$ ./statoo "https://ugur.ozyilmazel.com"
$ ./statoo -timeout 30 "https://ugur.ozyilmazel.com"
$ ./statoo -verbose "https://ugur.ozyilmazel.com"
$ ./statoo -json https://vigo.io
$ ./statoo -json -find "python" https://vigo.io
$ ./statoo -json -find "Python" https://vigo.io
$ ./statoo -json -find "Golang" https://vigo.io
$ ./statoo -request-header "Authorization: Bearer TOKEN" https://vigo.io
$ ./statoo -request-header "Authorization: Bearer TOKEN" -header "X-Api-Key: APIKEY" https://vigo.io
$ ./statoo -auth "user:secret" https://vigo.io
$ ./statoo -json -response-header "Server: GitHub.com" https://vigo.io
$ ./statoo -json -response-header "Server: GitHub.com" -response-header "Foo: bar" https://vigo.ioLet’s try:
statoo "https://ugur.ozyilmazel.com"
# 200statoo -verbose "https://ugur.ozyilmazel.com"
# https://ugur.ozyilmazel.com -> 200or;
statoo -json https://vigo.ioresponse;
{
"url": "https://vigo.io",
"status": 200,
"checked_at": "2021-05-13T18:09:26.342012Z",
"elapsed": 210.587871,
"skipcc": false
}elapsed represents response is in milliseconds.
Let’s find text inside of the response body. This feature is only available if
the -json flag is set! length represents response size in bytes
(gzipped) when you search something in body!
statoo -json -find "Golang" https://vigo.io{
"url": "https://vigo.io",
"status": 200,
"checked_at": "2022-01-26T20:08:33.735768Z",
"elapsed": 242.93925,
"length": 7827,
"find": "Golang",
"found": true,
"skipcc": false
}statoo -json -find "golang" https://vigo.io # case sensitive{
"url": "https://vigo.io",
"status": 200,
"checked_at": "2022-01-26T20:14:03.487002Z",
"elapsed": 253.665083,
"length": 7827,
"find": "golang",
"found": false,
"skipcc": false
}You can add basic authentication via -auth flag
statoo -auth "username:password" https://your.basic.auth.urlNow you can pass multiple -request-header flags:
statoo -request-header "Key1: Value1" -request-header "Key2: Value2" "https://ugur.ozyilmazel.com"You can query/search for response headers. You can pass multiple values, all
case sensitive!. Let’s lookup for Server and Foo response header values.
Server value should be GitHub.com and Foo value should be bar:
statoo -json -response-header "Server: GitHub.com" -response-header "Foo: bar" https://vigo.ioResponse:
{
"url": "https://vigo.io",
"status": 200,
"checked_at": "2022-07-09T17:51:14.792987Z",
"elapsed": 305.502833,
"skipcc": false,
"response_headers": {
"Foo=bar": false,
"Server=GitHub.com": true
}
}Server response header matches exactly!
It’s better to pipe -json output to jq or python -m json.tool for pretty
print :)
That’s it!
Bash completions is available via;
eval "$(statoo bash-completion)"New
You can check current build/commit hash via;
statoo -commithash$ rake -T
rake default # show avaliable tasks (default task)
rake docker:build # Build image (locally)
rake docker:lint # lint Dockerfile
rake docker:run[param] # Run image (locally)
rake release[revision] # release new version major,minor,patch, default: patch
rake test:run[verbose] # run tests, generate coverage
rake test:show_coverage # show coverage after running tests
rake test:update_coverage # update coverage value in READMEhttps://hub.docker.com/r/vigo/statoo/
# latest
docker run vigo/statoo -h
docker run vigo/statoo -json -find "Meetup organization" https://vigo.ioto run docker locally via rake task:
rake docker:build
rake docker:run["-h"]
rake docker:run["https://ugur.ozyilmazel.com"]- Uğur "vigo" Özyılmazel - Creator, maintainer
- Erman İmer - Contributor
- Rishi Kumar Ray - Contributor
All PR’s are welcome!
fork(https://github.com/vigo/statoo/fork)- Create your
branch(git checkout -b my-feature) commityours (git commit -am 'add some functionality')pushyourbranch(git push origin my-feature)- Than create a new Pull Request!
This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
This project is licensed under MIT