Client

Client provides you with metaprogram ruby rest clients generated from yml configurations.

Installation

Add this line to your application's Gemfile:

gem 'client'

and run bundle

Usage

Client tries to generate rest clients as soon as you require the gem. It will try to find client.yml in the main folder of your project:

/my_project/client.yml

The yaml should look something like this:

    google:
        base_uri: 'http://www.google.com'
    twitter:
        base_uri: 'http://www.twitter.com'

This will generate a rest client for you to perform post and gets and return NET/HTTP responses:

    require 'client'
    Client::Google.get 'search', query: {q: 'bonzofenix gem client'}
    #This should perform a GET to http://www.google.com/search?q=bonzofenix+gem+client

    #Some rest magic too:

    Client::Twitter.list_tweets(query: {user_id: 2}) #also try find_
    #This should perform a GET to http://www.twitter.com/tweets?user_id=2

    Client::Twitter.list_tweets(1, query: {token: 'asd123'}) #also try find_1
    #This should perform a GET to http://www.twitter.com/tweets/1?token=asd123

    Client::Twitter.destroy_tweets(3) #also try remove_ delete_ 
    #This should perform a DELETE to http://www.twitter.com/tweets/3

    Client::Twitter.create_tweet(body:{text: 'a tweet'}) #also try post_
    #This should perform a POST to http://www.twitter.com/tweets with body: text='a tweet'

    Client::Twitter.create_tweet(body: {text: 'a tweet'}, content_type: :json) #also try post_
    #This should perform a POST to http://www.twitter.com/tweets with body: '{"text": "a tweet"}' and header CONTENT-TYPE application/json

You can also load specific yml files:

    require 'client'
    Client.load_clients 'config/twitter.yml', 'config/google.yml'
    Client::Twitter
    # => Client::Twitter
    Client::Google
    # => Client::Google

See the spec folder for more examples.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request