# Totter

Totter, as in teeter-totter, let's you work with the Seesaw API in Ruby.

All networking is done with Net::HTTP so you don't have to worry about version conflicts with whatever networking library you may be using.

Read the [documentation](http://rubydoc.info/github/seesawco/totter-rb/master/frames) online.

## Installation

Add this line to your application's Gemfile:

``` ruby
gem 'totter'
```

And then execute:

``` shell
$ bundle
```

Or install it yourself as:

``` shell
$ gem install totter
```

## Usage

A client takes an optional access token when you initialize it. If you don't provide one, you can still use it to make unauthenticated requests. If you do provide one, it will set the authorization header for all requests.

``` ruby
> client = Totter::Client.new(access_token: 'your_access_token')
> current_user = client.me
> current_user.username
#=> "soffes"
> decision = client.decision(5, 3276)
#=> "Which lamp for the new apartment?"
> slug = client.slug('d/3I0n0g')
> slug.decision.user.username
#=> "soffes"
```

## Supported Ruby Versions

Totter is tested under 1.8.7, 1.9.2, 1.9.3, 2.0.0, JRuby 1.7.2 (1.9 mode), and Rubinius 2.0.0 (1.9 mode).

[![Build Status](https://travis-ci.org/seesawco/totter-rb.png?branch=master)](https://travis-ci.org/seesawco/totter-rb)

## Contributing

See the [contributing guide](Contributing.markdown).