strada 0.0.1 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d79487b0f3611692c622efcdb8c4eb7114b313f7f65b5683e4a9a772b7d5294f
-  data.tar.gz: 5a3447b412eea2ab0e8db8520aa0c845a994221445e55ee2af7ce45009927a79
+  metadata.gz: 01c182cd152dc864606ef204f15b86d5770d214b305d760f508e721f74a491a3
+  data.tar.gz: 57bf00a4987bb3f4b2022c2797c7281315c1a160fbb97633008d77880ee91b3e
 SHA512:
-  metadata.gz: 19b6eeabb5287a7a260dc821e979e5b10669aac42b2423aa4e23e3ad2ee93b33e0e96db98ae559ac9c9a0ad8d6997a498f1750cc47b9d25ae5fd8acc56212256
-  data.tar.gz: 8d4e2b5e207db3bb4676aca93a7d0e48025aba2a61e5d6e63778ef3d99c8bda74e0a9a2fe90beaccbfa58e55c07c403e81a74b3fdbfccd3a876fa3bec3a52e1b
+  metadata.gz: 9626789a1430f15384df5d926b20402bbf806127c8fdc4bbe02de8f44fa6889132ff00cafb8afbf89623fc4a28b77c5b1ea8a4c4dbf119f2f9a681fd68d1b132
+  data.tar.gz: 1461a09fb18ea04770d282cf9f2df8c0e0d3b2d2c12b9a9344c6b9831c4cab61ba2db66665710ab18fdbaa134364973d05e190cd2df1d95561b00f41329c044a

data/.idea/.gitignore

@@ -0,0 +1,8 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

data/.idea/dictionaries

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectDictionaryState">
+    <dictionary name="careline" />
+  </component>
+</project>

data/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MarkdownSettingsMigration">
+    <option name="stateVersion" value="1" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="RVM: ruby-3.1.0" project-jdk-type="RUBY_SDK" />
+</project>

data/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/strada.iml" filepath="$PROJECT_DIR$/.idea/strada.iml" />
+    </modules>
+  </component>
+</project>

data/.idea/strada.iml

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="ModuleRunConfigurationManager">
+    <shared />
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/features" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="activesupport (v7.0.2.3, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ast (v2.4.2, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v2.3.7, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="concurrent-ruby (v1.1.10, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="i18n (v1.10.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v5.15.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parallel (v1.22.1, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="parser (v3.1.2.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rack (v2.2.3, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rainbow (v3.1.1, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v13.0.6, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="regexp_parser (v2.3.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rexml (v3.2.5, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop (v1.27.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-ast (v1.17.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-minitest (v0.19.1, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-packaging (v0.5.1, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-performance (v1.13.3, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rubocop-rails (v2.14.2, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="ruby-progressbar (v1.11.0, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tzinfo (v2.0.4, RVM: ruby-3.1.0) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="unicode-display_width (v2.1.0, RVM: ruby-3.1.0) [gem]" level="application" />
+  </component>
+  <component name="RakeTasksCache">
+    <option name="myRootTask">
+      <RakeTaskImpl id="rake" />
+    </option>
+  </component>
+</module>

data/.idea/vagrant.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VagrantProjectSettings">
+    <option name="instanceFolder" value="" />
+    <option name="provider" value="" />
+  </component>
+</project>

data/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

data/README.md

@@ -1,59 +1,76 @@
 # Strada
-Configuration library for ruby with YAML/JSON/TOML backends with unified object
-access
+
+Configuration library for ruby with YAML/JSON/TOML backends with unified object access
 
 ## Install
-```
- % gem install Strada
+
+```shell
+ % gem install strada
 ```
 
 ## Use
+
 ### Simple
-```
-require 'Strada'
+
+```ruby
+require 'strada'
+require 'pp'
 cfg  = Strada.cfg
+# print cfg datastructure
+PP.pp cfg
+
 port = cfg.server.port
 user = cfg.auth.user
 pw   = cfg.auth.password
+
+PP.pp cfg
 ```
+
 It tried to detect your software name via caller_locations if no ':name'
 argument was given.
 It automatically loads /etc/name/config and ~/.config/name/config and merges
 them together.
 
 ### Advanced
-```
-require 'Strada'
+
+```ruby
+require 'strada'
+
 Strada = Strada.new name:    'mykewlapp',
-                    default: {'poop'=>'xyzzy'},
+                    default: { 'poop' => 'xyzzy' },
                     adapter: 'yaml',
                     usrdir:  '/home/app/config/',
                     sysdir:  '/System/config/',
                     load:    false
-Strada.default.poop2 = [1, 2, 3, 4]
+
+Strada.default.poop2            = [1, 2, 3, 4]
 Strada.default.starship.poopers = 42
 Strada.load :user
+
 if Strada.user.empty?
   Strada.user = Strada.default
   Strada.save :user
 end
-Strada.load    # load+merges cfg, takes argument :default, :system, :user
-Strada.cfg     # merged default + system + user  (merged on load)
+
+Strada.load # load+merges cfg, takes argument :default, :system, :user
+Strada.cfg # merged default + system + user  (merged on load)
 Strada.default # default only
-Strada.system  # system only
-Strada.user    # user only
+Strada.system # system only
+Strada.user # user only
 ```
 
 ## Reserved methods
 
-* each           - iterate all config keys in current level
+* each - iterate all config keys in current level
 * has_key?(arg)  - check if current level has key arg
 * [arg]          - fetch arg (useful for non-literal retrieval, instead of using #send)
-* key?           - all keys have question mark version reserved, checks if key exists+true (true), exists+false (false), not-exists (nil)
+* key? - all keys have question mark version reserved, checks if key exists+true (true), exists+false (false),
+  not-exists (nil)
+
 + all object class methods
 
 ## TODO
 
-  * should I add feature to raise on unconfigured/unset?
-  * should I always merge to 'cfg' when default/system/config is set?
+* should I add feature to raise on unconfigured/unset?
+* should I always merge to 'cfg' when default/system/config is set?
   

data/lib/strada/adapter/json.rb

@@ -13,13 +13,14 @@ class Strada
     class JSON
       # 定义类方法
       class << self
-        require "json"
         # 将 RUBY(HASH) 数据结构转换为 JSON
         def to(hash)
+          require "json"
           ::JSON.pretty_generate hash
         end
         # 将 JSON 转换为 RUBY 数据结构
         def from(json)
+          require "json"
           ::JSON.load json
         end
       end

data/lib/strada/adapter/toml.rb

@@ -13,14 +13,14 @@ class Strada
     class TOML
       # 定义类方法
       class << self
-        require "toml"
-
         # 将 RUBY(HASH) 数据结构转换为 TOML
         def to(hash)
+          require "toml"
           ::TOML::Generator.new(hash).body
         end
         # 将 TOML 转换为 RUBY 数据结构
         def from(toml)
+          require "toml"
           ::TOML.load toml
         end
       end

data/lib/strada/adapter/yaml.rb

@@ -13,14 +13,14 @@ class Strada
     class YAML
       # 定义类方法
       class << self
-        require "yaml"
-
         # 将 RUBY(HASH) 数据结构转换为 YAML
         def to(hash)
+          require "yaml"
           ::YAML.dump hash
         end
         # 将 YAML 转换为 RUBY(HASH) 数据结构
         def from(yaml)
+          require "yaml"
           ::YAML.load yaml
         end
       end

data/lib/strada/config_struct.rb

@@ -2,6 +2,39 @@
 
 class Strada
   class ConfigStruct
+    # 类对象初始化函数入口
+    def initialize(hash = nil, opts = {})
+      @key_to_s = opts.delete(:key_to_s) || false
+      @cfg      = hash ? _config_from_hash(hash) : {}
+    end
+
+    # 方法反射
+    def method_missing(name, *args, &block)
+      name = name.to_s
+      # 检索 ConfigStruct 键值对
+      # strada.cfg['foo']
+      name = args.shift if name[0..1] == "[]"
+      arg  = args.first
+
+      if name[-1..-1] == "?"
+        # 查询是否包含某个 KEY
+        # strada.cfg.foo.bar?
+        if @cfg.has_key? name[0..-2]
+          @cfg[name[0..-2]]
+        else
+          nil
+        end
+      elsif name[-1..-1] == "="
+        # strada.cfg.foo.bar = 'bala'
+        # ConfigStruct 键值对赋值
+        _config_set name[0..-2], arg
+      else
+        # strada.cfg.foo.bar
+        # ConfigStruct 查询某个属性
+        _config_get name, arg
+      end
+    end
+
     # 将配置信息转换为 HASH 对象
     def _config_to_hash
       hash = {}
@@ -9,7 +42,9 @@ class Strada
         if value.class == ConfigStruct
           value = value._config_to_hash
         end
-        key       = key.to_s if @key_to_s
+        # 是否需要将 key 转为 to_s
+        key = key.to_s if @key_to_s
+        # 保存键值对数据到 HASH
         hash[key] = value
       end
       hash
@@ -36,37 +71,13 @@ class Strada
     end
 
     private
-      def initialize(hash = nil, opts = {})
-        @key_to_s = opts.delete :key_to_s
-        @cfg      = hash ? _config_from_hash(hash) : {}
-      end
-
-      # 方法反射
-      def method_missing(name, *args, &block)
-        name = name.to_s
-        name = args.shift if name[0..1] == "[]" # strada.cfg['foo']
-        arg  = args.first
-
-        if name[-1..-1] == "?" # strada.cfg.foo.bar?
-          if @cfg.has_key? name[0..-2]
-            @cfg[name[0..-2]]
-          else
-            nil
-          end
-        elsif name[-1..-1] == "=" # strada.cfg.foo.bar = 'quux'
-          _config_set name[0..-2], arg
-        else
-          _config_get name, arg # strada.cfg.foo.bar
-        end
-      end
-
-      # 设置键值对
       def _config_set(key, value)
+        # 设置键值对
         @cfg[key] = value
       end
 
-      # 查询 KEY VALUE
       def _config_get(key, value)
+        # 查询 KEY VALUE
         if @cfg.has_key? key
           @cfg[key]
         else
@@ -74,8 +85,8 @@ class Strada
         end
       end
 
-      # 转换 HASH 数据为配置对象
       def _config_from_hash(hash)
+        # 转换 HASH 数据为配置对象
         cfg = {}
         hash.each do |key, value|
           if value.class == Hash

data/lib/strada/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Strada
-  VERSION = "0.0.1"
+  VERSION = "0.0.4"
 end

data/lib/strada.rb

@@ -6,11 +6,11 @@ require_relative "strada/adapter/json"
 require_relative "strada/adapter/toml"
 require "fileutils"
 
-class Strada < StandardError; end
+class StradaError < StandardError; end
 
-class NoName < ConfigError; end
+class NoName < StradaError; end
 
-class UnknownOption < ConfigError; end
+class UnknownOption < StradaError; end
 
 # @example common use case
 #   CFGS = Strada.new :name=>'my_sweet_program' :load=>false   # do not load config from filesystem
@@ -28,11 +28,6 @@ class UnknownOption < ConfigError; end
 #   ssh_hosts = CFG.ssh.hosts
 
 class Strada
-  CONFIG_FILE = "config"
-  # 类对象属性
-  attr_reader :cfg, :default, :file
-  attr_accessor :system, :user
-
   # 类方法
   class << self
     def cfg(*args)
@@ -40,6 +35,42 @@ class Strada
     end
   end
 
+  # 类变量 - 常量，配置保存文件名
+  CONFIG_FILE = "config"
+
+  # 类对象属性
+  attr_reader :cfg, :default, :file, :usr_dir, :sys_dir
+  attr_accessor :system, :user
+
+  # 类对象实例化函数入口
+  def initialize(opts = {})
+    # @param [Hash] opts options for Strada.new
+    # @option opts [String]  :name     name to use for strada (/etc/name/, ~/.config/name/) - autodetected if not defined
+    # @option opts [String]  :adapter  adapter to use 'yaml', 'json' or 'toml' for now
+    # @option opts [String]  :usr_dir   directory for storing user config ~/.config/name/ by default
+    # @option opts [String]  :sys_dir   directory for storing system config /etc/name/ by default
+    # @option opts [String]  :cfg_file  configuration filename, by default CONFIG_FILE
+    # @option opts [Hash]    :default  default settings to use
+    # @option opts [boolean] :load     automatically load+merge system+user config with defaults in #cfg
+    # @option opts [boolean] :key_to_s convert keys to string by calling #to_s for keys
+    @name     = opts.delete(:name) || meta_name
+    @adapter  = opts.delete(:adapter) || "yaml"
+    @usr_dir  = opts.delete(:usr_dir) || File.join(Dir.home, ".config", @name)
+    @sys_dir  = opts.delete(:sys_dir) || File.join("/etc", @name)
+    @cfg_file = opts.delete(:cfg_file) || CONFIG_FILE
+
+    # 配置对象属性
+    @default  = ConfigStruct.new opts.delete(:default)
+    @system   = ConfigStruct.new
+    @user     = ConfigStruct.new
+    @cfg      = ConfigStruct.new
+    @load     = true
+    @load     = opts.delete(:load) if opts.has_key?(:load)
+    @key_to_s = opts.delete(:key_to_s)
+    raise UnknownOption, "option '#{opts}' not recognized" unless opts.empty?
+    load :all if @load
+  end
+
   # When this is called, by default :system and :user are loaded from
   # filesystem and merged with default, so that user overrides system which
   # overrides default
@@ -78,8 +109,8 @@ class Strada
   # @option opts [boolean] :load         load config once saved, by default false
   # @return [boolean] true if config didn't exist and was created, false if config already exists
   def create(opts = {})
-    src = opts.delete :source || :default
-    dst = opts.delete :destination || :user
+    src = opts.delete(:source) || :default
+    dst = opts.delete(:destination) || :user
 
     no_config = false
     no_config = true if @system.empty? && @user.empty?
@@ -87,40 +118,12 @@ class Strada
       src = instance_variable_get "@" + src.to_s
       instance_variable_set("@" + dst.to_s, src.dup)
       save dst
-      load if opts.delete :load
+      load if opts.delete(:load)
     end
     no_config
   end
 
   private
-    def initialize(opts = {})
-      # @param [Hash] opts options for Strada.new
-      # @option opts [String]  :name     name to use for strada (/etc/name/, ~/.config/name/) - autodetected if not defined
-      # @option opts [String]  :adapter  adapter to use 'yaml', 'json' or 'toml' for now
-      # @option opts [String]  :usr_dir   directory for storing user config ~/.config/name/ by default
-      # @option opts [String]  :sys_dir   directory for storing system config /etc/name/ by default
-      # @option opts [String]  :cfg_file  configuration filename, by default CONFIG_FILE
-      # @option opts [Hash]    :default  default settings to use
-      # @option opts [boolean] :load     automatically load+merge system+user config with defaults in #cfg
-      # @option opts [boolean] :key_to_s convert keys to string by calling #to_s for keys
-      @name     = opts.delete(:name) || meta_name
-      @adapter  = opts.delete(:adapter) || "yaml"
-      @usr_dir  = opts.delete(:usr_dir) || File.join(Dir.home, ".config", @name)
-      @sys_dir  = opts.delete(:sys_dir) || File.join("/etc", @name)
-      @cfg_file = opts.delete(:cfg_file) || CONFIG_FILE
-
-      # 配置对象属性
-      @default  = ConfigStruct.new opts.delete(:default)
-      @system   = ConfigStruct.new
-      @user     = ConfigStruct.new
-      @cfg      = ConfigStruct.new
-      @load     = true
-      @load     = opts.delete(:load) if opts.has_key?(:load)
-      @key_to_s = opts.delete(:key_to_s)
-      raise UnknownOption, "option '#{opts}' not recognized" unless opts.empty?
-      load :all if @load
-    end
-
     # 加载配置文件
     def load_cfg(dir)
       @file = File.join dir, @cfg_file
@@ -134,7 +137,9 @@ class Strada
     def save_cfg(dir, config)
       config = to(@adapter, config)
       file   = File.join dir, @cfg_file
-      FileUtils.mkdir_p dir
+
+      # 判断目标文件夹是否存在，不存在则新建
+      FileUtils.mkdir_p dir unless Dir.exist? dir
       File.write file, config
     end
 
@@ -143,7 +148,7 @@ class Strada
       hash = {}
       # 将相关配置依次迭代并转换为 RUBY HASH 对象
       configs.each do |config|
-        hash = hash._config_deep_merge config._config_to_hash
+        hash = hash._config_deep_merge(config._config_to_hash)
       end
       # 将合并后的 HASH 数据结构转换为配置对象
       ConfigStruct.new hash
@@ -174,7 +179,7 @@ end
 class Hash
   def _config_deep_merge(new_hash)
     merger = proc do |key, old_val, new_val|
-      Hash === old_val && Hash === new_val ? old_val.merge(new_val, &merger) : new_val
+      (Hash === old_val && Hash === new_val) ? old_val.merge(new_val, &merger) : new_val
     end
     merge new_hash, &merger
   end

data/strada.gemspec

@@ -7,11 +7,10 @@ Gem::Specification.new do |s|
   s.licenses     = ["MIT"]
   s.platform     = Gem::Platform::RUBY
   s.authors      = ["WENWU.YAN"]
-  s.email        = %w( 968826@gmail.com )
+  s.email        = "968826@gmail.com"
   s.homepage     = "http://github.com/ciscolive/strada"
   s.summary      = "configuration library"
   s.description  = "configuration library with object access to YAML/JSON/TOML backends"
   s.files        = `git ls-files`.split("\n")
-  s.executables  = %w(  )
   s.require_path = "lib"
 end

metadata

@@ -1,23 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: strada
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.4
 platform: ruby
 authors:
 - WENWU.YAN
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-14 00:00:00.000000000 Z
+date: 2022-04-17 00:00:00.000000000 Z
 dependencies: []
 description: configuration library with object access to YAML/JSON/TOML backends
-email:
-- 968826@gmail.com
+email: 968826@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".idea/.gitignore"
+- ".idea/dictionaries"
+- ".idea/misc.xml"
+- ".idea/modules.xml"
+- ".idea/strada.iml"
+- ".idea/vagrant.xml"
+- ".idea/vcs.xml"
 - ".rubocop.yml"
 - Gemfile
 - README.md