tiny_dot 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a504ee11ac88fe637eda112ecb1a4f85cc8de98e652962666ecbd808c091837d
+  data.tar.gz: e43d65b6e60f61bb02476e40d3dfb9f28ef0651d5b0d984f6dad63d7579fbdf8
+SHA512:
+  metadata.gz: 752a76684804dec7a794d87bc444d7805c04bfd43b2a1cc67ed8818fca219753df8b07015912b9e8088938b0283264615fd1b48d1923604e763a22384c876488
+  data.tar.gz: aba04b5338a31643d859acbeefb456cd868959ecab8f3b7fa6c3744afa85b3deb112518351320ee90d66cb932df18b86fa1725ef0593d51a06ea09cdb44dbcff

data/lib/tiny_dot.rb

@@ -0,0 +1,63 @@
+require 'yaml'
+require 'json'
+
+# this class gives you read-only access to Hases, JSON, and YAML files using
+# dot notation. it makes clever use of #method_missing to allow you to do the
+# following:
+#
+#   > t = TinyDot.new({ 'foo' => { 'bar' => 'baz' }})
+#   > t.foo                                               # returns another instance of TinyDot
+#  => #<TinyDot:0x0201243 @data={ 'bar' => 'baz' }>
+#   > t.foo!                                              # ! returns the value under the chain of keys
+#  => { 'bar' => 'baz' }
+#
+# ... in other words, it gives you a convenient dot notation syntax for
+# accessing nested hashes. you can chain calls to this and you'll get a new
+# object that's essentially a #dig into the top-level hash.
+#
+# if you add '!' to the last method in a chain it will return the value under
+# that key.
+#
+# finally, you can use dot syntax as deep as you want, and if there's no key at
+# that level you'll just get `nil' back:
+#
+#   > t.foo.bar.baz.whatever.as.deep.as.you.want
+#  => nil
+#
+# ... which is sort of safe navigation operator-like without the save
+# navigation operator
+class TinyDot
+  # returns a TinyDot instance after parsing the YAML in the named filename
+  def self.from_yaml_file(filename)
+    TinyDot.new(YAML.safe_load_file(filename))
+  end
+
+  # returns a TinyDot instance after parsing the JSON in the named filename
+  def self.from_json_file(filename)
+    TinyDot.new(JSON.parse(IO.read(filename)))
+  end
+
+  # give it a Hash and it'll give you dot notation over it
+  def initialize(hash)
+    @data = hash
+  end
+
+  def method_missing(m)
+    ms = m.to_s
+
+    case @data
+    when Hash
+      if ms.end_with?('!')
+        @data[ms[0..-2]]
+      else
+        if @data.has_key?(ms)
+          TinyDot.new(@data[ms])
+        else
+          TinyDot.new({})
+        end
+      end
+    else
+      TinyDot.new({})
+    end
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: tiny_dot
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jeff Lunt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-11-18 00:00:00.000000000 Z
+dependencies: []
+description: a tiny read-only, dot notation wrapper for Hash, JSON, and YAML
+email: jefflunt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/tiny_dot.rb
+homepage: https://github.com/jefflunt/tiny_dot
+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.0.3.1
+signing_key: 
+specification_version: 4
+summary: want to have easy dot notation access to data that comes from Hashes, JSON,
+  and YAML - and absolutely nothing else? then this is the library for you.
+test_files: []