Skip to content

mdub/hoick

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hoick

Hoick is a command-line HTTP client. It's intended mainly as a tool for testing RESTful APIs, but you can use for something else, if you really want to.

Hoick is designed to be simple yet useful, and to play nicely in a Unix command pipeline.

Installation

Hoick is distributed as a Ruby gem, installable using:

$ gem install hoick

Usage

Hoick has subcommands modelled on HTTP verbs.

GET

To fetch a resource, use GET. The response body will be printed to STDOUT.

$ hoick GET http://api.example.com/widgets/123

If you're interested in response headers too, add the "-h" flag. Add the "--follow" flag if you wish to follow redirects.

PUT and POST

The "PUT" subcommand uploads data to a specified URL.

$ hoick PUT -T json http://api.example.com/widgets/123 < widget-123.json

By default, the payload is read from STDIN, but you can specify the "-F" option to read it from a file, instead.

$ hoick PUT -F widget-123.json http://api.example.com/widgets/123

Hoick guesses a "Content-Type" from the file-name. If a type cannot be guessed, or if the payload is sourced from STDIN, binary data ("application/octet-stream") is assumed. Either way, the default can be overridden with "-T" (which can be either a file extension, or a full MIME-type string).

The "POST" subcommand works in a similar way.

HEAD and DELETE

Rounding out the RESTful actions, "HEAD" and "DELETE" do pretty much what you'd expect.

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Submit a Pull Request

About

A command-line HTTP client

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages