jwells89 / cocoa-rest-client

A free, native Apple OS X app for testing HTTP/REST endpoints

About

CocoaRestClient is a Mac OS X app for testing HTTP/Restful endpoints.

I love curl, but sometimes I need my output XML or JSON pretty printed. I want to be able to save frequent PUT and POST bodies for later and copy and paste from responses easily. Think of this as curl with a light UI.

The goal of this project is to build a lightweight native Cocoa app for testing and debugging HTTP Restful services. This project was greatly inspired by the Java rest-client (http://code.google.com/p/rest-client/).

Official project website: http://mmattozzi.github.io/cocoa-rest-client/

Download

If you're not looking to compile from source and only want to use this tool, latest releases are here:

Download List

You can also install it through homebrew as a cask:

# install cask if necessary
brew install caskroom/cask/brew-cask
# install CocoaRestClient
brew cask install cocoarestclient

Features

• Make GET, PUT, POST, DELETE, HEAD calls
• Set request body to arbitrary content
• Set request headers
• Set HTTP basic & digest auth
• Auto-format (pretty print) XML, JSON, and MsgPack responses
• Some cool Ace Editor themes for syntax highlighting
• Display response headers
• Quick save requests in a handy drawer using folder organization
• Upload files and form data via multipart/form-data
• Enter POST/PUT input as raw input or key/value pairs
• Reports response latency
• Command-R reloads last request
• Lightweight: Low real memory usage
• SSL Support (including untrusted certificates)
• Optionally follows HTTP redirects
• Import and export requests

Screenshots

Pretty print JSON content. Set and save HTTP headers.

Pretty print XML content. Quick save of request URLs, body, and headers in one convenient drawer.

Set HTTP Basic or Digest Auth. Displays HTTP response headers.

Set HTTP request body content to a raw text blob or a list of parameters.

Upload files using HTTP multipart requests. HTTP form encoding also supported.

Source and Contributions

• Source code is hosted on Github: http://github.com/mmattozzi/cocoa-rest-client

• If you would like to contribute, please fork and create a pull request on Github

• Source uses Cocoapods for dependencies, to get started, install CocoaPods and in the main project directory run:

    pod install
  

  • Note that you must have a github account and a public key registered with github so that CocoaPods can pull down a github-hosted dependency.

Credits

• Contains json-framework/SBJSON library (http://code.google.com/p/json-framework/) embedded in it, source and all
• Much guidance from Adrian Kosmaczewski blog (http://kosmaczewski.net/playing-with-http-libraries/)
• Sparkle automatic update framework (https://github.com/andymatuschak/Sparkle)
• ACEView syntax highlighting (https://github.com/faceleg/ACEView)
• Base64 encoding uses Matt Gallagher's NSData+Base64 code (http://www.cocoawithlove.com/2009/06/base64-encoding-options-on-mac-and.html)
• Code & testing contributions: Adam Venturella, Sergey Klimov, Cory Alder, Tito Ciuro, Eric Broska, Nicholas Robinson, Diego Massanti, Robert Horvath