Y25-318 Publish sanger-jsonapi-resources gem from master

[seenanair]

Closes sanger/General-Backlog-Items#569

All Submissions:

This pull request creates a gem of version (0.2.0) from sanger-jsonapi-resources master branch (https://github.com/sanger/jsonapi-resources) ensuring compatibility with Rails version 7 and 8 and Ruby versions (3.3 and 3.2).
This pull request includes several updates to improve compatibility with newer Rails versions, simplify the codebase, and enhance testing and database configurations. The most notable changes involve introducing a compatibility helper for deprecation warnings, updating database configurations, and refining test setups. Below is a categorized summary of the most important changes:

Compatibility Enhancements:

• Added JSONAPI::CompatibilityHelper module to provide a version-safe method for issuing deprecation warnings across Rails versions. Updated all deprecation warnings in lib/jsonapi files to use this helper instead of ActiveSupport::Deprecation.warn.

Database Configuration Updates:

• Updated test/fixtures/active_record.rb to replace length with limit for string columns and added explicit foreign_key definitions for references to improve database schema compatibility.
• Split t.references calls into separate lines for clarity and added explicit indexing for composite keys.

CI Workflow Updates:

• Simplified .github/workflows/ruby.yml and updating Ruby and Rails version matrices to focus on newer versions.

Test Setup Refinements:

• Adjusted test/test_helper.rb to silence deprecation warnings conditionally based on Rails version and updated fixture paths for compatibility.

Codebase Simplifications:

• Added require 'rails/generators' to lib/generators/jsonapi/controller_generator.rb and lib/generators/jsonapi/resource_generator.rb for better clarity and dependency management.
• Added a conditional check to skip processing in find_related_polymorphic_fragments if relation_position is nil.

[stevieing]

I don't understand most of it so as long as it works I'm good.

1 issue to resolve with ruby versions.

[stevieing]

Traction Service is on ruby 3.4.4 so maybe worth adding ruby 3.4?

[seenanair]

Good spot! Done 👍

[seenanair]

I don't understand most of it so as long as it works I'm good.

1 issue to resolve with ruby versions.
Thanks for the review. Most of the changes are just to make things work with the current Rails and Ruby versions—updating the schema (ActiveRecord), tweaking the test_helper, and changing method which is no longer supported in Rails 8 (ActiveSupport::Deprecation.warn)