Boolio

A Ruby interface to the booleans.io API.

Installation

Add this line to your application's Gemfile:

gem 'boolio'

Or install it yourself as:

$ gem install boolio

Usage

Creating a Boolio instance hits the booleans.io API to create a corresponding boolean:

bool = Boolio.new val: true
# => #<Boolio:0x007fdcfa8f3548 @val=true, @id="1aa1f9c8-c65d-43c9-b8cb-ed171f0719bb">

Instantiating without a val argument will generate a random boolean value. This instance can now be used to interact your booleans. For example, to update your boolean's value, the API's PUT endpoint can be triggered by calling #update:

bool.val = false
bool.update

Or,

bool.update false

Already have an ID? Retrieving your booleans is simple:

bool = Boolio.fetch("5b4851a0-0883-4cef-8651-59b2daf053da")
# => #<Boolio:0x007fdcfb3bb7a0 @val=true, @id="5b4851a0-0883-4cef-8651-59b2daf053da">

Invoking #destroy! removes your boolean from the booleans.io server, nullifies the instance's attributes, and freezes the instance:

bool = Boolio.new val: false
# => #<Boolio:0x007fdcf99e8b98 @val=false, @id="b3f0a1fb-b74a-42b0-a950-cd57bd29a351">
bool.destroy!
# => #<Boolio:0x007fdcf99e8b98 @val=nil, @id=nil>

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

License

The gem is available as open source under the terms of the MIT License.