o 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+*~

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,8 @@
+source :rubygems
+
+group :development do
+	gem 'watchr'
+	gem 'rag'
+end
+
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Guten
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,107 @@
+O, a configuration libraray for Ruby
+====================================
+
+**Homepage**: [https://github.com/GutenLinux/o](https://github.com/GutenLinux/o) <br/>
+**Author**:	Guten <br/>
+**License**: MIT-LICENSE <br/>
+**Documentation**: [http://rubydoc.info/gems/o/frames](http://rubydoc.info/gems/o/frames) <br/>
+**Issue Tracker**: [https://github.com/GutenLinux/o/issues](https://github.com/GutenLinux/o/issues) <br/>
+
+Overview
+--------
+
+	descripe your prjoect here.
+
+Features
+--------
+
+	a clearly list of features.
+
+Introduction
+-------------
+
+	option = O.new
+
+	# assigment
+	option["a"] = 1
+	option[:a] = 1
+	option.a = 1
+
+	# access
+	option["a"] 
+	option[:a] 
+	option.a 
+	option.a? #=> true
+
+	#access Hash methods.
+	option._keys #=> [:a]
+
+assign default value
+
+	option = O.new
+	option.a #=> nil
+
+	option = O.new 0
+	option.a #=> 0
+
+another syntax
+
+	option = O do
+	  base = 1
+	  @a = base
+	  @b = base + 1
+	end
+	option.a #=> 1 
+	option.b #=> 2
+
+
+read option from a file
+
+	# ~/.gutenrc
+	@a = 1
+	@path = Pathname('/home')
+
+	# a.rb
+	require "pathname"
+	option = O.load("~/.gutenrc")
+	option.a #=> 1
+
+configuration file
+------------------
+
+ use instance variable to export field.
+
+	base = 1
+	@a = base 
+	@b = O do
+	  p @a #=> nil   # instance variable can't pass into block
+	  p base #=>  1  # local variable can pass into block
+	  @a = base + 1
+	end
+	
+	# after O.load(file)
+	option.a #=> 1
+	option.b.a #=> 2
+
+Contributing
+-------------
+
+* join the project.
+* report bugs/featues to issue tracker.
+* fork it and pull a request.
+* improve documentation.
+* feel free to post any ideas. 
+
+Install
+----------
+
+	gem install o
+
+Resources
+---------
+
+	some related resources to help each other.
+
+Copyright
+---------
+Copyright &copy; 2011 by Guten. this library released under MIT-LICENSE, See {file:LICENSE} for futher details.

data/Ragfile

@@ -0,0 +1,5 @@
+# add your own task in Ragfile or in tasks/*.rag
+class Rag < Thor
+end
+
+# vim: filetype=ruby

data/lib/o.rb

@@ -0,0 +1,175 @@
+#
+# internal: store data in a Hash, the key of the Hash is always converted to symbol.
+#
+#
+#
+class O < Hash
+	# PATH for O.load
+	PATH = []
+	Error = Exception.new 
+	LoadError = Exception.new(Error)
+
+	class O_Eval
+		def _data
+			_data = {}
+			self.instance_variables.each do |k|
+				key = k[1..-1].to_sym
+				value = self.instance_variable_get(k)
+				_data[key] = value 
+			end
+			_data
+		end
+	end
+
+	class << self
+		# convert <#Hash> to <#O>
+		#
+		# @param [hash] hash
+		# @return O
+		def from_hash hash
+			o = O.new
+			o._replace hash
+		end
+
+		# load a configuration file,
+		# support PATH, and '~/.gutenrc'
+		#
+		# first try name.rb, then use name
+		#
+		# @example
+		#   option = O.load("~/.gutenrc")
+		#   
+		#   O::Path << "/home"
+		#   option = O.load("guten")  #=> try guten.rb; then try guten
+		#   option = O.load("guten.rb")
+		#
+		# @param [String] name
+		# @return [O]
+		def load name
+			path = nil
+			if name =~ /^~/
+				file = File.expand_path(name)
+				path = file if File.exists?(file)
+			else
+				catch :break do
+					PATH.each  do |p|
+						['.rb', ''].each {|ext|
+							file = File.join(p, name+ext)
+							if File.exists? file
+								path = file
+								throw :break
+							end
+						}
+					end
+				end
+			end
+
+			raise LoadError, "can't find file -- #{name}" unless path
+
+			eval_file path
+		end
+
+		# relative load a configuration file
+		# @see load
+		#
+		# @param [String] name
+		# @return [O] option
+		def relative_load name
+			pd caller if $TEST
+			a,file, line, method = caller[0].match(/^(.*):(\d+):.*`(.*)'$/).to_a
+			raise LoadError, "#{type} is called in #{file}" if file=~/\(.*\)/ # eval, etc.
+
+			file = File.readlink(file) if File.symlink?(file)
+
+			path = nil
+			[".rb", ""].each do |ext|
+				f = File.absolute_path(File.join(File.dirname(file), name+ext))
+				if File.exists?(f)
+					path = f
+					break
+				end
+			end
+
+			raise LoadError, "can't find file -- #{name}" unless path
+
+			eval_file path
+		end
+
+		private
+		def eval_file path
+			content = File.open(path){|f| f.read}
+			o_eval = O_Eval.new
+			o_eval.instance_eval(content)
+			O.from_hash(o_eval._data)
+		end
+
+	end
+
+	attr_reader :_data
+
+	def initialize default=nil, &blk
+		@_data = Hash.new(default)
+		if blk
+			o_eval = O_Eval.new
+			o_eval.instance_eval &blk
+			@_data.merge!(o_eval._data)
+		end
+	end
+
+	def []= key, value
+		@_data[key.to_sym] = value
+	end
+
+	def [] key
+		@_data[key.to_sym]
+	end
+
+	def + other
+		O.new(@_data, other._data)
+	end
+
+	def _replace data
+		case data
+		when Hash
+			@_data = data
+		when O
+			@_data = data._data
+		end
+		self
+	end
+
+	#
+	# _method goes to @_data.send(_method, ..)
+	# method? #=> !! @_data[:method]
+	# method #=> @_data[:method]
+	# method=value #=> @_data[:method]=value
+	#
+	def method_missing method, *args, &blk
+		if method =~ /(.*)=$/
+			@_data[$1.to_sym] = args[0]
+		elsif method =~ /(.*)\?$/
+			!! @_data[$1.to_sym]
+		elsif method =~ /^_(.*)/
+			@_data.send($1.to_sym, *args, &blk)
+		else
+			@_data[method]
+		end
+	end
+
+	def inspect 
+		rst = "<#O "
+		@_data.each do |k,v|
+			rst << "#{k}:#{v.inspect} "
+		end
+		rst << " >" 
+	end
+
+	alias to_s inspect
+
+end
+
+module Kernel
+	def O default=nil, &blk
+		O.new(default, &blk)
+	end
+end

data/o.gemspec

@@ -0,0 +1,21 @@
+$: << "."
+require "version"
+
+Gem::Specification.new do |s|
+	s.name = "o"
+	s.version = O::VERSION::IS
+	s.summary = "a configuration libraray for Ruby"
+	s.description = <<-EOF
+a coonfiguration libraray for Ruby
+	EOF
+
+	s.author = "Guten"
+	s.email = "ywzhaifei@Gmail.com"
+	s.homepage = "http://github.com/GutenLinux/o"
+	s.rubyforge_project = "xx"
+
+	s.files = `git ls-files`.split("\n")
+	#s.executables = ["x"]
+
+	#s.add_dependency "x"
+end

data/o.watchr

@@ -0,0 +1,22 @@
+# lib/**/*.rb
+watch %r~lib/(.*)\.rb~ do |m|
+	test "spec/#{m[1]}_spec.rb"
+end
+
+# spec/**/*_spec.rb
+watch %r~spec/.*_spec\.rb~ do |m|
+	test m[0]
+end
+
+# Ctrl-\
+Signal.trap('QUIT') do
+  puts "--- Running all tests ---\n\n"
+	test "spec"
+end
+
+def test path
+	cmd = "rspec #{path}"
+	puts cmd
+	system cmd
+end
+

data/spec/data/home/gutenrc

@@ -0,0 +1 @@
+@a = 1

data/spec/data/lib/guten

@@ -0,0 +1,2 @@
+@a = 1
+

data/spec/data/lib/tag.rb

@@ -0,0 +1 @@
+@a = 1

data/spec/data/lib/test

@@ -0,0 +1,12 @@
+
+base = 1
+
+@a = base
+
+@b = O do
+	@a = 2
+	@c = base
+end
+
+
+# vim: filetype=ruby

data/spec/o_spec.rb

@@ -0,0 +1,111 @@
+require "spec_helper"
+
+class O
+	attr_reader :_data
+end
+
+o = O.relative_load "data/lib/test"
+p o._data
+
+describe O do
+	before :each do
+		@o = O.new
+		@o[:a] = 1
+	end
+
+	describe "#[]=" do
+		it "converts key to symbol" do
+			@o["b"] = 2
+			@o._data[:b].should == 2
+		end
+	end
+
+	describe "#[]" do
+		it "converts key to symbol" do
+			@o["a"].should == 1
+		end
+	end
+
+	describe "#method_missing" do
+		it "calls #key" do
+			@o.a.should == 1
+		end
+
+		it "calls #key?" do
+			@o.a?.should == true
+		end
+
+		it "calls #key=" do
+			@o.b = 2
+			@o._data[:b].should == 2
+		end
+
+		it "calls #_method" do
+			@o._keys.should == [:a]
+		end
+
+
+	end
+
+	describe ".new" do
+		it "has default value" do
+			O.new.a.should == nil
+			O.new(1).a.should == 1
+		end
+		it "retrive a block" do
+			o = O.new do
+				base = 1
+				@a = base
+				@b = base + 1
+			end
+			o.a.should == 1
+			o.b.should == 2
+		end
+	end
+
+	describe ".load" do
+		it "support ~/path" do
+			ENV["HOME"] = File.join($spec_dir, "data/home")
+			o = O.load("~/gutenrc")
+			o._data.should == {a: 1}
+		end
+
+		it "support PATH" do
+			O::PATH << File.join($spec_dir, "data/lib")
+
+			o = O.load("tag.rb")
+			o._data.should == {a: 1}
+
+			o = O.load("guten")
+			o._data.should == {a: 1}
+
+		end
+	end
+
+	describe ".relative_load" do
+		o = O.relative_load "data/lib/guten"
+		o._data.should == {a: 1}
+
+		o = O.relative_load "data/lib/tag.rb"
+		o._data.should == {a: 1}
+	end
+
+end
+
+describe O::O_Eval do
+	it "works" do
+		o = O::O_Eval.new
+		o.instance_eval <<-EOF
+			@a = 1
+		EOF
+
+		o._data.should == {a: 1}
+	end
+end
+
+describe "#O" do
+	option = O do
+		@a = 1
+	end
+	option._data.should == {a: 1}
+end

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require "o"
+
+$spec_dir = File.dirname(__FILE__)

data/version.rb

@@ -0,0 +1,9 @@
+module O
+	module VERSION
+		MAJOR = 0
+		MINOR = 1
+		PATCH = 0
+
+		IS = [MAJOR, MINOR, PATCH].join(".") 
+	end
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: o
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Guten
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-10 00:00:00 Z
+dependencies: []
+
+description: |
+  a coonfiguration libraray for Ruby
+
+email: ywzhaifei@Gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Ragfile
+- lib/o.rb
+- o.gemspec
+- o.watchr
+- spec/data/home/gutenrc
+- spec/data/lib/guten
+- spec/data/lib/tag.rb
+- spec/data/lib/test
+- spec/o_spec.rb
+- spec/spec_helper.rb
+- version.rb
+homepage: http://github.com/GutenLinux/o
+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: xx
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: a configuration libraray for Ruby
+test_files: []
+