Fetching contributors…
Cannot retrieve contributors at this time
31 lines (19 sloc) 1.25 KB

Here is a list of backward-incompatible changes that were introduced while Her is pre-1.0. After reaching 1.0, it will follow the Semantic Versioning system.


  • Her no longer includes default middleware when making HTTP requests. The user has now to define all the needed middleware. Before:

    Her::API.setup :url => "" do |connection|
      connection.insert(0, FaradayMiddle::OAuth)


      Her::API.setup :url => "" do |connection|
        connection.use FaradayMiddle::OAuth
        connection.use Her::Middleware::FirstLevelParseJSON
        connection.use Faraday::Request::UrlEncoded
        connection.use Faraday::Adapter::NetHttp


  • The default parser middleware has been replaced to treat first-level JSON data as the resource or collection data. Before it expected this:

    { "data": { "id": 1, "name": "Foo" }, "errors": [] }

    Now it expects this (the errors key is not treated as resource data):

    { "id": 1, "name": "Foo", "errors": [] }

    If you still want to get the old behavior, you can use Her::Middleware::SecondLevelParseJSON instead of Her::Middleware::FirstLevelParseJSON in your middleware stack.