# HTTParty

Tonight we're gonna HTTParty like it's 1999!

## Install

    $ sudo gem install httparty

## Some Quick Examples

The following is a simple example of wrapping Twitter's API for posting updates.

    class Twitter
      include HTTParty
      base_uri 'twitter.com'
      basic_auth 'username', 'password'
    end

    Twitter.post('/statuses/update.json', query: {status: "It's an HTTParty and everyone is invited!"})

That is really it! The object returned is a ruby hash that is decoded from Twitter's json response. JSON parsing is used because of the .json extension in the path of the request. You can also explicitly set a format (see the examples).

That works and all but what if you don't want to embed your username and password in the class? Below is an example to fix that:

    class Twitter
      include HTTParty
      base_uri 'twitter.com'

      def initialize(u, p)
        @auth = {username: u, password: p}
      end

      def post(text)
        options = { query: {status: text}, basic_auth: @auth }
        self.class.post('/statuses/update.json', options)
      end
    end

    Twitter.new('username', 'password').post("It's an HTTParty and everyone is invited!")

More Examples: There are several examples in the gem itself.

## Support

Conversations welcome in the google group and bugs/features over at Github.