newgem 0.11.0 → 0.13.0

data/bundles/RubyGem.tmbundle/Snippets/History header trunk.tmSnippet

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>content</key>
+	<string>== ${1:TRUNK} ${4:`date +%Y`}-${5:`date +%m`}-${6:`date +%d`}
+
+* $0</string>
+	<key>name</key>
+	<string>History header trunk</string>
+	<key>scope</key>
+	<string>text.rdoc</string>
+	<key>tabTrigger</key>
+	<string>==t</string>
+	<key>uuid</key>
+	<string>30A49315-D6C1-4F70-8323-5C3BC80F1DAB</string>
+</dict>
+</plist>

data/bundles/RubyGem.tmbundle/Snippets/History header.tmSnippet

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>content</key>
+	<string>== ${1:0}.${2:0}.${3:0} ${4:`date +%Y`}-${5:`date +%m`}-${6:`date +%d`}
+
+* $0</string>
+	<key>name</key>
+	<string>History header</string>
+	<key>scope</key>
+	<string>text.rdoc</string>
+	<key>tabTrigger</key>
+	<string>==</string>
+	<key>uuid</key>
+	<string>732C2F2F-3BA9-45B5-B803-FB03BC7C066B</string>
+</dict>
+</plist>

data/bundles/RubyGem.tmbundle/Syntaxes/Rdoc.tmLanguage

@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>fileTypes</key>
+	<array>
+		<string>txt</string>
+	</array>
+	<key>firstLineMatch</key>
+	<string>==</string>
+	<key>keyEquivalent</key>
+	<string>^~R</string>
+	<key>name</key>
+	<string>Rdoc</string>
+	<key>patterns</key>
+	<array>
+		<dict>
+			<key>begin</key>
+			<string>^(?=\S)(?![=-]{3,}(?=$))</string>
+			<key>end</key>
+			<string>^(?:\s*$|(?=[ ]{,3}&gt;.))|(?=[ \t]*\n)(?&lt;=^===|^====|=====|^---|^----|-----)[ \t]*\n</string>
+			<key>name</key>
+			<string>markup.heading.rdoc</string>
+			<key>patterns</key>
+			<array>
+				<dict>
+					<key>include</key>
+					<string>#inline</string>
+				</dict>
+				<dict>
+					<key>include</key>
+					<string>text.html.basic</string>
+				</dict>
+				<dict>
+					<key>captures</key>
+					<dict>
+						<key>1</key>
+						<dict>
+							<key>name</key>
+							<string>punctuation.definition.heading.markdown</string>
+						</dict>
+					</dict>
+					<key>match</key>
+					<string>^(={3,})(?=[ \t]*$)</string>
+					<key>name</key>
+					<string>markup.heading.1.markdown</string>
+				</dict>
+				<dict>
+					<key>captures</key>
+					<dict>
+						<key>1</key>
+						<dict>
+							<key>name</key>
+							<string>punctuation.definition.heading.markdown</string>
+						</dict>
+					</dict>
+					<key>match</key>
+					<string>^(-{3,})(?=[ \t]*$)</string>
+					<key>name</key>
+					<string>markup.heading.2.markdown</string>
+				</dict>
+			</array>
+		</dict>
+	</array>
+	<key>scopeName</key>
+	<string>text.rdoc</string>
+	<key>uuid</key>
+	<string>4923E00C-3A77-452C-8AD7-7B2E2989029F</string>
+</dict>
+</plist>

data/bundles/RubyGem.tmbundle/info.plist

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>name</key>
+	<string>RubyGem</string>
+	<key>ordering</key>
+	<array>
+		<string>732C2F2F-3BA9-45B5-B803-FB03BC7C066B</string>
+		<string>30A49315-D6C1-4F70-8323-5C3BC80F1DAB</string>
+		<string>4923E00C-3A77-452C-8AD7-7B2E2989029F</string>
+	</array>
+	<key>uuid</key>
+	<string>5298EAB5-5E10-4285-B6B7-FC152EA37D45</string>
+</dict>
+</plist>

data/config/hoe.rb

@@ -0,0 +1,48 @@
+require 'hoe'
+require 'newgem/version'
+
+AUTHOR        = "Dr Nic Williams"
+EMAIL         = "drnicwilliams@gmail.com"
+DESCRIPTION   = "Make your own gems at home"
+GEM_NAME      = "newgem" # what ppl will type to install your gem
+RUBYFORGE_PROJECT = "newgem"
+HOMEPATH      = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+RUBYFORGE_USERNAME = "unknown"
+if File.exists?(rubyforge_config_file = File.expand_path("~/.rubyforge/user-config.yml"))
+  config = YAML.load(File.read(rubyforge_config_file))
+  RUBYFORGE_USERNAME.replace config["username"]
+end
+
+REV = nil #File.read(".svn/entries")[/committed-rev="(\d+)"/, 1] rescue nil
+# REV = `svn info`.each {|line| if line =~ /^Revision:/ then k,v = line.split(': '); break v.chomp; else next; end} rescue nil
+VERS = Newgem::VERSION::STRING + (REV ? ".#{REV}" : "")
+CLEAN.include ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test*.rb"]
+  p.clean_globs |= CLEAN  #An array of file patterns to delete on clean.
+
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.extra_deps = [
+    ['hoe', '>=1.3.0'],
+    ['RedCloth','>=3.0.4'],
+    ['syntax','>=1.0.0'],
+    ['activesupport','>=1.4.2'],
+    ['rubigen','>=1.0.0']
+  ]
+  #p.spec_extras    - A hash of extra values to set in the gemspec.
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\n\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "\#{RUBYFORGE_PROJECT}/\#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')

data/config/svn_branch.rb

@@ -0,0 +1,15 @@
+# Use svn_branch gem for branch/merge support
+begin
+  Gem.manage_gems
+  gem = Gem.cache.search('svn_branch').sort_by { |g| g.version }.last
+  if gem.nil?
+    puts <<-EOS
+You can install RubyGem 'svn_branch' to get helper tasks for svn branch management
+    gem install svn_branch
+EOS
+  else
+    path = gem.full_gem_path
+    Dir[File.join(path, "/**/tasks/**/*.rake")].sort.each { |ext| load ext }
+  end
+rescue LoadError
+end

data/lib/newgem.rb

@@ -1,7 +1,6 @@
+$:.unshift File.dirname(__FILE__)
+
 module Newgem #:nodoc:
 end
 
-require 'newgem/rubyforge'
-require 'newgem/version'
-
 

data/lib/newgem/quick_template.rb

@@ -0,0 +1,28 @@
+require "erb"
+
+module Newgem
+  class QuickTemplate
+    attr_reader :args, :text, :file
+    def initialize(file)
+      @file = file
+      @text = File.read(file)
+    end
+    def exec(b)
+      begin
+        # b = binding
+        template = ERB.new(@text, 0, "%<>")
+        result = template.result(b)
+        # Chomp the trailing newline
+        result.gsub(/\n$/,'')
+      rescue NameError
+        puts "Error found for #{file}"
+        raise $!
+      end
+    end
+  end
+
+  def erb(file, b)
+     QuickTemplate.new(file).exec(b)
+  end
+end
+

data/lib/newgem/tasks.rb

@@ -0,0 +1 @@
+Dir[File.join(File.dirname(__FILE__), %w[.. .. tasks], '**/*.rake')].each { |rake| load rake }

data/lib/newgem/version.rb

@@ -1,7 +1,7 @@
 module Newgem #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
-    MINOR = 11
+    MINOR = 13
     TINY  = 0
 
     STRING = [MAJOR, MINOR, TINY].join('.')

data/newgem_generators/install_website/USAGE

@@ -0,0 +1,5 @@
+Description:
+  
+  
+Usage:
+  

data/newgem_generators/install_website/install_website_generator.rb

@@ -0,0 +1,76 @@
+require 'rbconfig'
+
+class InstallWebsiteGenerator < RubiGen::Base
+  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
+                              Config::CONFIG['ruby_install_name'])
+  
+  default_options :shebang => DEFAULT_SHEBANG,
+                  :author  => "TODO",
+                  :email   => nil
+  
+  attr_reader :gem_name, :module_name
+  attr_reader :author, :email
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    @gem_name     = File.basename(File.expand_path(destination_root))
+    @module_name  = @gem_name.camelcase
+    extract_options
+  end
+
+  def manifest
+    script_options     = { :chmod => 0755, :shebang => options[:shebang] == DEFAULT_SHEBANG ? nil : options[:shebang] }
+    windows            = (RUBY_PLATFORM =~ /dos|win32|cygwin/i) || (RUBY_PLATFORM =~ /(:?mswin|mingw)/)
+
+    record do |m|
+      # Ensure appropriate folder(s) exists
+      m.directory 'website/javascripts'
+      m.directory 'website/stylesheets'
+      m.directory 'script'
+      m.directory 'tasks'
+
+      # Website
+      m.template_copy_each %w( index.txt index.html ), "website"
+      
+      %w( txt2html ).each do |file|
+        m.template "script/#{file}",        "script/#{file}", script_options
+        m.template "script/win_script.cmd", "script/#{file}.cmd", 
+          :assigns => { :filename => file } if windows
+      end
+      
+      m.file_copy_each %w[ website.rake ], "tasks"
+      
+      m.dependency "plain", [], :destination => destination_root
+    end
+  end
+
+  protected
+    def banner
+      <<-EOS
+Adds a website to a RubyGem (or any other project I guess.)
+
+USAGE: #{$0} [options]"
+EOS
+    end
+
+    def add_options!(opts)
+      opts.separator ''
+      opts.separator 'Options:'
+      # For each option below, place the default
+      # at the top of the file next to "default_options"
+      opts.on("-a", "--author=\"Your Name\"", String,
+              "You. The author of this RubyGem. You name goes in in the website.",
+              "Default: 'TODO'") { |options[:author]| }
+      opts.on("-e", "--email=your@email.com", String,
+              "Your email for people to contact you.",
+              "Default: nil") { |options[:author]| }
+    end
+    
+    def extract_options
+      # for each option, extract it into a local variable (and create an "attr_reader :author" at the top)
+      # Templates can access these value via the attr_reader-generated methods, but not the
+      # raw instance variable value.
+      @author = options[:author]
+      @email  = options[:email]
+    end
+end

data/{templates/scripts → newgem_generators/install_website/templates/script}/txt2html

@@ -1,13 +1,20 @@
 #!/usr/bin/env ruby
 
 require 'rubygems'
+begin
+  require 'newgem'
+rescue LoadError
+  puts "\n\nGenerating the website requires the newgem RubyGem"
+  puts "Install: gem install newgem\n\n"
+  exit(1)
+end
 require 'redcloth'
 require 'syntax/convertors/html'
 require 'erb'
-require File.dirname(__FILE__) + '/../lib/#{gem_name}/version.rb'
+require File.dirname(__FILE__) + '/../lib/<%= gem_name %>/version.rb'
 
-version  = #{module_name}::VERSION::STRING
-download = 'http://rubyforge.org/projects/#{gem_name}'
+version  = <%= module_name %>::VERSION::STRING
+download = 'http://rubyforge.org/projects/<%= gem_name %>'
 
 class Fixnum
   def ordinal
@@ -25,7 +32,7 @@ end
 
 class Time
   def pretty
-    return "\#{mday}\#{mday.ordinal} \#{strftime('%B')} \#{year}"
+    return "#{mday}#{mday.ordinal} #{strftime('%B')} #{year}"
   end
 end
 
@@ -35,10 +42,10 @@ end
 
 if ARGV.length >= 1
   src, template = ARGV
-  template ||= File.dirname(__FILE__) + '/../website/template.rhtml'
+  template ||= File.join(File.dirname(__FILE__), '/../website/template.rhtml')
   
 else
-  puts("Usage: \#{File.split($0).last} source.txt [template.rhtml] > output.html")
+  puts("Usage: #{File.split($0).last} source.txt [template.rhtml] > output.html")
   exit!
 end
 
@@ -53,8 +60,8 @@ File.open(src) do |fsrc|
   body_text.gsub!(%r!<(pre|code)[^>]*?syntax=['"]([^'"]+)[^>]*>(.*?)</\1>!m){
     ident = syntax_items.length
     element, syntax, source = $1, $2, $3
-    syntax_items << "<\#{element} class='syntax'>\#{convert_syntax(syntax, source)}</\#{element}>"
-    "syntax-temp-\#{ident}"
+    syntax_items << "<#{element} class='syntax'>#{convert_syntax(syntax, source)}</#{element}>"
+    "syntax-temp-#{ident}"
   }
   title = RedCloth.new(title_text).to_html.gsub(%r!<.*?>!,'').strip
   body = RedCloth.new(body_text).to_html

data/newgem_generators/install_website/templates/tasks/website.rake

@@ -0,0 +1,17 @@
+desc 'Generate website files'
+task :website_generate => :ruby_env do
+  (Dir['website/**/*.txt'] - Dir['website/version*.txt']).each do |txt|
+    sh %{ #{RUBY_APP} script/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{RUBYFORGE_USERNAME}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{RUBYFORGE_PROJECT}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_generate, :website_upload, :publish_docs]

data/{templates → newgem_generators/install_website/templates}/website/index.html

@@ -1,11 +1,11 @@
 <html>
 	<head>
 		<meta http-equiv="Content-type" content="text/html; charset=utf-8">
-		<title>#{gem_name}</title>
+		<title><%= gem_name %></title>
 		
 	</head>
 	<body id="body">
-		<p>This page has not yet been created for RubyGem <code>#{gem_name}</code></p>
+		<p>This page has not yet been created for RubyGem <code><%= gem_name %></code></p>
 		<p>To the developer: To generate it, update website/index.txt and run the rake task <code>website</code> to generate this <code>index.html</code> file.</p>
 	</body>
 </html>

data/newgem_generators/install_website/templates/website/index.txt

@@ -0,0 +1,39 @@
+h1. <%= gem_name.gsub(/\W+/,' ') %>
+
+h1. &#x2192; '<%= gem_name %>'
+
+
+h2. What
+
+
+h2. Installing
+
+<pre syntax="ruby">sudo gem install <%= gem_name %></pre>
+
+h2. The basics
+
+
+h2. Demonstration of usage
+
+
+
+h2. Forum
+
+"http://groups.google.com/group/<%= gem_name %>":http://groups.google.com/group/<%= gem_name %>
+
+TODO - create Google Group - <%= gem_name %>
+
+h2. How to submit patches
+
+Read the "8 steps for fixing other people's code":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/ and for section "8b: Submit patch to Google Groups":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/#8b-google-groups, use the Google Group above.
+
+The trunk repository is <code>svn://rubyforge.org/var/svn/<%= gem_name %>/trunk</code> for anonymous access.
+
+h2. License
+
+This code is free to use under the terms of the MIT license. 
+
+h2. Contact
+
+Comments are welcome. Send an email to "<%= author %>":mailto:<%= email %> via the "forum":http://groups.google.com/group/<%= gem_name %>
+