comma 0.4.1 → 0.4.2

data/Gemfile

@@ -1,4 +1,10 @@
 source :rubygems
 
-# Include dependencies from gemspec.
-gemspec
+gem "activesupport", ">= 2.2.2"
+gem "rspec", "~> 2.3.0"
+gem "fastercsv"
+
+group :development do
+  gem "jeweler", "~> 1.6"
+  gem "activerecord", ">= 2.2.2"
+end

data/Gemfile.lock

@@ -1,29 +1,32 @@
-PATH
-  remote: .
-  specs:
-    comma (0.4.0)
-      activesupport (>= 2.2.2)
-
 GEM
   remote: http://rubygems.org/
   specs:
-    activesupport (3.0.1)
+    activerecord (2.3.10)
+      activesupport (= 2.3.10)
+    activesupport (2.3.10)
     diff-lcs (1.1.2)
-    rspec (2.0.1)
-      rspec-core (~> 2.0.1)
-      rspec-expectations (~> 2.0.1)
-      rspec-mocks (~> 2.0.1)
-    rspec-core (2.0.1)
-    rspec-expectations (2.0.1)
-      diff-lcs (>= 1.1.2)
-    rspec-mocks (2.0.1)
-      rspec-core (~> 2.0.1)
-      rspec-expectations (~> 2.0.1)
+    fastercsv (1.5.4)
+    git (1.2.5)
+    jeweler (1.6.0)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.8.7)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
+  activerecord (>= 2.2.2)
   activesupport (>= 2.2.2)
-  comma!
-  rspec (>= 1.2.9)
+  fastercsv
+  jeweler (~> 1.6)
+  rspec (~> 2.3.0)

data/README.rdoc

@@ -125,6 +125,10 @@ You can pass the :filename option and have Comma writes the CSV output to this f
 
  Book.limited(10).to_comma(:filename => 'books.csv')
 
+You also can pass the :write_header option to hide the header line (true is default):
+
+ Book.limited(10).to_comma(:write_headers => false)
+
 == Using blocks
 
 For more complex relationships you can pass blocks for calculated values, or related values. Following the previous example here is a comma set using blocks (both with and without labels for your CSV headings):
@@ -183,6 +187,17 @@ When used with Rails (ie. add 'comma' as a gem dependency), Comma automatically
 
  end
 
+You can specify which output format you would like to use by specifying a style parameter:
+ class BooksController < ApplicationController
+
+   def index
+     respond_to do |format|
+       format.csv { render :csv => Book.limited(50), :style => :brief }
+     end
+   end
+
+ end
+
 When used with Rails 2.3.*, Comma also adds support for exporting named scopes:
 
  class Book < ActiveRecord::Base

data/Rakefile

@@ -1,39 +1,37 @@
 require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
 require 'rake'
 
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name = "comma"
-    gem.summary = "Ruby Comma Seperated Values generation library"
-    gem.description = "Ruby Comma Seperated Values generation library"
-    gem.email = "crafterm@redartisan.com"
-    gem.rubyforge_project = 'comma'
-    gem.homepage = "http://github.com/crafterm/comma"
-    gem.authors = ["Marcus Crafter"]
-    gem.add_development_dependency "rspec", ">= 1.2.9"
-    gem.add_dependency("activesupport", ">= 2.2.2")
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  gem.name = "comma"
+  gem.summary = "Ruby Comma Seperated Values generation library"
+  gem.description = "Ruby Comma Seperated Values generation library"
+  gem.email = "crafterm@redartisan.com"
+  gem.rubyforge_project = 'comma'
+  gem.homepage = "http://github.com/crafterm/comma"
+  gem.authors = ["Marcus Crafter"]
 end
+Jeweler::RubygemsDotOrgTasks.new
 
-require 'spec/rake/spectask'
-Spec::Rake::SpecTask.new(:spec) do |spec|
-  spec.libs << 'lib' << 'spec'
-  spec.spec_files = FileList['spec/**/*_spec.rb']
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
 end
 
-Spec::Rake::SpecTask.new(:rcov) do |spec|
-  spec.libs << 'lib' << 'spec'
+RSpec::Core::RakeTask.new(:rcov) do |spec|
   spec.pattern = 'spec/**/*_spec.rb'
   spec.rcov = true
 end
 
-task :spec => :check_dependencies
-
 task :default => :spec
 
 require 'rake/rdoctask'
@@ -41,7 +39,7 @@ Rake::RDocTask.new do |rdoc|
   version = File.exist?('VERSION') ? File.read('VERSION') : ""
 
   rdoc.rdoc_dir = 'rdoc'
-  rdoc.title = "comma #{version}"
+  rdoc.title = "awesome #{version}"
   rdoc.rdoc_files.include('README*')
   rdoc.rdoc_files.include('lib/**/*.rb')
 end

data/VERSION

@@ -1 +1 @@
-0.4.1
+0.4.2

data/comma.gemspec

@@ -1,72 +1,71 @@
 # Generated by jeweler
 # DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{comma}
-  s.version = "0.4.1"
+  s.version = "0.4.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Marcus Crafter"]
-  s.date = %q{2010-10-19}
+  s.date = %q{2011-10-14}
   s.description = %q{Ruby Comma Seperated Values generation library}
   s.email = %q{crafterm@redartisan.com}
   s.extra_rdoc_files = [
     "README.rdoc"
   ]
   s.files = [
-    ".gitignore",
-     "Gemfile",
-     "Gemfile.lock",
-     "MIT-LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "VERSION",
-     "comma.gemspec",
-     "init.rb",
-     "lib/comma.rb",
-     "lib/comma/array.rb",
-     "lib/comma/association_proxy.rb",
-     "lib/comma/extractors.rb",
-     "lib/comma/generator.rb",
-     "lib/comma/named_scope.rb",
-     "lib/comma/object.rb",
-     "lib/comma/render_as_csv.rb",
-     "spec/comma/ar_spec.rb",
-     "spec/comma/comma_spec.rb",
-     "spec/comma/extractors_spec.rb",
-     "spec/spec.opts",
-     "spec/spec_helper.rb",
-     "sudo"
+    "Gemfile",
+    "Gemfile.lock",
+    "MIT-LICENSE",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "comma.gemspec",
+    "init.rb",
+    "lib/comma.rb",
+    "lib/comma/array.rb",
+    "lib/comma/association_proxy.rb",
+    "lib/comma/extractors.rb",
+    "lib/comma/generator.rb",
+    "lib/comma/named_scope.rb",
+    "lib/comma/object.rb",
+    "lib/comma/render_as_csv.rb",
+    "spec/comma/ar_spec.rb",
+    "spec/comma/comma_spec.rb",
+    "spec/comma/extractors_spec.rb",
+    "spec/spec.opts",
+    "spec/spec_helper.rb"
   ]
   s.homepage = %q{http://github.com/crafterm/comma}
-  s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{comma}
-  s.rubygems_version = %q{1.3.6}
+  s.rubygems_version = %q{1.4.2}
   s.summary = %q{Ruby Comma Seperated Values generation library}
-  s.test_files = [
-    "spec/comma/ar_spec.rb",
-     "spec/comma/comma_spec.rb",
-     "spec/comma/extractors_spec.rb",
-     "spec/spec_helper.rb"
-  ]
 
   if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
-    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<activesupport>, [">= 2.2.2"])
+      s.add_runtime_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_runtime_dependency(%q<fastercsv>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6"])
+      s.add_development_dependency(%q<activerecord>, [">= 2.2.2"])
     else
-      s.add_dependency(%q<rspec>, [">= 1.2.9"])
       s.add_dependency(%q<activesupport>, [">= 2.2.2"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<fastercsv>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6"])
+      s.add_dependency(%q<activerecord>, [">= 2.2.2"])
     end
   else
-    s.add_dependency(%q<rspec>, [">= 1.2.9"])
     s.add_dependency(%q<activesupport>, [">= 2.2.2"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<fastercsv>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6"])
+    s.add_dependency(%q<activerecord>, [">= 2.2.2"])
   end
 end
 

data/lib/comma.rb

@@ -35,6 +35,6 @@ if defined?(ActiveRecord)
   require 'comma/association_proxy'
 end
 
-if defined?(ActionController)
+if defined?(RenderAsCSV) && defined?(ActionController)
   ActionController::Base.send :include, RenderAsCSV
 end

data/lib/comma/generator.rb

@@ -8,9 +8,9 @@ module Comma
       @options  = {}
 
       if @style.is_a? Hash
-        @options  = @style.clone
-        @style    = @options.delete(:style) || :default
-        @filename = @options.delete(:filename)
+        @options                  = @style.clone
+        @style                    = @options.delete(:style) || :default
+        @filename                 = @options.delete(:filename)
       end
     end
 
@@ -25,7 +25,10 @@ module Comma
     private
     def append_csv(csv, iterator_method)
       return '' if @instance.empty?
-      csv << @instance.first.to_comma_headers(@style) # REVISIT: request to optionally include headers
+      unless @options.has_key?(:write_headers) && !@options[:write_headers]
+        csv << @instance.first.to_comma_headers(@style)
+      end
+      
       @instance.send(iterator_method) do |object|
         csv << object.to_comma(@style)
       end

data/lib/comma/render_as_csv.rb

@@ -1,42 +1,57 @@
-module RenderAsCSV
-  def self.included(base)
-    base.alias_method_chain :render, :csv
+if defined?(ActionController::Renderers) && ActionController::Renderers.respond_to?(:add)
+  ActionController::Renderers.add :csv do |obj, options|
+    filename = options[:filename] || 'data'
+    send_data obj.to_comma, :type => Mime::CSV, :disposition => "attachment; filename=#{filename}.csv"
   end
-
-  def render_with_csv(options = nil, extra_options = {}, &block)
-    return render_without_csv(options, extra_options, &block) unless options.is_a?(Hash) and options[:csv].present?
-
-    content  = options.delete(:csv)
-    style    = options.delete(:style) || :default
-    filename = options.delete(:filename)
-
-    headers.merge!(
-      'Content-Transfer-Encoding' => 'binary',
-      'Content-Type'              => 'text/csv; charset=utf-8'
-    )
-    filename_header_value = "attachment"
-    filename_header_value += "; filename=\"#{filename}\"" if filename.present?
-    headers.merge!('Content-Disposition' => filename_header_value)
-
-    @performed_render = false
-
-    render_stream :status => 200,
-                  :content => Array(content),
-                  :style => style
-  end
-
-  protected
-
-  def render_stream(options)
-    status  = options[:status]
-    content = options[:content]
-    style   = options[:style]
-
-    render :status => status, :text => Proc.new { |response, output|
-      output.write FasterCSV.generate_line(content.first.to_comma_headers(style))
-      content.each { |line| output.write FasterCSV.generate_line(line.to_comma(style)) }
-    }
+else
+  module RenderAsCSV
+    def self.included(base)
+      base.alias_method_chain :render, :csv
+    end
+
+    def render_with_csv(options = nil, extra_options = {}, &block)
+      return render_without_csv(options, extra_options, &block) unless options.is_a?(Hash) and options[:csv].present?
+
+      content  = options.delete(:csv)
+      style    = options.delete(:style) || :default
+      filename = options.delete(:filename)
+
+      headers.merge!(
+        'Content-Transfer-Encoding' => 'binary',
+        'Content-Type'              => 'text/csv; charset=utf-8'
+      )
+      filename_header_value = "attachment"
+      filename_header_value += "; filename=\"#{filename}\"" if filename.present?
+      headers.merge!('Content-Disposition' => filename_header_value)
+
+      @performed_render = false
+
+      render_stream :status => 200,
+                    :content => Array(content),
+                    :style => style
+    end
+
+    protected
+
+    def render_stream(options)
+      status  = options[:status]
+      content = options[:content]
+      style   = options[:style]
+
+      # If Rails 2.x
+      if defined? Rails and (Rails.version.split('.').map(&:to_i) <=> [2,3,5]) < 0
+        render :status => status, :text => Proc.new { |response, output|
+          output.write FasterCSV.generate_line(content.first.to_comma_headers(style))
+          content.each { |line| output.write FasterCSV.generate_line(line.to_comma(style)) }
+        }
+      else # If Rails 3.x
+        self.status = status
+        self.response_body = proc { |response, output|
+          output.write FasterCSV.generate_line(content.first.to_comma_headers(style))
+          content.each { |line| output.write FasterCSV.generate_line(line.to_comma(style)) }
+        }
+      end
+    end
   end
+  #credit : http://ramblingsonrails.com/download-a-large-amount-of-data-in-csv-from-rails
 end
-
-#credit : http://ramblingsonrails.com/download-a-large-amount-of-data-in-csv-from-rails

data/spec/comma/comma_spec.rb

@@ -201,6 +201,16 @@ describe Comma, 'to_comma data/headers object extensions' do
       header, foo = Array(@foo).to_comma.split("\n")
       header.should == ['Content', 'Truncated Content', 'Created at', 'Updated at', 'Created Custom Label', 'Updated at Custom Label'].join(',')
     end
+    
+    it 'should put headers in place when forced' do
+      header, foo = Array(@foo).to_comma(:write_headers => true).split("\n")
+      header.should == ['Content', 'Truncated Content', 'Created at', 'Updated at', 'Created Custom Label', 'Updated at Custom Label'].join(',')
+    end
+        
+    it 'should not write headers if specified' do
+      header, foo = Array(@foo).to_comma(:write_headers => false).split("\n")
+      header.should == [@content, @content[0..10], @time.to_s(:db), @time.to_s(:db), @time.to_s(:short), @time.to_s(:short)].join(',')
+    end
 
   end
 

data/spec/spec_helper.rb

@@ -1,6 +1,6 @@
 require 'rubygems'
-require 'spec'
-require 'activerecord'
+require 'rspec'
+require 'active_record'
 ActiveRecord::ActiveRecordError # http://tinyurl.com/24f84gf
 
 $:.unshift(File.dirname(__FILE__) + '/../lib')

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: comma
 version: !ruby/object:Gem::Version 
-  prerelease: false
+  hash: 11
+  prerelease: 
   segments: 
   - 0
   - 4
-  - 1
-  version: 0.4.1
+  - 2
+  version: 0.4.2
 platform: ruby
 authors: 
 - Marcus Crafter
@@ -14,37 +15,86 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-19 00:00:00 +11:00
+date: 2011-10-14 00:00:00 +11:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: rspec
-  prerelease: false
+  name: activesupport
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
         segments: 
-        - 1
         - 2
-        - 9
-        version: 1.2.9
-  type: :development
+        - 2
+        - 2
+        version: 2.2.2
+  type: :runtime
   version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: activesupport
   prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: rspec
   requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 3
+        - 0
+        version: 2.3.0
+  type: :runtime
+  version_requirements: *id002
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: fastercsv
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: jeweler
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 1
+        - 6
+        version: "1.6"
+  type: :development
+  version_requirements: *id004
+  prerelease: false
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 3
         segments: 
         - 2
         - 2
         - 2
         version: 2.2.2
-  type: :runtime
-  version_requirements: *id002
+  type: :development
+  version_requirements: *id005
+  prerelease: false
 description: Ruby Comma Seperated Values generation library
 email: crafterm@redartisan.com
 executables: []
@@ -54,7 +104,6 @@ extensions: []
 extra_rdoc_files: 
 - README.rdoc
 files: 
-- .gitignore
 - Gemfile
 - Gemfile.lock
 - MIT-LICENSE
@@ -76,39 +125,39 @@ files:
 - spec/comma/extractors_spec.rb
 - spec/spec.opts
 - spec/spec_helper.rb
-- sudo
 has_rdoc: true
 homepage: http://github.com/crafterm/comma
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 requirements: []
 
 rubyforge_project: comma
-rubygems_version: 1.3.6
+rubygems_version: 1.4.2
 signing_key: 
 specification_version: 3
 summary: Ruby Comma Seperated Values generation library
-test_files: 
-- spec/comma/ar_spec.rb
-- spec/comma/comma_spec.rb
-- spec/comma/extractors_spec.rb
-- spec/spec_helper.rb
+test_files: []
+

data/.gitignore

@@ -1,4 +0,0 @@
-pkg/*
-.*.swp
-*~
-.bundle

data/sudo

@@ -1,384 +0,0 @@
-#!/usr/bin/env ruby
-#
-# This file, hub, is generated code.
-# Please DO NOT EDIT or send patches for it.
-#
-# Please take a look at the source from
-# http://github.com/defunkt/hub
-# and submit patches against the individual files
-# that build hub.
-#
-
-module Hub
-  class Args < Array
-    def after(command = nil, &block)
-      @after ||= block ? block : command
-    end
-
-    def after?
-      !!@after
-    end
-  end
-end
-module Hub
-  module Commands
-    instance_methods.each { |m| undef_method(m) unless m =~ /(^__|send|to\?$)/ }
-    extend self
-
-    PRIVATE = 'git@github.com:%s/%s.git'
-    PUBLIC  = 'git://github.com/%s/%s.git'
-    USER    = `git config --global github.user`.chomp
-    REPO    = `basename $(pwd)`.chomp
-    LGHCONF = "http://github.com/guides/local-github-config"
-
-    def clone(args)
-      ssh = args.delete('-p')
-      args[1..-1].each_with_index do |arg, i|
-        i += 1
-        if arg.scan('/').size == 1 && !arg.include?(':')
-          url = ssh ? PRIVATE : PUBLIC
-          args[i] = url % arg.split('/')
-          break
-        elsif arg !~ /:|\//
-          url = ssh ? PRIVATE : PUBLIC
-          args[i] = url % [ github_user, arg ]
-          break
-        end
-      end
-    end
-
-    def remote(args)
-      return unless args[1] == 'add'
-
-      if args[-1] !~ /:|\//
-        ssh  = args.delete('-p')
-        user = args.last
-        url  = ssh ? PRIVATE : PUBLIC
-        args << url % [ user, REPO ]
-      end
-    end
-
-    def init(args)
-      if args.delete('-g')
-
-        url = PRIVATE % [ github_user, REPO ]
-        args.after "git remote add origin #{url}"
-      end
-    end
-
-    def alias(args)
-      shells = {
-        'sh'   => 'alias git=hub',
-        'bash' => 'alias git=hub',
-        'zsh'  => 'alias git=hub',
-        'csh'  => 'alias git hub',
-        'fish' => 'alias git hub'
-      }
-
-      silent = args.delete('-s')
-
-      if shell = args[1]
-        if silent.nil?
-          puts "Run this in your shell to start using `hub` as `git`:"
-          print "  "
-        end
-      else
-        puts "usage: hub alias [-s] SHELL", ""
-        puts "You already have hub installed and available in your PATH,"
-        puts "but to get the full experience you'll want to alias it to"
-        puts "`git`.", ""
-        puts "To see how to accomplish this for your shell, run the alias"
-        puts "command again with the name of your shell.", ""
-        puts "Known shells:"
-        shells.map { |key, _| key }.sort.each do |key|
-          puts "  " + key
-        end
-        puts "", "Options:"
-        puts "  -s   Silent. Useful when using the output with eval, e.g."
-        puts "       $ eval `hub alias -s bash`"
-
-        exit
-      end
-
-      if shells[shell]
-        puts shells[shell]
-      else
-        abort "fatal: never heard of `#{shell}'"
-      end
-
-      exit
-    end
-
-    def version(args)
-      args.after do
-        puts "hub version %s" % Version
-      end
-    end
-    alias_method "--version", :version
-
-    def help(args)
-      if args[1] == 'hub'
-        puts hub_manpage
-        exit
-      elsif args.size == 1
-        puts improved_help_text
-        exit
-      end
-    end
-
-    def improved_help_text
-      <<-help
-usage: git [--version] [--exec-path[=GIT_EXEC_PATH]] [--html-path]
-    [-p|--paginate|--no-pager] [--bare] [--git-dir=GIT_DIR]
-    [--work-tree=GIT_WORK_TREE] [--help] COMMAND [ARGS]
-
-Basic Commands:
-   init       Create an empty git repository or reinitialize an existing one
-   add        Add new or modified files to the staging area
-   rm         Remove files from the working directory and staging area
-   mv         Move or rename a file, a directory, or a symlink
-   status     Show the status of the working directory and staging area
-   commit     Record changes to the repository
-
-History Commands:
-   log        Show the commit history log
-   diff       Show changes between commits, commit and working tree, etc
-   show       Show information about commits, tags or files
-
-Branching Commands:
-   branch     List, create, or delete branches
-   checkout   Switch the active branch to another branch
-   merge      Join two or more development histories (branches) together
-   tag        Create, list, delete, sign or verify a tag object
-
-Remote Commands:
-   clone      Clone a remote repository into a new directory
-   fetch      Download data, tags and branches from a remote repository
-   pull       Fetch from and merge with another repository or a local branch
-   push       Upload data, tags and branches to a remote repository
-   remote     View and manage a set of remote repositories
-
-Advanced commands:
-   reset      Reset your staging area or working directory to another point
-   rebase     Re-apply a series of patches in one branch onto another
-   bisect     Find by binary search the change that introduced a bug
-   grep       Print files with lines matching a pattern in your codebase
-
-See 'git help COMMAND' for more information on a specific command.
-help
-    end
-
-  private
-
-    def github_user
-      if USER.empty?
-        abort "** No GitHub user set. See #{LGHCONF}"
-      else
-        USER
-      end
-    end
-
-    def hub_manpage
-      return "** Can't find groff(1)" unless groff?
-
-      require 'open3'
-      out = nil
-      Open3.popen3(groff_command) do |stdin, stdout, _|
-        stdin.puts hub_raw_manpage
-        stdin.close
-        out = stdout.read.strip
-      end
-      out
-    end
-
-    def groff?
-      system("which groff")
-    end
-
-    def groff_command
-      "groff -Wall -mtty-char -mandoc -Tascii"
-    end
-
-    def hub_raw_manpage
-      if File.exists? file = File.dirname(__FILE__) + '/../../man/hub.1'
-        File.read(file)
-      else
-        DATA.read
-      end
-    end
-
-    def puts(*args)
-      page_stdout
-      super
-    end
-
-    def page_stdout
-      return unless $stdout.tty?
-
-      read, write = IO.pipe
-
-      if Kernel.fork
-        $stdin.reopen(read)
-        read.close
-        write.close
-
-        ENV['LESS'] = 'FSRX'
-
-        Kernel.select [STDIN]
-
-        pager = ENV['PAGER'] || 'less -isr'
-        exec pager rescue exec "/bin/sh", "-c", pager
-      else
-        $stdout.reopen(write)
-        $stderr.reopen(write) if $stderr.tty?
-        read.close
-        write.close
-      end
-    end
-  end
-end
-module Hub
-  class Runner
-    attr_reader :args
-    def initialize(*args)
-      @args = Args.new(args)
-
-      @args[0] = 'help' if @args.empty?
-
-      if Commands.respond_to?(@args[0])
-        Commands.send(@args[0], @args)
-      end
-    end
-
-    def self.execute(*args)
-      new(*args).execute
-    end
-
-    def after
-      args.after.to_s
-    end
-
-    def command
-      "git #{args.join(' ')}"
-    end
-
-    def execute
-      if args.after?
-        execute_with_after_callback
-      else
-        exec "git", *args
-      end
-    end
-
-    def execute_with_after_callback
-      after = args.after
-      if system("git", *args)
-        after.respond_to?(:call) ? after.call : exec(after)
-        exit
-      else
-        exit 1
-      end
-    end
-  end
-end
-module Hub
-  Version = '0.1.3'
-end
-Hub::Runner.execute(*ARGV)
-__END__
-.\" generated with Ron/v0.3
-.\" http://github.com/rtomayko/ron/
-.
-.TH "HUB" "1" "December 2009" "DEFUNKT" "Git Manual"
-.
-.SH "NAME"
-\fBhub\fR \-\- git + hub = github
-.
-.SH "SYNOPSIS"
-\fBhub\fR \fICOMMAND\fR \fIOPTIONS\fR
-.
-.br
-\fBhub alias\fR [\fB\-s\fR] \fISHELL\fR
-.
-.P
-\fBgit init \-g\fR \fIOPTIONS\fR
-.
-.br
-\fBgit clone\fR [\fB\-p\fR] \fIOPTIONS\fR [\fIUSER\fR/]\fIREPOSITORY\fR \fIDIRECTORY\fR
-.
-.br
-\fBgit remote add\fR [\fB\-p\fR] \fIOPTIONS\fR \fIUSER\fR[/\fIREPOSITORY\fR]
-.
-.br
-.
-.SH "DESCRIPTION"
-\fBhub\fR enhances various \fBgit\fR commands with GitHub remote expansion. The
-alias command displays information on configuring your environment:
-.
-.TP
-\fBhub alias\fR [\fB\-s\fR] \fISHELL\fR 
-Writes shell aliasing code for \fISHELL\fR (\fBbash\fR, \fBsh\fR, \fBzsh\fR, \fBcsh\fR) to standard output. With the \fB\-s\fR option, the output of
-this command can be evaluated directly within the shell: \fBeval $(hub alias \-s bash)\fR 
-.
-.P
-After configuring the alias, the following commands have superpowers:
-.
-.TP
-\fBgit init\fR \fB\-g\fR \fIOPTIONS\fR 
-Create a git repository as with git\-init(1) and add remote \fBorigin\fR at
-"git@github.com:\fIUSER\fR/\fIREPOSITORY\fR.git"; \fIUSER\fR is your GitHub username and \fIREPOSITORY\fR is the current working directory's basename.
-.
-.TP
-\fBgit clone\fR [\fB\-p\fR] \fIOPTIONS\fR [\fIUSER\fR\fB/\fR]\fIREPOSITORY\fR \fIDIRECTORY\fR 
-Clone repository "git://github.com/\fIUSER\fR/\fIREPOSITORY\fR.git" into \fIDIRECTORY\fR as with git\-clone(1). When \fIUSER\fR/ is omitted, assumes
-your GitHub login. With \fB\-p\fR, use private remote
-"git@github.com:\fIUSER\fR/\fIREPOSITORY\fR.git".
-.
-.TP
-\fBgit remote add\fR [\fB\-p\fR] \fIOPTIONS\fR \fIUSER\fR[\fB/\fR\fIREPOSITORY\fR]
-Add remote "git://github.com/\fIUSER\fR/\fIREPOSITORY\fR.git" as with
-git\-remote(1). When /\fIREPOSITORY\fR is omitted, the basename of the
-current working directory is used. With \fB\-p\fR, use private remote
-"git@github.com:\fIUSER\fR/\fIREPOSITORY\fR.git".
-.
-.TP
-\fBgit help\fR
-Display enhanced git\-help(1).
-.
-.SH "CONFIGURATION"
-Use git\-config(1) to display the currently configured GitHub username:
-.
-.IP "" 4
-.
-.nf
-
-$ git config \-\-global github.user 
-.
-.fi
-.
-.IP "" 0
-.
-.P
-Or, set the GitHub username with:
-.
-.IP "" 4
-.
-.nf
-
-$ git config \-\-global github.user <username> 
-.
-.fi
-.
-.IP "" 0
-.
-.P
-See \fIhttp://github.com/guides/local\-github\-config\fR for more information.
-.
-.SH "BUGS"
-\fIhttp://github.com/defunkt/hub/issues\fR
-.
-.SH "AUTHOR"
-Chris Wanstrath :: chris@ozmm.org :: @defunkt
-.
-.SH "SEE ALSO"
-git(1), git\-clone(1), git\-remote(1), git\-init(1),\fIhttp://github.com\fR, \fIhttp://github.com/defunkt/hub\fR