lepidoptera 0.2.0

data/.gitignore

@@ -0,0 +1,2 @@
+.bundle
+pkg

data/HISTORY.md

@@ -0,0 +1,22 @@
+## Version 0.2.0, released 07.11.2010
+
+Due to a naming conflict with [an other project][1], I changed the name of the project and of the gem from __butterfly__ to __lepidoptera__, which is etymological the same.
+
+* [CHG] renaming of executable.
+
+
+## Version 0.1.1, released 06.11.2010
+
+kolleske made some fixes for Windows compatibility.
+
+* [FIX] require win32console to use cli color on Windows.
+* [FIX] set explicitly an executable file.
+
+
+## Version 0.1.0, released 04.11.2010
+
+Initial release!
+
+
+
+[1]: http://butterflycode.sourceforge.net/ "Butterfly Code Generator"

data/README.md

@@ -0,0 +1,151 @@
+lepidoptera
+===========
+
+Lepidoptera /ˌlɛpɪˈdɒptərə/
+
+1. _an order of insects that comprises the butterflies and moths. They have four large scale-covered wings that bear distinctive markings, and larvae that are caterpillars._ ORIGIN _modern Latin (plural), from Greek lepis, lepid- ‘scale’ + pteron ‘wing.’_
+
+2. _A life-enhancing __code generator__ for everyday use._
+
+What is lepidoptera?
+--------------------
+
+Lepidoptera is a very simple and easy extensible __code generator for common every day projects__.  
+Technically, Lepidoptera is a wrapper for [rubigen][r] which allows setting up code templates for arbitrary projects.
+
+Code generators integrated into Lepidoptera are structured in __generator groups__, whereas every group can have multiple __generator types__.
+
+For the time being, Lepidoptera has code generators for the following projects (more to come):
+
+   * [jquery][j] plugins, 
+   * static pages hosted on [heroku][h], 
+   * [sinatra][s] application hosted on [heroku][h].
+
+Installation
+------------
+
+    $ sudo gem install lepidoptera
+
+As [lep][wiki-2] (/ˈlɛp/) is a short for [lepidoptera][wiki-1], this gem will install an executable `lep`
+
+For aesthetic reasons, you may also set a synonym executable `butterfly` alias in your `.bashrc` file:
+
+    $ alias butterfly='lep $1'
+    
+Usage
+-----
+
+for grouped code generators:
+
+    lep [options] <generator-group> <generator-type> <project-name>
+
+or for ungrouped code generators:
+
+    lep [options] <generator-type> <project-name>
+
+with the following __options__:
+
+    -q, --quiet              Suppress status output.
+    -g, --git                Create a git repository after code generation.
+    -n, --new                Add a new code generator in ~/.lepidoptera
+    -h, --help               Print generator's options and usage.
+ 
+and - for the time being - the following __code generators__ which are included in this gem:
+
+    heroku static
+    heroku sinatra
+    jquery plugin
+  
+Helpers
+-------
+
+Get a list of all code generators grouped by generator-groups:
+
+    $ lep
+
+Get a list of all code generator-types for a given generator-group:
+
+    $ lep <generator-group>
+
+Extending Code Generators
+-------------------------
+
+Since lepidoptera is based on _Nic Williams_ Ruby generator framework [rubigen][r], it is very simple to add new own private code generators.
+
+You may include new code generators by putting the following code structure into `~/.lepidoptera`:
+
+    ~/.lepidoptera
+      └─ name
+         ├─ INFO
+         ├─ name_generator.rb
+         └─ template
+            ├─ a file
+            ├─ ...
+            └─ a folder
+
+Much more easy is to use a generator generator which generates the above code generator stub into `~/.lepidoptera`: (TODO)
+
+    $ lep -n <type-of-code-generator>
+    $ lep -n <code-generator-group> <type-of-code-generator>
+
+Integrated Code Generators
+==========================
+        
+jQuery Generators
+-----------------
+
+get List of all jquery generators:
+
+    $ lep jquery
+
+generate code for a jquery plugin:
+
+    $ lep jquery plugin <plugin-name>
+
+Heroku Generators
+-----------------
+
+get List of all heroku generators:
+
+    $ lep heroku
+
+generate code for a static page on heroku:
+
+    $ lep heroku static <page-name>
+    
+generate code for a sinatra application on heroku:
+
+    $ lep heroku sinatra <app-name>
+
+License
+=======
+
+Copyright 2010 Thomas Duerr (me@thomd.net)
+
+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.
+    
+    
+[wiki-1]: http://en.wikipedia.org/wiki/Lepidoptera "Lepidoptera on Wiktionary"
+[wiki-2]: http://en.wiktionary.org/wiki/lep "Lep on Wiktionary"
+[j]: http://jquery.com/ "jQuery: The Write Less, Do More, JavaScript Library"
+[h]: http://heroku.com/ "heroku | Ruby Cloud Platform as a Service"
+[s]: http://www.sinatrarb.com/ "Sinatra"
+[r]: http://rubigen.rubyforge.org/ "rubigen - Ruby Generator Framework"
+

data/Rakefile

@@ -0,0 +1,26 @@
+#
+# generate gemspec file
+#
+# usage:
+#   rake -T 
+#
+begin
+  require 'jeweler'
+  require File.dirname(__FILE__) + '/lib/butterfly'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "lepidoptera"
+    gemspec.version = Butterfly::VERSION
+    gemspec.summary = "a life-enhancing code generator for everyday use"
+    gemspec.description = "Lepidoptera is a very simple and easy extensible code generator for common every day projects."
+    gemspec.email = "thomduerr@gmail.com"
+    gemspec.homepage = "http://github.com/thomd/lepidoptera/"
+    gemspec.authors = ["Thomas Duerr"]
+    gemspec.executables = ["lep"]
+    gemspec.add_dependency "rubigen", ">= 1.5.5"
+    gemspec.add_dependency "git", ">= 1.2.5"
+    gemspec.add_development_dependency "jeweler", ">= 1.4.0"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: gem install jeweler"
+end

data/bin/lep

@@ -0,0 +1,117 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'optparse'
+require 'rubigen'
+require 'rubigen/scripts/generate'
+require File.dirname(__FILE__) + "/../lib/butterfly"
+require File.dirname(__FILE__) + "/../lib/options"
+require File.dirname(__FILE__) + "/../lib/base"
+
+
+# defines some colors for a nice command-line output
+begin
+  require 'Win32/Console/ANSI' if RUBY_PLATFORM =~ /win32/
+rescue LoadError
+  raise 'You must gem install win32console to use color on Windows'
+end
+PURPLE = "\033[0;35m"
+BLUE   = "\033[0;34m"
+WHITE  = "\033[0;37m"
+GREEN  = "\033[0;32m"
+YELLOW = "\033[0;33m"
+RED    = "\033[0;31m"
+
+
+### Set up generators
+
+# get code generators
+generators = Butterfly::CodeGenerators.new
+
+
+### Parse options and arguments from command-line
+
+# get options parser
+parser = Butterfly::Options::Parser.new(generators)
+
+# parse and get options
+options = parser.parse(ARGV)
+
+
+# After parsing the options,
+#  * first argument should be <generator-group>
+#  * second argument should be <generator-type>
+#  * third argument should be a <project_name>
+#
+# If no argument is left, show a list of available generator-groups
+if ARGV.empty?
+  parser.show_groups
+end
+
+
+# If one argument is provided, regard it as the name of a generator-group.
+# If the generator-group name is an existing generator-group, show a list of available generator-types 
+if ARGV.length == 1
+  
+  generator_group = ARGV[0]
+  
+  if generators.names.include?(generator_group)
+    parser.show_types(generator_group)
+  else
+    raise Butterfly::GeneratorError, "#{RED}generator group '#{generator_group}' does not exist.#{WHITE}" 
+  end
+  
+end
+
+
+# If two arguments are provided, regard the first as the name of a generator-group and the second as the name of a generator-type.
+# If the generator-type name is an existing generator-type, ask for a project name 
+if ARGV.length == 2
+
+  generator_group = ARGV[0]
+  generator_types = generators.types_of(generator_group)
+  generator_type = ARGV[1]
+
+  if generator_types.include?(generator_type)
+    parser.ask_for_project(generator_group, generator_type)
+  else
+    raise Butterfly::GeneratorError, "#{RED}generator type '#{generator_type}' does not exist in generator group '#{generator_group}'.#{WHITE}" 
+  end  
+
+end
+
+
+# If three arguments are provided, the first is the generator-group, the second the generator-type ans the thirs the project name.
+generator_group = ARGV.shift
+generator_type = ARGV.shift
+
+# check if generator group exists
+if !generators.names.include?(generator_group)
+  raise Butterfly::GeneratorError, "#{RED}generator group '#{generator_group}' does not exist.#{WHITE}" 
+end
+
+# check if generator type exists
+if !generators.types_of(generator_group).include?(generator_type)
+  raise Butterfly::GeneratorError, "#{RED}generator type '#{generator_type}' does not exist in generator group '#{generator_group}'.#{WHITE}" 
+end  
+
+project_name = ARGV[0]
+
+
+# DEBUG 
+#puts "generator group: #{generator_group}"
+#puts "generator type:  #{generator_type}"
+#puts "project name:    #{project_name}"
+#puts "options:         #{options}"
+
+
+### generate code!
+
+# Add only the code generator of the selected generator-group to the beginning of a list of sources.
+# This is to make generator-types with the same name clear
+RubiGen::Base.prepend_sources(generators.source_of(generator_group)) 
+
+
+# generate a new project <project_name> of type <generator_type>
+RubiGen::Scripts::Generate.new.run(ARGV, :generator => generator_type, :quiet => options[:quiet], :gitinit => options[:gitinit])
+

data/heroku_generators/sinatra/INFO

@@ -0,0 +1,10 @@
+------------
+deploy sinatra project on heroku with:
+
+<% if !gitinit then %>
+    git init
+    ...
+<% end %>
+    heroku create <%= name %>
+    git push heroku master
+    heroku open

data/heroku_generators/sinatra/sinatra_generator.rb

@@ -0,0 +1,18 @@
+class SinatraGenerator < Butterfly::Base
+  
+  def manifest
+    record do |m|
+
+      # Ensure appropriate generators folder exists
+      m.directory ""
+
+      # Generator stub
+      m.template "app.rb", "#{@name}_app.rb"
+      m.template "config.ru", "config.ru"
+      m.template "README.md", "README.md"
+      m.file ".gems", ".gems"
+    end
+  end
+
+end
+

data/heroku_generators/sinatra/templates/.gems

@@ -0,0 +1 @@
+sinatra

data/heroku_generators/sinatra/templates/README.md

@@ -0,0 +1,5 @@
+# <%= name %>
+
+sinatra application to be deployed on [heroku][h].
+
+[h]: http://heroku.com/ "heroku"

data/heroku_generators/sinatra/templates/app.rb

@@ -0,0 +1,23 @@
+require 'rubygems'
+require 'sinatra'
+
+configure :production do
+  # Configure stuff here you'll want to
+  # only be run at Heroku at boot
+
+  # TIP:  You can get you database information
+  #       from ENV['DATABASE_URI'] (see /env route below)
+end
+
+# Quick test
+get '/' do
+  "<%= name %> on Heroku!"
+end
+
+# You can see all your app specific information this way.
+# IMPORTANT! This is a very bad thing to do for a production
+# application with sensitive information
+
+# get '/env' do
+#   ENV.inspect
+# end

data/heroku_generators/sinatra/templates/config.ru

@@ -0,0 +1,3 @@
+require '<%= name %>_app'
+
+run Sinatra::Application

data/heroku_generators/static/INFO

@@ -0,0 +1,10 @@
+------------
+deploy static project on heroku with:
+
+<% if !gitinit then %>
+    git init
+    ...
+<% end %>
+    heroku create <%= name %>
+    git push heroku master
+    heroku open

data/heroku_generators/static/static_generator.rb

@@ -0,0 +1,24 @@
+class StaticGenerator < Butterfly::Base
+  
+  def manifest
+    record do |m|
+
+      # installation skeleton (intermediate directories are automatically created).
+      %w(
+        public/css
+        public/js
+        public/images
+      ).each { |path| m.directory path }
+
+      # Create file stubs
+      %w(
+        config.ru
+        README.md
+        public/index.html
+        public/css/main.css
+        public/js/app.js
+      ).each { |file| m.template file, file }
+    end
+  end
+
+end

data/heroku_generators/static/templates/README.md

@@ -0,0 +1,27 @@
+<%= name %>
+===========
+
+A static page for deployment on [heroku][1]:
+
+Author: <%= author %>
+
+Deployment
+----------
+
+<% if !gitinit then %>
+    $ git init
+<%- end -%>
+    $ ...
+    $ heroku create <%= name %>
+    $ git push heroku master
+    $ heroku open
+
+Meta
+----
+
+the `index.html` loads a [CSS Reset][2] and the [jQuery 1.4.3][3] library.
+
+
+[1]: http://heroku.com/  "Heroku"
+[2]: http://code.google.com/p/reset5/  "HTML5 CSS Reset"
+[3]: http://jquery.com/  "jquery.com"

data/heroku_generators/static/templates/config.ru

@@ -0,0 +1,28 @@
+#
+# deploy a static page on heroku
+# ------------------------------
+#
+#
+# required site structure:
+#
+#   name-of-site
+#   |- config.ru
+#   +- public
+#      |- index.html
+#      |- css
+#      |- js
+#      +- images
+#
+#
+#
+# deployment:
+#
+#   git init
+#   ...
+#   heroku create <name-of-site>
+#   git push heroku master
+#
+#
+
+use Rack::Static, :urls => ["/css", "/images", "/js"], :root => "public"
+run lambda { |env| [200, { 'Content-Type' => 'text/html', 'Cache-Control' => 'public, max-age=86400' }, File.open('public/index.html', File::RDONLY)] }

data/heroku_generators/static/templates/public/index.html

@@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+
+  <title><%= name %></title> 
+
+  <link rel="stylesheet" href="http://reset5.googlecode.com/hg/reset.css" />
+  <link rel="stylesheet" href="css/main.css" />
+</head>
+<body>
+
+  <h1><%= name %></h1>
+  
+  <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.3/jquery.min.js"></script>
+  <script type="text/javascript" src="js/app.js"></script>
+  <script type="text/javascript">
+    $(function(){
+      
+    });
+  </script>
+</body>

data/jquery_generators/plugin/plugin_generator.rb

@@ -0,0 +1,16 @@
+class PluginGenerator < Butterfly::Base
+  
+  def manifest
+    record do |m|
+
+      # Ensure appropriate generators folder exists
+      m.directory "js"
+
+      # Generator stub
+      m.template "js/jquery.plugin_name.js", "js/jquery.#{@name}.js"
+      m.template "demo.html", "demo.html"
+    end
+  end
+
+end
+

data/jquery_generators/plugin/templates/demo.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+
+  <title>jquery.<%= name %>.js</title> 
+
+  <link rel="stylesheet" href="http://reset5.googlecode.com/hg/reset.css" />
+</head>
+<body>
+
+  <h1>jquery.<%= name %>.js</h1>
+  
+  <ul>
+    <li>element-1</li>
+    <li>element-2</li>
+    <li>element-3</li>
+    <li>element-4</li>
+  </ul>
+  
+  <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.3/jquery.min.js"></script>
+  <script type="text/javascript" src="js/jquery.<%= name %>.js"></script>
+  <script type="text/javascript">
+    $(function(){
+      $('li').<%= name %>();
+    });
+  </script>
+</body>

data/jquery_generators/plugin/templates/js/jquery.plugin_name.js

@@ -0,0 +1,57 @@
+/* 
+*  jquery <%= name %> plugin
+*  
+*  author: <%= author %>
+*
+*/
+(function($) {
+
+  //
+  // plugin definition
+  //
+  $.fn.<%= name %> = function(options) {
+    
+    debug(this);
+    
+    // merge options into default options
+    var opts = $.extend({}, $.fn.<%= name %>.defaults, options);
+    
+    // iterate through each matched element
+    return this.each(function() {
+      
+      $this = $(this);
+      
+      // build element specific options
+      var o = $.meta ? $.extend({}, opts, $this.data()) : opts;
+      
+      // TODO
+      
+
+    });
+  };
+  
+  
+  //
+  // private debug function
+  //
+  function debug(obj) {
+    if (window.console && window.console.log)
+      window.console.log('<%= name %> selection count: ' + obj.size());
+  };
+  
+  //
+  // define function to be called from outside
+  //
+  $.fn.<%= name %>.foo = function() {
+
+  };
+
+  //
+  // plugin defaults
+  //
+  $.fn.<%= name %>.defaults = {
+    property1: 'value1',
+    property2: 'value2'
+  };
+
+})(jQuery);

data/lepidoptera.gemspec

@@ -0,0 +1,73 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{lepidoptera}
+  s.version = "0.2.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Thomas Duerr"]
+  s.date = %q{2010-11-07}
+  s.default_executable = %q{lep}
+  s.description = %q{Lepidoptera is a very simple and easy extensible code generator for common every day projects.}
+  s.email = %q{thomduerr@gmail.com}
+  s.executables = ["lep"]
+  s.extra_rdoc_files = [
+    "README.md"
+  ]
+  s.files = [
+    ".gitignore",
+     "HISTORY.md",
+     "README.md",
+     "Rakefile",
+     "bin/lep",
+     "heroku_generators/sinatra/INFO",
+     "heroku_generators/sinatra/sinatra_generator.rb",
+     "heroku_generators/sinatra/templates/.gems",
+     "heroku_generators/sinatra/templates/README.md",
+     "heroku_generators/sinatra/templates/app.rb",
+     "heroku_generators/sinatra/templates/config.ru",
+     "heroku_generators/static/INFO",
+     "heroku_generators/static/static_generator.rb",
+     "heroku_generators/static/templates/README.md",
+     "heroku_generators/static/templates/config.ru",
+     "heroku_generators/static/templates/public/css/main.css",
+     "heroku_generators/static/templates/public/index.html",
+     "heroku_generators/static/templates/public/js/app.js",
+     "jquery_generators/plugin/INFO",
+     "jquery_generators/plugin/plugin_generator.rb",
+     "jquery_generators/plugin/templates/demo.html",
+     "jquery_generators/plugin/templates/js/jquery.plugin_name.js",
+     "lepidoptera.gemspec",
+     "lib/base.rb",
+     "lib/butterfly.rb",
+     "lib/options.rb"
+  ]
+  s.homepage = %q{http://github.com/thomd/lepidoptera/}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{a life-enhancing code generator for everyday use}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rubigen>, [">= 1.5.5"])
+      s.add_runtime_dependency(%q<git>, [">= 1.2.5"])
+      s.add_development_dependency(%q<jeweler>, [">= 1.4.0"])
+    else
+      s.add_dependency(%q<rubigen>, [">= 1.5.5"])
+      s.add_dependency(%q<git>, [">= 1.2.5"])
+      s.add_dependency(%q<jeweler>, [">= 1.4.0"])
+    end
+  else
+    s.add_dependency(%q<rubigen>, [">= 1.5.5"])
+    s.add_dependency(%q<git>, [">= 1.2.5"])
+    s.add_dependency(%q<jeweler>, [">= 1.4.0"])
+  end
+end
+

data/lib/base.rb

@@ -0,0 +1,48 @@
+
+module Butterfly
+
+  # extend Base class wwith base functionality for all butterfly generators
+  class Base < RubiGen::Base
+
+    attr_reader :name, :author, :gitinit
+
+    def initialize(runtime_args, runtime_options = {})
+      super
+      @destination_root = File.expand_path(args.shift)
+      @name = base_name
+      @author = ENV['USER']
+      @gitinit = runtime_options[:gitinit]
+    end
+
+    # do some final things after generation
+    def after_generate
+      git_init if @gitinit
+      info_message
+    end
+
+    protected
+
+    # create an empty git repository and commit generated files
+    def git_init
+      require 'git'
+      begin
+        g = Git.open(@destination_root)
+        logger.exists '.git'
+      rescue ArgumentError
+        g = Git.init(@destination_root)
+        g.add(@destination_root)
+        g.commit("beginning of #{@name} project")
+        logger.create '.git'
+      end
+    end
+
+    # Read INFO from file in generator base path.
+    def info_message
+      info = File.read(File.join(spec.path, 'INFO')) rescue ''
+      template = ERB.new(info, nil, '<>')
+      puts "\n#{template.result(binding)}"
+    end
+  
+  end
+
+end

data/lib/butterfly.rb

@@ -0,0 +1,122 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'rubygems'
+require 'rubigen'
+
+
+module Butterfly
+
+  # Current version
+  VERSION = '0.2.0'
+
+  # path of build-in code generators
+  GENERATORS_PATH = File.join(File.dirname(__FILE__), '..', '*_generators')
+
+  # path of user code generators
+  USER_PATH = File.join(Dir.user_home, '.lepidoptera', '*_generators')
+
+
+  # Error handling
+  class GeneratorError < StandardError
+  end
+
+  class GeneratorSourceMissingError < StandardError
+  end
+
+
+  # Generator
+  class CodeGenerators
+    
+    attr_accessor :generators
+    
+    def initialize
+      @generators = []
+
+      # loop through build in code generators and user code generators
+      [GENERATORS_PATH, USER_PATH].each do |path|
+        Dir[path].each do |file|
+          @generators.push(GeneratorGroup.new(file)) if File.directory?(file)
+        end
+      end
+    end
+    
+    # returns array of generator-group names
+    def names
+      generators.map{ |generator| generator.name }
+    end
+
+    # returns array of generator-group sources
+    def sources
+      generators.map{ |generator| generator.source }      
+    end
+    
+    # returns generator source for a given generator-group
+    def source_of(name)
+      selected = generators.select { |n| n.name == name }
+      if selected.length == 0
+        raise Butterfly::GeneratorSourceMissingError
+      else
+        selected[0].source
+      end
+    end
+    
+    # returns array of generator-types for a given generator-group
+    def types_of(name)
+      selected = generators.select { |n| n.name == name }
+      if selected.length == 0
+        []
+      else
+        selected[0].types
+      end
+    end
+    
+    
+    # a generator-group contains a generator name, its path and its generator-types
+    class GeneratorGroup
+      
+      attr_accessor :name, :source, :types, :label
+      
+      def initialize(file)
+        @name = File.basename(file).gsub(/_generators$/, '')
+        @source = RubiGen::PathSource.new(:app, file)
+        @types = @source.names(:visible)
+        @label = @source.label
+      end
+    end
+    
+  end
+end
+
+
+# tweaking some things in Rubigen which does not fit to Butterfly
+module RubiGen
+  
+  # adding colored output for logger
+  class SimpleLogger
+    def log(status, message, &block)
+
+      # define some status colors
+      status_color = {
+        :exists => RED, 
+        :identical => BLUE, 
+        :create => GREEN,
+        :force => GREEN,
+        :skip => RED
+      }
+
+      template = "#{status_color[status.to_sym]}%12s#{WHITE}  %s%s\n"
+      template = "%12s  %s%s\n" if RUBY_PLATFORM =~ /win32/
+      
+      @out.print(template % [status, '  ' * @level, message]) unless quiet
+      indent(&block) if block_given?
+    end
+  end
+  
+  # show not only generators with an USAGE file
+  # (don't understand the usecase for this in rubigen)
+  class Spec
+    def visible?
+      true
+    end
+  end
+end

data/lib/options.rb

@@ -0,0 +1,112 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'rubygems'
+require 'rubigen'
+require 'optparse'
+
+
+
+# define global default option definitions
+class OptionParser
+  def add_default(opts)
+    self.separator ""
+
+#    self.on("-n", "--new", "Add a new code generator in ~/.lepidoptera") do
+#      opts[:new] = true
+#    end
+
+    self.on("-q", "--quiet", "Suppress status output") do
+      opts[:quiet] = true
+    end
+
+    self.on("-g", "--git","Create a git repository after code generation") do
+      opts[:gitinit] = true
+    end
+
+#    self.on("-s", "--svn [URL]","Initial import into a given svn repository") do |url|
+#      opts[:svnimport] = url
+#    end
+
+    self.on("-h", "--help", "Show help") do
+      puts self
+      exit
+    end
+
+    self.separator ""
+    self.define_head "Version #{Butterfly::VERSION}"
+    self.define_head "A life-enhancing code generator for everyday use."
+    self.define_head ""
+  end
+end
+
+
+
+module Butterfly
+  module Options
+  
+    # Default options. Overriden by command-line options.
+    OPTIONS = {
+      :quiet => false,
+      :gitinit => false,
+      :svnimport => false,
+      :new => false
+    }
+
+    # parser class
+    class Parser
+      attr_accessor :generators
+      
+      def initialize(generators)
+        @generators = generators
+      end
+      
+      def parse(args)
+        options = OPTIONS
+        parser = OptionParser.new do |opts|
+          opts.add_default(options)
+        end
+        parser.parse!(args)
+        options
+      end
+
+      def show_groups
+        parser = OptionParser.new do |opts|
+          opts.banner = "Usage: #{PURPLE}#{File.basename($0)}#{WHITE} [options] #{BLUE}<generator-group>#{WHITE} <generator-type> <project-name>"
+          opts.add_default(options = {})
+          opts.separator "#{BLUE}Please choose a generator-group:#{WHITE}"
+          opts.separator ""
+          @generators.names.each do |name|
+            opts.separator "    #{BLUE}#{name}#{WHITE}"
+          end
+        end
+        parser.parse(["-h"]) 
+        exit
+      end
+
+      def show_types(generator_group)
+        parser = OptionParser.new do |opts|
+          opts.banner = "Usage: #{PURPLE}#{File.basename($0)}#{WHITE} [options] #{PURPLE}#{generator_group}#{WHITE} #{BLUE}<generator-type>#{WHITE} <project-name>"
+          opts.add_default(options = {})
+          opts.separator "#{BLUE}Please choose a #{generator_group} generator-type:#{WHITE}"
+          opts.separator ""
+          @generators.types_of(generator_group).each do |type|
+            opts.separator "    #{BLUE}#{type}#{WHITE}"
+          end
+        end
+        parser.parse(["-h"])
+        exit
+      end
+
+      def ask_for_project(generator_group, generator_type)
+        parser = OptionParser.new do |opts|
+          opts.banner = "Usage: #{PURPLE}#{File.basename($0)}#{WHITE} [options] #{PURPLE}#{generator_group}#{WHITE} #{PURPLE}#{generator_type}#{WHITE} #{BLUE}<project-name>#{WHITE}"
+          opts.add_default(options = {})
+          opts.separator "#{BLUE}Please enter a project-name!#{WHITE}"
+        end
+        parser.parse(["-h"])
+        exit
+      end
+
+    end
+  end
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: lepidoptera
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
+platform: ruby
+authors: 
+- Thomas Duerr
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-07 00:00:00 +01:00
+default_executable: lep
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rubigen
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 5
+        - 5
+        version: 1.5.5
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: git
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 2
+        - 5
+        version: 1.2.5
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 0
+        version: 1.4.0
+  type: :development
+  version_requirements: *id003
+description: Lepidoptera is a very simple and easy extensible code generator for common every day projects.
+email: thomduerr@gmail.com
+executables: 
+- lep
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- .gitignore
+- HISTORY.md
+- README.md
+- Rakefile
+- bin/lep
+- heroku_generators/sinatra/INFO
+- heroku_generators/sinatra/sinatra_generator.rb
+- heroku_generators/sinatra/templates/.gems
+- heroku_generators/sinatra/templates/README.md
+- heroku_generators/sinatra/templates/app.rb
+- heroku_generators/sinatra/templates/config.ru
+- heroku_generators/static/INFO
+- heroku_generators/static/static_generator.rb
+- heroku_generators/static/templates/README.md
+- heroku_generators/static/templates/config.ru
+- heroku_generators/static/templates/public/css/main.css
+- heroku_generators/static/templates/public/index.html
+- heroku_generators/static/templates/public/js/app.js
+- jquery_generators/plugin/INFO
+- jquery_generators/plugin/plugin_generator.rb
+- jquery_generators/plugin/templates/demo.html
+- jquery_generators/plugin/templates/js/jquery.plugin_name.js
+- lepidoptera.gemspec
+- lib/base.rb
+- lib/butterfly.rb
+- lib/options.rb
+has_rdoc: true
+homepage: http://github.com/thomd/lepidoptera/
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: a life-enhancing code generator for everyday use
+test_files: []
+