shale 0.7.1 → 0.9.0

data/lib/shale/type/date.rb

@@ -47,6 +47,17 @@ module Shale
         value&.iso8601
       end
 
+      # Use ISO 8601 format in CSV document
+      #
+      # @param [Date] value
+      #
+      # @return [String]
+      #
+      # @api private
+      def self.as_csv(value, **)
+        value&.iso8601
+      end
+
       # Use ISO 8601 format in XML document
       #
       # @param [Date] value Value to convert to XML

data/lib/shale/type/time.rb

@@ -47,6 +47,17 @@ module Shale
         value&.iso8601
       end
 
+      # Use ISO 8601 format in CSV document
+      #
+      # @param [Time] value
+      #
+      # @return [String]
+      #
+      # @api private
+      def self.as_csv(value, **)
+        value&.iso8601
+      end
+
       # Use ISO 8601 format in XML document
       #
       # @param [Time] value Value to convert to XML

data/lib/shale/type/value.rb

@@ -111,6 +111,28 @@ module Shale
           value
         end
 
+        # Extract value from CSV document
+        #
+        # @param [any] value
+        #
+        # @return [any]
+        #
+        # @api private
+        def of_csv(value, **)
+          value
+        end
+
+        # Convert value to form accepted by CSV document
+        #
+        # @param [any] value
+        #
+        # @return [any]
+        #
+        # @api private
+        def as_csv(value, **)
+          value
+        end
+
         # Extract value from XML document
         #
         # @param [Shale::Adapter::<XML adapter>::Node] value

data/lib/shale/version.rb

@@ -2,5 +2,5 @@
 
 module Shale
   # @api private
-  VERSION = '0.7.1'
+  VERSION = '0.9.0'
 end

data/lib/shale.rb

@@ -3,6 +3,7 @@
 require 'yaml'
 
 require_relative 'shale/mapper'
+require_relative 'shale/adapter/csv'
 require_relative 'shale/adapter/json'
 require_relative 'shale/type/boolean'
 require_relative 'shale/type/date'
@@ -15,7 +16,7 @@ require_relative 'shale/version'
 # Main library namespace
 #
 # Shale uses adapters for parsing and serializing documents.
-# For handling JSON and YAML, adapter must implement .load and .dump methods, so
+# For handling JSON, YAML, TOML and CSV, adapter must implement .load and .dump methods, so
 # e.g for handling JSON, MultiJson works out of the box.
 #
 # Adapters for XML handling are more complicated and must conform to [@see shale/adapter/rexml]
@@ -29,9 +30,11 @@ require_relative 'shale/version'
 #   Shale.json_adapter = MultiJson
 #   Shale.json_adapter # => MultiJson
 #
-# @example setting YAML adapter for handling YAML documents
-#   Shale.yaml_adapter = MultiJson
-#   Shale.yaml_adapter # => MultiJson
+# @example setting TOML adapter for handling TOML documents
+#   require 'shale/adapter/toml_rb'
+#
+#   Shale.toml_adapter = Shale::Adapter::TomlRB
+#   Shale.toml_adapter # => Shale::Adapter::TomlRB
 #
 # @example setting REXML adapter for handling XML documents
 #   Shale.xml_adapter = Shale::Adapter::REXML
@@ -86,6 +89,16 @@ module Shale
     # @api public
     attr_accessor :toml_adapter
 
+    # Set CSV adapter
+    #
+    # @param [.load, .dump] adapter
+    #
+    # @example
+    #   Shale.csv_adapter = Shale::Adapter::CSV
+    #
+    # @api public
+    attr_writer :csv_adapter
+
     # XML adapter accessor. Available adapters are Shale::Adapter::REXML,
     # Shale::Adapter::Nokogiri and Shale::Adapter::Ox
     #
@@ -126,5 +139,18 @@ module Shale
     def yaml_adapter
       @yaml_adapter || YAML
     end
+
+    # Return CSV adapter. By default CSV is used
+    #
+    # @return [.load, .dump]
+    #
+    # @example
+    #   Shale.csv_adapter
+    #   # => Shale::Adapter::CSV
+    #
+    # @api public
+    def csv_adapter
+      @csv_adapter || Adapter::CSV
+    end
   end
 end

data/shale.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.authors = ['Kamil Giszczak']
   spec.email = ['beerkg@gmail.com']
 
-  spec.summary = 'Ruby object mapper and serializer for XML, JSON, TOML and YAML.'
-  spec.description = 'Ruby object mapper and serializer for XML, JSON, TOML and YAML.'
+  spec.summary = 'Ruby object mapper and serializer for XML, JSON, TOML, CSV and YAML.'
+  spec.description = 'Ruby object mapper and serializer for XML, JSON, TOML, CSV and YAML.'
   spec.homepage = 'https://shalerb.org'
   spec.license = 'MIT'
 
@@ -26,5 +26,5 @@ Gem::Specification.new do |spec|
   spec.bindir = 'exe'
   spec.executables = 'shaleb'
 
-  spec.required_ruby_version = '>= 2.7.0'
+  spec.required_ruby_version = '>= 2.6.0'
 end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: shale
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Kamil Giszczak
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-08-12 00:00:00.000000000 Z
+date: 2022-10-31 00:00:00.000000000 Z
 dependencies: []
-description: Ruby object mapper and serializer for XML, JSON, TOML and YAML.
+description: Ruby object mapper and serializer for XML, JSON, TOML, CSV and YAML.
 email:
 - beerkg@gmail.com
 executables:
@@ -23,6 +23,7 @@ files:
 - README.md
 - exe/shaleb
 - lib/shale.rb
+- lib/shale/adapter/csv.rb
 - lib/shale/adapter/json.rb
 - lib/shale/adapter/nokogiri.rb
 - lib/shale/adapter/nokogiri/document.rb
@@ -41,8 +42,16 @@ files:
 - lib/shale/mapping/descriptor/xml.rb
 - lib/shale/mapping/descriptor/xml_namespace.rb
 - lib/shale/mapping/dict.rb
+- lib/shale/mapping/dict_base.rb
+- lib/shale/mapping/dict_group.rb
+- lib/shale/mapping/group/dict.rb
+- lib/shale/mapping/group/dict_grouping.rb
+- lib/shale/mapping/group/xml.rb
+- lib/shale/mapping/group/xml_grouping.rb
 - lib/shale/mapping/validator.rb
 - lib/shale/mapping/xml.rb
+- lib/shale/mapping/xml_base.rb
+- lib/shale/mapping/xml_group.rb
 - lib/shale/schema.rb
 - lib/shale/schema/compiler/boolean.rb
 - lib/shale/schema/compiler/complex.rb
@@ -108,7 +117,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -118,5 +127,5 @@ requirements: []
 rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
-summary: Ruby object mapper and serializer for XML, JSON, TOML and YAML.
+summary: Ruby object mapper and serializer for XML, JSON, TOML, CSV and YAML.
 test_files: []