Vodka Build Status

Vodka makes communication easier. Always.

Vodka uses Her as a REST client.

Vodka currently supports these ORMs on server:

And the following plugins on client:

Vodka supports I18n. If you change locale on client you may expect getting response from server in this locale.

Vodka signs all requests and responses so you can relax and hope nothing goes wrong. Or your sensitive data will be stolen by some Russian gangsters. Or there will be some man-in-the-middle that will attack you. Anyway, as long as you're not using SSL for all your requests you're screwed.

Installation

Add this gem to both server and client application Gemfiles:

# Server
gem 'vodka', require: 'vodka/server'

# Client
gem 'vodka', require: 'vodka/client'

Configuring server

Add initializer vodka_setup.rb to config/initializers:

Vodka::Server.configure do |c|
  c.request_secret = '8089c2189321798bf60df6b8c01bb661fb585080'
  c.response_secret = '3ecb42ac23cd58994a6518971e7e31d2f4545e3c'

  # Optional

  # Any class that responds to .hexdigest method
  c.digest = Digest::SHA1 # Default is Digest::SHA512
end

Add vodka namespaced resources to your config/routes.rb

namespace :vodka do
  resources :articles do
    collection { get :best }
    resources :comments do
      member { put :approve }
    end
  end
end

Create controllers in app/controllers/vodka

# articles_controller.rb
class ArticlesController < VodkaController
  def best
    respond_with_collection(Article.best)
  end
end

# comments_controller.rb
class CommentsController < VodkaController
  def approve
    vodka_response.success = resource.approve
    respond_with_resource
  end
end

Modify your models:

# article.rb
class Article < ActiveRecord::Base
  has_many :comments
  scope :best, ->{ where('rating > 100') }
  validates_presence_of :title, :body

  # If .present_with was not called, default presenter (named as ModelNamePresenter) will be used
  # present_with ArticlePresenter
end

# comment.rb
class Comment < ActiveRecord::Base
  belongs_to :article
  belongs_to :user
  validates_presence_of :body

  # Defines custom presenter
  present_with CommentCustomPresenter

  def approve
    update_attributes(status: 'approved')
  end

  def author_name
    [user.first_name, user.last_name].join(' ')
  end
end

Add presenters:

# article_presenter.rb
class ArticlePresenter < VodkaPresenter
  def present
    json(id: id, title: title)
  end
end

Configuring client

Add initializer vodka_setup.rb to config/initializers:

Vodka::Client.configure do |c|
  c.api_url = 'https://api.myproject.org/vodka'
  c.request_secret = '8089c2189321798bf60df6b8c01bb661fb585080'  # Same as server's
  c.response_secret = '3ecb42ac23cd58994a6518971e7e31d2f4545e3c' # Same as server's

  # Optional

  # Any class that responds to .hexdigest method
  c.digest = Digest::SHA1 # Default is Digest::SHA512, same as server's

  # Configure Her automatically
  c.auto_configure_her = false
end

# You can call Vodka::Client.config.configure_her! or configure Her yourself
# Her::API.setup(url: Vodka::Client.config.api_url) do |c|
#   c.use Vodka::Client::Middleware::ErrorAware
#   c.use Vodka::Client::Middleware::SignedRequest
#   c.use Faraday::Request::UrlEncoded
#   c.use Vodka::Client::Middleware::SignedResponse
#   c.use Her::Middleware::SecondLevelParseJSON
#   c.use Faraday::Adapter::NetHttp
# end

Usage

After all the configuration is done, you can use your Her-applied models with all the new possibilities.

Vodka adds some convinient methods to client and supports them on server:

  • .create! (throws exception on error)
  • .paginate (returns WillPaginate-compatible collection)
  • .where (supports chaining the way you expect)
  • .first
  • .last
  • #update_attribute
  • #update_attribute! (throws exception on error)
  • #update_attributes
  • #update_attributes! (throws exception on error)
  • #destroy! (throws exception on error)
  • #delete (acts like #destroy)
  • #delete! (acts like #destroy!)

Is it secure? Should I use it in production?

Hell no. At least not yet.