Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jsmestad/jsonapi-consumer
Client framework for consuming JSONAPI services in Ruby
https://github.com/jsmestad/jsonapi-consumer
activemodel json-api jsonapi-standards ruby
Last synced: 5 days ago
JSON representation
Client framework for consuming JSONAPI services in Ruby
- Host: GitHub
- URL: https://github.com/jsmestad/jsonapi-consumer
- Owner: jsmestad
- License: apache-2.0
- Created: 2014-10-16T16:56:42.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-07-13T22:38:27.000Z (over 3 years ago)
- Last Synced: 2024-12-13T02:51:28.228Z (12 days ago)
- Topics: activemodel, json-api, jsonapi-standards, ruby
- Language: Ruby
- Homepage: https://github.com/jsmestad/jsonapi-consumer
- Size: 166 KB
- Stars: 94
- Watchers: 5
- Forks: 18
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# JSONAPI::Consumer
An ActiveModel-compliant consumer framework for communicating with JSONAPI-based APIs.
[![CircleCI](https://circleci.com/gh/jsmestad/jsonapi-consumer/tree/master.svg?style=svg)](https://circleci.com/gh/jsmestad/jsonapi-consumer/tree/master)
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'jsonapi-consumer', '~> 1.0'
```And then execute:
$ bundle
## Usage
It's suggested to create a base resource for the whole API that you can re-use.
```ruby
class Base < JSONAPI::Consumer::Resource
# self.connection_options = {} # Faraday connection options
# self.json_key_format = :dasherized_key # (default: underscored_key)
# self.route_format = :dasherized_route # (default: underscored_route)
self.site = 'http://localhost:3000/api/'
end
```Then inherit from that Base class for each resource defined in your API.
```ruby
module Blog
class Author < Base
has_many :posts, class_name: 'Blog::Post'
endclass Post < Base
has_one :user, class_name: 'Blog::User'
has_many :comments, class_name: 'Blog::Comment'
endclass User < Base
end
class Comment < Base
end
end
```## Contributing
1. Fork it ( https://github.com/jsmestad/jsonapi-consumer/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## Copyright & License
JSONAPI::Consumer is distributed under the Apache 2.0 License. See LICENSE.txt file for more information.
Version v1 is a rewrite is based on the excellent work by [json_api_client](https://github.com/chingor13/json_api_client) [v1.5.3](https://github.com/chingor13/json_api_client/tree/v1.5.3).