httpism/README.md

Resource savvy HTTP client

# HTTPism

## Hypermedia

The idea is that you can point `httpism` at a resource, identified by a URL, then call `GET` or `POST` on it, then follow a link in the returned resource, and make another `GET` or `POST`, or any other kind of verb. Follow the hypermedia links, that's what its all about right?

## API (in [pogoscript](http://pogoscript.org/), of course)

    httpism = require 'httpism'

    resource = httpism.get! 'http://example.com/'

### Content-Types

    httpism.content types = {
        'application/json' (response) =
            JSON.parse (response.body)
    }

### GET

    the resource = resource.get! ()

Or

    linked resource = resource.get! 'relative/url.html'

### POST

    new resource = resource.post! (body)

### Resource

    resource.body
    resource.status code
    resource.headers

# This is just for fun.

Of course, I don't mean for anybody to _actually_ use this!