Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Latest commit c4f0da4 @ryanmoran cleanup [ci skip]

Morpheus Travis CI Build Status

A RESTful API Client library built over Typhoeus

  • The project is working toward a DSL that is very ActiveResource/ActiveRecord-like with some features stolen from other great libraries like DataMapper.
  • We started working on this at a point when we felt we were pushing ActiveResource to its limits.
  • We wanted a little more flexibility in terms of API coupling.
  • We have plans to make Morpheus as flexible as possible in terms of query interface, and resource representation.
  • Additionally, Morpheus is built on top of Typhoeus and will be building in intuitive interfaces for working with parallel requests.

    class Dummy < Morpheus::Base
      property :name
      property :created_at
      property :has_smarts
      belongs_to :thingy
      has_many :thingamabobs
      has_one :doohickey

Creating new resources

  • Morpheus uses ActiveModel and so has an interface that tries to not stray too far from the similar ActiveRecord interface.

    @dummy =
      :name       => 'Dumb',
      :has_smarts => false,
      :thingy_id  => 2)     # => #<Dummy:0x1016858d8>
    @dummy.new_record?      # => true             # => POST

Finding existing resources

  • Resources can be retrieved with as little as their classname and unique identifier.

    @dummy = Dummy.find(1) # => GET
    @dummy.new_record?     # => false            # => 'Dumb'

Updating existing resources

  • Resources can be updated just in the same way you would expect from a Active* library. = 'Dumber'                        # => 'Dumber'                                   # => PUT
    @dummy.update_attributes(:has_smarts => true) # => PUT


  • Morpheus was originally conceived at a point when we needed ActiveResource with a little more.
  • Associations are a bit of that 'little more'.

    @dummy.thingy       # => GET
    @dummy.thingamabobs # => GET
    @dummy.doohickey    # => GET

Query Interface

  • ARel has a beautiful query interface.
  • We have ported its method-chaining style to fit our query interface.

    Dummy.all                                          # => GET
    Dummy.find(1,2,3)                                  # => GET,2,3
    Dummy.where(:name => 'Dumb')                       # => GET
    Dummy.where(:name => 'Dumb', :has_smarts => false) # => GET
    Dummy.limit(1)                                     # => GET
    Dummy.result_per_page = 25                         # => 25                                      # => GET

More about the project

Design informed by Service-Oriented Design with Ruby and Rails by Paul Dix, Amazon

Something went wrong with that request. Please try again.