Hackage :: [Package]

restman: Web request TUI program.

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Please see the README on GitLab at https://gitlab.com/krakrjak/restman#readme

[Skip to Readme]

Properties

Versions 0.7.1.1, 0.7.1.2
Change log CHANGELOG.md
Dependencies ansi-terminal-types (>=1.1.3 && <1.2), base (>=4.7 && <5), binary (>=0.8.9.3 && <0.9), brick (>=2.9 && <2.10), bytestring (>=0.12.2.0 && <0.13), case-insensitive (>=1.2.1.0 && <1.3), containers (>=0.7 && <0.8), http-client (>=0.7.19 && <0.8), http-client-tls (>=0.3.6.4 && <0.4), http-types (>=0.12.4 && <0.13), lens (>=5.3.5 && <5.4), microlens (>=0.4.14.0 && <0.5), microlens-mtl (>=0.2.1.0 && <0.3), mime-types (>=0.1.2.0 && <0.2), mtl (>=2.3.1 && <2.4), optparse-applicative (>=0.18.1.0 && <0.19), restman, skylighting (>=0.14.7 && <0.15), text (>=2.1.3 && <2.2), text-zipper (>=0.13 && <0.14), unliftio (>=0.2.25.1 && <0.3), utf8-string (>=1.0.2 && <1.1), vector (>=0.13.2.0 && <0.14), vty (>=6.4 && <6.5), wreq (>=0.5.4.3 && <0.6) [details]
License BSD-2-Clause
Copyright Zac Slade or Boyd Stephen Smith Jr, 2024
Author Zac Slade
Maintainer krakrjak@gmail.com, boyd.stephen.smith.jr@gmail.com
Category Web
Home page https://gitlab.com/krakrjak/restman#readme
Bug tracker https://gitlab.com/krakrjak/restman/issues
Source repo head: git clone https://gitlab.com/krakrjak/restman
Uploaded by krakrjak at 2026-01-14T11:02:58Z

Modules

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Readme for restman-0.7.1.2

[back to package description]

pipeline status

RESTMan is a program for sending web requests using a terminal user interface or TUI.

[[TOC]]

Right now, Windows is not supported directly due to limitations of the Brick library used to generate the TUI. You can however, use Windows to build and execute RESTMan through WSL2 and a Debian distribution. See details below.

Usage

% stack exec restman -- --help
RESTman, an HTTP(S) application

Usage: restman [--help] [-m|--method METHOD] 
                   [--no-default-headers | --default-headers] 
                   [-h|--custom-header NAME_VALUE] 
                   [--payload PAYLOAD | --payload-file PATHNAME]
  A TUI application for interactively using the full range of HTTP(S) directly

Available options:
  --help                   Show command-line help and abort normal operation.
  -m,--method METHOD       HTTP(S) Method (or "Verb") (default: "GET")
  --no-default-headers     Send ONLY the custom headers specified.
  --default-headers        Send custom headers after default headers. This is
                           the default behavior.
  -h,--custom-header NAME_VALUE
                           Add a custom header, argument is name:value (colon
                           separates name from value).
  --payload PAYLOAD        Specify (in UTF-8) payload directly on command-line
  --payload-file PATHNAME  Load payload from file on startup

https://gitlab.com/krakrjak/restman

Building

For those already familiar with Haskell and the Stack, you can get up and running quickly with the usual recipie of stack setup followed by stack build. As usual, stack setup only needs to be run once.

Building on Debian (WSL2 Tested)

Install and configure your favorite shell, you are going to spend a lot of time in it. :)

Once you are comfortable install the package haskell-stack, libtinfo-dev, and libz1g-dev using apt: apt install haskell-stack libtinfo-dev libz1g-dev

You will need to upgrade the Debian provided stack using stack upgrade. If needed it will prompt you for sudo access. Once your stack is up-to-date you need a Haskell compiler. Use stack setup to determine, fetch, and configure a compiler for your environment. You can check your installation using stack ghci to enter the GHC REPL.

Now you are ready to build RESTMan and all of its dependencies. stack build

Building on M1 Mac

Install ghcup, then brew install llvm. Then you will need the following setup in your environment:

export PATH="/opt/homebrew/opt/llvm@13/bin:$PATH"
export LDFLAGS="-L/opt/homebrew/opt/llvm@13/lib"
export CPPFLAGS="-I/opt/homebrew/opt/llvm@13/include"

Then you can successfully use stack to build the program. You will need some extra flags to make it all work. Here's what is reported to work currently: stack --arch aarch64 --system-ghc build.

Running and Testing

Once you have restman-exe built you can use stack to execute it with stack exec restman-exe. If you want to pass options to the program you can use the form stack exec restman-exe -- OPTIONS FOR RESTMAN BINARY. You can also install the binary to ~/.local with stack install. If you add ~/.local/bin to your PATH you can run the program without the aid of the stack executable.