source2pdf 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4bc32d6aef760e36fbce5d5ce3c8930a7e037966
+  data.tar.gz: 3a0489be411d220b1705b80b076dfd362a6d83f5
+SHA512:
+  metadata.gz: acc7a07dec0d07f1217abfa52a72de50668e6917daf5eb80c34a866a3c3e058c19c8864263ff839ef9d0046a10e4624a6ba43598faf6be73b811c1b046769e1b
+  data.tar.gz: 7cf77c0b0fec48cbd4f2e1aabbfc4bd52d505a237075b3c0dd15e5c042e62c45daed6d09647924425979f4c31cfec8e3fd0dfce041bc57aa6b8acdbb57a63b06

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,78 @@
+AllCops:
+  Include:
+    - Gemfile
+    - Rakefile
+    - bin/*
+    - source2pdf.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
+
+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
+
+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,13 @@
+#### 0.2.0
+
+- First public release as `source2pdf` gem
+- Rename the gem from `github_exporter` to `source2pdf`
+- Support Github/BitBucket or any git hosting services (your private hosting included)
+- Only support ruby 2.0.0+ upward to use new refinement feature instead of monkeypatching
+- Use precise gem version for gemspec file
+
+#### 0.1.0 - 0.1.5
+
+- Release as 'github_exporter' gem
+
+[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,157 @@
+## source2pdf
+
+[![Gem Version](https://badge.fury.io/rb/source2pdf.svg)][gem]
+[![Dependency Status](https://gemnasium.com/agilecreativity/source2pdf.png)][gemnasium]
+[![Code Climate](https://codeclimate.com/github/agilecreativity/source2pdf.png)][codeclimate]
+
+[gem]: http://badge.fury.io/rb/source2pdf
+[gemnasium]: https://gemnasium.com/agilecreativity/source2pdf
+[codeclimate]: https://codeclimate.com/github/agilecreativity/source2pdf
+
+Export/print content of a given git repository (or local project directory) to a 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 source2pdf
+```
+
+## Synopsis/Usage
+
+### Basic Usage
+
+```shell
+Usage:
+
+  $source2pdf -e, --exts=EXT1 EXT2 EXT3 -u, --url=URL -theme=theme_name --output-name=output_file.pdf
+
+Example:
+
+  # Export the *.rb from the given repository
+
+  $source2pdf -e rb -u https://github.com/agilecreativity/source2pdf.git
+
+  # Export the *.rb and also 'Gemfile' from a 'source2pdf' directory
+  # Note: this directory must be directly below the current directory
+
+  $source2pdf -e rb -f Gemfile -u source2pdf
+
+  # Same as previous command with the 'solarized' instead of 'default' colorscheme
+  $source2pdf -e rb -f Gemfile -u filename_cleaner -t solarized
+
+Options:
+
+  -u, --url=URL                   # The full url of the github project to be cloned OR local directory name
+
+  -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/colorscheme to be used with vim_printer see :help :colorscheme from inside Vim
+                                  # default: 'default'
+                                  # e.g. -t solarized
+
+  -o, [--output-name=output.pdf]  # The output pdf filename (will default to 'repository_name'.pdf)
+                                  # e.g. -o repository_name.pdf
+
+Export a given Github project or a local project directory to a single pdf file
+
+```
+
+### Sample Usage:
+
+```shell
+source2pdf -u https://github.com/agilecreativity/source2pdf.git -e rb
+```
+
+Should result in something similar to this in the console
+
+```
+The project /Users/agilecreativity/Desktop/source2pdf already exist, no git clone needed!
+FYI: list of extensions: ["gem", "gemspec", "lock", "md", "pdf", "png", "rb"]
+FYI: list of all files : ["./lib/source2pdf.rb", "./lib/source2pdf/cli.rb", "./lib/source2pdf/source2pdf.rb", "./lib/source2pdf/exporter.rb", "./lib/source2pdf/logger.rb", "./lib/source2pdf/version.rb", "./test/lib/github_exporter/test_github_exporter.rb", "./test/test_helper.rb"]
+FYI: input options for VimPrinter : ["print", "--base-dir", "/Users/agilecreativity/Desktop/source2pdf", "--exts", ["rb"], "--theme", "seoul256", "--recursive"]
+FYI: process file 1 of 8 : ./lib/source2pdf.rb
+FYI: process file 2 of 8 : ./lib/source2pdf/cli.rb
+FYI: process file 3 of 8 : ./lib/source2pdf/source2pdf.rb
+FYI: process file 4 of 8 : ./lib/source2pdf/exporter.rb
+FYI: process file 5 of 8 : ./lib/source2pdf/logger.rb
+FYI: process file 6 of 8 : ./lib/source2pdf/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 '/Users/agilecreativity/Desktop/source2pdf/vim_printer_source2pdf.tar.gz'
+Convert file 1 of 9 : ./index.html
+Convert file 2 of 9 : ./lib/source2pdf.rb.xhtml
+Convert file 3 of 9 : ./lib/source2pdf/cli.rb.xhtml
+Convert file 4 of 9 : ./lib/source2pdf/source2pdf.rb.xhtml
+Convert file 5 of 9 : ./lib/source2pdf/exporter.rb.xhtml
+Convert file 6 of 9 : ./lib/source2pdf/logger.rb.xhtml
+Convert file 7 of 9 : ./lib/source2pdf/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 8.01304 ms
+Your final output is '/Users/agilecreativity/Desktop/source2pdf_tmp/source2pdf/html2pdf_source2pdf.tar.gz'
+Create pdfmarks took 0.026689 ms
+Combine pdf files took 0.463659 ms
+Your combined pdf is available at /Users/agilecreativity/Desktop/source2pdf_tmp/source2pdf/pdfs2pdf_source2pdf.pdf
+Your final output is /Users/agilecreativity/Desktop/source2pdf.pdf
+```
+
+### Sample Output
+
+#### Using the 'default' theme/colorscheme for Vim
+
+```shell
+source2pdf -u https://github.com/agilecreativity/source2pdf.git --exts rb
+```
+
+Which generated the following [pdf output file](https://github.com/agilecreativity/source2pdf/raw/master/samples/source2pdf_default_colorscheme.pdf)
+
+The example screenshot:
+
+![](https://github.com/agilecreativity/source2pdf/raw/master/samples/source2pdf_default_colorscheme.png)
+
+#### Use non-default colorscheme/theme for Vim
+
+Use my favourite [seoul256][] colorscheme
+
+```shell
+source2pdf -u https://github.com/agilecreativity/source2pdf.git --exts rb --theme seoul256
+```
+
+Which generated the following [pdf output file](https://github.com/agilecreativity/source2pdf/raw/master/samples/source2pdf_seoul256_colorscheme.pdf)
+
+The example screenshot:
+
+![](https://github.com/agilecreativity/source2pdf/raw/master/samples/source2pdf_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://ghostscript.com/doc/current/Install.htm
+[Wkhtmltopdf]: https://github.com/pdfkit/pdfkit/wiki/Installing-WKHTMLTOPDF
+[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,27 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+project_name = "source2pdf"
+
+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/source2pdf"
+  include Source2Pdf
+  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"]
+  task.formatters = ["files"]
+  task.fail_on_error = false
+end

data/bin/source2pdf

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

data/lib/source2pdf/cli.rb

@@ -0,0 +1,92 @@
+require "thor"
+require "vim_printer"
+require "html2pdf"
+require "pdfs2pdf"
+require "agile_utils"
+require_relative "source2pdf"
+module Source2Pdf
+  class CLI < Thor
+    using AgileUtils::HashExt
+
+    desc "export", "Export a given Git's project or a local project to a single pdf file"
+    method_option "url",
+                  aliases:  "-u",
+                  desc:     "The full url of the git project to be cloned or local project directory (mandatory)",
+                  required: true
+    method_option "exts",
+                  type:     :array,
+                  aliases:  "-e",
+                  desc:     "The list of file extension to be exported (mandatory)",
+                  required: true
+    method_option "non_exts",
+                  type:     :array,
+                  aliases:  "-f",
+                  desc:     "The list of file without extension to be exported (optional)",
+                  default: []
+    method_option "theme",
+                  type:     :string,
+                  aliases:  "-t",
+                  desc:     "The theme to be used with vim_printer (optional)",
+                  default:  "default"
+    method_option "output_name",
+                  type:     :string,
+                  aliases:  "-o",
+                  desc:     "The output filename (optional)"
+    def export
+      #opts = options.symbolize_keys(options)
+      opts = options
+      exporter = Source2Pdf::Exporter.new opts[:url],
+                                          exts:        opts[:exts],
+                                          non_exts:    opts[:non_exts],
+                                          theme:       opts[:theme],
+                                          output_name: opts[:output_name]
+
+      exporter.export
+    end
+
+    desc "usage", "Display help screen"
+    def usage
+      puts <<-EOS
+Usage:
+
+  $source2pdf -u, --url=URL -e, --exts=EXT1 EXT2 EXT3 -t, --theme=theme_name -o, --output-name=output_file.pdf
+
+Example:
+
+  # Export the *.rb from the given repository
+
+  $source2pdf -u https://github.com/agilecreativity/source2pdf.git -e rb
+
+  # Export the *.rb and also 'Gemfile' from a 'source2pdf' directory
+  # Note: this directory must be directly below the current directory
+
+  $source2pdf -u source2pdf -e rb -f Gemfile
+
+  # Same as previous command with the 'solarized' instead of 'default' colorscheme
+  $source2pdf -u source2pdf -e rb -f Gemfile -t solarized
+
+Options:
+
+  -u, --url=URL                   # The full url of the git repository to be cloned OR local directory name
+
+  -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/colorscheme to be used with vim_printer see :help :colorscheme from inside Vim
+                                  # default: 'default'
+                                  # e.g. -t solarized
+
+  -o, [--output-name=output.pdf]  # The output pdf filename (will default to 'repository_name'.pdf)
+                                  # e.g. -o repository_name.pdf
+
+Export a given Git's repository or a local project directory to a single pdf file
+
+      EOS
+    end
+
+    default_task :usage
+  end
+end

data/lib/source2pdf/exporter.rb

@@ -0,0 +1,169 @@
+require "uri"
+require "agile_utils"
+require_relative "../source2pdf"
+module Source2Pdf
+  TMP_DIR = "source2pdf_tmp"
+  # rubocop:disable ClassLength, MethodLength
+  class Exporter
+    attr_reader :url,
+                :exts,
+                :non_exts,
+                :theme,
+                :output_name
+
+    attr_reader :base_dir,
+                :repo_name,
+                :output_path
+
+    # The initializer for Exporter
+    #
+    # @param [String] url the input URL like
+    #        https://github.com/opal/opal.git or just the immediate 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 colorscheme to use with `vim_printer`
+    # @option opts [String]        :output_name the output filename if any
+    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))
+      @output_name = pdf_filename(opts[:output_name]) || "#{@repo_name}.pdf"
+    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
+      copy_output
+      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}
+        output_name : #{output_name}
+     EOT
+    end
+
+    private
+
+    def clone
+      if File.exist?(output_path)
+        puts "The project #{output_path} already exist, no git clone needed!"
+        return
+      end
+      Source2Pdf.clone_repository(url, repo_name, base_dir)
+    end
+
+    # List all extensions
+    def all_extensions
+      all_exts = Source2Pdf.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 = Source2Pdf.list_files base_dir:  output_path,
+                                    exts:      exts,
+                                    non_exts:  non_exts,
+                                    recursive: true
+      end
+      files
+    end
+
+    # Convert files to htmls
+    def files2htmls
+      Source2Pdf.files_to_htmls base_dir: output_path,
+                              exts:     exts,
+                              non_exts: non_exts,
+                              theme:    theme if input_available?
+    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")
+      FileUtils.mkdir_p output_dir
+      AgileUtils::FileUtil.gunzip input_file, output_dir if File.exist?(input_file)
+      Source2Pdf.htmls_to_pdfs base_dir: output_dir
+    end
+
+    # Merge/join multiple pdf files into single pdf
+    def pdfs2pdf
+      input_file = File.expand_path("#{output_dir}/html2pdf_#{repo_name}.tar.gz")
+      AgileUtils::FileUtil.gunzip input_file, output_dir if File.exist?(input_file)
+      Source2Pdf.pdfs_to_pdf base_dir:  output_dir,
+                           recursive: true
+    end
+
+    def copy_output
+      generated_file = "#{output_dir}/pdfs2pdf_#{repo_name}.pdf"
+      destination_file = File.expand_path(File.dirname(output_dir) + "../../#{output_name}")
+      FileUtils.mv generated_file, destination_file if File.exist?(generated_file)
+      puts "Your final output is #{File.expand_path(destination_file)}"
+    end
+
+    def cleanup
+      FileUtils.rm_rf File.expand_path(File.dirname(output_dir) + "../../#{Source2Pdf::TMP_DIR}")
+      FileUtils.rm_rf File.expand_path(File.dirname(output_dir) + "../../#{repo_name}/vim_printer_#{repo_name}.tar.gz")
+    end
+
+    def output_dir
+      File.expand_path("#{base_dir}/#{Source2Pdf::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)
+      name = URI(uri).path.split(File::SEPARATOR).last if uri
+      File.basename(name, ".*") if name
+    end
+
+    # Add/rename the file extension to pdf
+    #
+    # @param [String] filename input file
+    # @return [String,NilClass] output file with .pdf as extension or nil
+    def pdf_filename(filename)
+      return nil unless filename
+      extname  = File.extname(filename)
+      basename = File.basename(filename, ".*")
+      if extname == ""
+        "#{filename}.pdf"
+      elsif extname != ".pdf"
+        "#{basename}.pdf"
+      else
+        filename
+      end
+    end
+  end
+  # robocop:enable All
+end

data/lib/source2pdf/logger.rb

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

data/lib/source2pdf/source2pdf.rb

@@ -0,0 +1,76 @@
+require "tmpdir"
+require "git"
+require "code_lister"
+module Source2Pdf
+  CustomError = Class.new(StandardError)
+  class << self
+    # Clone the given repository from git repository
+    #
+    # @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"
+      ]
+      args.concat(["--non-exts"]).concat(non_exts) unless non_exts.empty?
+
+      puts "FYI: 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/source2pdf/version.rb

@@ -0,0 +1,3 @@
+module Source2Pdf
+  VERSION = "0.2.0"
+end

data/lib/source2pdf.rb

@@ -0,0 +1,6 @@
+require_relative "source2pdf/version"
+require_relative "source2pdf/logger"
+require_relative "source2pdf/source2pdf"
+require_relative "source2pdf/exporter"
+require_relative "source2pdf/cli"
+include Source2Pdf

data/source2pdf.gemspec

@@ -0,0 +1,47 @@
+# coding: utf-8
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "source2pdf/version"
+Gem::Specification.new do |spec|
+  spec.name          = "source2pdf"
+  spec.version       = Source2Pdf::VERSION
+  spec.authors       = ["Burin Choomnuan"]
+  spec.email         = ["agilecreativity@gmail.com"]
+  spec.summary       = "Export any project from a given git repository or a local project directory to a single pdf file"
+  spec.description   = "Export any project from a given git repository (or a local directory) to a single pdf file.
+                        Combine useful features of vim_printer, html2pdf, pdfs2pdf and others
+                        to produce a single pdf file for quick review."
+  spec.homepage      = "https://github.com/agilecreativity/source2pdf"
+  spec.license       = "MIT"
+  spec.files         = Dir.glob("{bin,lib,templates}/**/*") + %w[Gemfile
+                                                                 Rakefile
+                                                                 source2pdf.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.1"
+  spec.add_runtime_dependency "git", "~> 1.2.7"
+  spec.add_runtime_dependency "agile_utils", "~> 0.2.0"
+  spec.add_runtime_dependency "code_lister", "~> 0.2.0"
+  spec.add_runtime_dependency "vim_printer", "~> 0.2.0"
+  spec.add_runtime_dependency "html2pdf", "~> 0.2.0"
+  spec.add_runtime_dependency "pdfs2pdf", "~> 0.2.0"
+  spec.add_development_dependency "awesome_print", "~> 1.2.0"
+  spec.add_development_dependency "bundler", "~> 1.6.2"
+  spec.add_development_dependency "gem-ctags", "~> 1.0.6"
+  spec.add_development_dependency "guard", "~> 2.6.1"
+  spec.add_development_dependency "guard-minitest", "~> 2.3.1"
+  spec.add_development_dependency "minitest", "~> 5.3"
+  spec.add_development_dependency "minitest-spec-context", "~> 0.0.3"
+  spec.add_development_dependency "pry", "~> 0.10.0"
+  spec.add_development_dependency "pry-theme", "~> 1.1.3"
+  spec.add_development_dependency "rake", "~> 10.3.2"
+  spec.add_development_dependency "rubocop", "~> 0.24.1"
+  spec.add_development_dependency "yard", "~> 0.8.7"
+end

metadata

@@ -0,0 +1,331 @@
+--- !ruby/object:Gem::Specification
+name: source2pdf
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Burin Choomnuan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-30 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.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.19.1
+- !ruby/object:Gem::Dependency
+  name: git
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.7
+- !ruby/object:Gem::Dependency
+  name: agile_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: code_lister
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: vim_printer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: html2pdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: pdfs2pdf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.6.2
+- !ruby/object:Gem::Dependency
+  name: gem-ctags
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.0.6
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.6.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.6.1
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.3.1
+- !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.10.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+- !ruby/object:Gem::Dependency
+  name: pry-theme
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.1.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.3.2
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.24.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.24.1
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+description: |-
+  Export any project from a given git repository (or a local directory) to a single pdf file.
+                          Combine useful features of vim_printer, html2pdf, pdfs2pdf and others
+                          to produce a single pdf file for quick review.
+email:
+- agilecreativity@gmail.com
+executables:
+- source2pdf
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/source2pdf
+- lib/source2pdf.rb
+- lib/source2pdf/cli.rb
+- lib/source2pdf/exporter.rb
+- lib/source2pdf/logger.rb
+- lib/source2pdf/source2pdf.rb
+- lib/source2pdf/version.rb
+- source2pdf.gemspec
+homepage: https://github.com/agilecreativity/source2pdf
+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 a given git repository or a local project directory
+  to a single pdf file
+test_files: []
+has_rdoc: