pears 0.0.6 → 0.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 645ae89efe6ddeadbdad1d0e7a7e5688c58b62a747048b541b94ef10e9f2026a
-  data.tar.gz: 3baa65f99f31f0229de5c500c5dcc373532fe793453c29f4ab5ae978de43f4a6
+  metadata.gz: 40970c145a4cb29cc549b0534c7ced74e799fab7745f153562b579c966c4bb19
+  data.tar.gz: a91ba1e130712c40d9d97f3c6fb21ebe562982bc370284988f8033e999a1d111
 SHA512:
-  metadata.gz: 57dc635116560ce42ad9c71e9f23134f61ae25040f59d0edc1ebfbef9654dd18305f4c49e86b5026a312c7a79237e49b48233fb564063d82d2bdef44e1d73c7e
-  data.tar.gz: 3897e7f03640897df2aa77709fc2fb494ec9eab1c4bf1642f89d25adf99d86605c9793314c9c94ace252293bc9fa484b2d65297a1662eefbd31cfc95b5b1e184
+  metadata.gz: 30515f3509a1c6832247fcf5c444881c28a87f442cacee341d84a75dc20117722fe2029561d8685b09592c2a84f38351cbfcce24a50d5a91a9dbe62d1b69a107
+  data.tar.gz: 367c680e08109add0b2f7c13dc1bb3c24cb6aaa1d817873cfa863eead5b5d5f6ff10e887c6ddb861ae85135a0ef08829cfcbea1695c799097431205ab2c62b90

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pears (0.0.6)
+    pears (0.0.8)
       activesupport
       dry-configurable (>= 0.13.0)
       redis
@@ -47,6 +47,7 @@ GEM
 
 PLATFORMS
   arm64-darwin-20
+  ruby
 
 DEPENDENCIES
   byebug

data/README.md

@@ -22,7 +22,31 @@ Or install it yourself as:
 
 ## Usage
 
-Configuration is loaded via the provider setting.
+Examples:
+
+```ruby
+# You can load a dynamic config file like this
+dynamic_config = Pears.subject(:settings) do |provider|
+  provider.subscription do
+    provider.remote_file "https://raw.githubusercontent.com/codefresh-io/yaml-examples/master/codefresh-build-1.yml"
+  end
+end
+
+# You can "Cascade" data like this
+cascading_config = Pears.subject(:settings) do |provider|
+  provider.local_file Rails.root.join('config', 'settings.concrete.yml') # defines foo: 'foo'
+  provider.local_file Rails.root.join('config', 'settings.default.yml') # defines foo: 'bar', baz: 'baz'
+end
+
+cascading_config[:foo] # => foo
+cascading_config[:baz] # => baz
+
+# And you can combine these
+combined_config = Pears.subject(:settings) do |provider|
+  provider.subscription { provider.remote_file "https://admin/configuration.yml" }
+  provider.local_file Rails.root.join('config', 'default.yml')
+end
+```
 
 
 ## Terminology
@@ -37,20 +61,40 @@ Configuration is loaded via the provider setting.
 - LocalFile - read a yaml file identified by a path into a "Subject"
 - RemoteFile - read a yaml file identified by a URI into a "Subject"
 - Subscription - Read a yaml file identified by a URI as a segment and update it whenever the the provided redis channel gets an update.
-- ENV - read the ENV and overwrite keys found on lower layers of the segment. **
-- LOCO - read a loco file into a segment. **
 
-** Nice to have
+You can create a custom povider like this:
+
+```ruby
+class GcloudProvider < Pears::Provider::LocalFile
+  def initialize
+    @data = parse_yaml Faraday.get(url, {}, authorization: token )
+  end
+
+  private
+
+  def url
+    'https://velogica-portal-admin.ey.r.appspot.com/settings/' \
+    "#{Rails.application.secrets.settings_file}"
+  end
+
+  def token
+    path = 'http://metadata.google.internal/computeMetadata/v1/instance/'
+
+    'Bearer ' + Faraday.get(path, {}, { metadata_flavor: 'Google' }).body
+  end
+end
+```
+
+And register it like this:
+
+```ruby
+# config/initializers/pears.rb
+Pears::Provider::Builder.enable_provider Pears::GcloudProvider
+```
 
 
 ## Todo
-- Figure out if subscription should be a providerof maybe something else.
-- Add Loco as a provider.
-- Add ENV as a provider.
-- Add Redis as a provider.
-- Figure out if there is a sensible tie in with kubernetes.
-- Add support for different file-types.
-- Add different ways to trigger updates from redis subscriptions. (like hand fired events?)
+
 
 ## Development
 
@@ -58,9 +102,25 @@ After checking out the repo, run `bin/setup` to install dependencies. Then, run
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
+
+## Future
+
+- Factor subject as a distinct, non-provider entitity.
+- Add Loco as a provider.
+- Add ENV as a provider.
+- Figure out if there is a sensible tie in with kubernetes.
+- Add support for different file-types.
+- Add different ways to trigger updates from redis subscriptions.
+
+We want to add the following providers:
+- ENV - read the ENV and overwrite keys found on lower layers of the segment. **
+- LOCO - read a loco file into a segment.
+- Redis - consume data drom a redis key.
+
+
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/pears.
+Hit me up on slack, jira or Bitbucket!
 
 ## License
 

data/lib/pears/errors.rb

@@ -1 +1,5 @@
-class Error < StandardError; end
+module Pears
+  class Error < StandardError; end
+  class RedisHasLeftTheBuilding < Error; end
+  class Pears::InvalidProviderData < Error; end
+end

data/lib/pears/provider/base.rb

@@ -2,6 +2,11 @@ module Pears
   module Provider
     class Base
       attr_accessor :data
+
+      def initialize(data, on_failure: :raise)
+        @data = data
+      end
+
       def has_key?(key)
         @data.has_key? key
       end
@@ -13,6 +18,14 @@ module Pears
       def [](key)
         @data[key]
       end
+
+      private
+
+      def parse_yaml(yaml_data)
+        yaml_data = YAML.load(yaml_data)
+        raise Pears::InvalidProviderData if yaml_data.is_a? String
+        yaml_data.with_indifferent_access
+      end
     end
   end
 end

data/lib/pears/provider/local_file.rb

@@ -5,15 +5,15 @@ module Pears
   module Provider
     # Used for loading simple YAML file locally.
     class LocalFile < Base
-      def initialize(file_path)
+      def initialize(file_path,  on_failure: :raise)
         yaml_data = File.read(file_path)
         @data = parse_yaml(yaml_data)
-      end
-
-      private
-
-      def parse_yaml(yaml_data)
-        YAML.load(yaml_data).with_indifferent_access
+      rescue Errno::ENOENT => error
+        if on_failure == :null
+          @data = {}
+        else
+          raise error
+        end
       end
     end
   end

data/lib/pears/provider/remote_file.rb

@@ -3,10 +3,20 @@ require 'net/http'
 module Pears
   module Provider
     # Fetch a yaml file via HTTP
-    class RemoteFile < LocalFile
-      def initialize(remote_url)
+    class RemoteFile < Base
+      def initialize(remote_url, on_failure: :raise)
         yaml_data = Net::HTTP.get(URI(remote_url))
         @data = parse_yaml(yaml_data)
+
+      rescue SocketError,
+          InvalidProviderData,
+          Errno::ECONNREFUSED,
+          Errno::EHOSTUNREACH => e
+        if on_failure == :null
+          @data = {}
+        else
+          raise e
+        end
       end
     end
   end

data/lib/pears/provider/subscription.rb

@@ -24,7 +24,7 @@ module Pears
 
         # Setup redis subscription
         establish_connection(redis_host)
-        reload
+        load_config
         subscribe
       end
 
@@ -32,7 +32,7 @@ module Pears
         @channel ||= @builder.subject_name
       end
 
-      def reload
+      def load_config
         @builder.freeze_layers do
           @data = @fetcher.call.data
         end
@@ -48,11 +48,12 @@ module Pears
 
       def subscribe
         @subscription = Thread.new do
-          connection.subscribe(@channel) do |on|
+          connection.subscribe(channel) do |on|
             on.message do |channel, message|
-              reload
+              load_config
             end
           end
+          puts "Redis connection died!"
         end
       end
 

data/lib/pears/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pears
-  VERSION = "0.0.6"
+  VERSION = "0.0.10"
 end

data/pears.gemspec

@@ -8,10 +8,10 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Steven Kemp"]
   spec.email         = ["steven@remarkgroup.com"]
 
-  spec.summary       = "Ingest hot-swappable configuration data"
-  spec.homepage      = "https://www.rubygems.com"
+  spec.summary       = "An overly complicated library for juggling configuration data."
+  spec.homepage      = "https://bitbucket.org/ivaldi/rubygems-pears/src/master/"
   spec.license       = "MIT"
-  spec.required_ruby_version = ">= 3.0.1"
+  spec.required_ruby_version = ">= 2.7.4"
 
   spec.metadata["homepage_uri"] = spec.homepage
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pears
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.10
 platform: ruby
 authors:
 - Steven Kemp
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-12-15 00:00:00.000000000 Z
+date: 2022-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: dry-configurable
@@ -96,13 +96,12 @@ files:
 - lib/pears/provider/subscription.rb
 - lib/pears/subject.rb
 - lib/pears/version.rb
-- pears-0.0.5.gem
 - pears.gemspec
-homepage: https://www.rubygems.com
+homepage: https://bitbucket.org/ivaldi/rubygems-pears/src/master/
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://www.rubygems.com
+  homepage_uri: https://bitbucket.org/ivaldi/rubygems-pears/src/master/
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -111,7 +110,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.1
+      version: 2.7.4
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -121,5 +120,5 @@ requirements: []
 rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
-summary: Ingest hot-swappable configuration data
+summary: An overly complicated library for juggling configuration data.
 test_files: []