darvin / cocoa-rest-client

A native OS X cocoa application for testing HTTP 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/).

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 and JSON responses
• Display response headers
• Quick save requests in a handy drawer
• 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 XML content. Quick save of request URLs, body, and headers in one convenient drawer.

Pretty print JSON content. Set and save HTTP headers.

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 now 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
• Downloads and issues will still be kept up to date on Google Code. I will probably keep source up to date with each release.
• I don't plan on switching from Garbage Collection to ARC until I drop 10.6 support, as there seems to be some limitations with ARC on 10.6. I will most likely switch to ARC when OS X 10.8 is released.
• I am not turning on AutoLayout constraints in my xib files until I drop 10.6 support.

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/)
• Multipart features contributed by Adam Venturella
• Sparkle automatic update framework (https://github.com/andymatuschak/Sparkle)

Pretty formatting

On requests export, choose .md or .markdown file extension and requests will be exported as:

User Create

POST /api/v1/auth/user

Input

Content-Type: application/json

{
	"username":"userna3dme 1",
	"password":"some password"
}

User Info

GET /api/v1/auth/user/1

Input

Content-Type: application/json

User Update

GET /api/v1/auth/user/1

Input

Content-Type: application/json

{
	"username":"New username",
	"password":"new password"
}