Dirble
Gem to make interacting with http://api.dirble.com/ amazingly easy. Using familiar Rails syntax. It uses Faraday and Typhoeus as adapter.
Compatibility
- Ruby 1.9.3 and 2
- JRuby 1.7
- Rubinius
Installation
Add this line to your application's Gemfile:
gem 'dirble'
And then execute:
$ bundle
Or install it yourself as:
$ gem install dirble
Usage
In Rails: Put this quick configuration block in environment file. Beyond Rails: Put this in initialization or config file.
Dirble.configure do |config|
config.api_key = "valid_api_key_from_dirble"
end
Now you are ready to go.
Category
- Fetch all categories with
Dirble::Category.all
- Fetch primary categories with
Dirble::Category.primary
or
Dirble::PrimaryCategory.all
- Find category by id
Dirble::Category.find(2)
- Get first category
Dirble::Category.first
- Find children of primary category
primary_category = Dirble::PrimaryCategory.first
children = primary_category.children
- Find stations of category
category.stations
Station
- Search stations
Dirble::Station.search('pop')
- Stations by continent
Dirble::Station.by_continent('Asia')
- Stations by country
Dirble::Station.by_country('us')
- Stations amount. Check currently registered stations in Dirble.
Dirble::Station.count
Contributing
- Fork it ( https://github.com/[my-github-username]/dirble/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request