tty-config 0.3.2 → 0.4.0

data/lib/tty/config/dependency_loader.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module TTY
+  class Config
+    module DependencyLoader
+      attr_reader :dep_name
+
+      # Lazy load a dependency
+      #
+      # @api public
+      def dependency(*dep_names, &block)
+        self.dep_name = dep_names
+        @block = block
+      end
+
+      # Load dependency before object instatiation
+      #
+      # @api public
+      def new(*)
+        load
+        super
+      end
+
+      # Try loading depedency
+      #
+      # @api private
+      def load
+        return if dep_name.nil?
+
+        dep_name.empty? ? @block.() : dep_name.each { |dep| require(dep) }
+      rescue LoadError, NameError => err
+        raise DependencyLoadError, "#{raise_error_message} #{err.message}"
+      end
+
+      def inherited(subclass)
+        super
+        subclass.send(:dep_name=, dep_name)
+      end
+
+      private
+
+      def raise_error_message
+        if dep_name.empty?
+          "One or more dependency are missing."
+        elsif dep_name.size == 1
+          "The dependency `#{dep_name.join}` is missing."
+        else
+          "The dependencies `#{dep_name.join(", ")}` are missing."
+        end
+      end
+
+      attr_writer :dep_name
+    end # DependencyLoader
+  end # Config
+end # TTY

data/lib/tty/config/generator.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module TTY
+  class Config
+    module Generator
+      # Generate file content based on the data hash
+      #
+      # @param [Hash] data
+      #
+      # @return [String]
+      #   the file content
+      #
+      # @api public
+      def self.generate(data, separator: '=')
+        content  = []
+        values   = {}
+        sections = {}
+
+        data.keys.sort.each do |key|
+          val = data[key]
+          if val.is_a?(NilClass)
+            next
+          elsif val.is_a?(Hash) ||
+                (val.is_a?(Array) && val.first.is_a?(Hash))
+            sections[key] = val
+          elsif val.is_a?(Array)
+            values[key] = val.join(',')
+          else
+            values[key] = val
+          end
+        end
+
+        # values
+        values.each do |key, val|
+          content << "#{key} #{separator} #{val}"
+        end
+        content << '' unless values.empty?
+
+        # sections
+        sections.each do |section, object|
+          next if object.empty? # only add section if values present
+
+          content << "[#{section}]"
+          if object.is_a?(Array)
+            object = object.reduce({}, :merge!)
+          end
+          object.each do |key, val|
+            val = val.join(',') if val.is_a?(Array)
+            content << "#{key} #{separator} #{val}" if val
+          end
+          content << ''
+        end
+        content.join("\n")
+      end
+    end # INIFile
+  end # Config
+end # TTY

data/lib/tty/config/marshaller.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require_relative "dependency_loader"
+
+module TTY
+  class Config
+    module Marshaller
+      # @api private
+      def self.included(base)
+        super
+        # Help marshallers to declare their gem dependency
+        base.extend DependencyLoader
+        # Help marshallers to declare their extension matching
+        base.extend ExtensionsStore
+      end
+
+      module ExtensionsStore
+        def ext
+          @ext ||= []
+        end
+
+        # Set a list of extensions
+        #
+        # @example
+        #   extenion "ext1", "ext2", "ext3"
+        #
+        # @api public
+        def extension(*extensions)
+          if extensions[0].is_a?(Array)
+            @ext = extensions[0]
+          else
+            @ext = extensions
+          end
+        end
+      end
+
+      # Marshal object into a given format
+      #
+      # @param [Object] _object
+      #
+      # @api public
+      def marshal(_object, _options = {})
+        raise NotImplementedError
+      end
+
+      # Unmarshal content into a hash object
+      #
+      # @param [String] _content
+      #
+      # @api public
+      def unmarshal(_content, _options = {})
+        raise NotImplementedError
+      end
+    end # Marshaller
+  end # Config
+end # TTY

data/lib/tty/config/marshaller_registry.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module TTY
+  class Config
+    class MarshallerRegistry
+
+      attr_reader :marshallers
+
+      # @api private
+      def initialize(mappings = {})
+        @marshallers = mappings
+      end
+
+      def names
+        marshallers.keys
+      end
+
+      def objects
+        marshallers.values
+      end
+
+      def exts
+        marshallers.values.reduce([]) { |acc, obj| acc + obj.ext }
+      end
+
+      def registered?(name_or_object)
+        marshallers.key?(name_or_object) || marshallers.has_value?(name_or_object)
+      end
+
+      def register(name, object)
+        marshallers[name] = object
+      end
+
+      def unregister(name)
+        marshallers.delete(name)
+      end
+
+      def [](name)
+        marshallers.fetch(name)
+      end
+    end
+  end # Config
+end # TTY

data/lib/tty/config/marshallers.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative "marshaller_registry"
+
+module TTY
+  class Config
+    module Marshallers
+      NO_EXT = ""
+
+      def marshaller_registry
+        @marshaller_registry ||= MarshallerRegistry.new
+      end
+
+      def marshallers
+        marshaller_registry.objects
+      end
+
+      def extensions
+        marshaller_registry.exts << NO_EXT
+      end
+
+      def registered_marshaller?(name_or_object)
+        marshaller_registry.registered?(name_or_object)
+      end
+
+      def register_marshaller(name, object)
+        marshaller_registry.register(name, object)
+      end
+
+      def unregister_marshaller(*names)
+        names.map { |name| marshaller_registry.unregister(name) }
+      end
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/marshallers/hcl_marshaller.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "../marshaller"
+
+module TTY
+  class Config
+    module Marshallers
+      class HCLMarshaller
+        include TTY::Config::Marshaller
+
+        dependency "rhcl"
+
+        extension ".hcl"
+
+        def marshal(object)
+          Rhcl.dump(object)
+        end
+
+        def unmarshal(content)
+          Rhcl.parse(content)
+        end
+      end # HCLMarshaller
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/marshallers/ini_marshaller.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "../generator"
+require_relative "../marshaller"
+
+module TTY
+  class Config
+    module Marshallers
+      class INIMarshaller
+        include TTY::Config::Marshaller
+
+        dependency "inifile"
+
+        extension ".ini", ".cnf", ".conf", ".cfg", ".cf"
+
+        def marshal(object)
+          TTY::Config::Generator.generate(object)
+        end
+
+        def unmarshal(content)
+          ini = IniFile.new(content: content).to_h
+          global = ini.delete('global')
+          ini.merge!(global)
+        end
+      end # INIMarshaller
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/marshallers/java_props_marshaller.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "../marshaller"
+
+module TTY
+  class Config
+    module Marshallers
+      class JavaPropsMarshaller
+        include TTY::Config::Marshaller
+
+        dependency "java-properties"
+
+        extension ".properties", ".props", ".prop"
+
+        def marshal(object)
+          JavaProperties.generate(object)
+        end
+
+        def unmarshal(content)
+          JavaProperties.parse(content)
+        end
+      end # JavapropsMarshaller
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/marshallers/json_marshaller.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "../marshaller"
+
+module TTY
+  class Config
+    module Marshallers
+      class JSONMarshaller
+        include TTY::Config::Marshaller
+
+        dependency "json"
+
+        extension ".json"
+
+        def marshal(object)
+          JSON.pretty_generate(object)
+        end
+
+        def unmarshal(content)
+          JSON.parse(content)
+        end
+      end # JSONMarshaller
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/marshallers/toml_marshaller.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "../marshaller"
+
+module TTY
+  class Config
+    module Marshallers
+      class TOMLMarshaller
+        include TTY::Config::Marshaller
+
+        dependency "toml"
+
+        extension ".toml"
+
+        def marshal(data)
+          TOML::Generator.new(data).body
+        end
+
+        def unmarshal(content)
+          TOML::Parser.new(content).parsed
+        end
+      end # TOMLMarshaller
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/marshallers/yaml_marshaller.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative "../marshaller"
+
+module TTY
+  class Config
+    module Marshallers
+      class YAMLMarshaller
+        include TTY::Config::Marshaller
+
+        dependency "yaml"
+
+        extension ".yaml", ".yml"
+
+        def marshal(object)
+          YAML.dump(TTY::Config.normalize_hash(object, :to_s))
+        end
+
+        def unmarshal(content)
+          if YAML.respond_to?(:safe_load)
+            YAML.safe_load(content)
+          else
+            YAML.load(content)
+          end
+        end
+      end # YAMLMarshaller
+    end # Marshallers
+  end # Config
+end # TTY

data/lib/tty/config/version.rb

@@ -2,6 +2,6 @@
 
 module TTY
   class Config
-    VERSION = "0.3.2"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tty-config
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Piotr Murach
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-06-18 00:00:00.000000000 Z
+date: 2020-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,49 +80,71 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: rhcl
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: java-properties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
 description: Define, read and write any Ruby app configurations with a penchant for
   terminal clients.
 email:
-- me@piotrmurach.com
+- piotr@piotrmurach.com
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
+- CHANGELOG.md
 files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- Rakefile
-- bin/console
-- bin/setup
 - lib/tty-config.rb
 - lib/tty/config.rb
+- lib/tty/config/dependency_loader.rb
+- lib/tty/config/generator.rb
+- lib/tty/config/marshaller.rb
+- lib/tty/config/marshaller_registry.rb
+- lib/tty/config/marshallers.rb
+- lib/tty/config/marshallers/hcl_marshaller.rb
+- lib/tty/config/marshallers/ini_marshaller.rb
+- lib/tty/config/marshallers/java_props_marshaller.rb
+- lib/tty/config/marshallers/json_marshaller.rb
+- lib/tty/config/marshallers/toml_marshaller.rb
+- lib/tty/config/marshallers/yaml_marshaller.rb
 - lib/tty/config/version.rb
-- spec/spec_helper.rb
-- spec/unit/alias_setting_spec.rb
-- spec/unit/append_spec.rb
-- spec/unit/autoload_env_spec.rb
-- spec/unit/delete_spec.rb
-- spec/unit/exist_spec.rb
-- spec/unit/fetch_spec.rb
-- spec/unit/generate_spec.rb
-- spec/unit/merge_spec.rb
-- spec/unit/new_spec.rb
-- spec/unit/normalize_hash_spec.rb
-- spec/unit/read_spec.rb
-- spec/unit/remove_spec.rb
-- spec/unit/set_from_env_spec.rb
-- spec/unit/set_if_empty_spec.rb
-- spec/unit/set_spec.rb
-- spec/unit/validate_spec.rb
-- spec/unit/write_spec.rb
-- tasks/console.rake
-- tasks/coverage.rake
-- tasks/spec.rake
-- tty-config.gemspec
-homepage: https://piotrmurach.github.io/tty
+homepage: https://ttytoolkit.org
 licenses:
 - MIT
-metadata: {}
+metadata:
+  allowed_push_host: https://rubygems.org
+  bug_tracker_uri: https://github.com/piotrmurach/tty-config/issues
+  changelog_uri: https://github.com/piotrmurach/tty-config/blob/master/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/tty-config
+  homepage_uri: https://ttytoolkit.org
+  source_code_uri: https://github.com/piotrmurach/tty-config
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -138,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Define, read and write any Ruby app configurations with a penchant for terminal