ramaze 2009.03 → 2009.04

data/rake_tasks/gem.rake

@@ -1,74 +0,0 @@
-def generate_gemspec(version)
-  Gem::Specification.new{|s|
-    s.name = "ramaze"
-    s.version = version
-    s.summary = "Ramaze is a simple and modular web framework"
-    s.description = s.summary
-
-    s.author = "Michael 'manveru' Fellinger"
-    s.email = "m.fellinger@gmail.com"
-    s.homepage = "http://ramaze.rubyforge.org"
-    s.rubyforge_project = "ramaze"
-
-    s.bindir = "bin"
-    s.require_path = "lib"
-
-    s.executables = Dir["#{s.bindir}/*"].map{|f| File.basename(f) }
-    s.files = FileList.new('**/*'){|fl|
-      fl.exclude(/^pkg\//)
-      fl.exclude(/^tags$/)
-    }.sort
-
-    s.platform = Gem::Platform::RUBY
-    s.has_rdoc = true
-    s.post_install_message = POST_INSTALL_MESSAGE
-
-    s.add_dependency('rack', '>=0.3.0')
-  }
-end
-
-def update_gemspec(spec)
-  gemspec = <<-OUT.strip
-Gem::Specification.new do |s|
-  s.name = %name%
-  s.version = %version%
-
-  s.summary = %summary%
-  s.description = %description%
-  s.platform = %platform%
-  s.has_rdoc = %has_rdoc%
-  s.author = %author%
-  s.email = %email%
-  s.homepage = %homepage%
-  s.executables = %executables%
-  s.bindir = %bindir%
-  s.require_path = %require_path%
-  s.post_install_message = %post_install_message%
-
-  %dependencies%
-
-  s.files = %files%
-end
-  OUT
-
-  gemspec.gsub!(/%(\w+)%/) do
-    case key = $1
-    when 'version'
-      spec.version.to_s.dump
-    when 'dependencies'
-      spec.dependencies.map{|dep|
-        "s.add_dependency('#{dep.name}', '#{dep.version_requirements}')"
-      }.join("\n  ")
-    else
-      spec.send($1).pretty_inspect.strip
-    end
-  end
-
-  File.open("ramaze.gemspec", 'w+'){|file| file.puts(gemspec) }
-end
-
-spec = generate_gemspec(version_today)
-Rake::GemPackageTask.new(spec) do |pkg|
-  pkg.need_zip = true
-  pkg.need_tar = true
-end

data/rake_tasks/maintenance.rake

@@ -1,386 +0,0 @@
-def version_today
-  Date.today.strftime("%Y.%m.%d")
-end
-
-def version_month
-  Date.today.strftime("%Y.%m")
-end
-
-namespace :maintenance do
-  desc "add copyright to all .rb files in the distribution"
-  task 'add-copyright' do
-    ignore = File.readlines('doc/LEGAL').
-      select{|line| line.strip!; File.exist?(line)}.
-      map{|file| File.expand_path(file)}
-
-    puts "adding copyright to files that don't have it currently"
-    puts COPYRIGHT
-    puts
-
-    Dir['{lib,test}/**/*{.rb}'].each do |file|
-      file = File.expand_path(file)
-      next if ignore.include? file
-      lines = File.readlines(file).map{|l| l.chomp}
-      unless lines.first(COPYRIGHT.size) == COPYRIGHT
-        puts "#{file} seems to need attention, first 4 lines:"
-        puts lines[0..3]
-        puts
-      end
-    end
-  end
-
-  desc "#{README} to doc/README.html"
-  Rake::RDocTask.new('readme2html-build') do |rd|
-    rd.options = %w[
-    --quiet
-    --opname readme.html
-    ]
-
-    rd.rdoc_dir = 'readme'
-    rd.rdoc_files = [README]
-    rd.main = README
-    rd.title = "Ramaze documentation"
-  end
-
-  desc "generate doc/TODO from the TODO tags in the source"
-  task 'todolist' do
-    list = `rake todo`
-    tasks = {}
-    current = nil
-
-    list.split("\n")[2..-1].each do |line|
-      if line =~ /TODO/ or line.empty?
-      elsif line =~ /^vim/
-        current = line.split[1]
-        tasks[current] = []
-      else
-        tasks[current] << line
-      end
-    end
-
-    lines = tasks.map{ |name, items| [name, items, ''] }.flatten
-    lines.pop
-
-    File.open(File.join('doc', 'TODO'), 'w+') do |f|
-      f.puts "This list is programmaticly generated by `rake todolist`"
-      f.puts "If you want to add/remove items from the list, change them at the"
-      f.puts "position specified in the list."
-      f.puts
-      f.puts(lines)
-    end
-  end
-
-  desc "remove those annoying spaces at the end of lines"
-  task 'fix-end-spaces' do
-    Dir['{lib,spec}/**/*.rb'].each do |file|
-      lines = File.readlines(file)
-      new = lines.dup
-      lines.each_with_index do |line, i|
-        if line =~ /\s+\n/
-          puts "fixing #{file}:#{i + 1}"
-          p line
-          new[i] = line.rstrip
-        end
-      end
-
-      unless new == lines
-        File.open(file, 'w+') do |f|
-          new.each do |line|
-            f.puts(line)
-          end
-        end
-      end
-    end
-  end
-
-  desc "Rebuild doc/tutorial/todolist.html"
-  task 'tutorial' do
-    require 'maruku'
-    require 'hpricot'
-
-    syntax_dir = File.dirname(Gem::latest_load_paths.grep(/syntax-/).first)
-    ruby_css = File.join(syntax_dir, 'data/ruby.css')
-    basefile = 'doc/tutorial/todolist'
-
-    content = File.read(basefile + '.mkd')
-    html = Maruku.new(content).to_html_document
-
-    doc = Hpricot(html)
-    css = %(<style type="text/css">
-            #{File.read(ruby_css)}
-    </style>)
-    doc.at('title').after(css)
-
-    File.open(basefile + '.html', 'w+'){|io| io << doc.to_s }
-  end
-
-  # This task is so full of hacks, it may break any second, but it just feels
-  # good to have proper highlighting for sh, ezamar and ruby generated from
-  # markdown without any external CSS to worry about.
-  desc 'Rebuild doc/tutorial/todolist.html using UltraViolet'
-  task 'tutorial-uv' do
-    require 'maruku'
-    require 'uv'
-    require 'hpricot'
-    require 'ramaze/contrib/maruku_uv'
-
-    # Inject ezamar syntax
-    Uv.init_syntaxes
-    ezamar = 'lib/ramaze/template/ezamar/textpow.syntax'
-    syntaxes = Uv.instance_variable_get('@syntaxes')
-    syntaxes['ezamar'] = Textpow::SyntaxNode.load(ezamar)
-
-    base = 'doc/tutorial/todolist'
-    original = File.read(base + '.mkd')
-    maruku = Maruku.new(original)
-    style = maruku.attributes[:uv_style]
-
-    html = maruku.to_html_document
-
-    uv_lib = Gem::latest_load_paths.grep(/ultraviolet/).first
-    uv_root = File.dirname(uv_lib)
-    css = Dir["#{uv_root}/**/#{style}.css"].first
-
-    doc = Hpricot(html)
-    css = %(<style type="text/css">
-              pre { margin: 1em; padding: 1em; }
-              #{File.read(css)}
-            </style>)
-
-    doc.at('title').after(css)
-
-    File.open(base + '.html', 'w+'){|io| io << doc.to_s }
-  end
-
-  def existing_authors
-    authors = {}
-
-    File.readlines('doc/AUTHORS').each do |line|
-      if line =~ /\s+(.*?)\s*:\s*(.*@.*)/
-        authors[$1] = {:email => $2, :patches => 0}
-      end
-    end
-
-    authors
-  end
-
-  def authors
-    format = "%an ** %ae"
-    log = `git-log --pretty=format:'#{format}'`
-
-    mapping = existing_authors
-
-    log.split("\n").each do |line|
-      name, email = line.split(' ** ')
-
-      if name =~ /(\S+@\S+)/
-        email ||= $1
-        name.sub!(email, '').strip!
-      end
-
-      email_start = /^#{Regexp.escape(name)}@(.*)/
-        AUTHOR_MAP.each do |e, a|
-        if e =~ email_start
-          email, name = e, a
-          break
-        end
-        end
-
-      name = AUTHOR_MAP[name] || name
-      email = AUTHOR_MAP.index(name) || email
-
-      mapping[name] ||= {:email => email, :patches => 0}
-      mapping[name][:patches] += 1
-    end
-
-    max = mapping.map{|k,v| k.size }.max
-    mapping.inject({}) {|h,(k,v)| h[k.ljust(max)] = v; h}
-  end
-
-  desc "Update /doc/AUTHORS"
-  task 'authors' do
-    # get the authors before we overwrite the file
-    authors = authors().sort_by{|k,v| k}
-
-    File.open('doc/AUTHORS', 'w+') do |fp|
-      fp.puts "Following persons (in alphabetical order) have contributed to Ramaze:"
-      fp.puts
-      authors.each do |name, author|
-        fp.puts "   #{name}  :  #{author[:email]}"
-      end
-      fp.puts
-    end
-  end
-
-  desc "show how many patches we made so far"
-  task :patchsize do
-    patches = `git rev-list HEAD | wc -l`.to_i
-    puts "currently we have #{patches} patches"
-    init = Time.parse("Sat Oct 14 04:22:49 JST 2006")
-    days = (Time.now - init) / (3600 * 24)
-    puts "%d days since init, avg %4.2f patches per day" % [days, patches/days]
-  end
-
-  desc "show who made how many patches"
-  task :patchstat do
-    total = 0.0
-
-    authors.map do |name, hash|
-      patches = hash[:patches]
-      total += patches
-      [patches, name]
-    end.sort.reverse_each do |patches, name|
-      puts "%s %4d [%6.2f%% ]" % [name, patches, patches/total * 100]
-    end
-  end
-
-  desc "upload packages to rubyforge"
-  task 'release' => ['distribute'] do
-    sh 'rubyforge login'
-    sh "rubyforge add_release ramaze ramaze #{VERS} pkg/ramaze-#{VERS}.gem"
-
-    require 'open-uri'
-    require 'hpricot'
-
-    url = "http://rubyforge.org/frs/?group_id=3034"
-    doc = Hpricot(open(url))
-    a = (doc/:a).find{|a| a[:href] =~ /release_id/}
-
-    version = a.inner_html
-    release_id = Hash[*a[:href].split('?').last.split('=').flatten]['release_id']
-
-    sh "rubyforge add_file ramaze ramaze #{release_id} pkg/ramaze-#{VERS}.tar.gz"
-    sh "rubyforge add_file ramaze ramaze #{release_id} pkg/ramaze-#{VERS}.tar.bz2"
-  end
-
-  task 'undocumented-module' do
-    require 'strscan'
-    require 'term/ansicolor'
-
-    $stdout.sync = true
-
-    class String
-      include Term::ANSIColor
-    end
-
-    class SimpleDoc
-      def initialize(string)
-        @s = StringScanner.new(string)
-      end
-
-      def scan
-        comment = false
-        total, missing = [], []
-        until @s.eos?
-          unless @s.scan(/^\s*#.*/)
-            comment = true if @s.scan(/^=begin[^$]*$/)
-                                           comment = false if comment and @s.scan(/^=end$/)
-
-                                           unless comment
-                                             if @s.scan(/(?:class ).*/)
-                                               #p @s.matched
-                                             elsif @s.scan(/(?:module ).*/)
-                                               #p @s.matched
-                                             elsif @s.scan(/(?:[\s$]def\s+)[\w?!*=+\/-]+(?=[\(\s])/)
-                                                           total << @s.matched.split.last
-                                                           prev = @s.pre_match.split("\n")
-                                                           prev.delete_if{|s| s.strip.empty?}
-                                                           unless prev.last =~ /^\s*#.*/
-                                                             missing << @s.matched.split.last
-                                                           end
-                                             else
-                                               @s.scan(/./m)
-                                             end
-                                           end
-          end
-        end
-
-        return total, missing
-      end
-    end
-
-    all = {}
-    files = Dir['lib/**/*.rb']
-    ignore = [
-      %r'contrib/gettext/(mo|po)\.rb',
-      %r'snippets/dictionary\.rb',
-      %r'lib/vendor',
-    ]
-
-    print "scanning ~#{files.size} files "
-    files.each do |file|
-      next if ignore.any?{|i| file =~ i}
-      print "."
-      t, m = SimpleDoc.new(File.read(file)).scan
-      all[file] = [t, m]
-    end
-    puts " done."
-
-    failed = all.reject{|k,(t,m)| m.size == 0}
-
-    max = failed.keys.sort_by{|f| f.size}.last.size
-
-    colors = {
-      (0..25  ) => :blue,
-      (25..50 ) => :green,
-      (50..75 ) => :yellow,
-      (75..100) => :red,
-    }
-
-    puts "\nAll undocumented methods\n\n"
-
-    failed.sort.each do |file, (t, m)|
-      ts, ms = t.size, m.size
-    tss, mss = ts.to_s, ms.to_s
-    ratio = ((ms.to_f/ts)*100).to_i
-    color = colors.find{|k,v| k.include?(ratio)}.last
-    complete = ms.to_f/ts.to_f
-    mthc = "method"
-    if ms > 0
-      puts "#{file.ljust(max)}\t[#{[mss, tss].join('/').center(8)}]".send(color)
-      mthc = "methods" if ts > 1
-      if $VERBOSE
-        puts "Of #{tss} #{mthc}, #{mss} still needs documenting (#{100 - ratio}% documented, #{ratio}% undocumented)".send(color)
-        mthc = "method"
-        mthc = "methods" if ms > 1
-        print "#{mthc.capitalize}: "
-      end
-      puts m.join(', ')
-      puts "vim #{file} '+/def #{m.first}'"
-      puts
-    end
-    end
-
-    puts "The colors mean percentages of documentation left (ratio of undocumented methods to total):"
-    colors.sort_by{|k,v| k.begin}.each do |r, color|
-      print "[#{r.inspect}] ".send(color)
-    end
-    puts "", ""
-
-    documented = 0
-    undocumented = 0
-
-    all.values.each do |(d,m)|
-      documented += d.size
-    undocumented += m.size
-    end
-
-    total = documented + undocumented
-    ratio = (documented * 100.0) / total
-
-    puts "Total documented: #{documented}, undocumented: #{undocumented}"
-    puts "%.2f%% of Ramaze is documented!" % ratio
-  end
-
-  desc "list all undocumented methods"
-  task 'undocumented' do
-    $VERBOSE = false
-    Rake::Task['maintenance:undocumented-module'].invoke
-  end
-
-  desc "list all undocumented methods verbosely"
-  task 'undocumented-verbose' do
-    $VERBOSE = true
-    Rake::Task['maintenance:undocumented-module'].invoke
-  end
-end