berkes-drupal.rb 0.0.6

data/History.txt

@@ -0,0 +1,35 @@
+=== 0.0.6 / 2008-10-16
+
+* 1 Minor Feature:
+
+  * Added hook_install() support
+
+=== 0.0.5 / 2008-10-06
+
+* 1 Minor Fix:
+
+  * Todo list was not parsing items starting with '@' in @todo
+
+=== 0.0.4 / 2008-10-03
+
+* 1 Major Feature:
+
+  * Installer allows lists of projects 'err,ac,devel'
+
+=== 0.0.3 / 2008-10-03
+
+* 1 Major Feature:
+
+  * Installer for Drupal projects
+
+=== 0.0.2 / 2008-10-02
+
+* 2 Bug Fixes:
+
+  * Executable
+  * Fixed template filepath errors
+
+=== 0.0.1 / 2008-09-27
+
+	* Initial release
+

data/Manifest.txt

@@ -0,0 +1,23 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/drupal
+lib/drupal.rb
+lib/drupal/todo_list.rb
+lib/drupal/create_module.rb
+lib/drupal/install.rb
+lib/drupal/templates/comments/file
+lib/drupal/templates/comments/large
+lib/drupal/templates/hooks/block
+lib/drupal/templates/hooks/boot
+lib/drupal/templates/hooks/install
+lib/drupal/templates/hooks/cron
+lib/drupal/templates/hooks/form_alter
+lib/drupal/templates/hooks/init
+lib/drupal/templates/hooks/menu
+lib/drupal/templates/hooks/perm
+lib/drupal/templates/hooks/schema
+lib/drupal/templates/hooks/theme
+lib/drupal/templates/txt/changelog
+lib/drupal/templates/txt/readme

data/README.txt

@@ -0,0 +1,94 @@
+= drupal
+
+http://berkes.github.com/drupal.rb/
+
+== DESCRIPTION:
+
+Drupal is an open source Ruby development tool allowing developers 
+to quickly generate and manage Drupal modules.
+
+== SYNOPSIS:
+
+	drupal [options] [arguments]
+
+== REQUIREMENTS:
+
+	none
+
+== ARGUMENTS:
+
+	create module <module_name>   		Generates a module skeleton from an interactive wizard.
+	todo list [total]    				  		Displays list of todo items or a total.
+	install <core | project> [dir]  	Install a Drupal project or core itself to [dir]
+
+== OPTIONS:
+
+ 	-h, --help       Display this help information.
+ 	-V, --version    Display version of the Drupal development tool.
+
+== EXAMPLES:
+
+  Create a new module in the current directory.
+    drupal create module my_module
+
+  Create a new module in a specific directory.
+     drupal create module my_module ./sites/all/modules
+
+  View todo list for current directory.
+     drupal todo list
+
+  View todo list for multiple files or directories.
+     drupal todo list ./sites/all/modules/mymodule 
+
+  View total todo items only.
+     drupal todo list total ./sites/all/modules
+	
+== TODO:
+
+  * Remove ':' from todo list items
+  * Add formatted help option
+  * Support versions for installer
+  * Support version prompt for project installation
+  * Support installing a list from file(s) so that devs may have lists of core modules they use
+  * Add hook dependencies
+  * Add installer for jQuery plugins?
+  * Add graceful error handling
+  * Add / refactor tests, using rspec
+  * Refactor / encapsulate entire project / make extendable
+
+== AUTHOR:
+
+Original:
+  TJ Holowaychuk 
+  tj@vision-media.ca
+  http://vision-media.ca
+
+Current Maintainer:
+  Bèr Kessels
+  ber@webschuur.com 
+  http://webschuur.com
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2008 FIX
+
+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/Rakefile

@@ -0,0 +1,21 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require File.dirname(__FILE__) + '/lib/drupal'
+
+desc 'Build and install ruby gem.'
+task :build do
+  sh "sudo gem build ./drupal.gemspec"
+  sh "sudo gem install drupal-#{Drupal::VERSION}.gem"
+end
+
+desc 'Remove ruby gem build data.'
+task :remove do
+  sh "sudo gem uninstall drupal"
+  sh "sudo rm drupal-#{Drupal::VERSION}.gem"
+end
+
+desc 'Run tests.'
+task :test do
+  sh "ruby " + File.dirname(__FILE__) + '/test/test_drupal.rb' + ' -r tk'
+end

data/bin/drupal

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'drupal'
+Drupal.new.run(ARGV)

data/drupal.rb.gemspec

@@ -0,0 +1,40 @@
+Gem::Specification.new do |s|
+  s.name     = "drupal.rb"
+  s.version  = "0.0.6"
+  s.date     = "2008-10-16"
+  s.summary  = "Drupal development kit"
+  s.email    = "ber@webschuur.com"
+  s.homepage = "http://berkes.github.com/drupal.rb/"
+  s.description = "Drupal is an open source Ruby development tool allowing developers to quickly generate and manage Drupal modules."
+  s.has_rdoc = true
+  s.require_path = "lib"
+  s.authors  = ["tj@vision-media.ca", "ber@webschuur.com"]
+  s.files    = ["History.txt", 
+		"Manifest.txt", 
+		"README.txt", 
+		"Rakefile", 
+		"drupal.rb.gemspec", 
+		"lib/drupal.rb", 
+		"lib/drupal/create_module.rb", 
+		"lib/drupal/todo_list.rb", 
+		"lib/drupal/install.rb", 
+		"lib/drupal/templates/comments/file", 
+		"lib/drupal/templates/comments/large", 
+		"lib/drupal/templates/hooks/block", 
+		"lib/drupal/templates/hooks/boot", 
+		"lib/drupal/templates/hooks/install", 
+		"lib/drupal/templates/hooks/cron", 
+		"lib/drupal/templates/hooks/form_alter", 
+		"lib/drupal/templates/hooks/init", 
+		"lib/drupal/templates/hooks/menu", 
+		"lib/drupal/templates/hooks/perm", 
+		"lib/drupal/templates/hooks/schema", 
+		"lib/drupal/templates/hooks/theme", 
+		"lib/drupal/templates/txt/changelog", 
+		"lib/drupal/templates/txt/readme", 
+		"bin/drupal"]
+	s.executables = ["drupal"]
+  s.test_files = ["test/test_drupal.rb", "test/test_install.rb", "test/test_create_module.rb", "test/test_todo_list.rb"]
+  s.rdoc_options = ["--main", "README.txt"]
+  s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.txt"]
+end

data/lib/drupal/create_module.rb

@@ -0,0 +1,202 @@
+
+class Drupal
+  class Create_Module
+    
+    # Create a module using the module builing wizard.
+    def run(arguments)
+      @arguments = arguments
+      @dir = @arguments[1] || '.' # TODO remove trailing slash, check validity, and existance
+      self.check_module_name
+      self.run_wizard
+    end
+    
+    # Ensure module name is supplied and that it is
+    # formatted correctly as module names must be alphanumeric
+    # and must begin with a letter.
+    def check_module_name
+      case 
+        when @arguments.empty?; puts 'Module name required.'; exit 3
+        when !@arguments[0].match(/^[a-z][\w]+/); puts 'Invalid module name.'; exit 4
+        else @module = @arguments[0]
+      end
+    end
+    
+    # Run module generation wizard.
+    def run_wizard
+      # TODO create self.log() with padding to even output
+      # Info
+      @author = self.ask('What is your name?:')
+      @link = self.ask('What is the URI to your companies website?:')
+      @email = self.ask('What is your email?:')
+      @module_name = self.ask('Enter a human readable name for your module:')
+      @module_description = self.ask('Enter a short description of your module:')
+      @module_dependencies = self.ask('Enter a list of dependencies for your module:', true)
+      # Hooks
+      puts self.list_templates('Hooks:', 'hooks')
+      @hooks = self.ask('Which hooks would you like to implement?:', true)
+      # Files
+      puts self.list_templates('Files:', 'txt')
+      @files = self.ask('Which additional files would you like to include?:', true)
+      # Dirs
+      puts "\nCommon directories:"
+      puts ['js', 'images', 'css'].collect{ |d| " - " << d }
+      @dirs = self.ask('Which directories would you like to create?:', true)
+      # Finish
+      self.create_tokens
+      self.create_hook_weights
+      self.create_module
+    end
+    
+    # Create global tokens.
+    def create_tokens
+      @tokens = {
+          :module => @module,
+          :link => @link,
+          :email => @email,
+          :author => @author,
+          :module_name => @module_name,
+          :module_description => @module_description,
+          :module_dependencies => @module_dependencies,
+        }
+    end
+    
+    # Register hook weights
+    def create_hook_weights
+      @hook_weights = [
+          'perm',
+          'cron',
+          'boot',
+          'init',
+          'menu',
+          'install',
+          'schema',
+          'theme',
+          'form_alter',
+          'block',
+        ]
+    end
+    
+    # Create module from wizard results.
+    def create_module
+      puts "\n... Creating module '#{@module}' in '#{@dir}'"
+      # Base directory
+      create_dir("#{@module}")
+      self.create_module_dirs
+      self.create_module_files
+      self.create_module_file
+      self.create_module_install_file
+      self.create_module_info_file
+      puts 'Module created :)'
+    end
+    
+    # Create directories.
+    def create_module_dirs
+      @dirs.each{ |dir| create_dir("#{@module}/#{dir}") }
+    end
+    
+    # Create file templates.
+    def create_module_files
+      @files.each do |file|
+        filepath = "#{file.upcase}.txt"
+        create_file(filepath)
+        append_template(filepath, "txt/#{file}", @tokens)
+      end      
+    end
+    
+    # Create .module file.
+    def create_module_file
+      create_file("#{@module}.module", "<?php\n")
+      append_template("#{@module}.module", 'comments/file', @tokens)
+      append_template("#{@module}.module", 'comments/large', {'title' => 'Hook Implementations'})
+      for hook in @hook_weights
+        if @hooks.include?(hook)
+          append_template("#{@module}.module", "hooks/#{hook}", @tokens) unless hook.match /^install|schema/
+        end
+      end      
+    end
+    
+    # Create .install file.
+    def create_module_install_file
+      if @hooks.include?('schema') || @hooks.include?('schema')
+        create_file("#{@module}.install", "<?php\n")
+        append_template("#{@module}.install", 'comments/file', @tokens)
+        @hooks.each do |hook|
+          append_template("#{@module}.install", "hooks/#{hook}", @tokens) if hook.match /^install|schema/
+        end
+      end      
+    end
+    
+    # Create info file.
+    def create_module_info_file
+      contents = '; $Id$'
+      contents << "\nname = #{@module_name}"
+      contents << "\ndescription = #{@module_description}"
+      contents << "\ncore = 6.x"
+      @module_dependencies.each do |dependency|
+        contents << "\ndependencies[] = #{dependency}"
+      end
+      create_file("#{@module}.info", contents)
+    end
+    
+    # Create a new directory.
+    def create_dir(dir)
+      dir = "#{@dir}/#{dir}"
+      puts "... Creating directory '#{dir}'"
+      Dir.mkdir(dir)
+    end
+    
+    # Create a new file.
+    def create_file(filepath, contents = '')
+      filepath = "#{@dir}/#{@module}/#{filepath}"
+      puts "... Creating file '#{filepath}'"
+      File.open(filepath, 'w') do |f|
+        f.write contents
+      end
+    end
+    
+    # Append a tokenized template template to a file.
+    def append_template(filepath, template, tokens = {})
+      # TODO: ensure template exists
+      # TODO: is \n included with STDIN?
+      _template = template
+      filepath = "#{@dir}/#{@module}/#{filepath}"
+      template = File.dirname(__FILE__) + "/templates/#{template}"
+      puts "... Adding template '#{_template}' to '#{filepath}'"
+      contents = File.read(template)
+      tokens.each_pair do |token, value|
+        if value.class == String && contents.include?("[#{token}]")
+          contents.gsub!(/\[#{token}\]/, value)
+        end
+      end
+      File.open(filepath, 'a') do |f|
+        f.write contents
+      end
+    end
+    
+    # Prompt user for input
+    def ask(question, list = false)
+      puts "\n" << question
+      # TODO: support 'all'
+      # TODO: why is gets not working?
+      # TODO: not catching exception when CTRL+C ?
+      begin
+        case list
+          when true; STDIN.gets.split
+          when false; STDIN.gets.gsub!(/\n/, '')
+        end
+      rescue => e
+        puts ':)'
+      end
+    end
+    
+    # List templates available of a certain type.
+    def list_templates(title, type)
+      "\n" << title << self.get_templates(type).collect{ |t| "\n - " << File.basename(t) }.join
+    end
+    
+    # Get array of templates of a certain type.
+    def get_templates(type)
+      Dir[File.dirname(__FILE__) + '/templates/' << type << '/*']
+    end
+  end
+end

data/lib/drupal/install.rb

@@ -0,0 +1,95 @@
+
+require 'zlib'
+require 'net/http'
+
+class Drupal
+  class Install
+    
+    # Attempt to download core installation or module.
+    def run(arguments)
+      @project = arguments[0]
+      @dest = arguments[1] || '.' 
+      abort "Destination #{@dest} is not a directory." unless File.directory?(@dest)
+      abort 'Project name required (core | <project>).' if arguments.empty?
+      install_projects
+    end
+    
+    def debug(message)
+      puts '... ' + message
+    end
+    
+    # Install single project or iterate lists.
+    def install_projects
+      if @project.include? ','
+        projects = @project.split ','
+        projects.each do |p|
+          @project = p
+          check_core
+          install_project 
+          puts
+        end   
+      else
+        check_core
+        install_project
+      end
+    end
+    
+    # Check if the destination is empty.
+    def destination_empty?
+      Dir['*'].length == 0 
+    end
+    
+    # Allow users to type 'core' instead of 'drupal install drupal'
+    def check_core
+      @project = 'drupal' if @project =~ /^core|drupal$/
+    end
+    
+    # Check if a uri is available.
+    def uri_available?(uri)
+      open(uri) rescue false
+    end
+    
+    # Install project.
+    def install_project
+      debug "Locating #{@project} page"
+      # Locate tarball from project page
+      begin 
+        response = Net::HTTP.get_response(URI.parse("http://drupal.org/project/#{@project}"))
+        @markup = response.body
+        # TODO: check 404
+        debug 'Located the project page'
+      rescue
+        puts 'Failed to request page'
+      end
+      @markup.match /(#{@project}-6(?:.*?)\.gz)/
+      @tarball = $1
+      @tarpath = File.expand_path("#{@dest}/#{@tarball}")
+      abort "Failed to find Drupal 6 tar of #{@project}" if @tarball.nil?
+      debug "Found tarball #{@tarball}"
+      
+      # Fetch tarball
+      begin
+        response = Net::HTTP.get_response(URI.parse("http://ftp.drupal.org/files/projects/#{@tarball}"))
+        File.open(@tarpath, 'w') do |f|
+          f.write response.body
+        end
+        debug "Copied tarball to #{@tarpath}"
+      rescue
+        abort "Failed to copy remote tarball #{@tarball}"
+      end
+      
+      # Extract tarball
+      @pwd = Dir.getwd
+      Dir.chdir File.dirname(@tarpath) and debug "Changed cwd to #{File.dirname(@tarpath)}" unless @dest == '.'
+      Kernel.system "tar -xf #{@tarpath}" rescue abort "Failed to extract #{@tarpath}"
+      Dir.chdir @pwd and debug "Reverted cwd back to #{@pwd}" unless @dest == '.'
+      
+      # Remove tarball
+      Kernel.system "rm #{@tarpath}" rescue abort "Failed to remove #{@tarpath}"
+      
+      # Installation complete
+      debug "Project installed to #{File.dirname(@tarpath)}" unless @dest == '.'
+      debug 'Installation complete'
+    end
+  end
+end

data/lib/drupal/templates/comments/file

@@ -0,0 +1,9 @@
+// $Id$
+
+/**
+ * @file
+ * [module_description]
+ * @author [author] <[email]>
+ * @link [link]
+ * @package [module]
+ */

data/lib/drupal/templates/comments/large

@@ -0,0 +1,6 @@
+
+/* -----------------------------------------------------------------
+
+  [title]
+
+------------------------------------------------------------------ */

data/lib/drupal/templates/hooks/block

@@ -0,0 +1,45 @@
+
+/**
+ * Implementation of hook_block().
+ */
+function [module]_block($op = 'list', $delta = 0, $edit = array()) {
+  switch($op) {
+    case 'list':
+      $blocks = array();
+      $blocks[0] = array(
+          'info' => t('Block desc in listing'),
+          'cache' => BLOCK_CACHE_PER_ROLE | BLOCK_CACHE_PER_PAGE,
+        );
+      return $blocks;
+
+    case 'configure':
+      $form = array();
+      switch($delta){
+        default:
+          $form['item'] = array(
+              '#type' => 'textfield',
+              '#title' => t('Form Item'),
+              '#default_value' => variable_get('item_var', 0),
+            );
+      }
+      return $form;
+
+    case 'save':
+      switch($delta){
+        default:
+          variable_set('item_var', $edit['item_var']);
+      }
+      break;
+
+    case 'view':
+      $block = array();
+      switch($delta) {
+        case 0:
+          $block = array(
+              'subject' => t('Block title'),
+              'content' => 'content here',
+            );
+      }
+      return $block;
+  }
+}

data/lib/drupal/templates/hooks/boot

@@ -0,0 +1,7 @@
+
+/**
+ * Implementation of hook_boot().
+ */
+function [module]_boot() {
+
+}

data/lib/drupal/templates/hooks/cron

@@ -0,0 +1,7 @@
+
+/**
+ * Implementation of hook_cron().
+ */
+function [module]_cron() {
+
+}

data/lib/drupal/templates/hooks/form_alter

@@ -0,0 +1,11 @@
+
+/**
+ * Implementation of hook_form_alter().
+ */
+function [module]_form_alter(&$form, $form_state, $form_id) {
+  switch($form_id) {
+    case '':
+      // @todo: do something
+      break;
+  }
+}

data/lib/drupal/templates/hooks/init

@@ -0,0 +1,7 @@
+
+/**
+ * Implementation of hook_init().
+ */
+function [module]_init() {
+
+}

data/lib/drupal/templates/hooks/install

@@ -0,0 +1,7 @@
+
+/**
+ * Implementation of hook_install().
+ */
+function [module]_install() {
+  drupal_install_schema('[module]');
+}

data/lib/drupal/templates/hooks/menu

@@ -0,0 +1,17 @@
+
+/**
+ * Implementation of hook_menu().
+ */
+function [module]_menu() {
+  $items = array();
+
+  $items['admin/settings/[module]'] = array(
+      'title' => '[module]',
+      'page callback' => 'drupal_get_form',
+      'page arguments' => array('[module]_settings'),
+      'access arguments' => array('administer [module]'),
+      'file' => '[module].admin.inc',
+    );
+
+  return $items;
+}

data/lib/drupal/templates/hooks/perm

@@ -0,0 +1,7 @@
+
+/**
+ * Implementation of hook_perm().
+ */
+function [module]_perm() {
+  return array('administer [module]');
+}

data/lib/drupal/templates/hooks/schema

@@ -0,0 +1,37 @@
+
+/**
+ * Implementation of hook_schema().
+ */
+function [module]_schema() {
+  $schema = array();
+
+  $schema['[module]'] = array(
+    'description' => t('Table description here.'),
+    'fields' => array(
+      'id' => array(
+        'description' => t('Primary identifier.'),
+        'type' => 'serial',
+        'unsigned' => TRUE,
+        'not null' => TRUE),
+      'status' => array(
+         'description' => t('Status. 0 = unpublished, 1 = published.'),
+        'type' => 'int',
+        'size' => 'tiny',
+        'not null' => FALSE,
+        'default' => 0),
+      'created' => array(
+        'description' => t('The Unix timestamp when the row was created.'),
+        'type' => 'int',
+        'not null' => TRUE,
+        'default' => 0),
+        ),
+      'indexes' => array(
+        'status' => array('status'),
+        'created' => array('created'),
+        'id_status' => array('id', 'status'),
+        ),
+      'primary key' => array('id'),
+      );
+
+  return $schema;
+}

data/lib/drupal/templates/hooks/theme

@@ -0,0 +1,11 @@
+
+/**
+ * Implementation of hook_theme().
+ */
+function [module]_theme($existing, $type, $theme, $path) {
+  return array(
+    'forum_topic_navigation' => array(
+      'arguments' => array('node' => NULL),
+    ),
+  );
+}

data/lib/drupal/templates/txt/changelog

@@ -0,0 +1,9 @@
+
+        $Id$
+
+
+        -------------------------------------------------------------------------------
+        [module] 6.4-1.0, YYYY-MM-DD
+        -------------------------------------------------------------------------------
+
+        - Initial release

data/lib/drupal/templates/txt/readme

@@ -0,0 +1,36 @@
+
+        $Id$
+
+
+        [module]
+        Provided by [link]
+        Developed by [author]
+
+        -------------------------------------------------------------------------------
+        INSTALLATION
+        -------------------------------------------------------------------------------
+
+        todo
+
+        -------------------------------------------------------------------------------
+        PERMISSIONS
+        -------------------------------------------------------------------------------
+
+        permission
+          - description
+
+
+        -------------------------------------------------------------------------------
+        PUBLIC API
+        -------------------------------------------------------------------------------
+
+        todo
+
+        -------------------------------------------------------------------------------
+        CONVENTIONS
+        -------------------------------------------------------------------------------
+
+        todo
+
+
+

data/lib/drupal/todo_list.rb

@@ -0,0 +1,40 @@
+
+class Drupal
+  class Todo_List
+    
+    # Run todo list
+    def run(arguments)
+      @total = 0
+      @arguments = arguments
+      @total_only = true if @arguments[0] == 'total'
+      @arguments.shift if @total_only == true
+      parse_dir('.') if @arguments.empty?
+      for argument in @arguments
+        parse_file(argument) if File.file?(argument)
+        parse_dir(argument) if File.directory?(argument)
+      end
+      puts "Total todo items: #{@total}" if @total_only == true
+    end
+    
+    # Parse file for todo items.
+    def parse_file(filepath)
+      File.open(filepath) do |file|
+        items = []
+        file.each_line do |line|
+          matches = line.match /(?:#|\/\/|\/\*|@)[\s]*todo:?[\s]*(.+)$/i
+          items << matches[1] unless matches.nil? || matches.length <= 0
+          @total += 1 unless matches.nil? || matches.length <= 0
+        end
+        puts "\n" + filepath unless items.empty? || @total_only == true
+        items.each{ |item| puts "   - #{item}" } unless @total_only == true
+      end
+    end
+    
+    # Parse directory for todo items.
+    def parse_dir(dir)
+      Dir["#{dir == '.' ? '.' : dir}/**/*"].each do |file|
+        parse_file(file) if File.file?(file)
+      end
+    end
+  end
+end

data/lib/drupal.rb

@@ -0,0 +1,148 @@
+#!/usr/bin/env ruby
+
+# == SYNOPSIS:
+#
+#	  drupal [options] [arguments]
+#
+# == ARGUMENTS:
+# 
+#   create module <module_name> [dir]      Generates a module skeleton from an interactive wizard. Current directory unless [dir] is specified.
+#   todo list [total]                      Displays list of todo items or a total.   
+#   install <core | project ...> [dir]  	 Install Drupal project(s) to [dir] or the current directory.
+#
+# == OPTIONS:
+# 
+#  	-h, --help       Display this help information.
+#	 	-V, --version    Display version of the Drupal development tool.
+#
+# == EXAMPLES:
+# 
+#   Create a new module in the current directory.
+#	    drupal create module my_module
+#
+#   Create a new module in a specific directory.
+#      drupal create module my_module ./sites/all/modules
+#
+#	  View todo list for current directory.
+#      drupal todo list
+#  
+#   View todo list for multiple files or directories.
+#	     drupal todo list ./sites/all/modules/mymodule 
+#
+#   View total todo items only.
+#     drupal todo list total ./sites/all/modules
+#    
+#   Install a module to the modules folder in my new installation (from drupal root)
+#     drupal install devel ./sites/all/modules
+#  
+#   Install a module when in the 'modules directory
+#     drupal install devel
+#
+#   Install several modules to the modules folder
+#     drupal install devel,pathauto,err,ac ./sites/all/modules
+#  
+   
+require 'optparse'
+require 'ostruct'
+require File.dirname(__FILE__) + '/drupal/create_module'
+require File.dirname(__FILE__) + '/drupal/todo_list'
+require File.dirname(__FILE__) + '/drupal/install'
+
+class Drupal
+  
+  MAJOR = 0
+  MINOR = 0
+  TINY = 6
+  VERSION = [MAJOR, MINOR, TINY].join('.')
+  
+  # Run the drupal development tool.
+  def run(arguments) 
+    @arguments = arguments || [] 
+    @options = OpenStruct.new
+    abort 'Arguments required. Use --help for additional information.' if @arguments.empty?
+    parse_options
+    determine_handler
+    execute_handler
+  end
+  
+  # Parse stdin for options.
+  def parse_options
+    opts = OptionParser.new
+    opts.on('-h', '--help') { output_help }
+    opts.on('-V', '--version') { output_version }
+    opts.parse!(@arguments)
+  end
+  
+  # Determine handler based on the current arguments.
+  def determine_handler
+    @handler = @arguments.shift.capitalize
+    while !@arguments.empty? && !is_handler(@handler) do
+      @handler << '_' + @arguments.shift.capitalize
+    end
+  end
+  
+  # Execute the handler if it was found.
+  def execute_handler
+    abort 'Invalid command.' if !is_handler(@handler)
+    eval("Drupal::#{@handler}.new.run(@arguments)")
+  end
+  
+  # Check existance of a handler.
+  def is_handler(klass)
+    Drupal.const_defined?(klass) 
+  end
+  
+  # Output help information.
+  def output_help
+    # TODO: utilize RDoc
+    puts <<-USAGE
+    
+  SYNOPSIS:
+ 
+    drupal [options] [arguments]
+ 
+  ARGUMENTS:
+ 
+    create module <module_name> [dir]  Generates a module skeleton from an interactive wizard. Current directory unless [dir] is specified.
+    todo list [total]                  Displays list of todo items or a total.   
+    install <core | project> [dir]  	 Install a Drupal project or core itself to [dir]    
+    
+  EXAMPLES:
+  
+    Create a new module in the current directory.
+      drupal create module my_module
+
+    Create a new module in a specific directory.
+      drupal create module my_module ./sites/all/modules
+
+    View todo list for current directory.
+      drupal todo list
+  
+    View todo list for multiple files or directories.
+      drupal todo list ./sites/all/modules/mymodule 
+
+    View total todo items only.
+      drupal todo list total ./sites/all/modules   
+      
+    Install drupal core to the current directory.
+      drupal install core
+      
+    Install a module to the modules folder in my new installation (from drupal root)
+      drupal install devel ./sites/all/modules
+      
+    Install a module when in the 'modules directory
+      drupal install devel
+       
+USAGE
+  exit
+  end
+  
+  # Output version information.
+  def output_version
+    puts "Version #{Drupal::VERSION}"
+    exit
+  end
+end
+
+
+

data/test/test_create_module.rb

@@ -0,0 +1 @@
+

data/test/test_drupal.rb

@@ -0,0 +1,6 @@
+
+require 'test/unit'
+require File.dirname(__FILE__) + '/../lib/drupal.rb'
+require File.dirname(__FILE__) + '/test_install.rb'
+require File.dirname(__FILE__) + '/test_create_module.rb'
+require File.dirname(__FILE__) + '/test_todo_list.rb'

data/test/test_install.rb

@@ -0,0 +1,23 @@
+
+class DrupalInstall < Test::Unit::TestCase
+    def setup
+      Drupal.new.run('install ab'.split)
+      Kernel.system "mkdir _modules"
+      Drupal.new.run('install devel ./_modules'.split)
+    end
+
+    def teardown
+      Kernel.system "rm -fr ./ab/*"
+      Kernel.system "rmdir ./ab"
+      Kernel.system "rm -fr ./_modules/*"
+      Kernel.system "rmdir ./_modules"
+    end
+
+    def test_contrib_cwd
+      assert(File.directory?('./ab'), 'Failed to install ab module in cwd.')
+    end
+    
+    def test_contrib_dir
+      assert(File.directory?('./_modules/devel'), 'Failed to install devel to _modules directory.')
+    end
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: berkes-drupal.rb
+version: !ruby/object:Gem::Version 
+  version: 0.0.6
+platform: ruby
+authors: 
+- tj@vision-media.ca
+- ber@webschuur.com
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-16 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Drupal is an open source Ruby development tool allowing developers to quickly generate and manage Drupal modules.
+email: ber@webschuur.com
+executables: 
+- drupal
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- drupal.rb.gemspec
+- lib/drupal.rb
+- lib/drupal/create_module.rb
+- lib/drupal/todo_list.rb
+- lib/drupal/install.rb
+- lib/drupal/templates/comments/file
+- lib/drupal/templates/comments/large
+- lib/drupal/templates/hooks/block
+- lib/drupal/templates/hooks/boot
+- lib/drupal/templates/hooks/install
+- lib/drupal/templates/hooks/cron
+- lib/drupal/templates/hooks/form_alter
+- lib/drupal/templates/hooks/init
+- lib/drupal/templates/hooks/menu
+- lib/drupal/templates/hooks/perm
+- lib/drupal/templates/hooks/schema
+- lib/drupal/templates/hooks/theme
+- lib/drupal/templates/txt/changelog
+- lib/drupal/templates/txt/readme
+- bin/drupal
+has_rdoc: true
+homepage: http://berkes.github.com/drupal.rb/
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Drupal development kit
+test_files: 
+- test/test_drupal.rb
+- test/test_install.rb
+- test/test_create_module.rb
+- test/test_todo_list.rb