app-configs 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 44bd83dad8cb131fa7e09b15221e6e350d3d8ade763687869598c12e41c02217
+  data.tar.gz: 880fc5ec782b3de5bb62263955a9576065253d2e8c95f1b37f674cfea088f3e0
+SHA512:
+  metadata.gz: 7fc746a8a7303a999f99f972024b3f4633de850e5d07357a492c60c39afa3980e6f259c443f885bea69fc13eeb5ad11b2c54d19effd89d499e5cf419acc129a7
+  data.tar.gz: 42dc9f7c3eae289fa80f08e1e8d0cba0981579f4e74a99d5d1ee3166a65de2d4175a1ca3c3f3d64753f6e4e25991bc582b2a18e81c3efe2e6b420a556a1ac90a

data/.gitignore

@@ -0,0 +1,23 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+/vendor/
+*.pid
+*.log
+*.log.*
+/var/
+/log/
+*.swp
+/.rspec_status
+

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.7.1
+before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in application-config.gemspec
+gemspec
+

data/README.adoc

@@ -0,0 +1,153 @@
+= App::Config
+
+Yet another library for load/save configuration files.
+
+== Features
+
+* Read the configuration files (default, startup, modified) in order and apply by overwriting.
+* The modified configuration can be saved as a file in a given directory.
+* File type Supports Ruby scripts, YAML and JSON.
+
+== Installation
+
+Add this line to your app's Gemfile:
+
+[source,ruby]
+----
+gem 'app-configs'
+----
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install app-configs
+    or
+    $ gem install -l app-configs-x.x.x.gem
+
+== Usage
+
+=== Example 1
+
+[source,ruby]
+----
+require  "app-config"
+
+# initial load. default search paths: "./config/defaults:./config:./var"
+config  =  App::Config.new
+
+puts  config["test"]["lastdate"]
+
+# update content.
+config["test"]["lastdate"]  =  Time.now.to_s
+pp  config["test"]
+
+# save section changes. (default: "./var")
+config.save("test")
+pp  config["test"]
+
+# load section.
+config.load("test")
+pp  config["test"]
+
+# remove modification and load original section
+config.reset("test")
+pp  config["test"]
+
+# reload all section.
+config.reload
+pp  config
+----
+
+== Reference
+
+=== Create a new App::Config::* with conditions.
+
+[source,ruby]
+----
+App::Config.new( type = nil, root: nil, path: nil )
+App::Config::RUBY.new( root: nil, path: nil )
+App::Config::YAML.new( root: nil, path: nil )
+App::Config::JSON.new( root: nil, path: nil )
+----
+
+* Result:
+  ** App::Config::{RUBY,YAML,JSON} object.
+
+* Parameter:
+  ** type:  Configulation file type. RUBY, YAML, or JSON. (default: YAML)
+  ** root:  App root directory. (default: ".")
+  ** path:  The directories for search and load file(s). (default: "$ROOT/config/defaults/:$ROOT/config:$ROOT/var")
+
+=== Reload all section(s).
+
+[source,ruby]
+----
+App::Config::RUBY#reload( root: nil, path: nil )
+App::Config::YAML#reload( root: nil, path: nil )
+App::Config::JSON#reload( root: nil, path: nil )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** root:  App root directory. (default: ".")
+  ** path:  The directories for search and load file(s). (default: "$ROOT/config/defaults/:$ROOT/config:$ROOT/var")
+
+=== Load the section.
+
+[source,ruby]
+----
+App::Config::RUBY#load( section )
+App::Config::YAML#load( section )
+App::Config::JSON#load( section )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** section: Section name for load.
+
+=== Save section changes. (default: "./var")
+
+[source,ruby]
+----
+App::Config::RUBY#save( section )
+App::Config::YAML#save( section )
+App::Config::JSON#save( section )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** section: Section name for save.
+
+=== Remove modification and load original section
+
+[source,ruby]
+----
+App::Config::RUBY#reset( section )
+App::Config::YAML#reset( section )
+App::Config::JSON#reset( section )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** section: Section name for reset.
+
+== Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/arimay/app-configs.
+
+== License
+
+The gem is available as open source under the terms of the http://opensource.org/licenses/MIT[MIT License].
+
+Copyright (c) ARIMA Yasuhiro <arima.yasuhiro@gmail.com>

data/README.ja.adoc

@@ -0,0 +1,153 @@
+= App::Config
+
+またもや構成ファイル読み込み/書き出しライブラリ.
+
+== 特徴
+
+* 構成ファイル（デフォルト、スタートアップ、更新分）を順番に読み取り、上書きして適用する.
+* 変更した構成は、所定のディレクトリにファイルとして保存することができる.
+* ファイルタイプ Rubyスクリプト、YAML、JSON をサポートする.
+
+== 導入
+
+アプリの Gemfile にこの行を追加
+
+[source,ruby]
+----
+gem 'app-configs'
+----
+
+それから実行
+
+    $ bundle install
+
+または次のように手動で導入
+
+    $ gem install app-configs
+    or
+    $ gem install -l app-configs-x.x.x.gem
+
+== 使い方
+
+=== Example 1
+
+[source,ruby]
+----
+require  "app-config"
+
+# 初期読み込み. 初期探索パス: "./config/defaults:./config:./var"
+config  =  App::Config.new
+
+puts  config["test"]["lastdate"]
+
+# 内容を更新する
+config["test"]["lastdate"]  =  Time.now.to_s
+pp  config["test"]
+
+# セクションの変更を保存する (default: "./var")
+config.save("test")
+pp  config["test"]
+
+# セクションを読み込む
+config.load("test")
+pp  config["test"]
+
+# セクションの変更を削除して元内容を読み込む
+config.reset("test")
+pp  config["test"]
+
+# 全セクションを読み込む
+config.reload
+pp  config
+----
+
+== リファレンス
+
+=== 条件を指定して、新たな App::Config::* を作成する.
+
+[source,ruby]
+----
+App::Config.new( type = nil, root: nil, path: nil )
+App::Config::RUBY.new( root: nil, path: nil )
+App::Config::YAML.new( root: nil, path: nil )
+App::Config::JSON.new( root: nil, path: nil )
+----
+
+* Result:
+  ** App::Config::{RUBY,YAML,JSON} オブジェクト.
+
+* Parameter:
+  ** type:  構成ファイルタイプ. RUBY, YAML, または JSON. (default: YAML)
+  ** root:  アプリの基準ディレクトリ. (default: ".")
+  ** path:  探索と読み込み対象のディレクトリ. (default: "$ROOT/config/defaults/:$ROOT/config:$ROOT/var")
+
+=== Reload all section(s).
+
+[source,ruby]
+----
+App::Config::RUBY#reload( root: nil, path: nil )
+App::Config::YAML#reload( root: nil, path: nil )
+App::Config::JSON#reload( root: nil, path: nil )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** root:  アプリの基準ディレクトリ. (default: ".")
+  ** path:  探索と読み込み対象のディレクトリ. (default: "$ROOT/config/defaults/:$ROOT/config:$ROOT/var")
+
+=== セクションを読み込む
+
+[source,ruby]
+----
+App::Config::RUBY#load( section )
+App::Config::YAML#load( section )
+App::Config::JSON#load( section )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** section:  読み込み対象のセクション.
+
+=== セクションを書き出す
+
+[source,ruby]
+----
+App::Config::RUBY#save( section )
+App::Config::YAML#save( section )
+App::Config::JSON#save( section )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** section:  書き込み対象のセクション.
+
+=== セクションを初期化
+
+[source,ruby]
+----
+App::Config::RUBY#reset( section )
+App::Config::YAML#reset( section )
+App::Config::JSON#reset( section )
+----
+
+* Result:
+  ** nil.
+
+* Parameter:
+  ** section:  初期化対象のセクション.
+
+== 貢献
+
+不具合報告とプルリクエストは GitHub https://github.com/arimay/app-configs まで. 
+
+== ライセンス
+
+この Gem は、 http://opensource.org/licenses/MIT[MITライセンス] の条件に基づいてオープンソースとして入手できる.
+
+Copyright (c) ARIMA Yasuhiro <arima.yasuhiro@gmail.com>

data/Rakefile

@@ -0,0 +1,96 @@
+require "bundler/gem_helper"
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+class Bundler::GemHelper
+
+  def git_archive( dir = "../zip" )
+    FileUtils.mkdir_p  dir
+    dest_path  =  File.join(dir, "#{name}-#{version}.zip")
+    cmnd  =  "git archive --format zip --prefix=#{name}/ HEAD > #{dest_path}"
+
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't archive gem,"  unless  code == 0
+
+    Bundler.ui.confirm "#{name} #{version} archived to #{dest_path}."
+  end
+
+  def git_push
+    ver  =  version.to_s
+
+    cmnd  =  "git push origin  #{ver} "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git push origin."  unless  code == 0
+
+    cmnd  =  "git push "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git push."         unless  code == 0
+
+    Bundler.ui.confirm "Git Push #{ver}."
+  end
+
+  def update_version( new_version )
+    version_filename  =  %x[ find . -type f -name "version.rb" | grep -v vendor | head -1 ].chomp
+    version_pathname  =  File.expand_path( version_filename )
+    lines  =  File.open( version_pathname ).read
+    lines  =  lines.gsub( /VERSION\s*=\s*\"\d+\.\d+\.\d+\"/, "VERSION = \"#{new_version}\"" )
+    File.open( version_pathname, "w" ) do |file|
+      file.write( lines )
+    end
+
+    cmnd  =  "git add  #{version_pathname} "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git add,"  unless  code == 0
+
+    cmnd  =  "git commit -m  '#{new_version}' "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git commit."  unless  code == 0
+
+    cmnd  =  "git tag        #{new_version} "
+    out, code = sh_with_status( cmnd )
+    raise "Couldn't git tag."          unless  code == 0
+
+    Bundler.ui.confirm "Update Tags to #{new_version}."
+  end
+
+end
+
+Bundler::GemHelper.new(Dir.pwd).instance_eval do
+
+  desc "Archive #{name}-#{version}.zip from repository"
+  task 'zip' do
+    git_archive
+  end
+
+  desc "Git Push"
+  task 'push' do
+    git_push
+  end
+
+  desc "Update Version Tiny"
+  task 'tiny' do
+    major, minor, tiny  =  version.to_s.split('.')
+    new_version  =  [major, minor, tiny.to_i + 1].join('.')
+    update_version( new_version )
+  end
+
+  desc "Update Version Minor"
+  task 'minor' do
+    major, minor, tiny  =  version.to_s.split('.')
+    new_version  =  [major, minor.to_i + 1, 0].join('.')
+    update_version( new_version )
+  end
+
+  desc "Update Version Major"
+  task 'major' do
+    major, minor, tiny  =  version.to_s.split('.')
+    new_version  =  [major.to_i + 1, 0, 0].join('.')
+    update_version( new_version )
+  end
+
+end
+

data/app-configs.gemspec

@@ -0,0 +1,23 @@
+require_relative 'lib/app/config/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "app-configs"
+  spec.version       = App::Config::VERSION
+  spec.authors       = ["arimay"]
+  spec.email         = ["arima.yasuhiro@gmail.com"]
+
+  spec.summary       = %q{ Application config loader/saver. }
+  spec.description   = %q{ Yet another library for load/save app config files. }
+  spec.homepage      = "https://github.com/arimay/app-configs"
+  spec.license       = "MIT"
+
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "application/config"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/config/app.json

@@ -0,0 +1,6 @@
+{
+  "app":{
+    "user": "<%= ENV['USER'] %>"
+  }
+}
+

data/config/app.rb

@@ -0,0 +1,6 @@
+{
+  "app" => {
+    "user" => ENV['USER'],
+  }
+}
+

data/config/app.yaml

@@ -0,0 +1,4 @@
+---
+app:
+  user: <%= ENV['USER'] %>
+

data/lib/app/config.rb

@@ -0,0 +1,18 @@
+require "app/config/version"
+require "app/config/base"
+require "app/config/deeply"
+
+module App
+  module Config
+    class Error < StandardError; end
+
+    class  <<  self
+      include App::Config::Base
+    end
+
+    autoload  :RUBY, "app/config/ruby"
+    autoload  :YAML, "app/config/yaml"
+    autoload  :JSON, "app/config/json"
+  end
+end
+

data/lib/app/config/base.rb

@@ -0,0 +1,29 @@
+
+module App
+  module Config
+
+    class Error < StandardError; end
+
+    DEFAULT_PATH  =  "$ROOT/config/defaults:$ROOT/config:$ROOT/var"
+
+    module Base
+
+      def new( *args, **opts )
+        type  =  args.shift || :YAML
+        case  type.to_sym
+        when  :RUBY
+          App::Config::RUBY.new( **opts )
+        when  :YAML
+          App::Config::YAML.new( **opts )
+        when  :JSON
+          App::Config::JSON.new( **opts )
+        else
+          raise  App::Config::Error, "unknown type: #{type}"
+        end
+      end
+
+    end
+
+  end
+end
+

data/lib/app/config/deeply.rb

@@ -0,0 +1,145 @@
+
+## deeply_symbolize_keys
+
+class Hash
+  def deeply_symbolize_keys!
+    hash  =  self.deeply_symbolize_keys
+    self.clear
+    self.merge( hash )
+  end
+
+  def deeply_symbolize_keys
+    self.each_with_object({}) do |(key, obj), hash|
+      k  =  key.to_s.to_sym
+      case  obj
+      when  Hash
+        hash[k]  =  obj.deeply_symbolize_keys
+      else
+        hash[k]  =  obj
+      end
+    end
+  end
+end
+
+
+## deeply_stringify_keys
+
+class Hash
+  def deeply_stringify_keys!
+    hash  =  self.deeply_stringify_keys
+    self.clear
+    self.merge( hash )
+  end
+
+  def deeply_stringify_keys
+    self.each_with_object({}) do |(key, obj), hash|
+      k  =  key.to_s
+      case  obj
+      when  Hash
+        hash[k]  =  obj.deeply_stringify_keys
+      else
+        hash[k]  =  obj
+      end
+    end
+  end
+end
+
+
+## deeply_merge
+
+class Hash
+  def deeply_merge( hash )
+    self.dup.deeply_merge!( hash )
+  end
+
+  def deeply_merge!( hash )
+    raise  ArgumentError("Type Invalid.")    unless Hash === hash
+
+    hash.each do |key, obj|
+      case  obj
+      when  NilClass
+        self[key]  =  nil
+      when  Hash
+        self[key]  =  {}    if self[key].nil?
+        self[key].deeply_merge!(obj)
+      else
+        self[key]  =  obj.dup
+      end
+    end
+  end
+end
+
+
+## deeply_map
+
+class Hash
+  def deeply_map( &block )
+    self.dup.deeply_map!( &block )
+  end
+
+  def deeply_map!( &block )
+    self.each do |key, obj|
+      case  obj
+      when  NilClass
+        self[key]  =  nil
+      when  Array, Hash
+        self[key].deeply_map!( &block )
+      else
+        self[key]  =  block.call( obj )
+      end
+    end
+  end
+end
+
+class Array
+  def deeply_map( &block )
+    self.dup.deeply_map!( &block )
+  end
+
+  def deeply_map!( &block )
+    self.map! do |obj|
+      case  obj
+      when  NilClass
+        nil
+      when  Array, Hash
+        obj.deeply_map!( &block )
+      else
+        block.call( obj )
+      end
+    end
+  end
+end
+
+
+## deeply_dup
+
+class Hash
+  def deeply_dup
+    self.each_with_object({}) do |(key, obj), hash|
+      case  obj
+      when  NilClass
+        hash[key]  =  nil
+      when  Array, Hash
+        hash[key]  =  obj.deeply_dup
+      else
+        hash[key]  =  obj.dup
+      end
+    end
+  end
+end
+
+class Array
+  def deeply_dup
+    self.map do |obj|
+      case  obj
+      when  NilClass
+        nil
+      when  Array, Hash
+        obj.deeply_dup
+      else
+        obj.dup
+      end
+    end
+  end
+end
+

data/lib/app/config/json.rb

@@ -0,0 +1,91 @@
+require  "fileutils"
+require  "erb"
+require  "json"
+require  "time"
+require  "date"
+
+module App
+  module Config
+
+    class JSON < ::Hash
+      DEFAULT_MASK  =  "*.json"
+      DEFAULT_SUFFIX  =  ".json"
+
+      def initialize( **opts )
+        self.default_proc  =  proc do |hash, key|
+          hash[key]  =  {}
+        end
+        reload( **opts )
+      end
+
+      # bulk load configuration in search paths.
+      def reload( root: nil, path: nil, encode: nil, decode: nil )
+        clear
+        @root  =  root || Dir.pwd
+        @paths  =  ( path || DEFAULT_PATH ).gsub('$ROOT', @root).split(':')
+        @paths  =  @paths.map{|it| !it.nil? && !it.empty? ? it : nil}.compact
+        @paths  <<  "."    if @paths.empty?
+
+        @vardir  =  @paths.last
+        Dir.mkdir( @vardir )    unless ::Dir.exist?( @vardir )
+
+        @encode  =  { allow_nan: true }.merge( encode || {} )
+        @decode  =  { allow_nan: true }.merge( decode || {} )
+
+        load_overlay( DEFAULT_MASK )
+      end
+
+      # load configuration.
+      def load( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+
+        self[section].clear
+        load_overlay( section + DEFAULT_SUFFIX )
+      end
+
+      # load configuration.
+      def load_overlay( filename )
+        @paths.each do |path|
+          begin
+            dirname  =  ::File.expand_path( path )
+            if  ::Dir.exist?( dirname )
+              ::Dir.glob( "#{ dirname }/#{ filename }" ) do |pathname|
+                text  =  ::File.open( pathname ).read    rescue  raise( ArgumentError, "could not load #{ pathname }" )
+                json  =  ::ERB.new( text ).result        rescue  raise( ArgumentError, "could not parse by ERB: #{ pathname }" )
+                hash  =  ::JSON.load( json, **@decode )
+                self.deeply_merge!( hash )
+              end
+            end
+          rescue => e
+            STDERR.puts e.message
+          end
+        end
+      end
+
+      # save configuration.
+      def save( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+        pathname  =  savepathname(section)
+        hash  =  { section => self[section] }.deeply_stringify_keys
+        ::File.open( pathname, "w" ) do |file|
+          file.puts( ::JSON.pretty_generate( hash, **@encode ) )
+        end
+      end
+
+      # remove and load configuration.
+      def reset( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+
+        pathname  =  savepathname(section)
+        ::FileUtils.remove( pathname )    if ::File.exist?( pathname )
+        load( section )
+      end
+
+      def savepathname( section )
+        ::File.join( @vardir, section + DEFAULT_SUFFIX )
+      end
+
+    end
+  end
+end
+

data/lib/app/config/ruby.rb

@@ -0,0 +1,87 @@
+require  "fileutils"
+require  "pp"
+
+module App
+  module Config
+
+    class RUBY < ::Hash
+      DEFAULT_MASK  =  "*.rb"
+      DEFAULT_SUFFIX  =  ".rb"
+
+      def initialize( **opts )
+        self.default_proc  =  proc do |hash, key|
+          hash[key]  =  {}
+        end
+        reload( **opts )
+      end
+
+      # bulk load configuration in search paths.
+      def reload( root: nil, path: nil, encode: nil, decode: nil )
+        clear
+        @root  =  root || Dir.pwd
+        @paths  =  ( path || DEFAULT_PATH ).gsub('$ROOT', @root).split(':')
+        @paths  =  @paths.map{|it| !it.nil? && !it.empty? ? it : nil}.compact
+        @paths  <<  "."    if @paths.empty?
+
+        @vardir  =  @paths.last
+        Dir.mkdir( @vardir )    unless ::Dir.exist?( @vardir )
+
+        @encode  =  {}.merge( encode || {} )
+        @decode  =  {}.merge( decode || {} )
+
+        load_overlay( DEFAULT_MASK )
+      end
+
+      # load configuration.
+      def load( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+
+        self[section].clear
+        load_overlay( section + DEFAULT_SUFFIX )
+      end
+
+      # load configuration.
+      def load_overlay( filename )
+        @paths.each do |path|
+          begin
+            dirname  =  ::File.expand_path( path )
+            if  ::Dir.exist?( dirname )
+              ::Dir.glob( "#{ dirname }/#{ filename }" ) do |pathname|
+                text  =  ::File.open( pathname ).read    rescue  raise( ArgumentError, "could not load #{ pathname }" )
+                hash  =  eval( text )
+                self.deeply_merge!( hash )
+              end
+            end
+          rescue => e
+            STDERR.puts e.message
+          end
+        end
+      end
+
+      # save configuration.
+      def save( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+        pathname  =  savepathname(section)
+        hash  =  { section => self[section] }.deeply_stringify_keys
+        ::File.open( pathname, "w" ) do |file|
+          file.puts( hash.pretty_inspect )
+        end
+      end
+
+      # remove and load configuration.
+      def reset( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+
+        pathname  =  savepathname(section)
+        ::FileUtils.remove( pathname )    if ::File.exist?( pathname )
+        load( section )
+      end
+
+      def savepathname( section )
+        ::File.join( @vardir, section + DEFAULT_SUFFIX )
+      end
+
+    end
+  end
+end
+

data/lib/app/config/version.rb

@@ -0,0 +1,5 @@
+module App
+  module Config
+    VERSION = "0.1.0"
+  end
+end

data/lib/app/config/yaml.rb

@@ -0,0 +1,89 @@
+require  "fileutils"
+require  "erb"
+require  "yaml"
+
+module App
+  module Config
+
+    class YAML < ::Hash
+      DEFAULT_MASK  =  "*.{yml,yaml}"
+      DEFAULT_SUFFIX  =  ".yaml"
+
+      def initialize( **opts )
+        self.default_proc  =  proc do |hash, key|
+          hash[key]  =  {}
+        end
+        reload( **opts )
+      end
+
+      # bulk load configuration in search paths.
+      def reload( root: nil, path: nil, encode: nil, decode: nil )
+        clear
+        @root  =  root || Dir.pwd
+        @paths  =  ( path || DEFAULT_PATH ).gsub('$ROOT', @root).split(':')
+        @paths  =  @paths.map{|it| !it.nil? && !it.empty? ? it : nil}.compact
+        @paths  <<  "."    if @paths.empty?
+
+        @vardir  =  @paths.last
+        Dir.mkdir( @vardir )    unless ::Dir.exist?( @vardir )
+
+        @encode  =  {}.merge( encode || {} )
+        @decode  =  {}.merge( decode || {} )
+
+        load_overlay( DEFAULT_MASK )
+      end
+
+      # load configuration.
+      def load( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+
+        self[section].clear
+        load_overlay( section + DEFAULT_SUFFIX )
+      end
+
+      # load configuration.
+      def load_overlay( filename )
+        @paths.each do |path|
+          begin
+            dirname  =  ::File.expand_path( path )
+            if  ::Dir.exist?( dirname )
+              ::Dir.glob( "#{ dirname }/#{ filename }" ) do |pathname|
+                text  =  ::File.open( pathname ).read    rescue  raise( ArgumentError, "could not load #{ pathname }" )
+                yaml  =  ::ERB.new( text ).result        rescue  raise( ArgumentError, "could not parse by ERB: #{ pathname }" )
+                hash  =  ::YAML.load( yaml, **@decode )
+                self.deeply_merge!( hash )
+              end
+            end
+          rescue => e
+            STDERR.puts e.message
+          end
+        end
+      end
+
+      # save configuration.
+      def save( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+        pathname  =  savepathname(section)
+        hash  =  { section => self[section] }.deeply_stringify_keys
+        ::File.open( pathname, "w" ) do |file|
+          file.puts( ::YAML.dump( hash, **@encode ) )
+        end
+      end
+
+      # remove and load configuration.
+      def reset( section )
+        raise  ArgumentError, "'#{ section }' is not String."    unless  String === section
+
+        pathname  =  savepathname(section)
+        ::FileUtils.remove( pathname )    if ::File.exist?( pathname )
+        load( section )
+      end
+
+      def savepathname( section )
+        ::File.join( @vardir, section + DEFAULT_SUFFIX )
+      end
+
+    end
+  end
+end
+

data/sample/sample_1.rb

@@ -0,0 +1,24 @@
+require  "app/config"
+
+path  =  "$ROOT/config/defaults/:$ROOT/config:$ROOT/var"
+
+# initialize variation
+
+pp config  =  App::Config.new
+pp config  =  App::Config.new( root: Dir.pwd )
+pp config  =  App::Config.new( path: path )
+
+pp config  =  App::Config.new( :YAML )
+pp config  =  App::Config.new( "YAML" )
+pp config  =  App::Config.new( :YAML, path: path )
+pp config  =  App::Config.new( "YAML", path: path )
+pp config  =  App::Config::YAML.new
+pp config  =  App::Config::YAML.new( path: path )
+
+pp config  =  App::Config.new( :JSON )
+pp config  =  App::Config.new( "JSON" )
+pp config  =  App::Config.new( :JSON, path: path )
+pp config  =  App::Config.new( "JSON", path: path )
+pp config  =  App::Config::JSON.new
+pp config  =  App::Config::JSON.new( path: path )
+

data/sample/sample_2.rb

@@ -0,0 +1,20 @@
+require  "app/config"
+
+path  =  "$ROOT/config/defaults/:$ROOT/config:$ROOT/var"
+
+type  =  ARGV.shift || :YAML
+config  =  App::Config.new(type)
+
+pp config.class
+pp config.keys
+pp config
+
+config.reload
+config.reload( path: path )
+config.load("section")
+
+value  =  config["section"]["seqn"].to_i
+p ["seqn", value]
+config["section"]["seqn"]  =  value + 1
+config.save("section")
+

data/sample/sample_3.rb

@@ -0,0 +1,21 @@
+require  "app/config"
+require  "time"
+
+type  =  ARGV.shift || :YAML
+
+# initialize object, load and merge all sections.
+config  =  App::Config.new(type)
+
+# save section
+config["status"]["lastdate"]  =  Time.now.iso8601(3)
+config.save("status")
+
+# show section
+pp config["status"]
+
+# debug print
+Dir.glob("var/*.#{type.to_s.downcase}") do |pathname|
+  p  pathname
+  puts  open(pathname).read
+end
+

data/sample/sample_4.rb

@@ -0,0 +1,10 @@
+require  "app/config"
+
+type  =  ARGV.shift || :YAML
+
+# initialize object, load and merge all sections.
+config  =  App::Config.new(type)
+
+# remove and reload section
+config.reset("status")
+

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: app-configs
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- arimay
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-10-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '12.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: " Yet another library for load/save app config files. "
+email:
+- arima.yasuhiro@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.adoc
+- README.ja.adoc
+- Rakefile
+- app-configs.gemspec
+- bin/console
+- bin/setup
+- config/app.json
+- config/app.rb
+- config/app.yaml
+- lib/app/config.rb
+- lib/app/config/base.rb
+- lib/app/config/deeply.rb
+- lib/app/config/json.rb
+- lib/app/config/ruby.rb
+- lib/app/config/version.rb
+- lib/app/config/yaml.rb
+- sample/sample_1.rb
+- sample/sample_2.rb
+- sample/sample_3.rb
+- sample/sample_4.rb
+homepage: https://github.com/arimay/app-configs
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Application config loader/saver.
+test_files: []