Tagen, a core and extra extension to Ruby library.
==========================================

**Homepage**: [https://github.com/GutenLinux/tagen](https://github.com/GutenLinux/tagen) <br/>
**Author**: 	Guten <br/>
**Contributors**: See Contributors section below  <br/>
**License**: MIT License <br/>
**Documentation**: [http://rubydoc.info/gems/tagen/frames](http://rubydoc.info/gems/tagen/frames) <br/>
**Issue Tracker**: [https://github.com/GutenLinux/tagen/issues](https://github.com/GutenLinux/tagen/issues) <br/>

Overview
--------

Ruby has an 'Open Class' feature, so we can extend any class by ourself.

This library provides some usefull Ruby core extension.  some comes from ActiveSupport. ActiveSupport is mainly target to Rails, but tagen is target to generic ruby development, and tagen is smaller. It is a colletion of most common core,extra extensions.

This library comes with a string format lib named {PyFormat}.

Usage
-----
use core extension

	require "tagen/core"

then we have String#blank? method, for a list of core extensions, see {file:docs/CoreExtensions.md docs/CoreExtensions}.

use extra extension

	require "pathname"
	require "tagen/pathname"

or

	require "tagen/pathname" # auto require "pathname"

this will add #path method to Pathname, see API doc.

Requirements
------------

	tested: ruby1.9 linux


An Introduction to PyFormat
---------------------------

	require "tagen/core"
	"I like %{fruit} and %{sport}".format('apple', 'football') 
	"I like %{fruit} and %{sport}".format(fruit: 'apple', sport: 'football') 

	"it costs %{howmatch:.2f} dollars".format(1.123) #=> "it costs 1.12 dollars"
	
more see API doc


Documentation
-------------

* {file:docs/CoreExtensions.md CoreExtensions} A list of core extensions.
* {file:docs/ExtraExtensions.md ExtraExtensions} A list of extra extensions.
* {file:docs/Architecture.md Architecture} Source code architecture.

Install
----------
	gem install tagen

Contributing
-------------

* report bugs/featues to issue tracker.
* fork it and pull a request.
* improve documentation.
* feel free to post any ideas. 

Contributors
------------

WORD-III


Copyright
---------
Copyright &copy; 2011 by Guten. this library released under MIT-License, See {file:LICENSE} for futher details.

asddf
asdf