dry_schema_rails 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a4f36b5c56fee74bae96b4dc58ad417771401e43a3ad09ea82a1af3ede0796b
-  data.tar.gz: 789431a29531e8bb001f4f5c59cf8edfa7f2a8d303a5ca8db2b5cace60a3dd85
+  metadata.gz: 6c3560caeddcea00621aed557566de2f4095e9ad0ff0c7b4581467cad3c0f813
+  data.tar.gz: 8ba8692aadec09ba7d50604f31ab94a5ea5e90c66b55edad8ddf6a9469cb1250
 SHA512:
-  metadata.gz: 4944f5d17da6df9265ebb55fbc03a9452ed74ef07eb05d95266e88f0247605c6846855aa74db3bb577653ca00d3991afdbe38e542b03404dd6af8ac169aa6acc
-  data.tar.gz: 0ec54b772f7c76c3940aa36020d7cb89ab351734128f0c34e8c4538425114e838e32676ac43129bccab33195a2e40a4a7036de7ea49b2b55418bbd55ca225993
+  metadata.gz: bc5375cf1db629467b34f91c79d00a0e099ab43b021042600e4ba9228f98878145c9dde969111b580bb9cc7ce80c895357347162c00eedac8eabe19514bcfbf7
+  data.tar.gz: 8b93626e2e87a47a14527fdf9a78ca162034ce560ee63f49e71b9cd5c00da37309a386f68b385d1d244487c30b8af510591ed801ef3ec4bfe6172343705d964d

data/CHANGELOG.md

@@ -1,29 +1,28 @@
 # Changelog
 
-All notable changes to "dry_schema_rails" will be documented in this file.
+All notable changes to [dry_schema_rails](https://github.com/golifox/dry_schema_rails) will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.1.3] - 2023-10-12
+### Add
+- Class comments
+- Class method comments & return values linting
 
-### Added
-- Initial development and features yet to be released.
-
-## [0.2.0] - 2023-10-20
-
-### Added
-- Feature X that does Y.
-- Improved documentation for feature Z.
+## [0.1.2] - 2023-10-12
+### Fixed
+- Compatibility errors
 
+## [0.1.1] - 2023-10-12
 ### Fixed
-- Bug that did Y under circumstance Z.
+- Maintain errors
 
 ### Changed
-- Refactored module X for better readability and performance.
+- class_method to instance class variables
 
 ### Removed
-- Deprecated methods in module Y.
+- Gem active-support
 
 ## [0.1.0] - 2023-10-10
 
@@ -35,6 +34,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Notes
 - This version serves as the foundational architecture for future features.
 
-[Unreleased]: https://github.com/your_username/dry_schema_rails/compare/v0.2.0...HEAD
-[0.2.0]: https://github.com/your_username/dry_schema_rails/compare/v0.1.0...v0.2.0
-[0.1.0]: https://github.com/your_username/dry_schema_rails/releases/tag/v0.1.0
+[0.1.2]: https://github.com/golifox/dry_schema_rails/compare/v0.1.0...v0.1.2  
+[0.1.1]: https://github.com/golifox/dry_schema_rails/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/golifox/dry_schema_rails/releases/tag/v0.1.0

data/README.md

@@ -31,7 +31,7 @@ bundle install
    Define your schema classes with necessary validation rules in a block passed to `schema`.
 
    ```ruby
-   class UserSchema < DrySchemaRails::ApplicationSchema
+   class UserSchema < DrySchemaRails::Base
      schema do
        required(:username).filled(:string)
        required(:email).filled(:string, format?: /@/)
@@ -59,6 +59,14 @@ bundle install
 module User
   class CreateValidator < DrySchemaRails::Base
     params User::CreateSchema.params
+     
+    rule(:username) do
+      key.failure('must be unique') if User.exists?(username: value)
+    end
+     
+    rule(:email) do
+      key.failure('must be in internation format') unless value.end_with?('.com')
+    end 
   end
 end
 ```
@@ -67,7 +75,7 @@ end
 ```ruby
 class UsersController < ApiController
   ...
-  schema(:create, &User::CreateSchema.schema) 
+  schema(:create, &UserSchema.schema) 
   
   # This checks maybe in base controller for reusability
   if safe_params&.failure?

data/lib/dry_schema_rails/base.rb

@@ -1,21 +1,114 @@
 require 'dry-schema'
-require 'active_support/core_ext/class/attribute'
 
 module DrySchemaRails
+  # Base class serves as a foundational class designed to encapsulate
+  # common functionalities associated with schema definitions. It provides a
+  # blueprint for creating new schema classes efficiently and consistently.
+  #
+  # The core mechanism of this class hinges on the `class_attribute` called
+  # `_schema_proc`, which stores the schema's definition as a proc.
+  # This proc gets executed in the context of `Dry::Schema` to define the schema.
+  #
+  #  Example Usage:
+  #
+  # To create a new schema, simply inherit from the Base class and provide
+  # the schema definition inside a block passed to the `schema` class method.
+  #
+  # Example:
+  #   BaseSchema = Class.new(DrySchemaRails::Base)
+  #   UserSchema = Class.new(BaseSchema) do
+  #     schema do
+  #       required(:username).filled(:string)
+  #       required(:email).filled(:string, format?: /@/)
+  #       required(:age).filled(:integer, gt?: 18)
+  #     end
+  #   end
+  #
+  #   user_params = { username: "John", email: "john@example.com", age: 25 }
+  #   result = UserSchema.params.call(user_params)
+  #   OR
+  #   result = UserSchema.call(user_params)
+  #
+  #   puts result.success?   # => true
+  #   puts result.errors     # => {}
+  #
+  # This approach allows for the creation of multiple schema classes in a concise
+  # and consistent manner, all inheriting common functionality from the base
+  # Base class.
   class Base
-    class_attribute :_schema_proc, default: -> {}
-
     class << self
+      def _schema_proc
+        @_schema_proc ||= -> {}
+      end
+
+      def _schema_proc=(proc)
+        @_schema_proc = proc
+      end
+
+      # @return [Dry::Schema::Result] the schema matching result
       def call(*args)
         params.call(*args)
       end
 
+      # Using to create custom validators easy.
+      #
+      #  Example:
+      #
+      #  UserSchema = Class.new(DrySchemaRails) do
+      #    schema do
+      #      required(:name).filled(:string)
+      #      required(:email).filled(:string)
+      #    end
+      #  end
+      #
+      #  class UserValidator < Dry::Validation::Contract
+      #    params UserSchema.params
+      #    # OR
+      #    params UserSchema.contract
+      #
+      #    rule(:name) do
+      #      key.failure('name is too short') if value.length < 3
+      #    end
+      #  end
+      #
+      #  validation = UserSchema.params
+      #
+      # @return [Dry::Schema::Params] the schema definition
       def params
         Dry::Schema.Params(&_schema_proc)
       end
 
       alias :contract :params
 
+      # Using in rails controllers.
+      #
+      #  Example:
+      #
+      #  UserSchema = Class.new(BaseSchema) do
+      #    schema do
+      #      required(:name).filled(:string)
+      #      optional(:email).filled(:string)
+      #    end
+      #  end
+      #
+      #  class ApplicationController < ActionController::Base
+      #    before_action do
+      #       if safe_params&.failure?
+      #        render json: { errors: safe_params.errors.to_h }, status: :bad_request
+      #       end
+      #    end
+      #  end
+      #
+      #  class UsersController < ApplicationController
+      #    schema(:create, &UserSchema.schema)
+      #
+      #    def create
+      #      @user = User.create(safe_params.output)
+      #      render json: @user, status: :created
+      #    end
+      #  end
+      #
+      # @return [Proc] the schema definition
       def schema(&block)
         if block_given?
           self._schema_proc = block
@@ -25,4 +118,4 @@ module DrySchemaRails
       end
     end
   end
-end
+end

data/lib/dry_schema_rails/version.rb

@@ -1,3 +1,3 @@
 module DrySchemaRails
-  VERSION = "0.1.0"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dry_schema_rails
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - David Rybolovlev
@@ -24,20 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.1'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.1'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -97,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
 summary: Simple DSL for reusing dry-schema in Rails.