configlet 1.3.0 → 2.0.0

data/CHANGELOG.rdoc

@@ -1,3 +1,9 @@
+=== 2.0.0 / 2010-09-28
+
+* Remove deprecated features.
+* Add doco on transformations.
+* Add sugar for munging URL args.
+
 === 1.3.0 / 2010-05-24
 
 * Add support for lazy defaults.

data/README.rdoc

@@ -45,6 +45,20 @@ resolved the first time its value is grabbed.
 Configlet is a module, so +include+ or +extend+ it wherever you
 want. It extends itself for your convenience.
 
+== Transformation
+
+Want something other than a string? You can munge any value:
+
+    default :url => "http://example.org"
+    munge(:url) { |v| URI.parse v }
+    Configlet[:url] # => #<URI::HTTP:0xdeadbeef URL:http://example.org>
+
+In fact, there's a shortcut just for URLs. I haven't added any others
+'cause I haven't needed to care:
+
+    url :url => "http://example.org"
+    Configlet[:url] # => #<URI::HTTP:0xcafebabe URL:http://example.org>
+
 == Installation
 
     $ gem install configlet

data/lib/configlet.rb

@@ -13,7 +13,7 @@ module Configlet
 
   # Duh.
 
-  VERSION = "1.3.0"
+  VERSION = "2.0.0"
 
   I = lambda { |v| v } #:nodoc:
 
@@ -88,11 +88,6 @@ module Configlet
     instance_eval(&block)
   end
 
-  def for *args, &block #:nodoc:
-    warn "Configlet.for is deprecated, and will be removed in 2.0."
-    config(*args, &block)
-  end
-
   # Mess with a value when it's retrieved. Useful for turning untyped
   # environment strings into numbers, booleans, enums, or class
   # instances. Here's how to munge a boolean:
@@ -111,14 +106,16 @@ module Configlet
     @mungers ||= Hash.new { |h, k| I }
   end
 
-  # Set prefix to +nil+, clear defaults and mungers.
+  # Behaves exactly like +default+, but additionally installs a munger
+  # for each key that calls <tt>URI.parse</tt>.
 
-  def reset
-    warn "Configlet.reset is deprecated, and will be removed in 2.0."
-    self.prefix = nil
+  def url args, &block
+    default args, &block
+    require "uri"
 
-    defaults.clear
-    mungers.clear
+    (args.keys rescue [args]).each do |key|
+      munge(key) { |v| URI.parse v }
+    end
   end
 
   extend self

data/test/test_configlet.rb

@@ -1,5 +1,6 @@
-require "minitest/autorun"
 require "configlet"
+require "minitest/autorun"
+require "uri"
 
 class TestConfiglet < MiniTest::Unit::TestCase
   class Stub
@@ -74,4 +75,14 @@ class TestConfiglet < MiniTest::Unit::TestCase
     @cfg[:thud] = "zap"
     assert_equal "zap", ENV["POW_THUD"]
   end
+
+  def test_url
+    @cfg.url :example => "http://example.org"
+    assert_equal URI.parse("http://example.org"), @cfg[:example]
+  end
+
+  def test_url_block
+    @cfg.url(:example) { "http://example.org" }
+    assert_equal URI.parse("http://example.org"), @cfg[:example]
+  end
 end

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: configlet
 version: !ruby/object:Gem::Version 
-  hash: 27
   prerelease: false
   segments: 
-  - 1
-  - 3
+  - 2
   - 0
-  version: 1.3.0
+  - 0
+  version: 2.0.0
 platform: ruby
 authors: 
 - John Barnette
@@ -15,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-24 00:00:00 -07:00
+date: 2010-09-28 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -26,12 +25,11 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        hash: 23
         segments: 
         - 2
         - 6
-        - 0
-        version: 2.6.0
+        - 2
+        version: 2.6.2
   type: :development
   version_requirements: *id001
 description: |-
@@ -73,7 +71,6 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -82,7 +79,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"