nueca_rails_interfaces 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 71471580cc28c42f5997160d6e01684e081244da014e44ecd110e37e4c62db91
+  data.tar.gz: 3236fcf542d757322a14ab338330ad721089445afc4f7b1877bd45cf6dbeda65
+SHA512:
+  metadata.gz: '089db05b4843a21ba0462efe9e07717a6b17f8e35117fcb096279d0f136f1f6828ed7c7d85f423e38781f325b58e678bb4a8f0808010daee14f530716d5ede3c'
+  data.tar.gz: 6061f449b9deb9130c7aeaba1d5de4a7a02542bc560333dc1995a088771a88f9f2a23e67eeb0e947b25a340e804f74b5eb8f1aef157d8900dccec7cd685136a7

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,14 @@
+require:
+  - rubocop-rails
+  - rubocop-rake
+  - rubocop-rspec
+
+AllCops:
+  TargetRubyVersion: 3.3
+  NewCops: enable
+
+Layout/LineLength:
+  Max: 120
+
+RSpec/NestedGroups:
+  Max: 5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,84 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at jenek@nuecca.com.ph. All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 2.0,
+available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 TODO: Write your name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,31 @@
+# Nueca Rails Interfaces
+
+This gem contains the culture and conventions that employees of Nueca should follow when developing Ruby on Rails applications. Inspect each interface for more details as they are documented.
+
+## Installation
+
+Add in your Gemfile:
+
+```ruby
+gem 'nueca_rails_interfaces'
+```
+
+## Usage
+
+Simply include the interfaces in classes and they will be enforced.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+## Contributing
+
+Bug reports and pull requests are welcome on Nueca GitLab at https://github.com/tieeeeen1994/nueca-rails-interfaces. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/tieeeeen1994/nueca-rails-interfaces/-/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the Nueca Rails Interfaces project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/tieeeeen1994/nueca-rails-interfaces/-/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/lib/nueca_rails_interfaces/util.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module NuecaRailsInterfaces
+  # Utility module helper.
+  module Util
+    def self.process_class_arguments(class_object, *arguments)
+      if arguments.size == 1 && arguments.first.is_a?(Hash)
+        class_object.new(**arguments.first)
+      else
+        class_object.new(*arguments)
+      end
+    end
+  end
+end

data/lib/nueca_rails_interfaces/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module NuecaRailsInterfaces
+  VERSION = '0.1.0'
+end

data/lib/nueca_rails_interfaces.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+raise 'Rails not found' unless defined?(Rails)
+
+require 'to_bool'
+
+require_relative 'nueca_rails_interfaces/version'
+
+# This module is a namespace for the gem.
+module NuecaRailsInterfaces
+end
+
+require_relative 'nueca_rails_interfaces/util'
+
+# Require all interfaces.
+Dir["#{__dir__}/v*/*_interface.rb"].each { |file| require_relative file }

data/lib/v1/form_interface.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module V1
+  # Form Interface. Include this module to create a new form.
+  # In this version, a form is defined as a data verifier, mainly coming from parameters
+  # to shoulder off validation from processors such as services and interactors, or action controllers.
+  # A form should be treated like a custom model without the need for a database.
+  # Forms are responsible for validating data and returning the data in a format that is ready for processing.
+  # Forms are responsible for handling bad data, returning errors provided by ActiveModel.
+  # Forms should implement the `attributes` method to define the attributes of the form.
+  # Forms should not override methods from ActiveModel for customization.
+  # The `attributes` method should return a hash of the attributes of the form (strictly not an array).
+  # It is up to the developer what `attributes` method will contain if there is an error. Treat as such like an API.
+  module FormInterface
+    # Allows the form mixin to include ActiveModel::Model powers.
+    # @param [self] base Instance of the base form that would include this module.
+    # @return [void]
+    def self.included(base)
+      base.include(ActiveModel::Model)
+    end
+
+    # Final attributes to be returned by the form after validation.
+    # This is the data that is expected of the form to produce for processing.
+    # @raise [NotImplementedError] If the method is not overridden.
+    def attributes
+      raise NotImplementedError, 'Requires implementation of attributes.'
+    end
+  end
+end

data/lib/v1/query_interface.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+module V1
+  # Query Mixin Interface. Include this module to a class that will be used as a query object.
+  # Query objects are eaily identified as helpers for querying with filters and sorting with complex algorithms.
+  # Thanks to ActiveRecord's inner workings, Ruby alone can handle the avdanced filtering
+  # before firing the query in the database. In this version, all query objects will be paginated.
+  # This is to avoid really heavy queries from hitting the database, either be it intentnional or malicious.
+  # In this version, pagination is enforced but only lightly encouraged.
+  # There will be a deprecation warning when no_pagination is used.
+  # However, the implementation of no_pagination is still a 1 page result;
+  # just that it supports a large number of queries in a single page.
+  # Developers will be required to move away from V1 of Query Interface soon to enforce strict pagination.
+  module QueryInterface
+    # The basis for validity of pagination settings. It also contains default values.
+    VALID_PAGINATION_HASH = {
+      max: 20, # Absolute maximum number of records per page, even if the query requests for more.
+      min: 1, # Absolute minimum number of records per page, even if the query requests for less.
+      per_page: 20, # Default number of records per page if not specified in the query.
+      page: 1 # Default page number if not specified in the query.
+    }.freeze
+
+    # Basis for considering a non-paging result even when the query is being processed for pagination.
+    # This number states the invalidity of pagination, but it exists for legacy support.
+    NO_PAGING_THRESHOLD = 1_000_000
+
+    class << self
+      def included(base)
+        # This is the method to call outside this object to apply the query filters, sortings and paginations.
+        # @param [Hash] query The query parameters.
+        # @param [ActiveRecord::Relation] collection The collection to be queried.
+        base.define_singleton_method(:call) do |query, collection|
+          new(query, collection).call
+        end
+      end
+    end
+
+    attr_reader :query, :collection
+
+    # Do not override! This is how we will always initialize our query objects.
+    # No processing should be done in the initialize method.
+    # @param [Hash] query The query parameters.
+    # @param [ActiveRecord::Relation] collection The collection to be queried.
+    def initialize(query, collection, pagination: true)
+      @query = query
+      @collection = collection
+      @pagination_flag = pagination
+      query_aliases
+    end
+
+    # Do not override. This is the method to call outside this object
+    # to apply the query filters, sortings and paginations.
+    def call
+      apply_filters!
+      apply_sorting!
+      apply_pagination!
+      collection
+    end
+
+    private
+
+    # Place here filters. Be sure to assign @collection to override the original collection. Be sure it is private!
+    def filters; end
+
+    # Place here sorting logic. Be sure to assign @collection to override the original collection.
+    # Be sure it is private!
+    def sorts; end
+
+    # Pagination settings to modify the default behavior of a query object.
+    # Default values are in VALID_PAGINATION_HASH constant.
+    # Override the method to change the default values.
+    def pagination_settings
+      {}
+    end
+
+    # Always updated alias of filters.
+    def apply_filters!
+      filters
+    end
+
+    # Always updated alias of sorts.
+    def apply_sorting!
+      sorts
+    end
+
+    # Paginates the collection based on query or settings.
+    def apply_pagination!
+      raise 'Invalid pagination settings.' unless correct_pagination_settings?
+      return unless @pagination_flag
+
+      @collection = collection.paginate(page: fetch_page_value, per_page: fetch_per_page_value)
+    end
+
+    # Logic for fetching the page value from the query or settings.
+    def fetch_page_value
+      query&.key?(:page) ? query[:page].to_i : merged_pagination_settings[:page]
+    end
+
+    # Logic for fetching the per page value from the query or settings.
+    def fetch_per_page_value
+      per_page = query&.key?(:per_page) ? query[:per_page].to_i : merged_pagination_settings[:per_page]
+      per_page.clamp(merged_pagination_settings[:min], merged_pagination_settings[:max])
+    end
+
+    # Checks if the pagination settings are correct.
+    # The app crashes on misconfiguration.
+    def correct_pagination_settings?
+      return false unless pagination_settings.is_a?(Hash)
+
+      detected_keys = []
+      merged_pagination_settings.each_key do |key|
+        return false unless VALID_PAGINATION_HASH.key?(key)
+
+        detected_keys << key
+      end
+
+      detected_keys.sort == VALID_PAGINATION_HASH.keys.sort
+    end
+
+    # The final result of pagination settings, and thus the used one.
+    def merged_pagination_settings
+      @merged_pagination_settings ||= VALID_PAGINATION_HASH.merge(pagination_settings)
+    end
+
+    # Aliases for query parameters for legacy support.
+    # No need to override this in children. Directly modify this method in this interface if need be.
+    def query_aliases
+      query[:per_page] = query[:limit] if query[:limit].present? && query[:per_page].blank?
+    end
+
+    # For deprecation. Use this for queries that do not need pagination.
+    # Queries will still be paginated as a result, but with the use of the threshold,
+    # the result is as good as a non-paginated result,
+    # and it will be treated as such.
+    def no_pagination
+      Rails.logger.warn 'Querying without paging is deprecated. Enforce paging in queries!'
+      { max: NO_PAGING_THRESHOLD, min: NO_PAGING_THRESHOLD }
+    end
+  end
+end

data/lib/v1/service_interface.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module V1
+  # Service Mixin Interface. Include from this module when creating a new service.
+  # In this version, a service is defined as an absolute reusable piece of code.
+  # They should not be related to views and presentation of data; they are instead processors.
+  # Because of this, errors encountered should be raised as exceptions naturally.
+  # Errors here are treated as bad data. Services are not responsible for handling bad data.
+  # Services assume all data passed is correct and valid. Services should no longer validate these data.
+  # Services can still store warnings; these warnings are sent to Sentry, although not yet implemented.
+  # All services will have a `perform` method that will call the `action` method. This is the invoker of the service.
+  # All services will have an `action` method that will contain the main logic of the service.
+  # All services will have a `data` method that will contain the resulting data that the service produced.
+  # Developers will mainly override `action` method and `data method`.
+  module ServiceInterface
+    # This is the main method of the service. This is the method that should be called to perform the service.
+    # Do not override this method. Instead, override the `action` method.
+    # @return [self] Instance of the service.
+    def perform
+      unless performed?
+        action
+        @performed = true
+        process_warnings
+      end
+
+      self
+    end
+
+    # Override this method and put the main logic of the service here.
+    # @raise [NotImplementedError] If the method is not overridden.
+    def action
+      raise NotImplementedError, 'Requires implementation of action.'
+    end
+
+    # Override this method and put the resulting data of the service here.
+    # If blank, then return an empty hash manually.
+    # Reason being is for readability's sake in the services.
+    # @raise [NotImplementedError] If the method is not overridden.
+    def data
+      raise NotImplementedError, 'Requires implementation of data.'
+    end
+
+    # Method used to add a warning. Do not override.
+    # @param [String] warning_message Descriptive sentence of the warning.
+    # @return [Array<String>] Array of all warnings.
+    def add_warning(warning_message)
+      _warnings << warning_message
+      warnings
+    end
+
+    # Checks if the service has been performed. Do not override.
+    # @return [Boolean] True or False
+    def performed?
+      performed
+    end
+
+    # Used to check if the service has encountered any warnings. Do not override.
+    # @return [Boolean] True or False
+    def warnings?
+      _warnings.any?
+    end
+
+    # This should contain all the warnings that the service has encountered.
+    # Intentionally made to be frozen to avoid free modification.
+    # Do not override this method.
+    # @return [Array<String>] Array of all warnings.
+    def warnings
+      _warnings.dup.freeze
+    end
+
+    private
+
+    # Status of the service. If the service has been performed, this should be true.
+    # Do not override this method.
+    # @return [Boolean] True or False
+    def performed
+      @performed ||= false
+    end
+
+    # The real warnings array. Do not override this method. Use `add_warning` method to add warnings.
+    # @return [Array<String>] Array of all warnings.
+    def _warnings
+      @warnings ||= []
+    end
+
+    # Iterates through the warnings and sends them to Sentry, supposedly. Unimplemented so far.
+    # Do not override the method.
+    # @return [void]
+    def process_warnings; end
+  end
+end

data/lib/v2/form_interface.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module V2
+  # V2 Form Interface is the same as V1 Form Interface,
+  # except forces an exception on the attributes method when intializing a form.
+  module FormInterface
+    class << self
+      # Allows the form mixin to include ActiveModel::Model powers.
+      def included(base)
+        base.include(ActiveModel::Model)
+
+        # Initializes the form in a class context with the options passed in.
+        base.define_singleton_method(:check) do |*arguments|
+          instance = NuecaRailsInterfaces::Util.process_class_arguments(self, *arguments)
+          instance.valid?
+          instance
+        end
+      end
+    end
+
+    # Initializes the form with the options passed in.
+    # It also calls the attributes method to ensure it is implemented.
+    def initialize(options = {})
+      super(**options)
+      attributes
+    end
+
+    # Final attributes to be returned by the form after validation.
+    # This is the data that is expected of the form to produce for processing.
+    # @raise [NotImplementedError] If the method is not overridden.
+    def attributes
+      raise NotImplementedError, 'Requires implementation of attributes.'
+    end
+  end
+end

data/lib/v2/service_interface.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module V2
+  # V2 Service Interface is the same as V1 Service Interface, except it is more straightforward.
+  # When performing the service, it will immediately return the data
+  module ServiceInterface
+    class << self
+      def included(base)
+        # This is the main method of the service in a class context.
+        # This is the method that should be called to perform the service statically.
+        # Use this instead if the service instance is not needed.
+        # Do not override this method. Instead, override the `action` method. Returns the data immediately.
+        # @return [Object] Data of the service.
+        base.define_singleton_method(:perform) do |*arguments|
+          instance = NuecaRailsInterfaces::Util.process_class_arguments(self, *arguments)
+          instance.perform
+        end
+      end
+    end
+
+    # This is the main method of the service. This is the method that should be called to perform the service.
+    # Do not override this method. Instead, override the `action` method. Returns the data immediately.
+    # @return [Object] Data of the service.
+    def perform
+      unless performed?
+        action
+        @performed = true
+        process_warnings
+      end
+
+      data
+    end
+
+    # Override this method and put the main logic of the service here.
+    # @raise [NotImplementedError] If the method is not overridden.
+    # @return [void]
+    def action
+      raise NotImplementedError, 'Requires implementation of action.'
+    end
+
+    # Override this method and put the resulting data of the service here.
+    # If blank, then return an empty hash manually.
+    # Reason being is for readability's sake in the services.
+    # @raise [NotImplementedError] If the method is not overridden.
+    # @return [Object] Data of the service.
+    def data
+      raise NotImplementedError, 'Requires implementation of data.'
+    end
+
+    # Method used to add a warning. Do not override.
+    # @param [String] warning_message Descriptive sentence of the warning.
+    # @return [Array<String>] Array of all warnings.
+    def add_warning(warning_message)
+      _warnings << warning_message
+      warnings
+    end
+
+    # Checks if the service has been performed. Do not override.
+    # @return [Boolean] True or False
+    def performed?
+      performed
+    end
+
+    # Used to check if the service has encountered any warnings. Do not override.
+    # @return [Boolean] True or False
+    def warnings?
+      _warnings.any?
+    end
+
+    # This should contain all the warnings that the service has encountered.
+    # Intentionally made to be frozen to avoid free modification.
+    # Do not override this method.
+    # @return [Array<String>] Array of all warnings.
+    def warnings
+      _warnings.dup.freeze
+    end
+
+    private
+
+    # Status of the service. If the service has been performed, this should be true.
+    # Do not override this method.
+    # @return [Boolean] True or False
+    def performed
+      @performed ||= false
+    end
+
+    # The real warnings array. Do not override this method. Use `add_warning` method to add warnings.
+    # @return [Array<String>] Array of all warnings.
+    def _warnings
+      @warnings ||= []
+    end
+
+    # Iterates through the warnings and sends them to Sentry, supposedly. Unimplemented so far.
+    # Do not override the method.
+    # @return [void]
+    def process_warnings; end
+  end
+end

data/nueca_rails_interfaces.gemspec

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative 'lib/nueca_rails_interfaces/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'nueca_rails_interfaces'
+  spec.version = NuecaRailsInterfaces::VERSION
+  spec.authors = ['Tien']
+  spec.email = ['tieeeeen1994@gmail.com']
+  spec.summary = 'Interfaces for known object entities in Rails Development at Nueca.'
+  spec.homepage = 'https://github.com/tieeeeen1994/nueca-rails-interfaces'
+  spec.required_ruby_version = '>= 3.3.0'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .gitlab-ci.yml appveyor Gemfile])
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Uncomment to register a new dependency of your gem
+  spec.add_dependency 'rails', '~> 7'
+  spec.add_dependency 'to_bool', '~> 2.1'
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+  spec.metadata['rubygems_mfa_required'] = 'true'
+  spec.license = 'MIT'
+end

metadata

@@ -0,0 +1,87 @@
+--- !ruby/object:Gem::Specification
+name: nueca_rails_interfaces
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Tien
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-06-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: to_bool
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+description:
+email:
+- tieeeeen1994@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/nueca_rails_interfaces.rb
+- lib/nueca_rails_interfaces/util.rb
+- lib/nueca_rails_interfaces/version.rb
+- lib/v1/form_interface.rb
+- lib/v1/query_interface.rb
+- lib/v1/service_interface.rb
+- lib/v2/form_interface.rb
+- lib/v2/service_interface.rb
+- nueca_rails_interfaces.gemspec
+homepage: https://github.com/tieeeeen1994/nueca-rails-interfaces
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.10
+signing_key:
+specification_version: 4
+summary: Interfaces for known object entities in Rails Development at Nueca.
+test_files: []