gist 3.1.1 → 4.0.0

data/lib/gist/manpage.rb

@@ -1,90 +0,0 @@
-module Gist
-  module Manpage
-    extend self
-
-    # Prints a manpage, all pretty and paged.
-    def display(name)
-      puts manpage(name)
-    end
-
-    # Returns the terminal-formatted manpage, ready to be printed to
-    # the screen.
-    def manpage(name)
-      return "** Can't find groff(1)" unless groff?
-
-      require 'open3'
-      out = nil
-      Open3.popen3(groff_command) do |stdin, stdout, _|
-        stdin.puts raw_manpage(name)
-        stdin.close
-        out = stdout.read.strip
-      end
-      out
-    end
-
-    # Returns the raw manpage. If we're not running in standalone
-    # mode, it's a file sitting at the root under the `man`
-    # directory.
-    #
-    # If we are running in standalone mode the manpage will be
-    # included after the __END__ of the file so we can grab it using
-    # DATA.
-    def raw_manpage(name)
-      if File.exists? file = File.dirname(__FILE__) + "/../../man/#{name}.1"
-        File.read(file)
-      else
-        DATA.read.split("__CACERT__").first
-      end
-    end
-
-    # Returns true if groff is installed and in our path, false if
-    # not.
-    def groff?
-      system("which groff > /dev/null")
-    end
-
-    # The groff command complete with crazy arguments we need to run
-    # in order to turn our raw roff (manpage markup) into something
-    # readable on the terminal.
-    def groff_command
-      "groff -Wall -mtty-char -mandoc -Tascii"
-    end
-
-    # All calls to `puts` are paged, git-style.
-    def puts(*args)
-      page_stdout
-      super
-    end
-
-    # http://nex-3.com/posts/73-git-style-automatic-paging-in-ruby
-    def page_stdout
-      return unless $stdout.tty?
-
-      read, write = IO.pipe
-
-      if Kernel.fork
-        # Parent process, become pager
-        $stdin.reopen(read)
-        read.close
-        write.close
-
-        # Don't page if the input is short enough
-        ENV['LESS'] = 'FSRX'
-
-        # Wait until we have input before we start the pager
-        Kernel.select [STDIN]
-
-        pager = ENV['PAGER'] || 'less -isr'
-        pager = 'cat' if pager.empty?
-
-        exec pager rescue exec "/bin/sh", "-c", pager
-      else
-        # Child process
-        $stdout.reopen(write)
-        $stderr.reopen(write) if $stderr.tty?
-        read.close
-        write.close
-      end
-    end
-  end
-end

data/lib/gist/standalone.rb

@@ -1,55 +0,0 @@
-module Gist
-  module Standalone
-    extend self
-
-    PREAMBLE = <<-preamble
-#!/usr/bin/env ruby
-# encoding: utf-8
-#
-# This file, gist, is generated code.
-# Please DO NOT EDIT or send patches for it.
-#
-# Please take a look at the source from
-# http://github.com/defunkt/gist
-# and submit patches against the individual files
-# that build gist.
-#
-
-preamble
-
-    POSTAMBLE = "Gist.execute(*ARGV)\n"
-    __DIR__   = File.dirname(__FILE__)
-    MANPAGE   = "__END__\n#{File.read(__DIR__ + '/../../man/gist.1')}"
-    CACERT    = "__CACERT__\n#{File.read(__DIR__ + '/cacert.pem')}"
-
-    def save(filename, path = '.')
-      target = File.join(File.expand_path(path), filename)
-      File.open(target, 'w') do |f|
-        f.puts build
-        f.chmod 0755
-      end
-    end
-
-    def build
-      root = File.dirname(__FILE__)
-
-      standalone = ''
-      standalone << PREAMBLE
-
-      Dir["#{root}/../**/*.rb"].each do |file|
-        # skip standalone.rb
-        next if File.expand_path(file) == File.expand_path(__FILE__)
-
-        File.readlines(file).each do |line|
-          next if line =~ /^\s*#/
-          standalone << line
-        end
-      end
-
-      standalone << POSTAMBLE
-      standalone << MANPAGE
-      standalone << CACERT
-      standalone
-    end
-  end
-end

data/lib/gist/version.rb

@@ -1,3 +0,0 @@
-module Gist
-  VERSION = Version = '3.1.1'
-end

data/man/gist.1

@@ -1,146 +0,0 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
-.
-.TH "GIST" "1" "November 2012" "GITHUB" "Gist Manual"
-.
-.SH "NAME"
-\fBgist\fR \- gist on the command line
-.
-.SH "SYNOPSIS"
-\fBgist\fR [\fB\-p\fR] [\fB\-t extension\fR] \fIFILE|\-\fR
-.
-.SH "DESCRIPTION"
-\fBgist\fR can be used to create gists on gist\.github\.com from the command line\. There are two primary methods of creating gists\.
-.
-.P
-If standard input is supplied, it will be used as the content of the new gist\. If \fIFILE\fR is provided, the content of that file will be used to create the gist\. If \fIFILE\fR is \'\-\' then gist will wait for content from standard input\.
-.
-.P
-Once your gist is successfully created, the URL will be copied to your clipboard\. If you are on OS X, \fBgist\fR will open the gist in your browser, too\.
-.
-.SH "OPTIONS"
-\fBgist\fR\'s default mode of operation is to read content from standard input and create a public, text gist without description from it, tied to your GitHub account if you user and passwordare provided (see \fBCONFIGURATION\fR)\.
-.
-.P
-These options can be used to change this behavior:
-.
-.TP
-\fB\-p\fR, \fB\-\-private\fR
-Create a private gist instead of a public gist\.
-.
-.TP
-\fB\-t\fR, \fB\-\-type\fR
-Set the file extension explicitly\. Passing a type of \fBrb\fR ensures the gist is created as a Ruby file\.
-.
-.TP
-\fB\-d\fR, \fB\-\-description\fR
-Set a description\.
-.
-.TP
-\fB\-o\fR, \fB\-\-[no\-]open\fR
-Open the gist in your browser after creation\. Or don\'t\. Defaults to \-\-open
-.
-.P
-You may additionally ask for help:
-.
-.TP
-\fB\-h\fR, \fB\-\-help\fR
-Print help\.
-.
-.TP
-\fB\-m\fR, \fB\-\-man\fR
-Display this man page\.
-.
-.SH "AUTHENTICATION"
-There are two ways to set GitHub user and password info:
-.
-.IP "\(bu" 4
-Using environment vars GITHUB_USER and GITHUB_PASSWORD
-.
-.IP
-$ export GITHUB_USER=johndoe
-.
-.br
-$ export GITHUB_PASSWORD=mysecretgithubpassword
-.
-.br
-$ gist ~/example
-.
-.IP "\(bu" 4
-Using git\-config(1)
-.
-.IP "" 0
-.
-.P
-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 "CONFIGURATION"
-You can set a few options in your git config (using git\-config(1)) to control the default behavior of gist(1)\.
-.
-.IP "\(bu" 4
-gist\.private \- boolean (yes or no) \- Determines whether to make a gist private by default
-.
-.IP "\(bu" 4
-gist\.extension \- string \- Default extension for gists you create\.
-.
-.IP "\(bu" 4
-gist\.browse \- boolean (yes or no) \- Whether to open the gist in your browser after creation\. Default: yes
-.
-.IP "" 0
-.
-.SH "ENVIRONMENT"
-The following environment variables affect the execution of \fBgist\fR:
-.
-.IP "\(bu" 4
-HTTP_PROXY \- Proxy to use when Gisting\. Should be "http://host:port/"
-.
-.IP "" 0
-.
-.SH "EXAMPLES"
-.
-.nf
-
-$ gist < file\.txt
-$ echo secret | gist \-\-private
-$ echo "puts :hi" | gist \-t rb
-$ gist script\.py
-$ gist \-
-the quick brown fox jumps over the lazy dog
-^D
-.
-.fi
-.
-.SH "BUGS"
-\fIhttp://github\.com/defunkt/gist/issues\fR
-.
-.SH "AUTHOR"
-Chris Wanstrath :: chris@ozmm\.org
-.
-.SH "SEE ALSO"
-hub(1), git(1), git\-clone(1), \fIhttp://github\.com\fR, \fIhttp://github\.com/defunkt/gist\fR

data/man/gist.1.html

@@ -1,209 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <meta http-equiv='content-type' value='text/html;charset=utf8'>
-  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
-  <title>gist(1) - gist on the command line</title>
-  <style type='text/css' media='all'>
-  /* style: man */
-  body#manpage {margin:0}
-  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
-  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
-  .mp h2 {margin:10px 0 0 0}
-  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
-  .mp h3 {margin:0 0 0 4ex}
-  .mp dt {margin:0;clear:left}
-  .mp dt.flush {float:left;width:8ex}
-  .mp dd {margin:0 0 0 9ex}
-  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
-  .mp pre {margin-bottom:20px}
-  .mp pre+h2,.mp pre+h3 {margin-top:22px}
-  .mp h2+pre,.mp h3+pre {margin-top:5px}
-  .mp img {display:block;margin:auto}
-  .mp h1.man-title {display:none}
-  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
-  .mp h2 {font-size:16px;line-height:1.25}
-  .mp h1 {font-size:20px;line-height:2}
-  .mp {text-align:justify;background:#fff}
-  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
-  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
-  .mp u {text-decoration:underline}
-  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
-  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
-  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
-  .mp b.man-ref {font-weight:normal;color:#434241}
-  .mp pre {padding:0 4ex}
-  .mp pre code {font-weight:normal;color:#434241}
-  .mp h2+pre,h3+pre {padding-left:0}
-  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
-  ol.man-decor {width:100%}
-  ol.man-decor li.tl {text-align:left}
-  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
-  ol.man-decor li.tr {text-align:right;float:right}
-  </style>
-</head>
-<!--
-  The following styles are deprecated and will be removed at some point:
-  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
-
-  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
-  .man-navigation should be used instead.
--->
-<body id='manpage'>
-  <div class='mp' id='man'>
-
-  <div class='man-navigation' style='display:none'>
-    <a href="#NAME">NAME</a>
-    <a href="#SYNOPSIS">SYNOPSIS</a>
-    <a href="#DESCRIPTION">DESCRIPTION</a>
-    <a href="#OPTIONS">OPTIONS</a>
-    <a href="#AUTHENTICATION">AUTHENTICATION</a>
-    <a href="#CONFIGURATION">CONFIGURATION</a>
-    <a href="#ENVIRONMENT">ENVIRONMENT</a>
-    <a href="#EXAMPLES">EXAMPLES</a>
-    <a href="#BUGS">BUGS</a>
-    <a href="#AUTHOR">AUTHOR</a>
-    <a href="#SEE-ALSO">SEE ALSO</a>
-  </div>
-
-  <ol class='man-decor man-head man head'>
-    <li class='tl'>gist(1)</li>
-    <li class='tc'>Gist Manual</li>
-    <li class='tr'>gist(1)</li>
-  </ol>
-
-  <h2 id="NAME">NAME</h2>
-<p class="man-name">
-  <code>gist</code> - <span class="man-whatis">gist on the command line</span>
-</p>
-
-<h2 id="SYNOPSIS">SYNOPSIS</h2>
-
-<p><code>gist</code> [<code>-p</code>] [<code>-t extension</code>] <var>FILE|-</var></p>
-
-<h2 id="DESCRIPTION">DESCRIPTION</h2>
-
-<p><code>gist</code> can be used to create gists on gist.github.com from the command
-line. There are two primary methods of creating gists.</p>
-
-<p>If standard input is supplied, it will be used as the content of the
-new gist. If <var>FILE</var> is provided, the content of that file will be used
-to create the gist. If <var>FILE</var> is '-' then gist will wait for content
-from standard input.</p>
-
-<p>Once your gist is successfully created, the URL will be copied to your
-clipboard. If you are on OS X, <code>gist</code> will open the gist in your
-browser, too.</p>
-
-<h2 id="OPTIONS">OPTIONS</h2>
-
-<p><code>gist</code>'s default mode of operation is to read content from standard
-input and create a public, text gist without description from it, tied
-to your GitHub account if you user and passwordare provided (see
-<code>CONFIGURATION</code>).</p>
-
-<p>These options can be used to change this behavior:</p>
-
-<dl>
-<dt><code>-p</code>, <code>--private</code></dt><dd><p>Create a private gist instead of a public gist.</p></dd>
-<dt><code>-t</code>, <code>--type</code></dt><dd><p>Set the file extension explicitly. Passing a type of <code>rb</code> ensures
-the gist is created as a Ruby file.</p></dd>
-<dt><code>-d</code>, <code>--description</code></dt><dd><p>Set a description.</p></dd>
-<dt><code>-o</code>, <code>--[no-]open</code></dt><dd><p>Open the gist in your browser after creation. Or don't. Defaults
-to --open</p></dd>
-</dl>
-
-
-<p>You may additionally ask for help:</p>
-
-<dl>
-<dt><code>-h</code>, <code>--help</code></dt><dd><p>Print help.</p></dd>
-<dt><code>-m</code>, <code>--man</code></dt><dd><p>Display this man page.</p></dd>
-</dl>
-
-
-<h2 id="AUTHENTICATION">AUTHENTICATION</h2>
-
-<p>There are two ways to set GitHub user and password info:</p>
-
-<ul>
-<li><p>Using environment vars GITHUB_USER and GITHUB_PASSWORD</p>
-
-<p>$ export GITHUB_USER=johndoe<br />
-$ export GITHUB_PASSWORD=mysecretgithubpassword<br />
-$ gist ~/example</p></li>
-<li><p>Using <span class="man-ref">git-config<span class="s">(1)</span></span></p></li>
-</ul>
-
-
-<p>Use <span class="man-ref">git-config<span class="s">(1)</span></span> to display the currently configured GitHub username:</p>
-
-<pre><code>$ git config --global github.user
-</code></pre>
-
-<p>Or, set the GitHub username with:</p>
-
-<pre><code>$ git config --global github.user &lt;username>
-</code></pre>
-
-<p>See <a href="http://github.com/guides/local-github-config" data-bare-link="true">http://github.com/guides/local-github-config</a> for more
-information.</p>
-
-<h2 id="CONFIGURATION">CONFIGURATION</h2>
-
-<p>You can set a few options in your git config (using <span class="man-ref">git-config<span class="s">(1)</span></span>) to
-control the default behavior of <a class="man-ref" href="gist.1.ron.html">gist<span class="s">(1)</span></a>.</p>
-
-<ul>
-<li><p>gist.private - boolean (yes or no) - Determines whether to make a gist
-private by default</p></li>
-<li><p>gist.extension - string - Default extension for gists you create.</p></li>
-<li><p>gist.browse - boolean (yes or no) - Whether to open the gist in your
-browser after creation. Default: yes</p></li>
-</ul>
-
-
-<h2 id="ENVIRONMENT">ENVIRONMENT</h2>
-
-<p>The following environment variables affect the execution of <code>gist</code>:</p>
-
-<ul>
-<li>HTTP_PROXY - Proxy to use when Gisting. Should be "http://host:port/"</li>
-</ul>
-
-
-<h2 id="EXAMPLES">EXAMPLES</h2>
-
-<pre><code>$ gist &lt; file.txt
-$ echo secret | gist --private
-$ echo "puts :hi" | gist -t rb
-$ gist script.py
-$ gist -
-the quick brown fox jumps over the lazy dog
-^D
-</code></pre>
-
-<h2 id="BUGS">BUGS</h2>
-
-<p><a href="http://github.com/defunkt/gist/issues" data-bare-link="true">http://github.com/defunkt/gist/issues</a></p>
-
-<h2 id="AUTHOR">AUTHOR</h2>
-
-<p>Chris Wanstrath :: chris@ozmm.org</p>
-
-<h2 id="SEE-ALSO">SEE ALSO</h2>
-
-<p><span class="man-ref">hub<span class="s">(1)</span></span>, <span class="man-ref">git<span class="s">(1)</span></span>, <span class="man-ref">git-clone<span class="s">(1)</span></span>,
-<a href="http://github.com" data-bare-link="true">http://github.com</a>,
-<a href="http://github.com/defunkt/gist" data-bare-link="true">http://github.com/defunkt/gist</a></p>
-
-
-  <ol class='man-decor man-foot man foot'>
-    <li class='tl'>GITHUB</li>
-    <li class='tc'>November 2012</li>
-    <li class='tr'>gist(1)</li>
-  </ol>
-
-  </div>
-</body>
-</html>