2 KiB
http-go-status
Inspired by httpstatu.us, but written in Go, and is as minimal as possible. No third party dependencies, and less than 100 lines of code in a single file.
Previous versions had a single third-party dependency, but that's no longer necessary.
Installation
go install codeberg.org/danjones000/http-go-status@latest
Usage
http-go-status
Then, make a request to your server. By default, it's running on port 8080, but you can set an environment variable, called PORT, to the port you prefer before running the command.
To make your request from within a web browser (CORS is supported), you could do this from the JS console:
let resp = await fetch("http://localhost:8080/451");
console.log(resp.status); // 451
console.log(resp.statusText); // Unavailable for Legal Reasons
resp = await fetch("http://localhost:8080/418/path/to/nothing");
console.log(resp.status); // 418
console.log(resp.statusText); // I'm a teapot
If there is no path, if the first element in the path is not an integer, or if it's an integer outside of the acceptable range, a 200 will be returned.
Deployment
I'll leave this as an exercise for the reader.
LICENSE
Copyright (c) 2023-2025 Dan Jones
Licensed under GNU Affero General Public License as stated in the LICENSE:
Copyright (c) 2023-2025 Dan Jones
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU Affero General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your option) any
later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
details.
You should have received a copy of the GNU Affero General Public License along
with this program. If not, see https://www.gnu.org/licenses/