sinclair 1.14.0 → 1.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ee09cd280144bc873d89c0272856bf716e0a20c2ca5d3f7fe8bf11ac972c859
-  data.tar.gz: c5107aa15ffab29f4dd14b45efd0387913c60064ad62a58c4ec85adb09d91c9c
+  metadata.gz: 4984ad62935fbe5a85e51b846b5124b72153b94cf9433a8a668f824c11e5eeaf
+  data.tar.gz: 336e7c54378ccd676f59eb92fe2a1bf32de84ff9a8bc2a91c8a6dd1e6494b46d
 SHA512:
-  metadata.gz: 38994db2d8a69ef1b9f3827a84bcb53a0bd18e2073a4840b004a89ac00a0fe0f5d9a8a69ce231b9d6c5f2cfc51b3a96c5ee898c848ce7ba802eac1d8556a058b
-  data.tar.gz: 4812c5a5793de217eb0cdd895c8cc94ac698af119c60fded29ea6929bddf0240b9dbcdba237dba7c1f060a3c3b8a3a173d2c7fef0509f6181d738ca0c7f0ef34
+  metadata.gz: f3a84c2a80644b15e31991cb99a314378453e642c29c9864080e96f28bd34234f2476735284291ba56dd48ab9d67883a5b16709a1aa67b31116ef262dd6b1df1
+  data.tar.gz: d1405b56826158314eb4d304b33c02dc18015e63fe58e716371f5a58c7a8f417652ea1026d5b533c844e7c5a89ffeae7990f70334e61dbf4019006f412359dfe

data/Dockerfile.circleci

@@ -0,0 +1,28 @@
+FROM darthjee/scripts:0.3.1 as scripts
+
+FROM darthjee/circleci_ruby_270:1.2.0 as base
+
+COPY --chown=app:app ./ /home/circleci/project/
+
+######################################
+
+FROM base as builder
+
+COPY --chown=circleci:circleci --from=scripts /home/scripts/builder/bundle_builder.sh /usr/local/sbin/bundle_builder.sh
+
+ENV PROJECT sinclair
+ENV HOME_DIR /home/circleci
+RUN bundle_builder.sh
+
+#######################
+#FINAL IMAGE
+FROM base
+
+COPY --chown=circleci:circleci --from=builder /home/circleci/bundle/ /home/circleci/.rubygems/
+
+COPY --chown=circleci:circleci --from=scripts /home/scripts/sbin/rubycritic.sh /usr/local/sbin/
+COPY --chown=circleci:circleci --from=scripts /home/scripts/sbin/check_specs /usr/local/sbin/
+COPY --chown=circleci:circleci --from=scripts /home/scripts/sbin/check_readme.sh /usr/local/sbin/
+COPY --chown=circleci:circleci --from=scripts /home/scripts/sbin/build_gem.sh /usr/local/sbin/
+
+RUN bundle install

data/README.md

@@ -9,17 +9,19 @@ Sinclair
 
 ![sinclair](https://raw.githubusercontent.com/darthjee/sinclair/master/sinclair.jpg)
 
-This gem helps the creation of complex gems/concerns
-that enables creation of methods on the fly through class
-methods
+Sinclair is a Ruby gem that provides developers with a variety of utility modules and classes
+to simplify common tasks, reusability and avoid boilerplate code. Whether you need to class methods to create methods on the fly,
+create custom comparators, configure your application, create powerfull options, Sinclair has got you covered.
 
-Current Release: [1.14.0](https://github.com/darthjee/sinclair/tree/1.14.0)
+Employing Sinclair in your applications helps you streamline your development workflow and enhance your development process through more efficient, cleaner code
 
-[Next release](https://github.com/darthjee/sinclair/compare/1.14.0...master)
+Current Release: [1.14.1](https://github.com/darthjee/sinclair/tree/1.14.1)
+
+[Next release](https://github.com/darthjee/sinclair/compare/1.14.1...master)
 
 Yard Documentation
 -------------------
-[https://www.rubydoc.info/gems/sinclair/1.14.0](https://www.rubydoc.info/gems/sinclair/1.14.0)
+[https://www.rubydoc.info/gems/sinclair/1.14.1](https://www.rubydoc.info/gems/sinclair/1.14.1)
 
 Installation
 ---------------
@@ -524,8 +526,16 @@ Client.config.url # returns 'http://interstella.com:8080'
 
 ### Sinclair::EnvSettable
 
-Settable allows classes to extract configuration from environments through
-a simple meta-programable way
+EnvSettable is a convenient utility that allows you to read environment
+variables using Ruby class methods.
+
+With this tool, you can define the usage of environment variables for your application in a single location
+allowing the use of prefixes to isolate groups of variables.
+
+This not only makes your code more readable and maintainable but also adds layer of security by ensuring
+that sensitive information like API keys and passwords are not exposed in your source code.
+
+EnvSettable allows accessing those variables thorugh a simple meta-programable way
 
 <details>
 <summary>Using env settable example</summary>
@@ -645,7 +655,8 @@ human1 == human2 # returns true
 <summary>Example with options</summary>
 
 ```ruby
-class Tv < Sinclair::Model.for(:model, writter: false, comparable: false)
+class Tv < Sinclair::Model
+  initialize_with :model, writter: false, comparable: false
 end
 
 tv1 = Tv.new(model: 'Sans Sunga Xt')

data/config/check_specs.yml

@@ -7,4 +7,5 @@ ignore:
   - lib/sinclair/matchers/base.rb
   - lib/sinclair/matchers/change_method_on.rb
   - lib/sinclair/matchers/method_to.rb
+  - lib/sinclair/model/builder_options.rb
   - lib/sinclair/version.rb

data/docker-compose.yml

@@ -21,3 +21,14 @@ services:
     <<: *base
     depends_on: [base_build]
     command: /bin/bash -c 'rspec && yard && rake yardstick_measure && rake verify_measurements'
+
+  sinclair_circleci:
+    <<: *base
+    image: sinclair_circleci
+    container_name: sinclair_circleci
+    volumes:
+      - .:/home/circleci/project
+    working_dir: /home/circleci/project
+    command: /bin/bash
+    build:
+      dockerfile: Dockerfile.circleci

data/lib/sinclair/method_definition/parameter_helper.rb

@@ -26,7 +26,7 @@ class Sinclair
       # @param parameters_list [Array<Object>] list of parameters and defaults
       # @param named [TrueClass,FalseClass] Flag informing if the parameters are
       #   named parameters
-      def initialize(parameters_list, named: false)
+      def initialize(parameters_list, named: nil)
         @parameters_list = parameters_list
         @named           = named
       end
@@ -40,7 +40,7 @@ class Sinclair
       def strings
         return [] unless parameters_list
 
-        parameters_strings + defaults_strings
+        parameters_strings + defaults_strings + wild_card_parameters
       end
 
       private
@@ -81,7 +81,18 @@ class Sinclair
       # @return [Array<Symbol>]
       def parameters
         parameters_list.reject do |param|
-          param.is_a?(Hash)
+          param.is_a?(Hash) || param.to_s.match?(/^\*/)
+        end
+      end
+
+      # Returns the named parameters that have not been defined
+      #
+      # THis is usually extra options
+      #
+      # @return [Array<String>]
+      def wild_card_parameters
+        parameters_list.reject do |param|
+          param.is_a?(Hash) || !param.to_s.match?(/^\*/)
         end
       end
 

data/lib/sinclair/model/builder.rb

@@ -26,11 +26,10 @@ class Sinclair
       #     method should be added
       #   @param comparable [TrueClass,FalseClass] flag to make the class {Comparable}
       #     by the fields
-      def initialize(klass, *attributes, writter: true, comparable: true)
+      def initialize(klass, *attributes, **options)
         super(klass)
         @attributes = attributes.flatten
-        @writter    = writter
-        @comparable = comparable
+        @options = BuilderOptions.new(**options)
 
         add_methods
         change_equals
@@ -39,7 +38,9 @@ class Sinclair
 
       private
 
-      attr_reader :attributes, :writter, :comparable
+      attr_reader :attributes, :options
+
+      delegate :writter, :comparable, to: :options
       alias writter? writter
       alias comparable? comparable
 
@@ -54,6 +55,14 @@ class Sinclair
       #
       # @return [Array<Symbol,Hash>]
 
+      # @!method options
+      # @api private
+      # @private
+      #
+      # Class building options
+      #
+      # @return [BuilderOptions]
+
       # @!method writter
       # @api private
       # @private
@@ -118,11 +127,15 @@ class Sinclair
       #
       # @return [Array<MethodDefinition>]
       def change_initializer
-        code = attributes_names.map do |attr|
+        lines = attributes_names.map do |attr|
           "@#{attr} = #{attr}"
-        end.join("\n")
+        end
+
+        lines << 'super(**attributes)'
+
+        code = lines.join("\n")
 
-        add_method(:initialize, code, named_parameters: attributes)
+        add_method(:initialize, code, named_parameters: attributes + ['**attributes'])
       end
 
       # @private

data/lib/sinclair/model/builder_options.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+class Sinclair
+  class Model
+    # @api private
+    # @author Darthjee
+    #
+    # Options for building model class
+    class BuilderOptions < Sinclair::Options
+      with_options writter: true, comparable: true
+    end
+  end
+end

data/lib/sinclair/model.rb

@@ -6,7 +6,8 @@ class Sinclair
   #
   # Basic model to be used when defining new classes quickly
   class Model
-    autoload :Builder, 'sinclair/model/builder'
+    autoload :Builder,        'sinclair/model/builder'
+    autoload :BuilderOptions, 'sinclair/model/builder_options'
 
     class << self
       # Returns a new class that inherits from model

data/lib/sinclair/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Sinclair
-  VERSION = '1.14.0'
+  VERSION = '1.14.1'
 end

data/sinclair.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |gem|
 
   gem.add_runtime_dependency 'activesupport', '~> 5.2.0'
 
-  gem.add_development_dependency 'bundler',            '2.3.25'
+  gem.add_development_dependency 'bundler',            '>= 2.3.25'
   gem.add_development_dependency 'pry',                '0.14.1'
   gem.add_development_dependency 'pry-nav',            '1.0.0'
   gem.add_development_dependency 'rake',               '13.0.1'

data/spec/lib/sinclair/method_definition/parameter_helper_spec.rb

@@ -22,6 +22,17 @@ describe Sinclair::MethodDefinition::ParameterHelper do
             .to eq(['a = 10', 'b = "word"', 'c = true', 'd = false', 'e = nil', 'f = :symbol'])
         end
       end
+
+      context 'when the parameter is an undefined parameter' do
+        let(:parameters) do
+          [:a, :b, '*args', { c: 10, d: 'word' }]
+        end
+
+        it 'returns a list of parameters' do
+          expect(described_class.parameters_from(parameters))
+            .to eq(['a', 'b', 'c = 10', 'd = "word"', '*args'])
+        end
+      end
     end
 
     context 'when parameters are named' do
@@ -42,6 +53,17 @@ describe Sinclair::MethodDefinition::ParameterHelper do
             .to eq(['a: 10', 'b: "word"', 'c: true', 'd: false', 'e: nil', 'f: :symbol'])
         end
       end
+
+      context 'when the parameter is an undefined parameter' do
+        let(:parameters) do
+          [:a, :b, '**opts', { c: 10, d: 'word' }]
+        end
+
+        it 'returns a list of parameters' do
+          expect(described_class.parameters_from(parameters, named: true))
+            .to eq(['a:', 'b:', 'c: 10', 'd: "word"', '**opts'])
+        end
+      end
     end
   end
 end

data/spec/lib/sinclair/model_spec.rb

@@ -54,6 +54,37 @@ describe Sinclair::Model do
       end
     end
 
+    context 'when class is subclass of another model' do
+      subject(:model) { klass.new(name: name, age: age) }
+
+      let(:age) { Random.rand(10..20) }
+
+      let(:superclass) do
+        Class.new(described_class) do
+          initialize_with(:age)
+        end
+      end
+
+      let(:klass) do
+        Class.new(superclass) do
+          initialize_with(:name)
+        end
+      end
+
+      it 'is initialized with both attributes' do
+        expect { klass.new(name: name, age: age) }
+          .not_to raise_error
+      end
+
+      it 'is initializes new attributes' do
+        expect(model.name).to eq(name)
+      end
+
+      it 'is initializes old attributes' do
+        expect(model.age).to eq(age)
+      end
+    end
+
     context 'when the build is done' do
       before do
         klass.initialize_with(*attributes, **options)

data/spec/support/models/tv.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
 
-class Tv < Sinclair::Model.for(:model, writter: false, comparable: false)
+class Tv < Sinclair::Model
+  initialize_with :model, writter: false, comparable: false
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sinclair
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.14.1
 platform: ruby
 authors:
 - DarthJee
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-16 00:00:00.000000000 Z
+date: 2023-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -28,14 +28,14 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.3.25
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.3.25
 - !ruby/object:Gem::Dependency
@@ -261,6 +261,7 @@ files:
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - Dockerfile
+- Dockerfile.circleci
 - Gemfile
 - LICENSE
 - README.md
@@ -316,6 +317,7 @@ files:
 - lib/sinclair/method_definitions.rb
 - lib/sinclair/model.rb
 - lib/sinclair/model/builder.rb
+- lib/sinclair/model/builder_options.rb
 - lib/sinclair/options.rb
 - lib/sinclair/options/builder.rb
 - lib/sinclair/options/class_methods.rb
@@ -468,7 +470,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.25
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Gem for easy concern creation