schemable 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d63ce1b1c91d8f6344b5800d9e793bb33a3b9694f91f646546a0e59f470a675
-  data.tar.gz: 04c750e85b0095266a86b5e74ccf64212af0c7669476b23229b3d0874af4a287
+  metadata.gz: 76b5ccf66c28d0bcfc644321e370e1c4404518ee1a4ba056fe20bb72a22cc415
+  data.tar.gz: cd7ad60e43634159a2b845c15ef557a3a60b02cb5c465e63e5f90ff47807afe5
 SHA512:
-  metadata.gz: 182e79396d00e3eb16d2344467cde65f9a8a0841b152f38c9fccafe4f3dfbaf47febdeb1a00063206090eb1fed37942f00788ee7530a936bda983a9c67944d34
-  data.tar.gz: 188035d9d158f7f28b2b79b98c1b9dea08df8482344c287eebac12116fddd5758637871917b8c79194537ad8af80ea72676f17f0e8cb5df2d811f5605240909e
+  metadata.gz: 835b1048ab2efd7419b45e77d4733e769d9c657a5cd08e67a26584f3cf6f3ca23588d7875eb21353d9a283f422b50bb50bfc8a5ef0dd2edcad3dcf0c76cfda16
+  data.tar.gz: accc7a59d075dfc07437f7d2c6bfa8367336b3aafd8d04aca652c38a98cebdf3e7f80c614c1e90524091df6f32e7306ac4f2d183ab79157863f4014376a3b14a

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 This file is used to list changes made in each version of the Schemable gem.
 
+## Schemable 1.0.3 (2024-01-30)
+
+* Added configuration for preventing expansion for nested relationships. This can be done by setting the `expand_nested` to `true` when  invoking `ResponseSchemaGenerator`'s `generate` instance method (e.g. `ResponseSchemaGenerator.new(instance).generate(expand: true, expand_nested: true)`. Additionally, you could globally set the value of `expand_nested` to the same value as `expand` by setting the configuration `infer_expand_nested_from_expand` to `true` in the `/config/initializers/schemable.rb`.
+
 ## Schemable 1.0.2 (2024-01-30)
 
 * Added configuration for making certain associations nullable in the response's relationship. This can be done by adding the name of the relation in the `nullable_relationships` method's array of strings.

data/README.md

@@ -61,6 +61,7 @@ Please note that the configurations options below are defined in the `Schemable`
 | `enum_prefix_for_simple_enum`                | The prefix to be used for the enum values when `mongoid` is used.                                                                                                                                                                                                                                          | `nil`         |
 | `enum_suffix_for_simple_enum`                | The suffix to be used for the enum values when `mongoid` is used.                                                                                                                                                                                                                                          | `nil`         |
 | `infer_attributes_from_custom_method`        | The name of the custom method that is used to get the attributes to be generated in the schema. See [Annex 1.3 - Infer attributes from custom method](#annex-13---infer-attributes-from-custom-method) for more information.                                                                               | `nil`         |
+| `infer_expand_nested_from_expand`            | Configures `ResponseSchemaGenerator`'s `generate` method to prevent expansion for nested relationships. It globally set the value of `expand_nested` to the same value as `expand` by setting the configuration to `true`                                                                                  | `flase`       |
 | `infer_attributes_from_jsonapi_serializable` | Whether or not to infer the attributes from the `JSONAPI::Serializable::Resource` class. See the previous example [Annex 1.1 - Use serialized instance](#annex-11---use-serialized-instance) for more information.                                                                                         | `false`       |
 | `custom_meta_response_schema`                | A hash of custom meta response schema that can be used to override the default meta response schema. See [Annex 1.4 - Custom meta response schema](#annex-14---custom-meta-response-schema) for more information.                                                                                          | `nil`         |
 | `pagination_enabled`                         | Enable pagination schema generation in the `meta` section of the response schema.                                                                                                                                                                                                                          | `true`        |
@@ -400,7 +401,7 @@ module Swagger
           "#{schema_instance.model}CreateRequest": schema_instance.camelize_keys(Schemable::RequestSchemaGenerator.new(schema_instance).generate_for_create),
           "#{schema_instance.model}UpdateRequest": schema_instance.camelize_keys(Schemable::RequestSchemaGenerator.new(schema_instance).generate_for_update),
           "#{schema_instance.model}Response": schema_instance.camelize_keys(Schemable::ResponseSchemaGenerator.new(schema_instance).generate(expand: true, collection: true, relationships_to_exclude_from_expansion: %w[addresses stores attachments])),
-          "#{schema_instance.model}ResponseExpanded": schema_instance.camelize_keys(Schemable::ResponseSchemaGenerator.new(schema_instance).generate(expand: true))
+          "#{schema_instance.model}ResponseExpanded": schema_instance.camelize_keys(Schemable::ResponseSchemaGenerator.new(schema_instance).generate(expand: true, expand_nested: true))
         ]
       end
     end

data/lib/schemable/configuration.rb

@@ -16,6 +16,7 @@ module Schemable
       :enum_prefix_for_simple_enum,
       :enum_suffix_for_simple_enum,
       :custom_meta_response_schema,
+      :infer_expand_nested_from_expand,
       :infer_attributes_from_custom_method,
       :infer_attributes_from_jsonapi_serializable
     )
@@ -32,6 +33,7 @@ module Schemable
       @custom_meta_response_schema = nil
       @enum_prefix_for_simple_enum = nil
       @enum_suffix_for_simple_enum = nil
+      @infer_expand_nested_from_expand = false
       @infer_attributes_from_custom_method = nil
       @infer_attributes_from_jsonapi_serializable = false
     end

data/lib/schemable/response_schema_generator.rb

@@ -27,12 +27,16 @@ module Schemable
     # @param expand [Boolean] Whether to include the included resources in the schema.
     # @param relationships_to_exclude_from_expansion [Array] The relationships to exclude from expansion in the schema.
     # @param collection [Boolean] Whether the response is for a collection of resources.
+    # @param expand_nested [Boolean] Whether to include the nested relationships in the schema.
     #
     # @example
-    #   schema = generator.generate(expand: true, relationships_to_exclude_from_expansion: ['some_relationship'], collection: true)
+    #   schema = generator.generate(expand: true, relationships_to_exclude_from_expansion: ['some_relationship'], collection: true, expand_nested: true)
     #
     # @return [Hash] The generated schema.
-    def generate(expand: false, relationships_to_exclude_from_expansion: [], collection: false)
+    def generate(expand: false, relationships_to_exclude_from_expansion: [], collection: false, expand_nested: false)
+      # Override expand_nested if infer_expand_nested_from_expand is true
+      expand_nested = expand if @configuration.infer_expand_nested_from_expand
+
       data = {
         type: :object,
         properties: {
@@ -51,7 +55,7 @@ module Schemable
       schema = collection ? { data: { type: :array, items: data } } : { data: }
 
       if expand
-        included_schema = IncludedSchemaGenerator.new(@model_definition).generate(expand:, relationships_to_exclude_from_expansion:)
+        included_schema = IncludedSchemaGenerator.new(@model_definition).generate(expand: expand_nested, relationships_to_exclude_from_expansion:)
         @schema_modifier.add_properties(schema, included_schema, '.')
       end
 

data/lib/schemable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Schemable
-  VERSION = '1.0.2'
+  VERSION = '1.0.3'
 end

data/lib/templates/schemable.rb

@@ -41,6 +41,11 @@ Schemable.configure do |config|
   #
   # config.infer_attributes_from_custom_method = nil
 
+  # If you want to recursively expand the relationships in the response schema
+  # then set this option to true, otherwise set it to false (default).
+  #
+  # config.infer_expand_nested_from_expand = true
+
   # If you want to get the list of attributes from the jsonapi-rails gem's
   # JSONAPI::Serializable::Resource class, set this option to true.
   # It uses the attribute_blocks method to get the list of attributes.

data/sig/schemable/configuration.rbs

@@ -8,6 +8,7 @@ module Schemable
     attr_accessor custom_defined_enum_method: Symbol?
     attr_accessor enum_prefix_for_simple_enum: String?
     attr_accessor enum_suffix_for_simple_enum: String?
+    attr_accessor infer_expand_nested_from_expand: bool
     attr_accessor custom_type_mappers: Hash[Symbol, any]
     attr_accessor infer_attributes_from_custom_method: Symbol?
     attr_accessor custom_meta_response_schema: Hash[Symbol, any]?

data/sig/schemable/response_schema_generator.rbs

@@ -8,6 +8,6 @@ module Schemable
     def initialize: (Definition) -> void
     def meta: -> Hash[Symbol, any]
     def jsonapi: -> Hash[Symbol, any]
-    def generate: (expand: bool, relationships_to_exclude_from_expansion: Array[Symbol], collection: bool) -> Hash[Symbol, any]
+    def generate: (expand: bool, relationships_to_exclude_from_expansion: Array[Symbol], collection: bool, expand_nested: bool) -> Hash[Symbol, any]
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schemable
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Muhammad Nawzad