csvbuilder-dynamic-columns-core 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 286cc68dc88a8b1e34d6c35178197a18baaf87325413eb21cf3f85a988a189f2
-  data.tar.gz: 2c67f25a060145b14c161fa14ec6cc1ae48f2c8176868f15b2c1b8f1900f7854
+  metadata.gz: 99c7a32415edfe0c4a0e96334efc38324f4d40084d53654116c34259adb509be
+  data.tar.gz: 113d6cb9f651d3722b3985a12dc74df8438f5eb62e8f76daa9e80b7cd283a005
 SHA512:
-  metadata.gz: b978378d072890a66da304afc010f0eeabe18e204927c4f9ccc18888ab497acc3cb1cf22f6fe8812423bedaabd4bd9a2b3b2920c1c52a35244e1006b794304b6
-  data.tar.gz: 642a379dc4ed3a6eee45846994fd856015f7b24d9a15f5e07f2438d1287e4242a01324c03bca5de492eee1ef7461556e6d94b42cb76e9fcf107635504ba94e01
+  metadata.gz: 4d198549961191ea64da224f1a6a0920bb72eff7becf3b3c285c6d89c908c6d72943a4637f646a3d0f6284555b07850dc073ec1cb99924c084ed6ab66f281e05
+  data.tar.gz: 9ec8c2212ccdcdf2bd379d5c7cf496eea1daba2c655abd21bc374c8f685e2254b45742977ebd25adb3906742c1d01892061a059680666a6cadcf9b0f71f3e143

data/.rubocop.yml

@@ -1,13 +1,13 @@
 inherit_from: .rubocop_todo.yml
 
-require:
+plugins:
   - rubocop-performance
   - rubocop-rake
   - rubocop-rspec
 
 AllCops:
   NewCops: enable
-  TargetRubyVersion: 2.6
+  TargetRubyVersion: 3.4
 
 Style/StringLiterals:
   Enabled: true

data/.tool-versions

@@ -0,0 +1 @@
+ruby 3.4.2

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [0.1.2] - 2024-02-27
+
+- Update Ruby 3.4 and Relax Rails Constraint
+
+## [0.1.1] - 2022-12-21
+
+Change the option :header_models_context_key to :as
+Fix the call of process_cell_method_name with the correct name
+
 ## [0.1.0] - 2022-12-21
 
 - Initial release

data/Gemfile

@@ -14,3 +14,5 @@ gem "rubocop"
 gem "rubocop-performance"
 gem "rubocop-rake"
 gem "rubocop-rspec"
+
+# gem "csvbuilder-core", path: "../csvbuilder-core"

data/Gemfile.lock

@@ -1,76 +1,102 @@
 PATH
   remote: .
   specs:
-    csvbuilder-dynamic-columns-core (0.1.0)
-      activesupport (>= 5.2, < 8)
+    csvbuilder-dynamic-columns-core (0.1.2)
+      activesupport (>= 5.2)
+      csv
       csvbuilder-core
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.1.7)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
+    activesupport (8.0.1)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
       minitest (>= 5.1)
-      tzinfo (~> 2.0)
-      zeitwerk (~> 2.3)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
     ast (2.4.2)
-    concurrent-ruby (1.1.10)
-    csvbuilder-core (0.1.2)
-      activesupport (>= 5.2, < 8)
-    diff-lcs (1.5.0)
-    i18n (1.12.0)
+    base64 (0.2.0)
+    benchmark (0.4.0)
+    bigdecimal (3.1.9)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.0)
+    csv (3.3.2)
+    csvbuilder-core (0.1.4)
+      activesupport (>= 5.2)
+      csv
+    diff-lcs (1.6.0)
+    drb (2.2.1)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    json (2.6.3)
-    minitest (5.16.3)
-    parallel (1.22.1)
-    parser (3.1.3.0)
+    json (2.10.1)
+    language_server-protocol (3.17.0.4)
+    lint_roller (1.1.0)
+    logger (1.6.6)
+    minitest (5.25.4)
+    parallel (1.26.3)
+    parser (3.3.7.1)
       ast (~> 2.4.1)
+      racc
+    racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.0.6)
-    regexp_parser (2.6.1)
-    rexml (3.2.5)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.0)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.1)
+    rake (13.2.1)
+    regexp_parser (2.10.0)
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.3)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.1)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.2)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.0)
-    rubocop (1.41.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.2)
+    rubocop (1.73.0)
       json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
-      parser (>= 3.1.2.1)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.23.0, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.24.0)
-      parser (>= 3.1.1.0)
-    rubocop-performance (1.15.1)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
-    rubocop-rake (0.6.0)
-      rubocop (~> 1.0)
-    rubocop-rspec (2.16.0)
-      rubocop (~> 1.33)
-    ruby-progressbar (1.11.0)
-    tzinfo (2.0.5)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.38.1)
+      parser (>= 3.3.1.0)
+    rubocop-performance (1.24.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    rubocop-rake (0.7.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.72.1)
+    rubocop-rspec (3.5.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    unicode-display_width (2.3.0)
-    zeitwerk (2.6.6)
+    unicode-display_width (3.1.4)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+    uri (1.0.3)
 
 PLATFORMS
-  arm64-darwin-21
-  x86_64-linux
+  arm64-darwin-24
+  ruby
 
 DEPENDENCIES
   csvbuilder-dynamic-columns-core!
@@ -82,4 +108,4 @@ DEPENDENCIES
   rubocop-rspec
 
 BUNDLED WITH
-   2.3.22
+   2.6.2

data/README.md

@@ -1,22 +1,119 @@
-# Csvbuilder::Dynamic::Columns
+# Csvbuilder::Dynamic::Columns::Core
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/csvbuilder/dynamic/columns`. To experiment with that code, run `bin/console` for an interactive prompt.
+[Csvbuilder::Dynamic::Columns::Core](https://github.com/joel/csvbuilder-dynamic-columns-core) is part of the [csvbuilder-collection](https://github.com/joel/csvbuilder)
 
-TODO: Delete this and the text above, and describe your gem
+The Dynamic Columns Core contains the shared components used and extended by the Dynamic Columns Exporter and the Dynamic Columns Importer. It carries the architecture for the Dynamic Columns feature, and it can’t be used alone.
+
+See:
+ - [Csvbuilder::Dynamic::Columns::Exporter](https://github.com/joel/csvbuilder-dynamic-columns-exporter)
+ - [Csvbuilder::Dynamic::Columns::Importer](https://github.com/joel/csvbuilder-dynamic-columns-importer)
 
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:
 
-    $ bundle add csvbuilder-dynamic-columns
+    $ bundle add csvbuilder-dynamic-columns-core
 
 If bundler is not being used to manage dependencies, install the gem by executing:
 
-    $ gem install csvbuilder-dynamic-columns
+    $ gem install csvbuilder-dynamic-columns-core
 
 ## Usage
 
-TODO: Write usage instructions here
+The Dynamic Columns Core adds a new entry into the
+DSL of the Model:
+
+```ruby
+class UserCsvRowModel
+  include Csvbuilder::Model
+
+  column :first_name
+  column :last_name
+
+  dynamic_column :skills
+end
+```
+
+Here we indicate we will have length variable headers about skills in the CSV file. Important notes, only one dynamic column can be defined per model, and it must be placed after the regular headers!
+
+The Dynamic Columns add two new methods to the Model:
+
+```ruby
+class BasicRowModel
+  include Csvbuilder::Model
+
+  class << self
+
+    # Safe to override. Method applied to each dynamic_column attribute
+    #
+    # @param cells [Array] Array of values
+    # @param column_name [Symbol] Dynamic column name
+    def format_dynamic_column_cells(cells, _column_name, _context)
+      cells
+    end
+
+    # Safe to override
+    #
+    # @return [String] formatted header
+    def format_dynamic_column_header(header_model, _column_name, _context)
+      header_model
+    end
+  end
+end
+```
+
+The collection of Objects is expected to be provided through the context with a key of the same name as the declared dynamic_column.
+
+## Aliasing
+
+When the Dynamic Column is defined, it can be aliased to another name if needed:
+
+```ruby
+class UserCsvRowModel
+  include Csvbuilder::Model
+
+  column :name
+
+  dynamic_column :skills, as: :abilities
+
+  def ability(cell_value, header)
+    # logic comes here
+  end
+end
+```
+
+## Formatted Headers
+
+Formatting can be applied to the headers as follow:
+
+```ruby
+class UserCsvRowModel
+  include Csvbuilder::Model
+
+  column :name
+
+  dynamic_column :skills
+
+  class << self
+    def format_dynamic_column_header(header_model, column_name, _context)
+      "#{column_name}: [#{header_model}]"
+    end
+  end
+end
+```
+
+For simple cases, the shorter way can be used instead:
+
+```ruby
+class UserCsvRowModel
+  include Csvbuilder::Model
+
+  column :name
+
+  dynamic_column :skills, header: ->(name) { "skills: [#{name}]" }
+end
+```
+
 
 ## Development
 
@@ -26,7 +123,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/csvbuilder-dynamic-columns. 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/[USERNAME]/csvbuilder-dynamic-columns/blob/main/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/joel/csvbuilder-dynamic-columns. 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/[USERNAME]/csvbuilder-dynamic-columns/blob/main/CODE_OF_CONDUCT.md).
 
 ## License
 

data/gemfiles/{Gemfile.5.2._gemfile → Gemfile.8.0._gemfile}

@@ -3,7 +3,7 @@
 source "https://rubygems.org"
 
 # Runtime dependencies
-gem "activesupport", "~> 5.2"
+gem "activemodel", "~> 7.0"
 
 # Libraries dependencies
 gem "csvbuilder-core"

data/lib/csvbuilder/dynamic/columns/core/concerns/dynamic_columns_base.rb

@@ -22,7 +22,11 @@ module Csvbuilder
     }.freeze
     ATTRIBUTE_METHODS.each do |method_name, attribute_method|
       define_method(method_name) do
-        super().merge! column_names_to_attribute_value(self.class.dynamic_column_names, attribute_method)
+        super().merge!(
+          column_names_to_attribute_value(
+            self.class.dynamic_column_names, attribute_method
+          )
+        )
       end
     end
 
@@ -38,7 +42,11 @@ module Csvbuilder
       # Define default attribute method for a dynamic_column
       # @param column_name [Symbol] the cell's column_name
       def define_dynamic_attribute_method(column_name)
-        define_proxy_method(column_name) { original_attribute(column_name) }
+        define_proxy_method(column_name) do
+          # Proxy to the concret implementation if DynamicColumnAttributeBase#value
+          original_attribute(column_name)
+        end
+
         dynamic_attribute_class.define_process_cell(self, column_name)
       end
 

data/lib/csvbuilder/dynamic/columns/core/internal/concerns/dynamic_column_shared.rb

@@ -21,12 +21,26 @@ module Csvbuilder
     #
     # header models
     #
+    # return the collection given by the context
+    # i.e: skills: ["Ruby", "Python", "Javascript"]
+    # header_models => ["Ruby", "Python", "Javascript"]
+    #
+    # @return [Array] Array of values
     def header_models
       Array(context.public_send(header_models_context_key))
     end
 
+    # The name of the dynamic_column
+    #
+    # i.e: With dynamic_column :skills
+    # => :skills
+    #
+    # i.e: With dynamic_column :skills, as: :programming_languages
+    # => :programming_languages
+    #
+    # @return [Symbol] Symbol
     def header_models_context_key
-      options[:header_models_context_key] || column_name
+      options[:as] || column_name
     end
   end
 end

data/lib/csvbuilder/dynamic/columns/core/internal/dynamic_column_attribute_base.rb

@@ -7,28 +7,59 @@ module Csvbuilder
   class DynamicColumnAttributeBase < AttributeBase
     include DynamicColumnShared
 
+    # The value is the collection of cell's values
+    # @return [Array] Array of values
     def value
       @value ||= row_model_class.format_dynamic_column_cells(unformatted_value, column_name, row_model.context)
     end
 
+    # The source_cells is meant to be implemented in the concret class
+    # @return [Array] Array of values
     def formatted_cells
       source_cells.map do |cell|
         row_model_class.format_cell(cell, column_name, row_model.context)
       end
     end
 
+    def source_cells
+      raise NotImplementedError
+    end
+
+    def unformatted_value
+      raise NotImplementedError
+    end
+
     protected
 
+    # Instance access to singularized name of the dynamic_column
+    #
+    # @return [Symbol] value
     def process_cell_method_name
-      self.class.process_cell_method_name(column_name)
+      self.class.process_cell_method_name(header_models_context_key)
     end
 
+    # Calls the singularized method of the dynamic_column
+    #
+    # i.e: With dynamic_column :skills
+    # => :skill
+    #
     # Calls the process_cell to return the value of a Attribute given the args
-    def call_process_cell(*args)
-      row_model.public_send(process_cell_method_name, *args)
+    #
+    # @return [Object] value
+    def call_process_cell(*)
+      row_model.public_send(process_cell_method_name, *)
     end
 
     class << self
+      # The singularized name of the dynamic_column
+      #
+      # i.e: With dynamic_column :skills
+      # => :skill
+      #
+      # i.e: With dynamic_column :skills, as: :programming_languages
+      # => :programming_language
+      #
+      # @return [Symbol] Symbol
       def process_cell_method_name(column_name)
         column_name.to_s.singularize.to_sym
       end
@@ -36,8 +67,8 @@ module Csvbuilder
       # define a method to process each cell of the attribute method
       # process_cell = one cell
       # attribute_method = many cells = [process_cell(), process_cell()...]
-      def define_process_cell(row_model_class, column_name, &block)
-        row_model_class.define_proxy_method(process_cell_method_name(column_name), &block)
+      def define_process_cell(row_model_class, column_name, &)
+        row_model_class.define_proxy_method(process_cell_method_name(column_name), &)
       end
     end
   end

data/lib/csvbuilder/dynamic/columns/core/version.rb

@@ -4,7 +4,7 @@ module Csvbuilder
   module Dynamic
     module Columns
       module Core
-        VERSION = "0.1.0"
+        VERSION = "0.1.2"
       end
     end
   end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: csvbuilder-dynamic-columns-core
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Joel Azemar
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-12-23 00:00:00.000000000 Z
+date: 2025-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -17,9 +16,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '5.2'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -27,9 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '5.2'
-    - - "<"
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '8'
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: csvbuilder-core
   requirement: !ruby/object:Gem::Requirement
@@ -55,6 +62,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
+- ".tool-versions"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -62,9 +70,8 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- gemfiles/Gemfile.5.2._gemfile
-- gemfiles/Gemfile.6.1._gemfile
 - gemfiles/Gemfile.7.0._gemfile
+- gemfiles/Gemfile.8.0._gemfile
 - lib/.DS_Store
 - lib/csvbuilder/.DS_Store
 - lib/csvbuilder/dynamic/.DS_Store
@@ -86,7 +93,6 @@ metadata:
   source_code_uri: https://github.com/joel/csvbuilder-dynamic-columns
   changelog_uri: https://github.com/joel/csvbuilder-dynamic-columns/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -94,15 +100,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Csvbuilder Dynamic Columns contain the components to handle CSV dynamic columns
 test_files: []

data/gemfiles/Gemfile.6.1._gemfile

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Runtime dependencies
-gem "activesupport", "~> 6.1"
-
-# Libraries dependencies
-gem "csvbuilder-core"
-
-# Development dependencies
-gem "rake"
-gem "rspec"
-gem "rubocop"
-gem "rubocop-performance"
-gem "rubocop-rake"
-gem "rubocop-rspec"