DoodleClient
Installation
Add this line to your application's Gemfile:
gem 'doodle_client'
And then execute:
$ bundle
Or install it yourself as:
$ gem install doodle_client
Troubleshooting
Needs nokogiri, so you'll probably hit at least one dependency issue if you don't have it installed already.
Try these 'one size fits all' approaches if you're stuck
Ubuntu/Debian - apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev
CentOS/Redhat - yum install gcc ruby-devel zlib-devel
Usage
Verify
Checks if a provided URL or id is a valid doodle.com reference.
Takes a string, returns true or false.
2.3.0 :001 > require 'doodle_client'
=> true
2.3.0 :002 > DoodleClient.verify("http://doodle.com/poll/kfha4cefe7zutuqu")
=> true
2.3.0 :003 > DoodleClient.verify("kfha4cefe7zutuqu")
=> true
2.3.0 :004 > DoodleClient.verify("http://doodle.com/poll/notarealdoodleid")
=> false
2.3.0 :005 > DoodleClient.verify("notarealdoodleid")
=> false
List
Lists the various options available on the poll. Currently doesn't have useul information like value.
Takes a string of either URL or id again.
2.3.0 :001 > require 'doodle_client'
=> true
2.3.0 :002 > DoodleClient.list("http://doodle.com/poll/kfha4cefe7zutuqu")
=> [[checkbox:0xce6a1c type: checkbox name: option0 value: false], [checkbox:0xce6850 type: checkbox name: option1 value: false], [checkbox:0xce6634 type: checkbox name: option2 value: false], [checkbox:0xce6468 type: checkbox name: option3 value: false]]
2.3.0 :003 > DoodleClient.list("kfha4cefe7zutuqu")
=> [[checkbox:0xc8e77c type: checkbox name: option0 value: false], [checkbox:0xc8e560 type: checkbox name: option1 value: false], [checkbox:0xc8e344 type: checkbox name: option2 value: false], [checkbox:0xc8e164 type: checkbox name: option3 value: false]]
Vote
The main event, lets you vote on a poll.
Takes a string for URL/id, a string for the name you want to vote as and an array of true or false to reflect if you're attending or not.
2.3.0 :001 > require 'doodle_client'
=> true
2.3.0 :002 > DoodleClient.vote("http://doodle.com/poll/kfha4cefe7zutuqu", "Sam", [true, false, true])
=> true
2.3.0 :003 > DoodleClient.vote("kfha4cefe7zutuqu", "Jim", [false, false, true])
=> true
Resulting in:
Development
After checking out the repo, run bin/setup
to install dependencies. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/zyio/doodle_client.
License
The gem is available as open source under the terms of the MIT License.