sting 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1b4cb2c0a668bf879e98ac401f7419678288949857b8ed055daf23a41cc6b7e7
-  data.tar.gz: e3c52cd17082f8cd7ce774aaa404ec1bc87091f09d3d5b5223d8e8fb70377b4c
+  metadata.gz: 271132274baa28e3ded663cbd4abda0b371b948cdc71b2a6b1cd6a9e0dd444aa
+  data.tar.gz: 424dc73b1871a68e87f0206b354a40995f9fef20a9b35892d0ec71102f293c0c
 SHA512:
-  metadata.gz: 00dd281cbc65ec4365686ae4137c011397a18f1e12bef0bea99ae46d63a119d9f30063f3601de1ddc294cfe921808df515ad1d58454eba14e027413dc56dd044
-  data.tar.gz: ae1d6134e99010e99d9a06a836b28db0429c23236fcbb1ca614cfa1a06582825af0e728bfba7d28c265a9408b79984392e81f9ddaa12e89bb97f43c1d33cbbf9
+  metadata.gz: aa0836070e5db815867796c726b4e3eea387d9f3fd859ecb17abe770d224994142c478295f4340eeecb5f42e89a39f3dbd18374ca4b76f50d361675930704093
+  data.tar.gz: ba50fce961c36bee99fbbc05b8ab06dcbda5112d26d04a14f0320df572fdba9791f062d9cc7bd6cb25ad72f9de40f2dd8f231d5266efd3a4cce0636c308f033e

data/README.md

@@ -33,6 +33,7 @@ Features
 
 - [Aggressively minimalistic][1], no dependencies, no monkey-patching, no magic.
 - Settings are accessible through a globally available class.
+- Can be used either as a singleton class or as an instance.
 - Load and merge one or more YAML files or hashes.
 - Settings objects are standard ruby hashes, arrays and basic types.
 - Ability to update settings at runtime.
@@ -43,7 +44,7 @@ Nonfeatures
 --------------------------------------------------
 
 - No dot notation access to nested values - Use `Settings.server['host']` 
-  instead of `Settings.server.host` - to avoid having to monkey-patch hashes.
+  instead of `Settings.server.host`.
 - No special generators for Rails. 
   [Usage with rails is still trivial](#using-with-rails).
 
@@ -51,6 +52,8 @@ Nonfeatures
 Usage
 --------------------------------------------------
 
+### Using as a singleton class
+
 ```ruby
 require 'sting'
 
@@ -62,6 +65,11 @@ Settings = Sting
 Settings << 'one'
 Settings << 'two.yml'
 
+# Adding additional files can also be done with `#push`. These two are the 
+# same.
+Settings << 'one'
+Settings.push 'one'
+
 # Merge with another options hash
 Settings << { port: 3000, host: 'localhost' }
 
@@ -92,6 +100,23 @@ Settings.port = 3000
 Settings.reset!
 ```
 
+### Using as an instance
+
+All the above operations are also available to instances of `Sting`.
+
+```ruby
+require 'sting'
+
+# Create an instance.
+config = Sting.new
+
+# Or, create an instance, and provide the first source file to it.
+config = Sting.new 'settings'
+
+# Load additional YAML files. 
+config << 'local_settings'
+```
+
 
 Using with Rails
 --------------------------------------------------
@@ -122,4 +147,4 @@ Create four config files:
 - config/settings/**test**.yml
 
 
-[1]: https://github.com/DannyBen/sting/blob/master/lib/sting.rb
+[1]: https://github.com/DannyBen/sting/blob/master/lib/sting/sting_operations.rb

data/lib/sting/sting_operations.rb

@@ -0,0 +1,70 @@
+require 'yaml'
+require 'erb'
+
+class Sting
+  module StingOperations
+    def initialize(source = nil)
+      self << source if source
+    end
+
+    def <<(source)
+      if source.is_a? Hash
+        content = source.collect{ |k,v| [k.to_s, v] }.to_h
+      else
+        source = "#{source}.yml" unless source =~ /\.ya?ml$/
+        content = File.read source
+        content = YAML.load(ERB.new(content).result)
+      end
+      settings.merge! content if content
+    end
+    alias_method :push, :<<
+
+    def [](key)
+      settings[key.to_s]
+    end
+
+    def method_missing(name, *args, &blk)
+      name = name.to_s
+      return settings[name] if has_key? name
+
+      suffix = nil
+
+      if name.end_with? *['=', '!', '?']
+        suffix = name[-1]
+        name = name[0..-2]
+      end
+
+      case suffix
+      when "="
+        settings[name] = args.first
+
+      when "?"
+        !!settings[name]
+
+      when "!"
+        if has_key? name
+          return settings[name]
+        else
+          raise ArgumentError, "Key '#{name}' does not exist"
+        end
+
+      else
+        nil
+
+      end
+
+    end
+
+    def settings
+      @settings ||= {}
+    end
+
+    def reset!
+      @settings = nil
+    end
+
+    def has_key?(key)
+      settings.has_key? key.to_s
+    end
+  end
+end

data/lib/sting/version.rb

@@ -1,3 +1,3 @@
 class Sting
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/lib/sting.rb

@@ -1,65 +1,11 @@
 require 'yaml'
 require 'erb'
+require 'sting/sting_operations'
 
 class Sting
-  class << self
-    def <<(source)
-      if source.is_a? Hash
-        content = source.collect{ |k,v| [k.to_s, v] }.to_h
-      else
-        source = "#{source}.yml" unless source =~ /\.ya?ml$/
-        content = File.read source
-        content = YAML.load(ERB.new(content).result)
-      end
-      settings.merge! content if content
-    end
-
-    def [](key)
-      settings[key.to_s]
-    end
-
-    def method_missing(name, *args, &blk)
-      name = name.to_s
-      return settings[name] if has_key? name
-
-      suffix = nil
-
-      if name.end_with? *['=', '!', '?']
-        suffix = name[-1]
-        name = name[0..-2]
-      end
-
-      case suffix
-      when "="
-        settings[name] = args.first
-
-      when "?"
-        !!settings[name]
+  include StingOperations
 
-      when "!"
-        if has_key? name
-          return settings[name]
-        else
-          raise ArgumentError, "Key '#{name}' does not exist"
-        end
-
-      else
-        nil
-
-      end
-
-    end
-
-    def settings
-      @settings ||= {}
-    end
-
-    def reset!
-      @settings = nil
-    end
-
-    def has_key?(key)
-      settings.has_key? key.to_s
-    end
+  class << self
+    include StingOperations
   end
 end

metadata

@@ -1,99 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: sting
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Danny Ben Shitrit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-07-04 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: byebug
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '10.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.6'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.6'
-- !ruby/object:Gem::Dependency
-  name: rspec_fixtures
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.3'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.3'
-- !ruby/object:Gem::Dependency
-  name: runfile
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.10'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.10'
-- !ruby/object:Gem::Dependency
-  name: runfile-tasks
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.4'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.4'
-- !ruby/object:Gem::Dependency
-  name: simplecov
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.15'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.15'
+date: 2019-01-05 00:00:00.000000000 Z
+dependencies: []
 description: Minimal, lightweight, multi-YAML settings
 email: db@dannyben.com
 executables: []
@@ -102,6 +18,7 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/sting.rb
+- lib/sting/sting_operations.rb
 - lib/sting/version.rb
 homepage: https://github.com/dannyben/sting
 licenses: