Emites Client

This is the official Ruby client for the Emites API.

Add this line to your application's Gemfile:

gem 'emites-client', require: 'emites'

And then execute:

$ bundle

Or install it yourself as:

$ gem install emites-client

require "emites"

Emites.configure do |config|
  config.url = "https://sandbox.emites.com.br/api/v1" # defaults to "https://app.emites.com.br/api/v1"
  config.user_agent = 'My App v1.0' # optional, but you should pass a custom user-agent identifying your app
end

client = Emites.client("YOUR_TOKEN_HERE")

• Emitters API as client.emitters
• Takers API as client.takers
• Services API as client.services
• Webhooks API as client.webhooks
• NFSe API as client.nfse

All actions that change data triggers an event that you can subscribe to. This event allow you to extend the logic executed when you call a client method.

All you have to do is create a class that responds to a method #call with two arguments:

class MyListener
  def call(result, args)
  end
end

Where:

• result is the return of a client method
• args is an array of arguments passed to the client method you called

Now you have a listener, you can subscribe to an event:

Emites.subscribe("emites.emitters.destroy", MyListener.new)

Example:

When you call client.emitters.destroy(1), an event emites.emitters.destroy will be triggered. Your listener method #call will receive:

• result would be true or false - depending on what client.emitters.destroy(1) returned
• args would be [1] - an array with the arguments passed to the client method

1. Fork it ( https://github.com/myfreecomm/emites-client-ruby/fork )
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 a new Pull Request