github_exporter 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 47dcd5396b00731afac0413cf3828b3b68a7c08f
+  data.tar.gz: e2e30f973770a966a06ce78bb97a711695204218
+SHA512:
+  metadata.gz: 22976c785ba411819679e2882c765d46c236cc347d2b08c040382013dc0bd0afc6a684f5ffccf84148af48885e6bc5dac76e0e3ee6e455d9cd9c8843d798f1f6
+  data.tar.gz: c2840d83bed7a41e8925e1f5d945023086389f6aed3002498ebe1abe3e368817ff97675c8f861ed696ca854ea4ce4c8a527ff13d8d00fbb4106e5b6284669509

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+# Custom generated files
+.ruby-version

data/.rubocop.yml

@@ -0,0 +1,96 @@
+AllCops:
+  Include:
+    - Gemfile
+    - Rakefile
+    - bin/*
+    - github_exporter.gemspec
+    - lib/**/*.rb
+    - test/**/*.rb
+# Avoid long parameter lists
+ParameterLists:
+  Max: 5
+  CountKeywordArgs: true
+
+MethodLength:
+  CountComments: false
+  Max: 15
+
+# Avoid more than `Max` levels of nesting.
+BlockNesting:
+  Max: 4
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect:  'map'
+    inject:   'reduce'
+    find_all: 'select'
+   #find:     'detect' # comment out for now as this will trigger changes for
+                       # Pathname.find to Pathname.detect which is not correct
+
+# Do not force public/protected/private keyword to be indented at the same
+# level as the def keyword. My personal preference is to outdent these keywords
+# because I think when scanning code it makes it easier to identify the
+# sections of code and visually separate them. When the keyword is at the same
+# level I think it sort of blends in with the def keywords and makes it harder
+# to scan the code and see where the sections are.
+AccessModifierIndentation:
+  Enabled: false
+
+# Limit line length
+LineLength:
+  Enabled: false
+
+# Disable documentation checking until a class needs to be documented once
+Documentation:
+  Enabled: false
+
+# Enforce Ruby 1.8-compatible hash syntax
+HashSyntax:
+  Enabled: true
+
+# Use spaces inside hash literals
+SpaceInsideHashLiteralBraces:
+  EnforcedStyle: space
+
+# Allow dots at the end of lines
+DotPosition:
+  Enabled: false
+
+# Don't require magic comment at the top of every file
+Encoding:
+  Enabled: false
+
+# Enforce outdenting of access modifiers (i.e. public, private, protected)
+AccessModifierIndentation:
+  EnforcedStyle: outdent
+
+EmptyLinesAroundAccessModifier:
+  Enabled: true
+
+# Align ends correctly
+EndAlignment:
+  AlignWith: variable
+
+# Indentation of when/else
+CaseIndentation:
+  IndentWhenRelativeTo: end
+  IndentOneStep: false
+
+DoubleNegation:
+  Enabled: false
+
+PercentLiteralDelimiters:
+  PreferredDelimiters:
+    '%':  ()
+    '%i': ()
+    '%q': ()
+    '%Q': ()
+    '%r': '{}'
+    '%s': ()
+    '%w': '[]'
+    '%W': '[]'
+    '%x': ()
+
+StringLiterals:
+  EnforcedStyle: double_quotes

data/CHANGELOG.md

@@ -0,0 +1,6 @@
+#### 0.1.0
+
+- Initial release following the [semantic versioning][]
+- Allow the export from local source
+
+[semantic versioning]: http://semver.org

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in valid_filename.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Burin Choomnuan
+
+MIT License
+
+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.md

@@ -0,0 +1,155 @@
+## github_exporter
+
+[![Gem Version](https://badge.fury.io/rb/github_exporter.svg)][gem]
+[![Dependency Status](https://gemnasium.com/agilecreativity/github_exporter.png)][gemnasium]
+[![Code Climate](https://codeclimate.com/github/agilecreativity/github_exporter.png)][codeclimate]
+
+[gem]: http://badge.fury.io/rb/github_exporter
+[gemnasium]: https://gemnasium.com/agilecreativity/github_exporter
+[codeclimate]: https://codeclimate.com/github/agilecreativity/github_exporter
+
+Export/print content of a given github repository (or local project directory) to single pdf for quick review offline.
+
+## Requirements
+
+- Valid installation of [Ghostscript][] required by [pdfs2pdf][] gem
+- Valid installation of [Wkhtmltopdf][] required by [html2pdf][] gem
+- Valid installation of [Vim][] required by [vim_printer][] gem
+
+## Installation
+
+```
+gem install github_exporter
+```
+
+## Synopsis/Usage
+
+```shell
+Usage:
+
+  $github_exporter -e, --exts=EXT1 EXT2 EXT3 -u, --url=URL -theme=theme_name
+
+Example:
+
+  # Export the *.rb from the given repository
+
+  $github_exporter -e rb -u https://github.com/agilecreativity/filename_cleaner.git
+
+  # Export the *.rb and also 'Gemfile' from a given directory 'filename_cleaner'
+  # Note: must be one directory directly relative to current directory
+
+  $github_exporter -e rb -f Gemfile -u filename_cleaner
+
+  # Export the *.rb and also 'Gemfile' from a given directory 'filename_cleaner'
+  # using 'solarized' theme
+  # Note: must be one directory directly relative to current directory
+
+  $github_exporter -e rb -f Gemfile -u filename_cleaner -t solarized
+
+Options:
+
+  -u, --url=URL                   # The full url of the github project to be cloned
+
+  -e, --exts=EXT1 EXT2 EXT3 ..    # The list of extension names to be exported
+                                  # e.g. -e md rb java
+
+  -f, [--non-exts=one two three]  # The list of file without extension to be exported
+                                  # e.g. -f Gemfile LICENSE
+
+  -t, [--theme=theme_name]        # The theme to be used with vim_printer see :h :colorscheme from Vim
+                                  # default: 'default'
+                                  # e.g. -t solarized
+
+Export a given URL or project to a single pdf file
+
+```
+
+### Sample Usage:
+
+```shell
+github_exporter -u https://github.com/agilecreativity/github_exporter.git -e rb
+```
+
+Should result in something similar to this in the console
+
+```
+git clone https://github.com/agilecreativity/github_exporter.git ./github_exporter
+FYI: list of extensions: ["gemspec", "md", "pdf", "png", "rb"]
+FYI: list of all files : ["./lib/github_exporter.rb", "./lib/github_exporter/cli.rb", "./lib/github_exporter/exporter.rb", "./lib/github_exporter/github_exporter.rb", "./lib/github_exporter/logger.rb", "./lib/github_exporter/version.rb", "./test/lib/github_exporter/test_github_exporter.rb", "./test/test_helper.rb"]
+Your input options for VimPrinter : ["print", "--base-dir", "./github_exporter", "--exts", ["rb"], "--theme", "default", "--recursive"]
+FYI: process file 1 of 8 : ./lib/github_exporter.rb
+FYI: process file 2 of 8 : ./lib/github_exporter/cli.rb
+FYI: process file 3 of 8 : ./lib/github_exporter/exporter.rb
+FYI: process file 4 of 8 : ./lib/github_exporter/github_exporter.rb
+FYI: process file 5 of 8 : ./lib/github_exporter/logger.rb
+FYI: process file 6 of 8 : ./lib/github_exporter/version.rb
+FYI: process file 7 of 8 : ./test/lib/github_exporter/test_github_exporter.rb
+FYI: process file 8 of 8 : ./test/test_helper.rb
+Your output file is './github_exporter/vim_printer_github_exporter.tar.gz'
+Convert file 1 of 9 : ./index.html
+Convert file 2 of 9 : ./lib/github_exporter.rb.xhtml
+Convert file 3 of 9 : ./lib/github_exporter/cli.rb.xhtml
+Convert file 4 of 9 : ./lib/github_exporter/exporter.rb.xhtml
+Convert file 5 of 9 : ./lib/github_exporter/github_exporter.rb.xhtml
+Convert file 6 of 9 : ./lib/github_exporter/logger.rb.xhtml
+Convert file 7 of 9 : ./lib/github_exporter/version.rb.xhtml
+Convert file 8 of 9 : ./test/lib/github_exporter/test_github_exporter.rb.xhtml
+Convert file 9 of 9 : ./test/test_helper.rb.xhtml
+Convert files to pdfs took 2.324978936 ms
+Your final output is './github_exporter_tmp/github_exporter/html2pdf_github_exporter.tar.gz'
+Create pdfmarks took 0.027517634 ms
+Combine pdf files took 0.763918867 ms
+Your combined pdf is available at ./github_exporter_tmp/github_exporter/pdfs2pdf_github_exporter.pdf
+Your final output is ./github_exporter.pdf
+```
+
+### Sample Output
+
+#### Using the 'default' theme/colorscheme for Vim
+
+```shell
+github_exporter -u https://github.com/agilecreativity/github_exporter.git --exts rb
+```
+
+Which generated the following [pdf output file](/samples/github_exporter_default_colorscheme.pdf)
+
+The example screenshot:
+
+![](/samples/github_exporter_default_colorscheme.png)
+
+#### Use non-default colorscheme/theme for Vim
+
+Use [seoul256][] colorscheme
+
+```shell
+github_exporter -u https://github.com/agilecreativity/github_exporter.git --exts rb --theme seoul256
+```
+
+Which generated the following [pdf output file](/samples/github_exporter_seoul256_colorscheme.pdf)
+
+The example screenshot:
+
+![](/samples/github_exporter_seoul256_colorscheme.png)
+
+### Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+[thor]: https://github.com/erikhuda/thor
+[minitest]: https://github.com/seattlerb/minitest
+[yard]: https://github.com/lsegal/yard
+[pry]: https://github.com/pry/pry
+[rubocop]: https://github.com/bbatsov/rubocop
+[grit]: https://github.com/mojombo/grit
+[Ghostscript]: http://todo.com/
+[Wkhtmltopdf]: http://todo.com/
+[Vim]: http://www.vim.org
+[vim_printer]: https://github.com/agilecreativity/vim_printer
+[pdfs2pdf]: https://github.com/agilecreativity/pdfs2pdf
+[html2pdf]: https://github.com/agilecreativity/html2pdf
+[monokai]: https://github.com/lsdr/monokai
+[seoul256]: https://github.com/junegunn/seoul256.vim

data/Rakefile

@@ -0,0 +1,29 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+project_name = "github_exporter"
+
+Rake::TestTask.new do |t|
+  t.libs << "lib/#{project_name}"
+  t.test_files = FileList["test/lib/#{project_name}/test_*.rb"]
+  t.verbose = true
+end
+
+task default: [:test, :rubocop]
+task :pry do
+  require "pry"
+  require "awesome_print"
+  require_relative "lib/github_exporter"
+  include GithubExporter
+  ARGV.clear
+  Pry.start
+end
+
+require "rubocop/rake_task"
+desc "Run RuboCop on the lib directory"
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.patterns = ["lib/**/*.rb"]
+  # only show the files with failures
+  task.formatters = ["files"]
+  # don't abort rake on failure
+  task.fail_on_error = false
+end

data/bin/github_exporter

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+require_relative "../lib/github_exporter"
+include GithubExporter
+if ARGV.empty?
+  GithubExporter::CLI.start(%w[usage])
+else
+  GithubExporter::CLI.start(%w[export].concat(ARGV))
+end

data/github_exporter.gemspec

@@ -0,0 +1,49 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "github_exporter/version"
+Gem::Specification.new do |spec|
+  spec.name          = "github_exporter"
+  spec.version       = GithubExporter::VERSION
+  spec.authors       = ["Burin Choomnuan"]
+  spec.email         = ["agilecreativity@gmail.com"]
+  spec.summary       = %q(Export any project from github to a single pdf file)
+  spec.description   = %q{Export any project from github to a single pdf file.
+                          Combine useful features of the following ruby gems
+                          (vim_printer, html2pdf, pdfs2pdf and others)
+                          to produce a single pdf file that can be view any where
+                          where pdf is supported.
+                         }
+  spec.homepage      = "https://github.com/agilecreativity/github_exporter"
+  spec.license       = "MIT"
+  spec.files         = Dir.glob("{bin,lib,templates}/**/*") + %w[Gemfile
+                                                                 Rakefile
+                                                                 github_exporter.gemspec
+                                                                 README.md
+                                                                 CHANGELOG.md
+                                                                 LICENSE
+                                                                 .rubocop.yml
+                                                                 .gitignore]
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+  spec.add_runtime_dependency "thor", "~> 0.19"
+  spec.add_runtime_dependency "git", "~> 1.2"
+  spec.add_runtime_dependency "awesome_print", "~> 1.2"
+  spec.add_runtime_dependency "agile_utils", "~> 0.1.3"
+  spec.add_runtime_dependency "code_lister", "~> 0.1.2"
+  spec.add_runtime_dependency "vim_printer", "~> 0.1.7"
+  spec.add_runtime_dependency "html2pdf", "~> 0.1.6"
+  spec.add_runtime_dependency "pdfs2pdf", "~> 0.1.6"
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "gem-ctags", "~> 1.0"
+  spec.add_development_dependency "guard", "~> 2.6"
+  spec.add_development_dependency "guard-minitest", "~> 2.2"
+  spec.add_development_dependency "minitest", "~> 5.3"
+  spec.add_development_dependency "minitest-spec-context", "~> 0.0.3"
+  spec.add_development_dependency "pry", "~> 0.9"
+  spec.add_development_dependency "pry-theme"
+  spec.add_development_dependency "rake", "~> 10.1"
+  spec.add_development_dependency "rubocop", "~> 0.23"
+  spec.add_development_dependency "yard", "~> 0.8"
+end

data/lib/github_exporter/cli.rb

@@ -0,0 +1,81 @@
+require "thor"
+require "vim_printer"
+require "html2pdf"
+require "pdfs2pdf"
+require_relative "github_exporter"
+module GithubExporter
+  class CLI < Thor
+    desc "export", "Export a given URL or project to a single pdf file"
+    method_option "url",
+                  aliases:  "-u",
+                  desc:     "The full url of the github project to be cloned",
+                  required: true
+    method_option "exts",
+                  type:     :array,
+                  aliases:  "-e",
+                  desc:     "The list of file extension to be exported",
+                  required: true
+    method_option "non_exts",
+                  type:     :array,
+                  aliases:  "-f",
+                  desc:     "The list of file without extension to be exported",
+                  default: []
+    method_option "theme",
+                  type:     :string,
+                  aliases:  "-t",
+                  desc:     "The theme to be used with vim_printer",
+                  default:  "default"
+    def export
+      exporter = GithubExporter::Exporter.new options[:url],
+                                              exts:     options[:exts],
+                                              non_exts: options[:non_exts],
+                                              theme:    options[:theme]
+      exporter.export
+    end
+
+    desc "usage", "Display help screen"
+    def usage
+      puts <<-EOS
+Usage:
+
+  $github_exporter -e, --exts=EXT1 EXT2 EXT3 -u, --url=URL -theme=theme_name
+
+Example:
+
+  # Export the *.rb from the given repository
+
+  $github_exporter -e rb -u https://github.com/agilecreativity/filename_cleaner.git
+
+  # Export the *.rb and also 'Gemfile' from a given directory 'filename_cleaner'
+  # Note: must be one directory directly relative to current directory
+
+  $github_exporter -e rb -f Gemfile -u filename_cleaner
+
+  # Export the *.rb and also 'Gemfile' from a given directory 'filename_cleaner'
+  # using 'solarized' theme
+  # Note: must be one directory directly relative to current directory
+
+  $github_exporter -e rb -f Gemfile -u filename_cleaner -t solarized
+
+Options:
+
+  -u, --url=URL                   # The full url of the github project to be cloned
+
+  -e, --exts=EXT1 EXT2 EXT3 ..    # The list of extension names to be exported
+                                  # e.g. -e md rb java
+
+  -f, [--non-exts=one two three]  # The list of file without extension to be exported
+                                  # e.g. -f Gemfile LICENSE
+
+  -t, [--theme=theme_name]        # The theme to be used with vim_printer see :h :colorscheme from Vim
+                                  # default: 'default'
+                                  # e.g. -t solarized
+
+Export a given URL or project to a single pdf file
+
+      EOS
+    end
+
+    default_task :usage
+  end
+end

data/lib/github_exporter/exporter.rb

@@ -0,0 +1,162 @@
+#!/usr/bin/env ruby
+require "uri"
+require "agile_utils"
+require_relative "../github_exporter"
+module GithubExporter
+  # The temporary directory
+  TMP_DIR = "github_exporter_tmp"
+
+  class Exporter
+    attr_reader :url,
+                :exts,
+                :non_exts,
+                :theme
+    attr_reader :base_dir,
+                :repo_name,
+                :output_path
+    # Constructor for Executor
+    #
+    # @param [String] url the input URL like
+    #        https://github.com/opal/opal.git or just the immediat folder name
+    # @param [Hash<Symbol,Object>] opts the option hash
+    #
+    # @option opts [Array<String>] :exts the list of file extension to be used
+    # @option opts [Array<String>] :non_exts the list of file without extension to be used
+    # @option opts [String]        :theme the theme to use for `vim_printer`
+    def initialize(url, opts = {})
+      @url         = url
+      @base_dir    = Dir.pwd
+      @exts        = opts[:exts]     || []
+      @non_exts    = opts[:non_exts] || []
+      @theme       = opts[:theme]    || "default"
+      @repo_name   = project_name(url)
+      @output_path = File.expand_path([base_dir, repo_name].join(File::SEPARATOR))
+    end
+
+    # Print and export the source from a given URL to a pdf
+    def export
+      clone
+      puts "FYI: list of extensions: #{all_extensions}"
+      puts "FYI: list of all files : #{all_files}"
+      files2htmls
+      htmls2pdfs
+      pdfs2pdf
+      cleanup
+    end
+
+    def to_s
+      <<-EOT
+      url         : #{url}
+      base_dir    : #{base_dir}
+      exts        : #{exts}
+      non_exts    : #{non_exts}
+      repo_name   : #{repo_name}
+      theme       : #{theme}
+      output_path : #{output_path}
+     EOT
+    end
+
+  private
+
+    def clone
+      if File.exist?(output_path)
+        puts "The project #{output_path} already exist, no git clone needed!"
+        return
+      end
+      GithubExporter.clone_repository(url, repo_name, base_dir)
+    end
+
+    # List all extensions
+    def all_extensions
+      all_exts = GithubExporter.list_extensions(output_path)
+      # Strip off the '.' in the output if any.
+      all_exts.map! { |e| e.gsub(/^\./, "") }
+      all_exts
+    end
+
+    # List all files base on simple criteria
+    def all_files
+      files = []
+      if input_available?
+        files = GithubExporter.list_files base_dir:  output_path,
+                                          exts:      exts,
+                                          non_exts:  non_exts,
+                                          recursive: true
+
+      end
+      files
+    end
+
+    # Convert files to htmls
+    def files2htmls
+      if input_available?
+        GithubExporter.files_to_htmls base_dir: output_path,
+                                      exts:     exts,
+                                      non_exts: non_exts,
+                                      theme:    theme
+      end
+    end
+
+    # Convert list of html to list of pdf files
+    def htmls2pdfs
+      input_file = File.expand_path("#{output_path}/vim_printer_#{repo_name}.tar.gz")
+      if File.exist?(input_file)
+        FileUtils.mkdir_p output_dir
+        # input_file = File.expand_path("#{output_path}/vim_printer_#{repo_name}.tar.gz")
+        AgileUtils::FileUtil.gunzip input_file, output_dir
+        GithubExporter.htmls_to_pdfs(base_dir: output_dir)
+      end
+    end
+
+    # Merge/join multiple pdf files into single pdf
+    def pdfs2pdf
+      input_file = File.expand_path("#{output_dir}/html2pdf_#{repo_name}.tar.gz")
+      if File.exist?(input_file)
+        AgileUtils::FileUtil.gunzip input_file, output_dir
+        GithubExporter.pdfs_to_pdf base_dir: output_dir,
+                                   recursive: true
+      end
+    end
+
+    def cleanup
+      generated_file = "#{output_dir}/pdfs2pdf_#{repo_name}.pdf"
+      if File.exist?(generated_file)
+        destination_file = File.expand_path(File.dirname(output_dir) + "../../#{repo_name}.pdf")
+        FileUtils.mv generated_file, destination_file
+        puts "Your final output is #{File.expand_path(destination_file)}"
+
+        # Now cleanup the generated files
+        FileUtils.rm_rf File.expand_path(File.dirname(output_dir) + "../../#{GithubExporter::TMP_DIR}")
+
+        # Also remove the 'vim_printer_#{repo_name}.tar.gz' if we have one
+        FileUtils.rm_rf File.expand_path(File.dirname(output_dir) + "../../#{repo_name}/vim_printer_#{repo_name}.tar.gz")
+      end
+    end
+
+  private
+
+    def output_dir
+      File.expand_path("#{base_dir}/#{GithubExporter::TMP_DIR}/#{repo_name}")
+    end
+
+    def input_available?
+      (exts && !exts.empty?) || (non_exts && !non_exts.empty?)
+    end
+
+    # Extract project name from a given URL
+    #
+    # @param [String] uri input uri
+    #
+    # example:
+    #
+    #  project_name('https://github.com/erikhuda/thor.git') #=> 'thor'
+    #  project_name('https://github.com/erikhuda/thor')     #=> 'thor'
+    def project_name(uri)
+      if uri
+        name = URI(uri).path.split(File::SEPARATOR).last
+        # strip the '.' if any
+        File.basename(name, ".*") if name
+      end
+    end
+  end
+end

data/lib/github_exporter/github_exporter.rb

@@ -0,0 +1,80 @@
+require "tmpdir"
+require "git"
+require "code_lister"
+require "awesome_print"
+module GithubExporter
+  CustomError = Class.new(StandardError)
+  class << self
+    # Clone the given repository from github
+    #
+    # @param [String] url the github repository url like 'https://github.com/schacon/ruby-git.git'
+    # @param [String] name the output name to be used
+    # @param [String] path the output directory
+    def clone_repository(url, name, path)
+      puts "git clone #{url} #{File.expand_path(path)}/#{name}"
+      Git.clone url, name, path: File.expand_path(path)
+    end
+
+    def list_extensions(base_dir = ".")
+      extensions = Dir.glob(File.join(File.expand_path(base_dir), "**/*")).reduce([]) do |exts, file|
+        exts << File.extname(file)
+      end
+      extensions.sort.uniq.delete_if { |e| e == "" }
+    end
+
+    def list_files(options = {})
+      CodeLister.files(options)
+    end
+
+    def files_to_htmls(opts)
+      base_dir = base_dir(opts[:base_dir])
+      exts     = opts[:exts]     || []
+      non_exts = opts[:non_exts] || []
+      args = [
+        "print",
+        "--base-dir",
+        base_dir,
+        "--exts",
+        exts,
+        "--theme",
+        opts.fetch(:theme, "default"),
+        "--recursive"
+      ]
+
+      # Add file without the extension if any
+      unless non_exts.empty?
+        args.concat(["--non-exts"]).concat(non_exts)
+      end
+      puts "Your input options for VimPrinter : #{args}"
+      VimPrinter::CLI.start(args)
+    end
+
+    # Export list of html files to pdfs using `html2pdf` gem
+    def htmls_to_pdfs(opts)
+      base_dir = base_dir(opts[:base_dir])
+      Html2Pdf::CLI.start [
+        "export",
+        "--base-dir",
+        base_dir,
+        "--recursive"]
+    end
+
+    # Merge/combine pdfs using `pdfs2pdf` gem
+    def pdfs_to_pdf(opts)
+      base_dir = base_dir(opts[:base_dir])
+      Pdfs2Pdf::CLI.start [
+        "merge",
+        "--base-dir",
+        base_dir,
+        "--recursive"
+      ]
+    end
+
+  private
+
+    # Always expand the directory name so that '~' or '.' is expanded correctly
+    def base_dir(dir_name)
+      File.expand_path(dir_name)
+    end
+  end
+end

data/lib/github_exporter/logger.rb

@@ -0,0 +1,10 @@
+require "logger"
+module GithubExporter
+  class << self
+    attr_writer :logger
+    # @return [Logger] the logger for the project
+    def logger
+      @logger ||= Logger.new STDOUT
+    end
+  end
+end

data/lib/github_exporter/version.rb

@@ -0,0 +1,3 @@
+module GithubExporter
+  VERSION = "0.1.0"
+end

data/lib/github_exporter.rb

@@ -0,0 +1,6 @@
+require_relative "github_exporter/version"
+require_relative "github_exporter/logger"
+require_relative "github_exporter/github_exporter"
+require_relative "github_exporter/exporter"
+require_relative "github_exporter/cli"
+include GithubExporter

metadata

@@ -0,0 +1,331 @@
+--- !ruby/object:Gem::Specification
+name: github_exporter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Burin Choomnuan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: agile_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+- !ruby/object:Gem::Dependency
+  name: code_lister
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.2
+- !ruby/object:Gem::Dependency
+  name: vim_printer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+- !ruby/object:Gem::Dependency
+  name: html2pdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.6
+- !ruby/object:Gem::Dependency
+  name: pdfs2pdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.6
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: gem-ctags
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.3'
+- !ruby/object:Gem::Dependency
+  name: minitest-spec-context
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: pry-theme
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.23'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: "Export any project from github to a single pdf file.\n                          Combine
+  useful features of the following ruby gems\n                          (vim_printer,
+  html2pdf, pdfs2pdf and others)\n                          to produce a single pdf
+  file that can be view any where\n                          where pdf is supported.\n
+  \                        "
+email:
+- agilecreativity@gmail.com
+executables:
+- github_exporter
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/github_exporter
+- github_exporter.gemspec
+- lib/github_exporter.rb
+- lib/github_exporter/cli.rb
+- lib/github_exporter/exporter.rb
+- lib/github_exporter/github_exporter.rb
+- lib/github_exporter/logger.rb
+- lib/github_exporter/version.rb
+homepage: https://github.com/agilecreativity/github_exporter
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Export any project from github to a single pdf file
+test_files: []
+has_rdoc: