configuration-blocks 1.0.0

data/.rspec

@@ -0,0 +1 @@
+--format nested --color

data/.yardopts

@@ -0,0 +1,12 @@
+--title 'Easy way of adding configuration blocks to classes, modules and applications'
+--protected
+--readme README.md
+--no-private
+--hide-void-return
+-p docs/yard-tpl
+-t default
+-
+docs/HISTORY
+ChangeLog
+docs/COPYING
+docs/LGPL-LICENSE

data/ChangeLog

@@ -0,0 +1,35 @@
+commit 1b04f5f3e97639b455a473c5f9c2200cf9f18c26
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Dec 2 03:01:35 2012 +0100
+
+    Deps updated
+
+commit 648ddc5fa83e50e72ffbd4ed287d0387ebe9b789
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Dec 2 03:00:06 2012 +0100
+
+    Release 1.0.0
+
+commit 379849ff5570306b892db0b94923cc0d385658df
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Dec 2 02:48:40 2012 +0100
+
+    Anonymous modules caching fixed, added singleton support
+
+commit 38c4f9ac29bb12696c22af23690484fff38c885f
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sun Dec 2 02:47:48 2012 +0100
+
+    README updated
+
+commit 2abc6a4c17b753dbe0cb515cc83cf6dd4b25b82f
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sat Dec 1 21:52:28 2012 +0100
+
+    ChangeLog and Manifest.txt updated
+
+commit c10e977775a83b8cd1ef4e7a8b1a128b71661beb
+Author: Paweł Wilk <siefca@gnu.org>
+Date:   Sat Dec 1 21:51:34 2012 +0100
+
+    Initial commit

data/LGPL-LICENSE

@@ -0,0 +1,169 @@
+<tt>
+	
+			  GNU LESSER GENERAL PUBLIC LICENSE
+	                       Version 3, 29 June 2007
+	
+	 Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+	 Everyone is permitted to copy and distribute verbatim copies
+	 of this license document, but changing it is not allowed.
+	
+	
+	  This version of the GNU Lesser General Public License incorporates
+	the terms and conditions of version 3 of the GNU General Public
+	License, supplemented by the additional permissions listed below.
+	
+	  0. Additional Definitions.
+	
+	  As used herein, "this License" refers to version 3 of the GNU Lesser
+	General Public License, and the "GNU GPL" refers to version 3 of the GNU
+	General Public License.
+	
+	  "The Library" refers to a covered work governed by this License,
+	other than an Application or a Combined Work as defined below.
+	
+	  An "Application" is any work that makes use of an interface provided
+	by the Library, but which is not otherwise based on the Library.
+	Defining a subclass of a class defined by the Library is deemed a mode
+	of using an interface provided by the Library.
+	
+	  A "Combined Work" is a work produced by combining or linking an
+	Application with the Library.  The particular version of the Library
+	with which the Combined Work was made is also called the "Linked
+	Version".
+	
+	  The "Minimal Corresponding Source" for a Combined Work means the
+	Corresponding Source for the Combined Work, excluding any source code
+	for portions of the Combined Work that, considered in isolation, are
+	based on the Application, and not on the Linked Version.
+	
+	  The "Corresponding Application Code" for a Combined Work means the
+	object code and/or source code for the Application, including any data
+	and utility programs needed for reproducing the Combined Work from the
+	Application, but excluding the System Libraries of the Combined Work.
+	
+	  1. Exception to Section 3 of the GNU GPL.
+	
+	  You may convey a covered work under sections 3 and 4 of this License
+	without being bound by section 3 of the GNU GPL.
+	
+	  2. Conveying Modified Versions.
+	
+	  If you modify a copy of the Library, and, in your modifications, a
+	facility refers to a function or data to be supplied by an Application
+	that uses the facility (other than as an argument passed when the
+	facility is invoked), then you may convey a copy of the modified
+	version:
+	
+	   a) under this License, provided that you make a good faith effort to
+	   ensure that, in the event an Application does not supply the
+	   function or data, the facility still operates, and performs
+	   whatever part of its purpose remains meaningful, or
+	
+	   b) under the GNU GPL, with none of the additional permissions of
+	   this License applicable to that copy.
+	
+	  3. Object Code Incorporating Material from Library Header Files.
+	
+	  The object code form of an Application may incorporate material from
+	a header file that is part of the Library.  You may convey such object
+	code under terms of your choice, provided that, if the incorporated
+	material is not limited to numerical parameters, data structure
+	layouts and accessors, or small macros, inline functions and templates
+	(ten or fewer lines in length), you do both of the following:
+	
+	   a) Give prominent notice with each copy of the object code that the
+	   Library is used in it and that the Library and its use are
+	   covered by this License.
+	
+	   b) Accompany the object code with a copy of the GNU GPL and this license
+	   document.
+	
+	  4. Combined Works.
+	
+	  You may convey a Combined Work under terms of your choice that,
+	taken together, effectively do not restrict modification of the
+	portions of the Library contained in the Combined Work and reverse
+	engineering for debugging such modifications, if you also do each of
+	the following:
+	
+	   a) Give prominent notice with each copy of the Combined Work that
+	   the Library is used in it and that the Library and its use are
+	   covered by this License.
+	
+	   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+	   document.
+	
+	   c) For a Combined Work that displays copyright notices during
+	   execution, include the copyright notice for the Library among
+	   these notices, as well as a reference directing the user to the
+	   copies of the GNU GPL and this license document.
+	
+	   d) Do one of the following:
+	
+	       0) Convey the Minimal Corresponding Source under the terms of this
+	       License, and the Corresponding Application Code in a form
+	       suitable for, and under terms that permit, the user to
+	       recombine or relink the Application with a modified version of
+	       the Linked Version to produce a modified Combined Work, in the
+	       manner specified by section 6 of the GNU GPL for conveying
+	       Corresponding Source.
+	
+	       1) Use a suitable shared library mechanism for linking with the
+	       Library.  A suitable mechanism is one that (a) uses at run time
+	       a copy of the Library already present on the user's computer
+	       system, and (b) will operate properly with a modified version
+	       of the Library that is interface-compatible with the Linked
+	       Version.
+	
+	   e) Provide Installation Information, but only if you would otherwise
+	   be required to provide such information under section 6 of the
+	   GNU GPL, and only to the extent that such information is
+	   necessary to install and execute a modified version of the
+	   Combined Work produced by recombining or relinking the
+	   Application with a modified version of the Linked Version. (If
+	   you use option 4d0, the Installation Information must accompany
+	   the Minimal Corresponding Source and Corresponding Application
+	   Code. If you use option 4d1, you must provide the Installation
+	   Information in the manner specified by section 6 of the GNU GPL
+	   for conveying Corresponding Source.)
+	
+	  5. Combined Libraries.
+	
+	  You may place library facilities that are a work based on the
+	Library side by side in a single library together with other library
+	facilities that are not Applications and are not covered by this
+	License, and convey such a combined library under terms of your
+	choice, if you do both of the following:
+	
+	   a) Accompany the combined library with a copy of the same work based
+	   on the Library, uncombined with any other library facilities,
+	   conveyed under the terms of this License.
+	
+	   b) Give prominent notice with the combined library that part of it
+	   is a work based on the Library, and explaining where to find the
+	   accompanying uncombined form of the same work.
+	
+	  6. Revised Versions of the GNU Lesser General Public License.
+	
+	  The Free Software Foundation may publish revised and/or new versions
+	of the GNU Lesser General Public License from time to time. Such new
+	versions will be similar in spirit to the present version, but may
+	differ in detail to address new problems or concerns.
+	
+	  Each version is given a distinguishing version number. If the
+	Library as you received it specifies that a certain numbered version
+	of the GNU Lesser General Public License "or any later version"
+	applies to it, you have the option of following the terms and
+	conditions either of that published version or of any later version
+	published by the Free Software Foundation. If the Library as you
+	received it does not specify a version number of the GNU Lesser
+	General Public License, you may choose any version of the GNU Lesser
+	General Public License ever published by the Free Software Foundation.
+	
+	  If the Library as you received it specifies that a proxy can decide
+	whether future versions of the GNU Lesser General Public License shall
+	apply, that proxy's public statement of acceptance of any version is
+	permanent authorization for you to choose that version for the
+	Library.
+
+</tt>

data/Manifest.txt

@@ -0,0 +1,18 @@
+.rspec
+.yardopts
+ChangeLog
+LGPL-LICENSE
+Manifest.txt
+README.md
+Rakefile
+configuration-blocks.gemspec
+docs/COPYING
+docs/HISTORY
+docs/LEGAL
+docs/LGPL-LICENSE
+docs/TODO
+docs/rdoc.css
+docs/yard-tpl/default/fulldoc/html/css/common.css
+lib/configuration-blocks.rb
+lib/configuration-blocks/core.rb
+lib/configuration-blocks/version.rb

data/README.md

@@ -0,0 +1,193 @@
+Configuration blocks for classes, modules and applications
+==========================================================
+
+**configuration-blocks version `1.0`** (`True`)
+
+* https://rubygems.org/gems/configuration-blocks
+* https://github.com/siefca/configuration-blocks/tree
+* pw@gnu.org
+
+
+Summary
+-------
+
+This is simple module that helps in creating configuration blocks in objects.
+
+It separates configuration blocks from a class containing configuration methods
+by creating anonymous modules containing delegators. Those delegators are used
+to set or get some configuration data through delegates (methods that exist in your
+class or module).
+
+Example
+-------
+
+Instance-level:
+
+```ruby
+  class SomeClass
+    include ConfigurationBlocks
+
+    def some_setting(arg)
+      p "setting to #{arg}"
+    end
+    configuration_method :some_setting
+  end
+
+  obj = SomeClass.new
+  
+  obj.configuration_block do
+    some_setting :some_value
+  end
+```
+
+Class-level:
+
+```ruby
+  class SomeClass
+    include ConfigurationBlocks
+
+    class <<self
+      def some_setting(arg)
+        p "setting to #{arg}"
+      end
+      configuration_method :some_setting
+    end
+  end
+
+  SomeClass.configuration_block do
+    some_setting :some_value
+  end
+```
+
+Imported from modules:
+
+```ruby
+  module MyModule
+    include ConfigurationBlocks
+  
+    def some_setting(arg)
+      p "setting to #{arg}"
+    end
+    configuration_method :some_setting
+  end
+  
+  module SecondModule
+    include ConfigurationBlocks
+    include MyModule
+  
+    def other(v)
+      p "setting other to #{v}"
+    end
+    configuration_method :other
+  end
+  
+  class SomeClass
+    include ConfigurationBlocks
+    include SecondModule
+  end
+  
+  SomeClass.new.configuration_block do
+    some_setting  :some_value
+    other         :other
+  end
+```
+
+Please note that configuration blocks called **without arguments** are evaluated in the context of a module
+and that module persists between calls. You can store and retrieve instance variables, create
+module-level methods and so on:
+
+```ruby
+  class SomeClass
+    include ConfigurationBlocks
+  end
+
+  obj = SomeClass.new
+  
+  obj.configuration_block do
+    @some_var = 8
+  end
+
+  obj.configuration_block do
+    p @some_var
+  end
+```
+
+If you pass **at least one argument** to a configuration block, then the module will be passed as a first argument
+of the block and the context will remain as it is (current). Imagine using +tap+.
+
+See also
+--------
+
+* See [whole documentation](http://rubydoc.info/gems/configuration-blocks/) to browse all documents.
+
+Requirements
+------------
+
+* [rubygems](http://docs.rubygems.org/)
+* [bundler](http://gembundler.com/)
+
+Download
+--------
+
+### Source code ###
+
+* https://github.com/siefca/configuration-blocks/tree
+* `git clone git://github.com/siefca/configuration-blocks.git`
+
+### Gem ###
+
+* https://rubygems.org/gems/configuration-blocks
+
+Installation
+------------
+
+```ruby
+gem install configuration-blocks
+```
+
+Specs
+-----
+
+You can run RSpec examples both with
+
+* `bundle exec rake spec` or just `bundle exec rake`
+* run a test file directly, e.g. `ruby -S rspec spec/configuration-blocks_spec.rb -Ispec:lib`
+
+Common rake tasks
+-----------------
+
+* `bundle exec rake bundler:gemfile` – regenerate the `Gemfile`
+* `bundle exec rake docs` – render the documentation (output in the subdirectory directory `doc`)
+* `bundle exec rake gem:spec` – builds static gemspec file (`configuration-blocks.gemspec`)
+* `bundle exec rake gem` – builds package (output in the subdirectory `pkg`)
+* `bundle exec rake spec` – performs spec. tests
+* `bundle exec rake Manifest.txt` – regenerates the `Manifest.txt` file
+* `bundle exec rake ChangeLog` – regenerates the `ChangeLog` file
+
+Like my work?
+-------------
+
+You can send me some bitcoins if you would like to support me:
+
+* `13wZbBjs6yQQuAb3zjfHubQSyer2cLAYzH`
+
+Or you can endorse my skills on LinkedIn or Coderwall:
+
+* [pl.linkedin.com/in/pwilk](http://www.linkedin.com/profile/view?id=4251568#profile-skills)
+
+* [![endorse](http://api.coderwall.com/siefca/endorsecount.png)](http://coderwall.com/siefca)
+
+License
+-------
+
+Copyright (c) 2012 by Paweł Wilk.
+
+configuration-blocks is copyrighted software owned by Paweł Wilk (pw@gnu.org).
+You may redistribute and/or modify this software as long as you
+comply with either the terms of the LGPL (see [LGPL-LICENSE](http://rubydoc.info/gems/configuration-blocks/file/docs/LGPL-LICENSE)),
+or Ruby's license (see [COPYING](http://rubydoc.info/gems/configuration-blocks/file/docs/COPYING)).
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE.

data/Rakefile

@@ -0,0 +1,85 @@
+# encoding: utf-8
+# -*- ruby -*-
+
+$:.unshift File.join(File.dirname(__FILE__), "lib")
+
+require 'rubygems'
+require 'bundler/setup'
+
+require "rake"
+require "rake/clean"
+
+require "fileutils"
+
+require 'configuration-blocks/version'
+require 'hoe'
+
+task :default => [:spec]
+
+desc "install by setup.rb"
+task :install do
+  sh "sudo ruby setup.rb install"
+end
+
+### Gem
+
+Hoe.plugin :bundler
+Hoe.plugin :yard
+Hoe.plugin :gemspec
+
+Hoe.spec 'configuration-blocks' do
+  developer               ConfigurationBlocks::DEVELOPER, ConfigurationBlocks::EMAIL
+
+  self.version         =  ConfigurationBlocks::VERSION
+  self.rubyforge_name  =  ConfigurationBlocks::NAME
+  self.summary         =  ConfigurationBlocks::SUMMARY
+  self.description     =  ConfigurationBlocks::DESCRIPTION
+  self.url             =  ConfigurationBlocks::URL
+
+  self.remote_rdoc_dir = ''
+  self.rsync_args      << '--chmod=a+rX'
+  self.readme_file     = 'README.md'
+  self.history_file    = 'docs/HISTORY'
+
+  extra_dev_deps      << ['rspec',            '>= 2.6.0']   <<
+                         ['yard',             '>= 0.8.2']   <<
+                         ['rdoc',             '>= 3.8.0']   <<
+                         ['redcarpet',        '>= 2.1.0']   <<
+                         ['bundler',          '>= 1.0.10']  <<
+                         ['hoe-bundler',      '>= 1.1.0']   <<
+                         ['hoe-gemspec',      '>= 1.0.0']
+
+  unless extra_dev_deps.flatten.include?('hoe-yard')
+    extra_dev_deps << ['hoe-yard', '>= 0.1.2']
+  end
+end
+
+task 'Manifest.txt' do
+  puts 'generating Manifest.txt from git'
+  sh %{git ls-files | grep -v gitignore | grep -v Gemfile > Manifest.txt}
+  sh %{git add Manifest.txt}
+end
+
+task 'ChangeLog' do
+  sh %{git log > ChangeLog}
+end
+
+desc "Fix documentation's file permissions"
+task :docperm do
+  sh %{chmod -R a+rX doc}
+end
+
+### Sign & Publish
+
+desc "Create signed tag in Git"
+task :tag do
+  sh %{git tag -s v#{ConfigurationBlocks::VERSION} -m 'version #{ConfigurationBlocks::VERSION}'}
+end
+
+desc "Create external GnuPG signature for Gem"
+task :gemsign do
+  sh %{gpg -u #{ConfigurationBlocks::EMAIL} \
+           -ab pkg/#{ConfigurationBlocks::NAME}-#{ConfigurationBlocks::VERSION}.gem \
+            -o pkg/#{ConfigurationBlocks::NAME}-#{ConfigurationBlocks::VERSION}.gem.sig}
+end
+

data/configuration-blocks.gemspec

@@ -0,0 +1,58 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "configuration-blocks"
+  s.version = "1.0.0.20121202030054"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Pawe\u{142} Wilk"]
+  s.cert_chain = ["/Users/siefca/.gem/gem-public_cert.pem"]
+  s.date = "2012-12-02"
+  s.description = "Easy way of adding configuration blocks to classes, modules and applications."
+  s.email = ["pw@gnu.org"]
+  s.extra_rdoc_files = ["Manifest.txt"]
+  s.files = [".rspec", ".yardopts", "ChangeLog", "LGPL-LICENSE", "Manifest.txt", "README.md", "Rakefile", "configuration-blocks.gemspec", "docs/COPYING", "docs/HISTORY", "docs/LEGAL", "docs/LGPL-LICENSE", "docs/TODO", "docs/rdoc.css", "docs/yard-tpl/default/fulldoc/html/css/common.css", "lib/configuration-blocks.rb", "lib/configuration-blocks/core.rb", "lib/configuration-blocks/version.rb"]
+  s.homepage = "https://rubygems.org/gems/configuration-blocks/"
+  s.rdoc_options = ["--title", "Configuration::Blocks Documentation", "--quiet"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = "configuration-blocks"
+  s.rubygems_version = "1.8.23"
+  s.signing_key = "/Users/siefca/.gem/gem-private_key.pem"
+  s.summary = "Easy way of adding configuration blocks to classes, modules and applications"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<hoe-yard>, [">= 0.1.2"])
+      s.add_development_dependency(%q<rspec>, [">= 2.6.0"])
+      s.add_development_dependency(%q<yard>, [">= 0.8.2"])
+      s.add_development_dependency(%q<rdoc>, [">= 3.8.0"])
+      s.add_development_dependency(%q<redcarpet>, [">= 2.1.0"])
+      s.add_development_dependency(%q<bundler>, [">= 1.0.10"])
+      s.add_development_dependency(%q<hoe-bundler>, [">= 1.1.0"])
+      s.add_development_dependency(%q<hoe-gemspec>, [">= 1.0.0"])
+      s.add_development_dependency(%q<hoe>, ["~> 2.16"])
+    else
+      s.add_dependency(%q<hoe-yard>, [">= 0.1.2"])
+      s.add_dependency(%q<rspec>, [">= 2.6.0"])
+      s.add_dependency(%q<yard>, [">= 0.8.2"])
+      s.add_dependency(%q<rdoc>, [">= 3.8.0"])
+      s.add_dependency(%q<redcarpet>, [">= 2.1.0"])
+      s.add_dependency(%q<bundler>, [">= 1.0.10"])
+      s.add_dependency(%q<hoe-bundler>, [">= 1.1.0"])
+      s.add_dependency(%q<hoe-gemspec>, [">= 1.0.0"])
+      s.add_dependency(%q<hoe>, ["~> 2.16"])
+    end
+  else
+    s.add_dependency(%q<hoe-yard>, [">= 0.1.2"])
+    s.add_dependency(%q<rspec>, [">= 2.6.0"])
+    s.add_dependency(%q<yard>, [">= 0.8.2"])
+    s.add_dependency(%q<rdoc>, [">= 3.8.0"])
+    s.add_dependency(%q<redcarpet>, [">= 2.1.0"])
+    s.add_dependency(%q<bundler>, [">= 1.0.10"])
+    s.add_dependency(%q<hoe-bundler>, [">= 1.1.0"])
+    s.add_dependency(%q<hoe-gemspec>, [">= 1.0.0"])
+    s.add_dependency(%q<hoe>, ["~> 2.16"])
+  end
+end

data/docs/COPYING

@@ -0,0 +1,57 @@
+configuration-blocks is copyrighted free software owned by Paweł Wilk (pw@gnu.org). The Owner of this software permits you to redistribute and/or modify the software under either the terms of the LGPL version 3 (see the file {file:LGPL-LICENSE LGPL-LICENSE}), or the conditions below ("Ruby License").
+
+== 1.
+
+You may make and give away verbatim copies of the source form of this software without restriction, provided that you retain ALL of the
+original copyright notices and associated disclaimers.
+
+== 2.
+
+You may modify your copy of the software in any way, provided that you do at least ONE of the following:
+
+a) place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said
+modifications to Usenet or an equivalent medium, or by allowing
+the author to include your modifications in the software.
+
+b) use the modified software only within your corporation or
+organization.
+
+c) give non-standard binaries non-standard names, with
+instructions on where to get the original software distribution.
+
+d) make other distribution arrangements with the Owner.
+
+== 3.
+
+You may distribute the software in object code or binary form, provided that you do at least ONE of the following:
+
+a) distribute the binaries and library files of the software,
+together with instructions (in a manual page or equivalent)
+on where to get the original distribution.
+
+b) accompany the distribution with the machine-readable source of
+the software.
+
+c) give non-standard binaries non-standard names, with
+instructions on where to get the original software distribution.
+
+d) make other distribution arrangements with the Owner.
+
+== 4.
+
+You may modify and include parts of the software into any other software (possibly commercial), provided you comply with the terms in
+Sections 1, 2, and 3 above. But some files in the distribution are not written by the Owner, so they may be made available to you
+under different terms.
+
+For the list of those files and their copying conditions, see the
+file LEGAL.
+
+== 5.
+
+The scripts and library files supplied as input to or produced as output from the software do not automatically fall under the
+copyright of the software, but belong to whoever generated them, and may be sold commercially, and may be aggregated with this software.
+
+== 6.
+
+THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+

data/docs/HISTORY

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2012-11-12
+
+* 1 major enhancement
+
+  * Birthday!
+

data/docs/LEGAL

@@ -0,0 +1,11 @@
+LEGAL NOTICE INFORMATION
+------------------------
+
+configuration-blocks is Copyright (C) 2012 by Paweł Wilk.
+
+configuration-blocks is copyrighted software owned by Paweł Wilk
+(pw@gnu.org). You may redistribute and/or modify this
+software as long as you comply with either the terms of the LGPL
+(see the file {file:LGPL-LICENSE}),
+or Ruby's license (see the file {file:COPYING}).
+

data/docs/LGPL-LICENSE

@@ -0,0 +1,166 @@
+
+= GNU LESSER GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc. < http://fsf.org/ >
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+=== 0. Additional Definitions.
+
+As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+=== 1. Exception to Section 3 of the GNU GPL.
+
+You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+=== 2. Conveying Modified Versions.
+
+If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+a) under this License, provided that you make a good faith effort to
+ensure that, in the event an Application does not supply the
+function or data, the facility still operates, and performs
+whatever part of its purpose remains meaningful, or
+
+b) under the GNU GPL, with none of the additional permissions of
+this License applicable to that copy.
+
+=== 3. Object Code Incorporating Material from Library Header Files.
+
+The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+a) Give prominent notice with each copy of the object code that the
+Library is used in it and that the Library and its use are
+covered by this License.
+
+b) Accompany the object code with a copy of the GNU GPL and this license
+document.
+
+=== 4. Combined Works.
+
+You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+a) Give prominent notice with each copy of the Combined Work that
+the Library is used in it and that the Library and its use are
+covered by this License.
+
+b) Accompany the Combined Work with a copy of the GNU GPL and this license
+document.
+
+c) For a Combined Work that displays copyright notices during
+execution, include the copyright notice for the Library among
+these notices, as well as a reference directing the user to the
+copies of the GNU GPL and this license document.
+
+d) Do one of the following:
+
+0) Convey the Minimal Corresponding Source under the terms of this
+License, and the Corresponding Application Code in a form
+suitable for, and under terms that permit, the user to
+recombine or relink the Application with a modified version of
+the Linked Version to produce a modified Combined Work, in the
+manner specified by section 6 of the GNU GPL for conveying
+Corresponding Source.
+
+1) Use a suitable shared library mechanism for linking with the
+Library.  A suitable mechanism is one that (a) uses at run time
+a copy of the Library already present on the user's computer
+system, and (b) will operate properly with a modified version
+of the Library that is interface-compatible with the Linked
+Version.
+
+e) Provide Installation Information, but only if you would otherwise
+be required to provide such information under section 6 of the
+GNU GPL, and only to the extent that such information is
+necessary to install and execute a modified version of the
+Combined Work produced by recombining or relinking the
+Application with a modified version of the Linked Version. (If
+you use option 4d0, the Installation Information must accompany
+the Minimal Corresponding Source and Corresponding Application
+Code. If you use option 4d1, you must provide the Installation
+Information in the manner specified by section 6 of the GNU GPL
+for conveying Corresponding Source.)
+
+=== 5. Combined Libraries.
+
+You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+a) Accompany the combined library with a copy of the same work based
+on the Library, uncombined with any other library facilities,
+conveyed under the terms of this License.
+
+b) Give prominent notice with the combined library that part of it
+is a work based on the Library, and explaining where to find the
+accompanying uncombined form of the same work.
+
+=== 6. Revised Versions of the GNU Lesser General Public License.
+
+The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+

data/docs/rdoc.css

@@ -0,0 +1,21 @@
+@import "rdoc_base.css";
+
+#documentation > ul:first-of-type {
+  padding-bottom: 2em;
+  padding-top: 1.5em;
+  background-position: 20em 0%;
+  background-repeat: no-repeat;
+  }
+
+#documentation .method-description > p:first-of-type + p {
+  margin-top: 0.5em;
+}
+
+#documentation .method-description > ul {
+  margin-left: 1.2em;
+}
+
+#documentation .method-description > p + ul {
+  margin-left: 1.8em;
+}
+

data/docs/yard-tpl/default/fulldoc/html/css/common.css

@@ -0,0 +1,5 @@
+
+.signature .aliases, h3.signature .aliases {
+  margin-top: 2ex;
+}
+

data/lib/configuration-blocks.rb

@@ -0,0 +1,6 @@
+# Author::    Paweł Wilk (mailto:pw@gnu.org)
+# Copyright:: (c) 2012 by Paweł Wilk
+# License::   This program is licensed under the terms of {file:LGPL-LICENSE GNU Lesser General Public License} or {file:COPYING Ruby License}.
+
+require 'configuration-blocks/version'
+require 'configuration-blocks/core'

data/lib/configuration-blocks/core.rb

@@ -0,0 +1,145 @@
+# Author::    Paweł Wilk (mailto:pw@gnu.org)
+# Copyright:: (c) 2012 by Paweł Wilk
+# License::   This program is licensed under the terms of {file:LGPL-LICENSE GNU Lesser General Public License} or {file:COPYING Ruby License}.
+#
+# This file contains ConfigurationBlocks module.
+
+require 'set'
+
+# This module adds support for configuration blocks.
+module ConfigurationBlocks
+
+  # @private
+  def self.included(base)
+    base.extend(ClassMethods)
+    base.singleton_class.extend(ClassMethods)
+    super if defined?(super)
+  end
+
+  # Returns configuration block.
+  # 
+  # @param base [Object,Symbol] base object which delegators will point to (defaults to object on which
+  #  this method has been called). If symbol is given, then it should contain the name of a method that
+  #  will be called on current object.
+  # @return [Object] result of evaluating the given block within context of configuration module
+  def configuration_block(base = self, &block)
+    self.class.configuration_block(base, &block)
+  end
+
+  # Returns configuration module that delegates methods pointing to the given +base+ object
+  # and optionally evaluates the given block in the context of this module or in the current context.
+  # 
+  # If a block is given then it is evaluated in the context of the configuration module.
+  # If a block with at least one argument is given then the context remains as it was
+  # but the first argument is the module.
+  # 
+  # @example
+  #   # using external access to configuration module:
+  #   x.configuration_block do |c|
+  #     c.some_setting  :a
+  #     c.other_setting :b
+  #   end
+  #   
+  #   # using internal access to configuration module:
+  #   x.configuration_block do
+  #     some_setting  :a
+  #     other_setting :b
+  #   end
+  # 
+  # @param base [Object,Symbol] base object which delegators will point to (defaults to object on which
+  #  this method has been called). If symbol is given, then it should contain the name of a method that
+  #  will be called on current object.
+  # @return [Module,Object] configuration module if not block is given or a block takes no arguments. In case
+  #  of one or more arguments in a block it also returns a module unless +break+ statement is used; in such case
+  #  the value passed to +break+ is returned.
+  def configuration_block(base = self, &block)
+    @cb_conf_module ||= self.class.configuration_module(base)
+    self.class.send(:configuration_block_core, @cb_conf_module, &block)
+  end
+
+  # This module contains methods that will extend the class.
+  module ClassMethods
+
+    # Returns configuration block.
+    # 
+    # @param base [Object,Symbol] base object which delegators will point to (defaults to object on which
+    #  this method has been called). If symbol is given, then it should contain the name of a method that
+    #  will be called on current object.
+    # 
+    # @return [Object] result of evaluating the given block within context of configuration module
+    def configuration_block(base = self, &block)
+      @cb_conf_module ||= configuration_module(base)
+      configuration_block_core(@cb_conf_module, &block)
+    end
+
+    # Creates and returns anonymous module containing
+    # delegators that point to methods from a class this module is included in
+    # or the given +base+.
+    # 
+    # @param base [Object,Symbol] base object which delegators will point to (defaults to object on which
+    #  this method has been called). If symbol is given, then it should contain the name of a method that
+    #  will be called on current object.
+    # 
+    # @return [Module] anonymous module with proxy module methods delegating actions to +base+ object
+    def configuration_module(base = self)
+      Module.new.tap do |cm|
+        delegators = get_configuration_methods
+        base = send(base) if base.is_a?(Symbol)
+        cm.extend Module.new {
+          delegators.each do |method|
+            module_eval do
+              define_method(method) do |*args|
+                base.send(method, *args)
+              end
+            end
+          end
+        }
+      end
+    end
+
+    # Gets all method names known to configuration engine.
+    # 
+    # @param local_only [Boolean] optional flag that if set, causes only methods added
+    #  by current class or module to be listed.
+    # 
+    # @return [Array<Symbol>] delegated method names
+    def get_configuration_methods(local_only = false)
+      all_delegators = singleton_class.send(:cf_block_delegators) + cf_block_delegators
+      return all_delegators if local_only
+      ancestors.each_with_object(all_delegators) do |ancestor, all|
+        all.merge(ancestor.send(__method__, true)) if ancestor.respond_to?(__method__)
+      end
+    end
+
+    # This DSL method is intended to be used in a class or module to indicate which methods
+    # should be delegated.
+    # 
+    # @param methods [Array<Symbol,String>] list of method names
+    # @return [nil]
+    def configuration_block_delegate(*methods)
+      methods.flatten.each { |m| cf_block_delegators.add(m.to_sym) }
+      @cb_conf_module = nil if @cb_conf_module
+      nil
+    end
+    alias_method :configuration_method,   :configuration_block_delegate
+    alias_method :configuration_methods,  :configuration_block_delegate
+    alias_method :settings_method,        :configuration_block_delegate
+
+    private
+
+    # Getter for +@cf_block_delegators+ internal variable.
+    def cf_block_delegators
+      @cf_block_delegators ||= Set.new
+    end
+
+    # Evaluates configuration block within a context of the given module.
+    def configuration_block_core(conf_module, &block)
+      return conf_module unless block_given?
+      return conf_module.tap(&block) unless block.arity == 0
+      conf_module.module_eval(&block)
+      conf_module
+    end
+
+  end # module ClassMethods
+
+end # module ConfigurationBlocks

data/lib/configuration-blocks/version.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+#
+# Author::    Paweł Wilk (mailto:pw@gnu.org)
+# Copyright:: (c) 2012 by Paweł Wilk
+# License::   This program is licensed under the terms of {file:LGPL-LICENSE GNU Lesser General Public License} or {file:COPYING Ruby License}.
+# 
+# This file contains version information.
+
+module ConfigurationBlocks
+  # @private
+  DEVELOPER   = 'Paweł Wilk'
+  # @private
+  EMAIL       = 'pw@gnu.org'
+  # @private
+  VERSION     = '1.0.0'
+  # @private
+  NAME        = 'configuration-blocks'
+  # @private
+  SUMMARY     = 'Easy way of adding configuration blocks to classes, modules and applications'
+  # @private
+  URL         = 'https://rubygems.org/gems/configuration-blocks/'
+  # @private
+  DESCRIPTION = 'Easy way of adding configuration blocks to classes, modules and applications.'
+end

metadata

@@ -0,0 +1,241 @@
+--- !ruby/object:Gem::Specification
+name: configuration-blocks
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Paweł Wilk
+autorequire: 
+bindir: bin
+cert_chain:
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURLakNDQWhLZ0F3SUJB
+  Z0lCQURBTkJna3Foa2lHOXcwQkFRVUZBREE3TVE4d0RRWURWUVFEREFaemFX
+  Vm0KWTJFeEV6QVJCZ29Ka2lhSmsvSXNaQUVaRmdObmJuVXhFekFSQmdvSmtp
+  YUprL0lzWkFFWkZnTnZjbWN3SGhjTgpNRGt3TmpBMk1Ea3dPREE1V2hjTk1U
+  QXdOakEyTURrd09EQTVXakE3TVE4d0RRWURWUVFEREFaemFXVm1ZMkV4CkV6
+  QVJCZ29Ka2lhSmsvSXNaQUVaRmdObmJuVXhFekFSQmdvSmtpYUprL0lzWkFF
+  WkZnTnZjbWN3Z2dFaU1BMEcKQ1NxR1NJYjNEUUVCQVFVQUE0SUJEd0F3Z2dF
+  S0FvSUJBUUNkazQrOWllU3gySTJPUHNsUGNqL0xqYWp3dHNySAptZXY2RnMz
+  eEs5aGRESWJiTHVRTTlBeXBCUzdOZUtQLzJZVG9FT0d4c3Z6Y3BGekwyQWg3
+  MWNQNllmbitaMllvCnp2cXBBeDUvbmw3OVBySkt2amxrZHpWTk9GQnAvRU9r
+  TEs2N1FLNFB2OTdBQm5HMlBrRjRGb2txT2p1TkhMTTcKNDdPa0pQdkZ5Zkh5
+  TUJEWk43RUZsakJCTm0zSXVRUlRpTzQ4ZTVKY3AzTDc2MVBXT3ZDcG5WOHdp
+  Z2EwV3d0Mwo5OEdteTdjMW5XemZiUWMxd0h3S0xQSUNZL2FpZEtVMjBLeW1T
+  SEc2M0JTVzVwTzJjWFplY0llWWp3NVlOakdBCk0xUlpNaXdUN1FKOVc4NlZW
+  UCs4RXFiSktKT1M5NXhsbVFUSGpQSzU2eVh2OEdpdXlMUUhwUGg1QWdNQkFB
+  R2oKT1RBM01Ba0dBMVVkRXdRQ01BQXdIUVlEVlIwT0JCWUVGS09Lc3BaT05x
+  NGJ0NUQyREVleEIrdnNNQjJHTUFzRwpBMVVkRHdRRUF3SUVzREFOQmdrcWhr
+  aUc5dzBCQVFVRkFBT0NBUUVBVWgwTG5CNG81WEtwSDN5T3hhdkV5cDlYCk5l
+  bjJlODU0d3NTakFyMHdhU1Z6RXQzWHhZMXZveUlFNldDR3haSlUvLzQwQ1Iw
+  QmU3ajVDY3NKc0RVMkNaeVoKOFNYTjEvbVpqTXFXdll5RU1TZlFQNFh6a0ZT
+  T3V5RGNvREFmNDNPR2hPaGR2NUpjcy9FdC9GSDZEZ1dZd1J4cQpSdEFUUldP
+  TjVSOTl1Z1BlUmI3aTFuSXBuekdFQkE5VjMycjZyOTU5QnAzWGprVkVYeWxi
+  SXRZTXFTQVJhWmxZCnF6S1NzSVVqaDd2RHlUTnF0YTBEalNnQ2syNmRobk93
+  YzBobXpodlZadEJ3ZlpyaXRTVmhmQ0xwNXVGd3FDcVkKTkszVElaYVBDaDFT
+  Mi9FUzZ3WE52alErNUVuRUVMOWovcFNFb3A5RFlFQlBhTTJXRFZSNWkwakpU
+  QWFSV3c9PQotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
+date: 2012-12-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: hoe-yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.8.2
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.8.0
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.10
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.10
+- !ruby/object:Gem::Dependency
+  name: hoe-bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: hoe-gemspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.16'
+description: Easy way of adding configuration blocks to classes, modules and applications.
+email:
+- pw@gnu.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- Manifest.txt
+files:
+- .rspec
+- .yardopts
+- ChangeLog
+- LGPL-LICENSE
+- Manifest.txt
+- README.md
+- Rakefile
+- configuration-blocks.gemspec
+- docs/COPYING
+- docs/HISTORY
+- docs/LEGAL
+- docs/LGPL-LICENSE
+- docs/TODO
+- docs/rdoc.css
+- docs/yard-tpl/default/fulldoc/html/css/common.css
+- lib/configuration-blocks.rb
+- lib/configuration-blocks/core.rb
+- lib/configuration-blocks/version.rb
+homepage: https://rubygems.org/gems/configuration-blocks/
+licenses: []
+post_install_message: 
+rdoc_options:
+- --title
+- Configuration::Blocks Documentation
+- --quiet
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2840952254768116890
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: configuration-blocks
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Easy way of adding configuration blocks to classes, modules and applications
+test_files: []