Skip to content

Commit e057af8

Browse files
authored
Merge pull request #17 from speee/docs/add-speee-fork-installation-instructions
Add Speee fork installation instructions to README
2 parents c3c3924 + ec60062 commit e057af8

1 file changed

Lines changed: 49 additions & 1 deletion

File tree

README.md

Lines changed: 49 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,36 @@ of your resources, including their attributes and relationships, to make your se
99
JR is designed to work with Rails 5.1+, and provides custom routes, controllers, and serializers. JR's resources may be
1010
backed by ActiveRecord models or by custom objects.
1111

12+
## Speee Fork
13+
14+
This is the [Speee](https://speee.jp/) fork of [jsonapi-resources](https://github.com/cerebris/jsonapi-resources).
15+
16+
### Goals
17+
18+
- **Modern Rails Support**: Enable compatibility with the latest Rails versions (7.1, 7.2, 8.0, 8.1+)
19+
- **0.9.x Backward Compatibility**: Maintain compatibility with code written for jsonapi-resources 0.9.x
20+
21+
### Key Changes from Upstream
22+
23+
#### Rails Compatibility
24+
- Full support for Rails 7.1, 7.2, 8.0, and 8.1
25+
- Rack 3.0 compatibility fixes
26+
- Rails 8.2 deprecation warning fixes
27+
28+
#### 0.9.x Backward Compatibility
29+
- `result.resource` and `result.resources` accessors on operation results
30+
- `apply_filters` method made public for custom filter implementations
31+
- PORO (Plain Old Ruby Object) support in `find_fragments`
32+
33+
#### Bug Fixes
34+
- MySQL compatibility fix for the `quote` method (uses database adapter)
35+
- Ruby 2.6/2.7 compatibility for `Psych.unsafe_load`
36+
37+
#### Development
38+
- Docker support for multi-version Rails testing
39+
- Comprehensive CI matrix covering Ruby 2.6-3.4 and Rails 5.1-8.1
40+
- SimpleCov integration for test coverage measurement
41+
1242
## Documentation
1343

1444
Full documentation can be found at [http://jsonapi-resources.com](http://jsonapi-resources.com), including the [v0.10 alpha Guide](http://jsonapi-resources.com/v0.10/guide/) specific to this version.
@@ -24,9 +54,27 @@ which *should* be compatible with JSON:API compliant server implementations such
2454

2555
## Installation
2656

27-
Add JR to your application's `Gemfile`:
57+
### Using This Fork
2858

59+
To use this fork, add the following to your application's `Gemfile`:
60+
61+
```ruby
62+
gem 'jsonapi-resources', github: 'speee/jsonapi-resources', tag: 'v26.1.1'
63+
```
64+
65+
Then execute:
66+
67+
```bash
68+
bundle install
2969
```
70+
71+
You can find available tags at [https://github.com/speee/jsonapi-resources/tags](https://github.com/speee/jsonapi-resources/tags).
72+
73+
### Original (upstream)
74+
75+
To use the original jsonapi-resources gem from RubyGems, add it to your application's `Gemfile`:
76+
77+
```ruby
3078
gem 'jsonapi-resources'
3179
```
3280

0 commit comments

Comments
 (0)