prigner 0.1.0

data/CHANGELOG

@@ -0,0 +1,248 @@
+2010-10-16 
+-----------
+
+* Adding of templates for Ruby projects
+
+* Command for create a new project
+
+* Status for CLI commands and fixes in builder test
+
+* Improvements in builder
+
+  * All methods returns the path and the state information.
+
+  * Removing of PWD from paths.
+
+2010-10-15 
+-----------
+
+* Small improvements in tasks and gemspec updates
+
+* Updates in changelog file
+
+* Fixes in the task to update changelog file
+
+* Updates in date of version
+
+* Adding of task to handle date of version
+
+* Changes in the path to shared templates
+
+* Updates in the informations
+
+* Improvements in template and new CLI commands
+
+  * Show all templates for use in the CLI commands.
+
+  * RuntimeError when the CLI is unable to run a command.
+
+  * Adding list and new commands.
+
+* Main executable
+
+* Mask for template presentation
+
+2010-10-14 
+-----------
+
+* Fixtures in handle exceptions in path and specfile
+
+* Adjustments in exceptions for Specfile
+
+* RubyGems
+
+* Adjustments in the library path
+
+2010-10-13 
+-----------
+
+* Removing conversion from string to pathname
+
+2010-09-29 
+-----------
+
+* Fixes in the LOAD_PATH variable for requirements
+
+* Configuration for RVM
+
+* Unneeded files removed after builder test
+
+* Errors fixed in load of the specfile
+
+* Added the executable file in Gemspec
+
+* Fixes in load the specfile without values
+
+2010-09-28 
+-----------
+
+* Updates in Gemspec file
+
+* Added new files
+
+  * Project class and CLI module have been separated from main file.
+
+  * A builder has been created for improve feedback in the CLI.
+
+  * Documentation.
+
+* Several improves
+
+  * Add `specfile` in fixtures.
+
+  * Template methods have been improved:
+
+    * List all templates.
+
+    * Several query methods have been removed.
+
+    * Added method for list all template paths.
+
+    * All methods that build a project were removed for create a new
+
+      build class.
+
+  * Small fixes in empty values (nil).
+
+  * Documentation.
+
+2010-09-27 
+-----------
+
+* Fixes in path to model file
+
+* Fixes in the load of modules
+
+* Sorting command list
+
+* Command for list all templates
+
+* Shared path to user templates
+
+* Remove test index
+
+2010-09-26 
+-----------
+
+* Added command-line interface
+
+* Task to build Gem
+
+2010-09-25 
+-----------
+
+* Listing all templates by namespace
+
+* Template builds all model files
+
+* Change SHARED_PATH to query method shared_path
+
+2010-09-23 
+-----------
+
+* Added counter for all test names
+
+* Template draw projects
+
+  * Updates in fixtures.
+
+  * Added binding class for filters in ERB model files.
+
+* Documentation and changes in method names
+
+* Fix in mapping of the models in the specfile
+
+* Small improvements in tests
+
+2010-09-22 
+-----------
+
+* Small fixes in source code and tests
+
+* Fixes in converting Hash into Struct
+
+* Fixes in tasks for tests
+
+2010-09-17 
+-----------
+
+* Project has been remodelled
+
+  * Project renamed to Prigner.
+
+  * Start builder DSL.
+
+  * Spec class.
+
+  * Project class was simplified.
+
+2010-08-17 
+-----------
+
+* Test for check the content written by model
+
+* Template and models
+
+  * A template has many model files.
+
+  * The tests and fixtures for template and models have been added.
+
+  * Small improvements in code.
+
+* Fixture for test model
+
+* Revision in model for build contents
+
+  * The method _binding_ inside structs have been updated for public
+
+    access.
+
+  * Model only builds the content and draws a destination file.
+
+2010-08-16 
+-----------
+
+* Fix error in parse an empty Hash to Struct
+
+* Deleting temporary files
+
+* Refactoring in template
+
+  * Load options from configuration file.
+
+  * The template is a simple directory tree.
+
+* Basic model finished
+
+  * Tests and fixtures for model.
+
+2010-08-15 
+-----------
+
+* Small improvements in code
+
+2010-08-14 
+-----------
+
+* Basic template finished
+
+  * Tests and fixtures for templates.
+
+  * Fix in changelog task.
+
+* Basic project finished
+
+  * Class for Ruby project is based in a simple directory path.
+
+  * Gemspec file.
+
+  * Several useful extensions.
+
+  * Tests.
+
+  * Tasks for development and publishing.
+
+* Added basic files
+
+* First commit
+

data/COPYING

@@ -0,0 +1,21 @@
+Copyright (c) 2009, 2010 Hallison Batista
+
+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.mkd

@@ -0,0 +1,90 @@
+Prigner
+=======
+
+Prigner is a Project Design Kit, that is, a tool which creates a conventional
+structure for several projects as RubyGems, Websites, MVC application and
+simple scripts. It is a DRY tool, because everything is based in templates. In
+short, a project template engine.
+
+Features
+========
+
+* Load and create all directories and files from templates.
+* Default Ruby project templates.
+  * Ruby Gem.
+  * A simple project using setup.
+  * Script file with or without directory structure.
+* Add common tasks and libraries.
+  * Tests.
+  * Deploy.
+  * Code for versioning.
+
+Installation
+============
+
+First, install Prigner stable through Gem:
+
+    gem install prigner
+
+Usage
+=====
+
+Prigner create the most common Ruby projects through templates shared. To
+generate new Gem project, run command using the following syntax:
+
+    prign new ruby:gem foo
+
+    foo
+    |-- CHANGELOG
+    |-- COPYRIGHT
+    |-- README.mkd
+    |-- Rakefile
+    |-- bin
+    |   `-- foo
+    |-- foo.gemspec
+    |-- lib
+    |   |-- foo
+    |   `-- foo.rb
+    `-- test
+        |-- fixtures
+        |-- foo_test.rb
+        `-- helper.rb
+
+This command will generate 'foo' Gem project structure. Or, you maybe create a
+Ruby script or a UNIX-like program.
+
+    prign new bash:script bar
+
+    bar
+    |-- bar
+    `-- barrc
+
+    prign new bash:program ducklet
+
+    ducklet
+    |-- bin
+    |   `-- ducklet
+    `-- etc
+        `-- duckletrc
+
+Templates
+=========
+
+Prigner offer the following templates:
+
+* Ruby
+  * Default project based only library directory and common files as
+    README.rdoc, CHANGELOG
+  * Gem project that include library directory, main module, test and
+    directories for fixtures.
+  * Sinatra basic application.
+
+Copyright
+=========
+
+Written by [Hallison Batista](http://hallisonbatista.com/whoiam).
+
+Prigner is Copyright (C) 2010, [Codigorama](http://codigorama.com/products).
+
+See COPYRIGHT file for more information about license.
+

data/Rakefile

@@ -0,0 +1,211 @@
+require "rake/clean"
+require "lib/prigner"
+
+# Helpers
+# =============================================================================
+
+def rdoc(*args)
+  @rdoc ||= if Gem.available? "hanna"
+              ["hanna", "--fmt", "html", "--accessor", "option_accessor=RW", *args]
+            else
+              ["rdoc", *args]
+            end
+  sh @rdoc.join(" ")
+end
+
+def test(pattern)
+  testfiles = Dir[pattern]
+  if Gem.available? "turn"
+    sh [ "turn", *testfiles ].join(" ")
+  else
+    testfiles.each do |testfile|
+      sh "ruby #{testfile}"
+    end
+  end
+end
+
+def manifest
+  @manifest ||= `git ls-files`.split("\n").sort.reject do |out|
+    out =~ /^\./ || out =~ /^doc/
+  end.map do |file|
+    "    #{file.inspect}"
+  end.join(",\n")
+end
+
+def log
+  @log ||= `git log --date=short --format='%d;%cd;%s;%b;'`
+end
+
+def version
+  @version ||= Prigner.version
+end
+
+def gemspec
+  @gemspec ||= Struct.new(:spec, :file).new
+  @gemspec.file ||= Pathname.new("prigner.gemspec")
+  @gemspec.spec ||= eval @gemspec.file.read
+  @gemspec
+end
+
+# Documentation
+# =============================================================================
+
+namespace :doc do
+
+  CLOBBER << FileList["doc/*"]
+
+  file "doc/api/index.html" => FileList["lib/**/*.rb", "README.mkd", "CHANGELOG"] do |filespec|
+    rm_rf "doc"
+    rdoc "--op", "doc/api",
+         "--charset", "utf8",
+         "--main", "'Prigner'",
+         "--title", "'Prigner v#{version.tag} API Documentation'",
+         "--inline-source",
+         "--promiscuous",
+         "--line-numbers",
+         filespec.prerequisites.join(" ")
+  end
+
+  desc "Build API documentation (doc/api)"
+  task :api => "doc/api/index.html"
+
+  desc "Creates/updates CHANGELOG file."
+  task :changelog do |spec|
+    historic = {}
+    text     = ""
+
+    log.scan(/(.*?);(.*?);(.*?);(.*?);/m) do |tag, date, subject, content|
+      
+      historic[date] = {
+        :release => "#{date} #{tag.match(/(v\d\..*)/im) ? tag : nil}",
+        :changes => []
+      } unless historic.has_key? date
+
+      historic[date][:changes] << "\n* #{subject}\n"
+      historic[date][:changes] << content.gsub(/(.*?)\n/m){"\n  #{$1}\n"} unless content.empty?
+    end
+
+    historic.keys.sort.reverse.each do |date|
+      entry = historic[date]
+      puts "Adding historic from date #{date} ..."
+      text  << <<-end_text.gsub(/^[ ]{8}/,'')
+        #{entry[:release]}
+        #{"-" * entry[:release].size}
+        #{entry[:changes]}
+      end_text
+    end
+
+    File.open("CHANGELOG", "w+") { |changelog| changelog << text }
+    puts "Historic has #{historic.keys.size} entry dates"
+    puts "Successfully updated CHANGELOG file"
+  end
+
+end
+
+# Versioning
+# =============================================================================
+
+namespace :version do
+
+  major, minor, patch, build = version.tag.split(".").map{ |key| key.to_i } << 0
+
+  desc "Dump major version"
+  task :major do
+    version.tag = "#{major+=1}.0.0"
+    version.save!
+    puts version.to_hash.to_yaml
+  end
+
+  desc "Dump minor version"
+  task :minor do
+    version.tag = "#{major}.#{minor+=1}.0"
+    version.save!
+    puts version.to_hash.to_yaml
+  end
+
+  desc "Dump patch version"
+  task :patch do
+    version.tag = "#{major}.#{minor}.#{patch+=1}"
+    version.save!
+    puts version.to_hash.to_yaml
+  end
+
+  desc "Dump build version"
+  task :build do
+    version.tag = "#{major}.#{minor}.#{patch}.#{build+=1}"
+    version.save!
+    puts version.to_hash.to_yaml
+  end
+
+  desc "Update version date (current #{version.date})"
+  task :date, [:date] do |spec, args|
+    require "parsedate"
+    require "date"
+    yyyy, mm, dd = ParseDate.parsedate(args[:date]).compact if args[:date]
+    version.date = (yyyy && mm && dd) ? Date.new(yyyy, mm, dd) : Date.today
+    version.save!
+    puts version.to_hash.to_yaml
+  end
+end
+
+task :version => "version:build"
+
+# RubyGems
+# =============================================================================
+
+namespace :gem do
+
+  file gemspec.file => FileList["{lib,test}/**", "Rakefile"] do
+    spec = gemspec.file.read
+
+    puts "Updating version ..."
+      spec.sub! /spec\.version\s*=\s*".*?"/,  "spec.version = #{version.tag.inspect}"
+
+    puts "Updating date of version ..."
+      spec.sub! /spec\.date\s*=\s*".*?"/,     "spec.date = #{version.date.to_s.inspect}"
+
+    puts "Updating file list ..."
+      spec.sub! /spec\.files\s*=\s*\[.*?\]/m, "spec.files = [\n#{manifest}\n  ]"
+
+    gemspec.file.open("w+") { |file| file << spec }
+
+    puts "Successfully update #{gemspec.file} file"
+  end
+
+  desc "Build gem package #{gemspec.spec.file_name}"
+  task :build => gemspec.file do
+    sh "gem build #{gemspec.file}"
+  end
+
+  desc "Deploy gem package to RubyGems.org"
+  task :deploy => :build do
+    sh "gem push #{gemspec.spec.file_name}"
+  end
+
+  desc "Install gem package #{gemspec.spec.file_name}"
+  task :install => :build do
+    sh "gem install #{gemspec.spec.file_name} --local"
+  end
+
+  desc "Uninstall gem package #{gemspec.spec.file_name}"
+  task :uninstall do
+    sh "gem uninstall #{gemspec.spec.name} --version #{gemspec.spec.version}"
+  end
+
+end
+
+task :gem => "gem:build"
+
+# Test
+# =============================================================================
+
+desc "Run tests"
+task :test, [:pattern] do |spec, args|
+  test(args[:pattern] ? "test/#{args[:pattern]}_test.rb" : "test/*_test.rb")
+end
+
+# Default
+# =============================================================================
+
+task :default => "test"
+

data/bin/prign

@@ -0,0 +1,65 @@
+#!/usr/bin/env ruby
+# Copyright (C) 2010 Hallison Batista
+# encoding: UTF-8
+
+require "prigner"
+
+program = File.basename(__FILE__)
+
+begin
+  Prigner::CLI.run *ARGV unless ARGV.empty? or ARGV.first =~ /^-.*$/
+
+  ARGV.options do |arguments|
+
+    arguments.summary_indent = "  "
+    arguments.summary_width  = 24
+    arguments.banner = <<-end_banner.gsub(/^[ ]{6}/, '')
+      #{Prigner::Version}
+
+      Usage:
+        #{program} <namespace>[:template] [path] [options]
+        #{program} <command> [command_options]
+        #{program} [options]
+
+      Commands:
+        #{Prigner::CLI.commands.join(", ")}
+
+        Run command with option "-h" or "--help" for more information.
+
+    end_banner
+
+    arguments.separator "Options:"
+
+    arguments.on("-c", "--commands", nil, "Show only command names.") do
+      puts Prigner::CLI.commands.join("\n")
+    end
+
+    arguments.on("-t", "--templates", nil, "Show only template names.") do
+      puts Prigner::CLI.templates.sort.join("\n")
+    end
+
+    arguments.on("-h", "--help", nil, "Show this message.") do
+      puts arguments
+    end
+
+    arguments.on("-v",  "--version", nil, "Show version information.") do
+      puts Prigner::Version
+    end
+
+    arguments.separator ""
+
+    unless ARGV.empty?
+      arguments.parse!
+    else
+      puts arguments
+      exit 0
+    end
+  end
+
+rescue => error
+  puts "#{program}: #{error.message} (#{error.class})"
+  puts "Try '#{program} -h' or '#{program} --help' for more information."
+  exit 1
+end
+
+# vim: filetype=ruby

data/lib/prigner/builder.rb

@@ -0,0 +1,51 @@
+# == The project builder
+#
+# The Builder class is a main handler of the projects and templates.
+class Prigner::Builder
+
+  require "fileutils"
+
+  include FileUtils
+
+  attr_reader :project
+
+  attr_reader :template
+
+  # Build a new project based on a template.
+  def initialize(project, template)
+    @project, @template = project, template
+  end
+
+  def make_project_path #:yields: path, info
+    mkdir_p(@project.path)
+    { no_pwd(@project.path) => File.stat(@project.path) }
+  end
+
+  def make_project_directories #:yields: path, info
+    @template.directories.inject({}) do |hash, basedir|
+      directory = basedir.gsub(/\((.*?)\)/){ @project.send($1) }
+      path      = File.join(@project.path, directory)
+      mkdir_p(path)
+      hash[no_pwd(path)] = File.stat(path)
+      hash
+    end
+  end
+
+  def make_project_files #:yields: path, info
+    @template.models.inject({}) do |hash, (model, basename)|
+      file = basename.gsub(/\((.*?)\)/){ project.send($1) }
+      path = File.join(@project.path, file)
+      model.binder = Prigner::Binder.new(@project, @template.options)
+      model.write(path)
+      hash[no_pwd(model.file_written)] = File.stat(model.file_written)
+      hash
+    end
+  end
+
+private
+
+  def no_pwd(path)
+    path.gsub("#{Dir.pwd}/", "")
+  end
+end
+