= cutagem - Cut a Gem for creating new beautiful gem.

by cho45 <cho45@lowreal.net>

== Description

cutagem (Cut a Gem) is yet another executable for creating gem skelton.

This is similar in concept to newgem[http://newgem.rubyforge.org/] but
more customizable for each user.

cutagem (Cut a Gem: 宝石のカット) は新しい gem のスケルトンを作るコマンドです。

newgem[http://newgem.rubyforge.org/] とよく似たものですが、cutagem は
各ユーザがカスタマイズしやすいようになっています。

== Concept

* User customizable templates.
* Not use hoe, etc. Because it makes difficult to customize the created Rakefile.
  A time like this, copy and paste is better than DRY.
* Do not use more config file which is written what can be written in Rakefile
  in default template.

   

* ユーザ固有のテンプレート
* hoe とかを使いません。これは生成された Rakefile を更めてその gem 用に
  カスタマイズしたいときにめんどくさくないようにです。
* このパッケージのテンプレートは、
  Rakefile に書けば済むことを設定として分離したりしません。

== Installation

=== Gem Installation

  gem install cutagem

=== Subversion Repository

Hosted by CodeRepos[http://coderepos.org/share/browser/lang/ruby/cutagem]

  svn co http://svn.coderepos.org/share/lang/ruby/cutagem/

== Usage

Most simple sample:

  $ cutagem gemname
  Using Template: .cutagem/templates/default
  ~/.cutagem/config.yaml is not found. Use default.
  cp -r /pathto/templates/default /pathto/gemname
  Rename test/gemname_test.rb to test/gemname_test.rb
  Rename lib/gempath.rb to lib/gemname.rb
  Done.
  Type any key to edit Rakefile.
  

When +gemname+ includes hyphens, it's replaced with "/".

  $ cutagem module-test
  Using Template: .cutagem/templates/default
  ~/.cutagem/config.yaml is found. Use it.
  cp -r /pathto/templates/default /pathto/module-test
  Rename test/gemname_test.rb to test/module-test_test.rb
  Rename lib/gempath.rb to lib/module/test.rb
  Done.
  Type any key to edit Rakefile.


  $ ls module-test/lib/module/test.rb
  module-test/lib/module/test.rb


Select templates interactively. (<code>-s</code>, <code>--select</code> option)

  $ cutagem -s module-test
  Select template:
   1. .cutagem/templates/default
   2. default
   3. command
  1
  Using Template: .cutagem/templates/default
  ~/.cutagem/config.yaml is found. Use it.
  cp -r /pathto/templates/default /pathto/module-test
  Rename test/gemname_test.rb to test/module-test_test.rb
  Rename lib/gempath.rb to lib/module/test.rb
  Done.
  Type any key to edit Rakefile.


Edit user configuration.

  $ cutagem -c
  [Open ~/.cutagem/config.yaml with $EDITOR]

Other options:

  Usage: cutagem [options] gemname
  
  Options:
  -s, --select                     Select template interactively.
  -d, --desc                       Describe this gem.
  -c, --config                     Configure user values. Use $EDITOR
      --copy-template NAME         Copy template to user template dir naming NAME
      --version                    Show version string `0.0.2'


== Customization

+cutagem+ reads ~/.cutagem/templates/* for using it as custom template.
Especially "default" template is precedence.

You can make new template by coping the existing template using '--copy-template NAME' option.

=== Priority Example

Library installed templates:

* default
* command

User templates:

* ~/.cutagem/templates/default
* ~/.cutagem/templates/foobar

Priority order:

1. ~/.cutagem/templates/default
2. ~/.cutagem/templates/foobar
3. default (system)
4. command (system)

If you want to check this priority, add <code>-s</code>, <code>--select</code> option to +cutagem+.


=== Template Spec.

==== File Name Replacement

[gemname]
  The argument +gemname+.
[gempath]
  The string created by replacing "-" with "/" in +gemname+.
  (ex. gemname is <code>hoge-hoge</code> then, gempath is <code>hoge/hoge</code>)
  The path is automatically created.

==== ERB Replacement

All files process through ERB.

[<%=gemname%>]
  same as filename.
[<%=gempath%>]
  same as filename.
[<%=gemclass%>]
  classfied gemname.
  (ex. gemname is <code>hoge-hoge_fuga</code> then, gemclass is <code>Hoge::HogeFuga</code>)
[<%=author%>]
  ENV["USER"] or ~/.cutagem/config.yaml#author
[<%=email%>]
  <code>#{ENV["USER"]}@#{ENV["HOST"]}</code> or ~/.cutagem/config.yaml#email
[<%=description%>]
  <code>-d</code>, <code>--desc</code> option's value
[<%=config["user_config_value"]%>]
  Replace with ~/.cutagem/config.yaml entry.

Of course ERB is Ruby, you can write everything in the bracket.

== Copyright

Author::    cho45 <cho45@lowreal.net>
Copyright:: Copyright (c) 2007 cho45 www.lowreal.net
License::   Ruby's