funfig 0.0.2

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.sw[po]

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in funfig.gemspec
+gemspec

data/README

@@ -0,0 +1,81 @@
+Example
+=======
+
+    require 'funfig'
+    
+    UploadConf = Funfig.new do
+      p.root '/services'
+      g.nginx   do
+        p.folder { File.join(_.root, 'nginx') }
+        p.port '8000'
+      end
+      p.public_ip_port '*:80'
+    end
+    
+    conf = UploadConf.new
+    p conf.nginx.folder
+    conf.root = "~/MailProject/upload"
+    p conf.nginx.folder
+    conf.each {|k,v| puts "#{k} #{v}"}
+    p conf
+    p conf.to_hash()
+    p conf.to_hash(true)
+    
+    Up1Conf = UploadConf.clone do
+      g.nginx do
+        p.folder { File.join(_.root, 'nganx') }
+        p.location '/public'
+      end
+    end
+    
+    conf1 = Up1Conf.new
+    conf1.update(conf.to_hash())
+    p conf1
+    conf1.nginx_reset!
+    p conf1
+
+TODO
+====
+
+1. define array of same kinds
+
+    Conf = Funfig.new do
+      p.port 8000
+      p.folder '/folder'
+      array :servers do
+        p.port { _parent.port + _pos }
+        p.folder { File.join(_parent.folder, _pos.to_s) }
+      end
+      a.servers1 do
+        p.port { _parent.port + _pos }
+        p.folder { File.join(_parent.folder, _pos.to_s) }
+      end
+    end
+
+2. define hash of same kinds
+
+    Conf = Funfig.new do
+      hash :environments do
+        p.host 'localhost'
+        p.database { "mybase_#{_name}" }
+      end
+      h.environments1 do
+        p.host 'localhost'
+        p.database { "mybase_#{_name}" }
+      end
+    end
+
+3. Correct composition of schemes
+
+    ConfServ = Funfig.new do
+      p.port 80
+      p.ip   '192.168.168.192'
+    end
+
+    ConfApp = Funfig.new do
+      p.path '/srv/path'
+      g.server ConfServ do
+        p.path { _.path }
+      end
+    end
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/funfig.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "funfig/version"
+
+Gem::Specification.new do |s|
+  s.name        = "funfig"
+  s.version     = Funfig::VERSION
+  s.authors     = ["Sokolov Yura 'funny-falcon'"]
+  s.email       = ["funny.falcon@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Configuration with calculable defaults}
+  s.description = %q{Defines configuration schema with calculable defaults}
+
+  s.rubyforge_project = "funfig"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/lib/funfig/version.rb

@@ -0,0 +1,3 @@
+module Funfig
+  VERSION = "0.0.2"
+end

data/lib/funfig.rb

@@ -0,0 +1,292 @@
+require "funfig/version"
+require "yaml" unless defined? YAML
+
+module Funfig
+  NOT_SET = Object.new.freeze
+  class ProxyParam < BasicObject
+    def initialize(group)
+      @group = group
+    end
+    def method_missing(name, value = NOT_SET, &block)
+      unless value.equal? NOT_SET
+        @group.param name, value
+      else
+        @group.param name, &block
+      end
+    end
+  end
+
+  class ProxyGroup < BasicObject
+    def initialize(group)
+      @group = group
+    end
+    def method_missing(name, &block)
+      @group.group name, &block
+    end
+  end
+
+  class Group
+    def initialize(parent=nil) # :nodoc:
+      @parent = parent
+    end
+
+    # Get enclosing group
+    def _parent
+      @parent
+    end
+
+    # Get root of configuration
+    # :call-seq:
+    #   _
+    #   _root
+    def _
+      @parent._
+    end
+    alias _root _
+
+    # Update config by yaml file
+    def load_file(filename)
+      params = YAML.load_file(filename)
+      update(params)
+    end
+
+    # Update config by hash
+    def update(hash)
+      hash.each{|k, v|
+        self.send("#{k}=", v)
+      }
+    end
+
+    # Iterate over parameter names
+    def each_param
+      return to_enum(:each_param) unless block_given?
+      self.class._params.each{|k, _|
+        yield k
+      }
+    end
+
+    # Iterate over parameters and values
+    # If called with parameter +true+, then iterate only over explicit setted parameters
+    #
+    # :call-seq:
+    #    config.each{|name, value| puts "#{name} = #{value}"}
+    #    config.each(true){|name, value| puts "#{name} = #{value}"}
+    def each(explicit=false)
+      return to_enum(:each, explicit) unless block_given?
+      self.class._params.each{|k, _|
+        yield k, send(k)  unless explicit && !instance_variable_defined?("@#{k}")
+      }
+    end
+
+    # Convert configuration to hash
+    # If called with parameter +true+ than consider only explicit setted parameters
+    def to_hash(explicit=false)
+      h = {}
+      each(explicit){|k, v|
+        if Group === v
+          v = v.to_hash(explicit)
+          next  if explicit && v.empty?
+        end
+        h[k] = v
+      }
+      h
+    end
+
+    def inspect
+      "<#{self.class.name} #{each.map{|k,v| "#{k}=#{v.inspect}"}.join(' ')}>"
+    end
+
+    # :stopdoc:
+
+    def _cache_get(k, &block)
+      _._cache.fetch(_sub_name(k), NOT_SET)
+    end
+
+    def _cache_set(k, v)
+      _._cache[_sub_name(k)] = v
+    end
+
+    def _sub_name(name)
+      self.class._sub_name(name)
+    end
+
+    def _path
+      self.class._path
+    end
+
+    def self._params
+      @params ||= {}
+    end
+
+    def self.initialize_clone(arg)
+      super
+      if @params
+        params, @params = @params, {}
+        params.each{|name, par|
+          if par.is_a?(Class) && Group >= par
+            @params[name] = par.clone
+          else
+            @params[name] = par
+          end
+        }
+      end
+    end
+
+    def self._sub_name(name)
+      "#{_path}.#{name}"
+    end
+
+    # :startdoc:
+
+    # Define named group of values
+    #
+    # :call-seq:
+    #   config = Funfig.new do
+    #     group :name_of_group do
+    #     end
+    #   end
+    def self.group(name, &block)
+      name = name.to_sym
+      vname = :"@#{name}"
+      _prev = _params[name]
+      klass = _prev.is_a?(Class) && Group >= _prev ? _prev : Class.new(Group)
+      _params[name] = klass
+      path = _sub_name(name)
+      const_set name.capitalize, klass
+
+      klass.send(:define_singleton_method, :_path) do
+        path
+      end
+
+      define_method(name) do
+        instance_variable_get(vname) ||
+          instance_variable_set(vname, klass.new(self))
+      end
+
+      define_method("#{name}=") do |hash|
+        send(name).update(hash)
+      end
+
+      define_method("#{name}_reset!") do
+        _._cache_clear!
+        remove_instance_variable(vname)  if instance_variable_defined?(vname)
+      end
+      klass.class_exec ProxyParam.new(klass), &block
+    end
+
+    # define named parameter
+    #
+    # :call-seq:
+    #   config = Funfig.new do
+    #     param :name_of_param do calculate_default_value end
+    #   end
+    def self.param(name, value = NOT_SET, &block)
+      _params[name] = true
+      vname = :"@#{name}"
+      name = name.to_sym
+
+      block ||= proc{
+        begin
+          value.dup
+        rescue TypeError
+          block = proc { value }
+          value
+        end
+      }
+
+      define_method(name) do
+        if instance_variable_defined?(vname)
+          instance_variable_get(vname)
+        else
+          if (v = _cache_get(name)).equal? NOT_SET
+            raise "Parameter #{_sub_name(name)} must be set!" unless block
+            _cache_set(name, (v = instance_eval &block))
+          end
+          v
+        end
+      end
+
+      define_method("#{name}=") do |v|
+        _._cache_clear!
+        instance_variable_set(vname, v)
+      end
+
+      define_method("#{name}_reset!") do
+        _._cache_clear!
+        remove_instance_variable(vname)  if instance_variable_defined?(vname)
+      end
+    end
+
+    # syntax sugar proxy for declaring params
+    #
+    # :call-seq
+    #   conf = Funfig.new do
+    #     p.name_of_param :default_value
+    #     p.other_param { calculate_default }
+    #   end
+    def self.p
+      @proxy_param ||= ProxyParam.new(self)
+    end
+
+    # syntax sugar proxy for declaring group
+    #
+    # :call-seq
+    #   conf = Funfig.new do
+    #     g.name_of_group do
+    #     end
+    #   end
+    def self.g
+      @group_param ||= ProxyGroup.new(self)
+    end
+
+    # Create a copy of configuration scheme
+    #
+    # :call-seq:
+    #   other_conf = config.clone do
+    #     param :other_value do other_default end
+    #   end
+    def self.clone(&block)
+      new = super
+      new.send(:class_eval, &block)  if block_given?
+      new
+    end
+  end
+
+  # :stopdoc:
+  class Root < Group
+    attr_reader :_cache
+    def initialize
+      @_cache = {}
+    end
+
+    def _cache_clear!
+      @_cache.clear
+    end
+
+    def _parent
+      raise "Already at root"
+    end
+
+    def _
+      self
+    end
+
+    def self._path
+      ""
+    end
+
+    def self._sub_name(name)
+      name.to_s
+    end
+  end
+  # :startdoc:
+
+  # Create configuration schema
+  #
+  # :call-seq:
+  def self.new(&block)
+    conf = Class.new(Root)
+    conf.class_exec ProxyParam.new(conf), &block
+    conf
+  end
+end

metadata

@@ -0,0 +1,52 @@
+--- !ruby/object:Gem::Specification
+name: funfig
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Sokolov Yura 'funny-falcon'
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-30 00:00:00.000000000 Z
+dependencies: []
+description: Defines configuration schema with calculable defaults
+email:
+- funny.falcon@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README
+- Rakefile
+- funfig.gemspec
+- lib/funfig.rb
+- lib/funfig/version.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: funfig
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Configuration with calculable defaults
+test_files: []