props 0.1.0 → 0.2.0

data/History.markdown

@@ -1,3 +1,8 @@
+### 0.2 / 2012-06-10
+
+* Add optional erb processing with passed in binding (`load_file_with_erb`)
+* Add section lookup (`fetch_with_section`)
+
 ### 0.1 / 2012-06-03
 
 * Everything is new. First release

data/README.markdown

@@ -1,4 +1,4 @@
-# `props` -  Manage Settings
+# `props` -  Manage Settings Hierachies (Commandline, User, Home, Defaults, etc.)
 
 ## Description
 
@@ -6,7 +6,59 @@ TBD
 
 ## Usage
 
-TBD
+Example:
+
+```
+class Config
+
+  DEFAULTS = { 'libs' => [ 'kramdown' ],
+               'extnames' => [
+                 '.markdown',
+                 '.m',
+                 '.mark',
+                 '.mkdn',
+                 '.md',
+                 '.mdown',
+                 '.markdn',
+                 '.txt',
+                 '.text' ],
+                'redcarpet' => {
+                 'extensions' => [
+                    'no_intra_emphasis',
+                    'fenced_code_blocks',
+                    'tables',
+                    'strikethrough' ] }
+             }
+
+  def initialize
+    @props = @props_default = Props.new( DEFAULTS, 'DEFAULTS' )
+
+    # check for user settings (markdown.yml) in home folder
+
+    props_home_file = File.join( Env.home, 'markdown.yml' )
+    if File.exists?( props_home_file )
+      puts "Loading settings from '#{props_home_file}'..."
+      @props = @props_home = Props.load_file( props_home_file, @props )
+    end
+      
+    # check for user settings (markdown.yml) in working folder
+    
+    props_work_file = File.join( '.', 'markdown.yml' )
+    if File.exists?( props_work_file )
+      puts "Loading settings from '#{props_work_file}'..."
+      @props = @props_work = Props.load_file( props_work_file, @props )
+    end
+  end
+
+  def markdown_extnames
+    @props.fetch( 'extnames', nil )
+  end
+
+  ...
+  
+end # class Config
+```
+
 
 ## Install
 
@@ -17,17 +69,18 @@ Just install the gem:
 
 ## Real World Usage
 
-The [`slideshow`](http://slideshow.rubyforge.org) (also known as Slide Show (S9)) gem
+The [`slideshow`](http://slideshow.rubyforge.org) gem (also known as Slide Show (S9))
 that lets you create slide shows
-and author slides in plain text using a wiki-style markup language that's easy-to-write and easy-to-read
-ships with the `props` gem.
+and author slides in plain text using a wiki-style markup language that's easy-to-write and easy-to-read.
 
+The [`markdown`](http://geraldb.github.com/markdown) gem that lets you use your markdown library
+of choice.
 
 ## Alternatives
 
-TBD
+* [`configtoolkit`](http://configtoolkit.rubyforge.org) gem
 
 ## License
 
 The `props` scripts are dedicated to the public domain.
-Use it as you please with no restrictions whatsoever.
+Use it as you please with no restrictions whatsoever.

data/Rakefile

@@ -5,7 +5,7 @@ Hoe.spec 'props' do
   
   self.version = Props::VERSION
   
-  self.summary = 'props - Manage Settings'
+  self.summary = 'props - Manage Settings Hierachies (Commandline, User, Home, Defaults, etc.)'
   self.description = summary
 
   self.urls    = ['http://geraldb.github.com/props']

data/lib/props.rb

@@ -6,6 +6,7 @@ require 'pp'
 require 'logger'
 require 'optparse'
 require 'fileutils'
+require 'erb'
 
 
 
@@ -37,7 +38,7 @@ end # class Env
 
 class Props
 
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 
   attr_reader :path
   attr_reader :parent
@@ -54,19 +55,39 @@ class Props
     pp h    # todo: add debug flag (turn off for default)
     Props.new( h, path, parent )
   end
+  
+  ### todo: use TOP_LEVEL_BINDING for binding default?
+  def self.load_file_with_erb( path, binding, parent=nil )  # run through erb first
+    text = ERB.new( File.read( path ) ).result( binding )
+    h = YAML.load( text )
+    puts "dump of >#{path}<:"
+    pp h    # todo: add debug flag (turn off for default)
+    Props.new( h, path, parent )
+  end
     
-  def [](key)  get( key );  end
     
   def fetch(key, default)
     value = get( key )
     value.nil? ? default : value
   end
+  
+  def fetch_from_section(section, key, default)
+    value = get_from_section( section, key )
+    value.nil? ? default : value
+  end
+
+  def [](key)  get( key );  end
 
-private
   def get( key )
-    value = @hash[ key.to_s ]
+    value = @hash.fetch( key.to_s, nil )
     # if not found try lookup in parent hash
-    (value.nil? && parent) ? parent[key] : value
+    (value.nil? && parent) ? parent.get(key) : value
   end
-    
-end # class props
+
+  def get_from_section( section, key )
+    value = @hash.fetch( section.to_s, {} ).fetch( key.to_s, nil )
+    # if not found try lookup in parent hash
+    (value.nil? && parent) ? parent.get_from_section(section,key) : value
+  end
+
+end # class Props

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: props
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: 
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Gerald Bauer
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-06-03 00:00:00 Z
+date: 2012-06-10 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rdoc
@@ -47,7 +47,7 @@ dependencies:
         version: "3.0"
   type: :development
   version_requirements: *id002
-description: props - Manage Settings
+description: props - Manage Settings Hierachies (Commandline, User, Home, Defaults, etc.)
 email: webslideshow@googlegroups.com
 executables: []
 
@@ -94,6 +94,6 @@ rubyforge_project: props
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: props - Manage Settings
+summary: props - Manage Settings Hierachies (Commandline, User, Home, Defaults, etc.)
 test_files: []