jsonapi-resources

A resource-focused Rails library for developing JSON API compliant servers.

  • Owner: cerebris/jsonapi-resources
  • Platform:
  • License:: MIT License
  • Category::
  • Topic:
  • Like:
    0
      Compare:

Github stars Tracking Chart

JSONAPI::Resources Gem Version Build Status Code Climate

Join the chat at https://gitter.im/cerebris/jsonapi-resources

JSONAPI::Resources, or "JR", provides a framework for developing an API server that complies with the
JSON:API specification.

Like JSON:API itself, JR's design is focused on the resources served by an API. JR needs little more than a definition
of your resources, including their attributes and relationships, to make your server compliant with JSON API.

JR is designed to work with Rails 4.2+, and provides custom routes, controllers, and serializers. JR's resources may be
backed by ActiveRecord models or by custom objects.

Documentation

Full documentation can be found at http://jsonapi-resources.com, including the v0.10 alpha Guide specific to this version.

Demo App

We have a simple demo app, called Peeps, available to show how JR is used.

Client Libraries

JSON:API maintains a (non-verified) listing of client libraries
which should be compatible with JSON:API compliant server implementations such as JR.

Installation

Add JR to your application's Gemfile:

gem 'jsonapi-resources'

And then execute:

bundle

Or install it yourself as:

gem install jsonapi-resources

For further usage see the v0.10 alpha Guide

Contributing

  1. Submit an issue describing any new features you wish it add or the bug you intend to fix
  2. Fork it ( http://github.com/cerebris/jsonapi-resources/fork )
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Run the full test suite (rake test)
  5. Fix any failing tests
  6. Commit your changes (git commit -am 'Add some feature')
  7. Push to the branch (git push origin my-new-feature)
  8. Create a new Pull Request

Did you find a bug?

  • Ensure the bug was not already reported by searching on GitHub under Issues.

  • If you're unable to find an open issue addressing the problem, open a new one.
    Be sure to include a title and clear description, as much relevant information as possible,
    and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

  • If possible, use the relevant bug report templates to create the issue.
    Simply copy the content of the appropriate template into a .rb file, make the necessary changes to demonstrate the issue,
    and paste the content into the issue description or attach as a file:

License

Copyright 2014-2017 Cerebris Corporation. MIT License (see LICENSE for details).

Main metrics

Overview
Name With Ownercerebris/jsonapi-resources
Primary LanguageRuby
Program languageRuby (Language Count: 1)
Platform
License:MIT License
所有者活动
Created At2014-03-29 18:45:23
Pushed At2024-11-21 03:09:06
Last Commit At2024-04-18 08:48:18
Release Count88
Last Release Namev0.11.0.beta2 (Posted on 2023-09-26 10:45:33)
First Release Namev0.0.1 (Posted on 2014-08-22 12:36:17)
用户参与
Stargazers Count2.3k
Watchers Count46
Fork Count535
Commits Count1.7k
Has Issues Enabled
Issues Count685
Issue Open Count203
Pull Requests Count572
Pull Requests Open Count48
Pull Requests Close Count148
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private