LondonCab

Gem Version Build Status Code Climate

A Ruby client for the London Cab APIs.

Installation

Add this line to your application's Gemfile:

gem 'london_cab'

And then execute:

$ bundle

Or install it yourself as:

$ gem install london_cab

Usage

API Token

To acquire an API token, use the london_cab-auth gem. Use the same credentials for your corporate London Cab account.

Configuration

LondonCab.configure do |config|
  config.token = ENV['LONDON_CAB_API_TOKEN']
end

This sets a global default token. You can also pass a token to the initializer of LondonCab::Client.

client = LondonCab::Client.new(token: ENV['LONDON_CAB_API_TOKEN'])

The instance token will be used over the global default.

The following globals settings are supported via LondonCab.configure.

setting description
token London Cab API token.
logger An optional logger.
Default: Logger.new(STDOUT) at Logger::WARN level.

Client

The London Cab API allows you to build applications that interact with London Cab.

Configuration

setting description
endpoint London Cab endpoint.
Default: http://65.182.108.16:3467/api
user_agent User-agent.
Default: LondonCab/VERSION.
token Required. London Cab API token.
logger Optional. Logger instance that logs HTTP requests.

Documentation

Rides

You can use the client to make requests related to rides.

Request Rides

Request rides with #ride_request.

client.ride_request(PickupLong:  '31.276942',
                    PickupLat:   '29.962696',
                    DropoffLong: '31.330108',
                    DropoffLat:  '30.056610')

History

The structure of this gem is based on slack-ruby-client.

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.

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/RaMin0/london_cab.