yarrow 0.2.6 → 0.2.7

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    ZjViODEzNDFmNDI5OTgwNjNkODY1YWExMDE4ZTM4YWYzNDQ3ZDJiOA==
+    YjkyNjg4NmRiYzY3OTc4YTI2ZTMxYjhjZjZjMDFkMDY0YmFhMDlhYQ==
   data.tar.gz: !binary |-
-    ODYwNjY4Y2QxMDYzZjdjZDEwOWMzOWY1ZjdhZGU0ZDBjZThlOWNhMg==
+    Yjc1NzE0YzRiYzQzNjk5OTFiNjQ2MzQ3ZWU2ZWQzODc2MWI3NGRkNQ==
 SHA512:
   metadata.gz: !binary |-
-    OGI4OWIxZTNjMDc1NWM4NGVlMGIwNGJiYzQwZWI3YTNhOTYxMWY0YWFjMjQy
-    MTlmODlhYmU3YTA5ZjJkNWQ3NTdjYjYzYmI3ZTNjMDc1ZjU3NDA3MDQ5NjY4
-    MzBmZmJlZTNmOTk4N2NmMzE1YjZkMDA4NDQyNDM2YmUxZTU5YzQ=
+    OGE5NTdmNDViN2MwY2JmMGQyY2Y5ZGM2OTAyNmNmNTZjZjg1Y2E1Mjg5OGM5
+    YWVlZDUzOTg4ZDM2OTM0MmM3Y2VjMDA5YTI4MmNkYmVlYmNhNTEyNDg2MmI5
+    NThkZDM4YjQ4NTk4OTVhMzg4Yjk4OTVjOTJmODRjMzVlNmU3ZmY=
   data.tar.gz: !binary |-
-    NTRhZWNjNzcyNjcyM2M4YzkyZmQyNjMxYmMwNDVkMGVlNzYwYzcxMTVkOGYw
-    ZDBiOWY1Mjg4NzNiMjJkMTM2MWE0YzRiYzI4NDIzMzkyMDEzMzJkZGE4YWZl
-    NjEwNGYxN2RhMTQyM2UxZWU5ZTI3NjVkMzA2ODVlYTRlNzA5OGE=
+    ZjVmZGY3ZDBiOGE5MjI5YmFhOWZiZWViNzM3MjhmZGM3NDAwYjAwMGJlNmU3
+    NGM3NDA1YTliNDVhNzg5MjRhNzk1OTlmZjY1ODJmZTA3MTM0ZWU0OTU3ZDBk
+    YzhiOTZiMzA5NWMwNzdjNDcyZjIwNWQ1ZjgxMjFjZTZiMzAzNGQ=

data/lib/yarrow/configuration.rb

@@ -1,22 +1,81 @@
 module Yarrow
+
+  ##
+  # Hash-like object containing runtime configuration values. Can be accessed indifferently
+  # via object style lookups or symbol keys.
+  #
   class Configuration < Hashie::Mash
    
     class << self
 
+      ##
+      # Provides access to the registered global configuration.
+      #
+      # If no configuration is registered, returns a blank object.
+      #
+      # @return [Yarrow::Configuration]
+      #
       def instance
-        @@configuration || Hashie::Mash.new
+        @@configuration ||= self.new
       end
 
+      ##
+      # Loads and registers a global configuration object.
+      #
+      # @param [String] path to YAML file
+      #
       def register(file)
         @@configuration = self.load(file)
       end
 
+      ##
+      # Clears the global configuration to the empty default.
+      #
+      def clear
+        @@configuration = self.new
+      end
+
+
+      ##
+      # Merges the given configuration or hash-like object with the
+      # registered global configuration.
+      #
+      # @param [Hash, Hashie::Mash, Yarrow::Configuration]
+      #
+      def merge(config)
+        instance.deep_merge!(config)
+      end
+
+      ##
+      # Loads a configuration object from the given YAML file.
+      #
+      # @param [String] path to YAML file
+      #
+      # @return [Yarrow::Configuration]
+      #
       def load(file)
-        configuration = self.new(YAML.load_file(file))
-        configuration
+        self.new(YAML.load_file(file))
       end
 
     end
     
   end
+
+  ##
+  # Embeds global configuration access in a client object.
+  #
+  module Configurable
+
+    ##
+    # Provides access to the registered global configuration. This can
+    # be overriden by subclasses to customize behaviour (eg: in test cases).
+    #
+    # @return [Yarrow::Configuration]
+    #
+    def config
+      Configuration.instance
+    end
+
+  end
+
 end

data/lib/yarrow/html/asset_tags.rb

@@ -2,6 +2,10 @@ module Yarrow
   module HTML
     module AssetTags
       
+      def config
+        Yarrow::Configuration.instance
+      end
+
       # TODO: make sprockets manifest optional/pluggable
       def manifest
         Yarrow::Assets::Manifest.new(config || {})

data/lib/yarrow/version.rb

@@ -1,4 +1,4 @@
 module Yarrow
   APP_NAME = "Yarrow"
-  VERSION = "0.2.6"
+  VERSION = "0.2.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yarrow
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
 platform: ruby
 authors:
 - Mark Rickerby
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-28 00:00:00.000000000 Z
+date: 2014-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
@@ -108,6 +108,20 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Yarrow is a tool for generating well structured documentation from a
   variety of input sources.
 email: me@maetl.net