github-markup 0.7.4 → 0.7.5

data/Gemfile

@@ -2,7 +2,9 @@ source "http://rubygems.org"
 gem "redcarpet"
 gem "RedCloth"
 gem "rdoc", "~>3.6"
-gem "org-ruby"
+gem "org-ruby", ">= 0.7.0"
 gem "creole", "~>0.3.6"
 gem "wikicloth", "=0.6.0"
+gem "literati", "= 0.0.3"
+gem "asciidoctor", ">= 0.0.5"
 gem "rake"

data/README.md

@@ -10,7 +10,7 @@ Markups
 The following markups are supported.  The dependencies listed are required if
 you wish to run the library.
 
-* [.markdown](http://daringfireball.net/projects/markdown/) -- `gem install redcarpet` (https://github.com/tanoku/redcarpet)
+* [.markdown, .mdown, .md](http://daringfireball.net/projects/markdown/) -- `gem install redcarpet` (https://github.com/vmg/redcarpet)
 * [.textile](http://www.textism.com/tools/textile/) -- `gem install RedCloth`
 * [.rdoc](http://rdoc.sourceforge.net/) -- `gem install rdoc -v 3.6.1`
 * [.org](http://orgmode.org/) -- `gem install org-ruby`
@@ -57,7 +57,7 @@ If nothing complains, congratulations!
 ### Classes
 
 If your markup can be translated using a Ruby library, that's
-great. Check out Check `lib/github/markups.rb` for some
+great. Check out `lib/github/markups.rb` for some
 examples. Let's look at Markdown:
 
     markup(:markdown, /md|mkdn?|markdown/) do |content|
@@ -111,10 +111,10 @@ Contributing
 2. Create a branch (`git checkout -b my_markup`)
 3. Commit your changes (`git commit -am "Added Snarkdown"`)
 4. Push to the branch (`git push origin my_markup`)
-5. Create an [Issue][1] with a link to your branch
+5. Open a [Pull Request][1]
 6. Enjoy a refreshing Diet Coke and wait
 
 
 [r2h]: http://github.com/github/markup/tree/master/lib/github/commands/rest2html
 [r2hc]: http://github.com/github/markup/tree/master/lib/github/markups.rb#L13
-[1]: http://github.com/github/markup/issues
+[1]: http://github.com/github/markup/pulls

data/github-markup.gemspec

@@ -13,8 +13,8 @@ Gem::Specification.new do |s|
   ## If your rubyforge_project name is different, then edit it and comment out
   ## the sub! line in the Rakefile
   s.name              = 'github-markup'
-  s.version           = '0.7.4'
-  s.date              = '2012-07-19'
+  s.version           = '0.7.5'
+  s.date              = '2012-12-17'
   s.executables       = ['github-markup']
 
   ## Make sure your summary is short. The description may be as long
@@ -62,8 +62,6 @@ desc
     bin/github-markup
     github-markup.gemspec
     lib/github-markup.rb
-    lib/github/commands/asciidoc2html
-    lib/github/commands/asciidocapi.py
     lib/github/commands/rest2html
     lib/github/markup.rb
     lib/github/markup/rdoc.rb
@@ -73,6 +71,8 @@ desc
     test/markups/README.asciidoc.html
     test/markups/README.creole
     test/markups/README.creole.html
+    test/markups/README.lhs
+    test/markups/README.lhs.html
     test/markups/README.markdown
     test/markups/README.markdown.html
     test/markups/README.mediawiki

data/lib/github-markup.rb

@@ -1,6 +1,6 @@
 module GitHub
   module Markup
-    VERSION = '0.7.4'
+    VERSION = '0.7.5'
     Version = VERSION
   end
 end

data/lib/github/commands/rest2html

@@ -61,8 +61,15 @@ def main():
     parts = publish_parts(text, writer=writer, settings_overrides=SETTINGS)
     if 'html_body' in parts:
         html = parts['html_body']
-        return html.encode('utf-8')
+
+        # publish_parts() in python 2.x return dict values as Unicode type
+        # in py3k Unicode is unavailable and values are of str type
+        if isinstance(html, str):
+            return html
+        else:
+            return html.encode('utf-8')
     return ''
 
 if __name__ == '__main__':
-    print main()
+    sys.stdout.write("%s%s" % (main(), "\n"))
+    sys.stdout.flush()

data/lib/github/markups.rb

@@ -1,4 +1,4 @@
-MD_FILES = /md|mkdn?|mdown|markdown/
+MD_FILES = /md|mkdn?|mdwn|mdown|markdown/
 
 if markup('github/markdown', MD_FILES) do |content|
     GitHub::Markdown.render(content)
@@ -40,9 +40,15 @@ markup(:wikicloth, /mediawiki|wiki/) do |content|
   WikiCloth::WikiCloth.new(:data => content).to_html(:noedit => true)
 end
 
-command(:rest2html, /re?st(\.txt)?/)
+markup(:literati, /lhs/) do |content|
+  Literati.render(content)
+end
 
-command('asciidoc -s --backend=xhtml11 -o - -', /asciidoc/)
+markup(:asciidoctor, /asc|adoc|asciidoc/) do |content|
+  Asciidoctor::Document.new(content).render
+end
+
+command(:rest2html, /re?st(\.txt)?/)
 
 # pod2html is nice enough to generate a full-on HTML document for us,
 # so we return the favor by ripping out the good parts.

data/test/markups/README.lhs

@@ -0,0 +1,10 @@
+# Markdown
+
+Except with more magic added.
+
+> isPrefixOf              :: (Eq a) => [a] -> [a] -> Bool
+> isPrefixOf [] _         =  True
+> isPrefixOf _  []        =  False
+> isPrefixOf (x:xs) (y:ys)=  x == y && isPrefixOf xs ys
+
+And Haskell.  A lot of Haskell.

data/test/markups/README.lhs.html

@@ -0,0 +1,11 @@
+<h1>Markdown</h1>
+
+<p>Except with more magic added.</p>
+
+<pre><code class="haskell">isPrefixOf              :: (Eq a) =&gt; [a] -&gt; [a] -&gt; Bool
+isPrefixOf [] _         =  True
+isPrefixOf _  []        =  False
+isPrefixOf (x:xs) (y:ys)=  x == y &amp;&amp; isPrefixOf xs ys
+</code></pre>
+
+<p>And Haskell.  A lot of Haskell.</p>

data/test/markups/README.org.html

@@ -9,75 +9,108 @@
 <h1><span class="heading-number heading-number-1">2 </span>History</h1>
 <h2><span class="heading-number heading-number-2">2.1 </span>2009-12-30: Version 0.5.1</h2>
 <ul>
-  <li>Minor enhancement: Recognize lines starting with &#8220;:&#8221; as examples.</li>
-  <li>Minor enhancement: Recognize #+BEGIN_SRC as source blocks</li>
-  <li>Minor enhancement: Add &#8220;src&#8221; and &#8220;example&#8221; classes to &lt;pre&gt; blocks.</li>
+  <li>Minor enhancement: Recognize lines starting with &#8220;:&#8221; as examples.
+  </li>
+  <li>Minor enhancement: Recognize #+BEGIN_SRC as source blocks
+  </li>
+  <li>Minor enhancement: Add &#8220;src&#8221; and &#8220;example&#8221; classes to &lt;pre&gt; blocks.
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.2 </span>2009-12-30: Version 0.5.0</h2>
 <ul>
-  <li>Parse (but not necessarily <b>use</b>) in-buffer settings. The following in-buffer settings <b>are</b> used:</li>
+  <li>Parse (but not necessarily <b>use</b>) in-buffer settings. The following in-buffer settings <b>are</b> used:
   <ul>
-    <li>Understand the #+TITLE: directive.</li>
-    <li>Exporting todo keywords (option todo:t)</li>
-    <li>Numbering headlines (option num:t)</li>
-    <li>Skipping text before the first headline (option skip:t)</li>
-    <li>Skipping tables (option |:nil)</li>
-    <li>Custom todo keywords</li>
-    <li>EXPORT_SELECT_TAGS and EXPORT_EXLUDE_TAGS for controlling parts of the tree to export</li>
+    <li>Understand the #+TITLE: directive.
+    </li>
+    <li>Exporting todo keywords (option todo:t)
+    </li>
+    <li>Numbering headlines (option num:t)
+    </li>
+    <li>Skipping text before the first headline (option skip:t)
+    </li>
+    <li>Skipping tables (option |:nil)
+    </li>
+    <li>Custom todo keywords
+    </li>
+    <li>EXPORT_SELECT_TAGS and EXPORT_EXLUDE_TAGS for controlling parts of the tree to export
+    </li>
   </ul>
-  <li>Rewrite &#8220;file:(blah).org&#8221; links to &#8220;http:(blah).html&#8221; links. This makes the inter-links to other org-mode files work.</li>
-  <li>Uses &lt;th&gt; tags inside table rows that precede table separators.</li>
-  <li>Bugfixes:</li>
+  </li>
+  <li>Rewrite &#8220;file:(blah).org&#8221; links to &#8220;http:(blah).html&#8221; links. This makes the inter-links to other org-mode files work.
+  </li>
+  <li>Uses &lt;th&gt; tags inside table rows that precede table separators.
+  </li>
+  <li>Bugfixes:
   <ul>
-    <li>Headings now have HTML escaped.</li>
+    <li>Headings now have HTML escaped.
+    </li>
   </ul>
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.3 </span>2009-12-29: Version 0.4.2</h2>
 <ul>
-  <li>Got rid of the extraneous newline at the start of code blocks.</li>
-  <li>Everything now shows up in code blocks, even org-mode metadata.</li>
-  <li>Fixed bugs:</li>
+  <li>Got rid of the extraneous newline at the start of code blocks.
+  </li>
+  <li>Everything now shows up in code blocks, even org-mode metadata.
+  </li>
+  <li>Fixed bugs:
   <ul>
-    <li>Regressed smart double quotes with HTML escaping. Added a test case and fixed the regression.</li>
+    <li>Regressed smart double quotes with HTML escaping. Added a test case and fixed the regression.
+    </li>
   </ul>
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.4 </span>2009-12-29: Version 0.4.1</h2>
 <ul>
-  <li>HTML is now escaped by default</li>
-  <li>org-mode comments will show up in a code block.</li>
+  <li>HTML is now escaped by default
+  </li>
+  <li>org-mode comments will show up in a code block.
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.5 </span>2009-12-29: Version 0.4</h2>
 <ul>
-  <li>The first thing output in HTML gets the class &#8220;title&#8221;</li>
-  <li>HTML output is now indented</li>
-  <li>Proper support for multi-paragraph list items.</li>
+  <li>The first thing output in HTML gets the class &#8220;title&#8221;
+  </li>
+  <li>HTML output is now indented
+  </li>
+  <li>Proper support for multi-paragraph list items.
   <p>See? This paragraph is part of the last bullet.</p>
-  <li>Fixed bugs:</li>
+  </li>
+  <li>Fixed bugs:
   <ul>
-    <li>&#8220;rake spec&#8221; wouldn&#8217;t work on Linux. Needed &#8220;require &#8216;rubygems&#8217;&#8221;.</li>
+    <li>&#8220;rake spec&#8221; wouldn&#8217;t work on Linux. Needed &#8220;require &#8216;rubygems&#8217;&#8221;.
+    </li>
   </ul>
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.6 </span>2009-12-27: Version 0.3</h2>
 <ul>
-  <li>Uses rubypants to get better typography (smart quotes, elipses, etc&#8230;).</li>
-  <li>Fixed bugs:</li>
+  <li>Uses rubypants to get better typography (smart quotes, elipses, etc&#8230;).
+  </li>
+  <li>Fixed bugs:
   <ul>
-    <li>Tables and lists did not get properly closed at the end of file</li>
-    <li>You couldn&#8217;t do inline formatting inside table cells</li>
-    <li>Characters in PRE blocks were not HTML escaped.</li>
+    <li>Tables and lists did not get properly closed at the end of file
+    </li>
+    <li>You couldn&#8217;t do inline formatting inside table cells
+    </li>
+    <li>Characters in PRE blocks were not HTML escaped.
+    </li>
   </ul>
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.7 </span>2009-12-26: Version 0.2</h2>
 <ul>
-  <li>Added <code>to_html</code> output on the parser.</li>
-  <li>Added support for the full range of inline markup: <b>bold</b>, <i>italic</i>, <code>code</code>, <code>verbatim</code>, <span style="text-decoration:underline;">underline</span>, <del>strikethrough</del>.</li>
-  <li>Lots of refactoring to make the code more maintainable.</li>
+  <li>Added <code>to_html</code> output on the parser.
+  </li>
+  <li>Added support for the full range of inline markup: <b>bold</b>, <i>italic</i>, <code>code</code>, <code>verbatim</code>, <span style="text-decoration:underline;">underline</span>, <del>strikethrough</del>.
+  </li>
+  <li>Lots of refactoring to make the code more maintainable.
+  </li>
 </ul>
 <h2><span class="heading-number heading-number-2">2.8 </span>2009-12-23: Version 0.1</h2>
 <ul>
-  <li>Added support for block code, like this:</li>
-</ul>
-<pre class="example">
+  <li>Added support for block code, like this:
+  <pre class="example">
      def flush!
      @logger.debug "FLUSH ==========&gt; #{@output_type}"
      if (@output_type == :blank) then
@@ -92,8 +125,12 @@
      end
      @buffer = ""
    end
-</pre>
-<ul>
-  <li>Major code cleanup: Created the <code>OutputBuffer</code> class that greatly simplified a lot of the messiness of <code>textile</code> conversion.</li>
-  <li>Added support for line breaks within list items.</li>
+  </pre>
+  </li>
+  <ul>
+    <li>Major code cleanup: Created the <code>OutputBuffer</code> class that greatly simplified a lot of the messiness of <code>textile</code> conversion.
+    </li>
+    <li>Added support for line breaks within list items.
+    </li>
+  </ul>
 </ul>

metadata

@@ -1,34 +1,26 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: github-markup
-version: !ruby/object:Gem::Version 
-  hash: 11
+version: !ruby/object:Gem::Version
+  version: 0.7.5
   prerelease: 
-  segments: 
-  - 0
-  - 7
-  - 4
-  version: 0.7.4
 platform: ruby
-authors: 
+authors:
 - Chris Wanstrath
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-07-19 00:00:00 +02:00
-default_executable: 
+date: 2012-12-17 00:00:00.000000000 Z
 dependencies: []
-
-description: "  This gem is used by GitHub to render any fancy markup such as\n  Markdown, Textile, Org-Mode, etc. Fork it and add your own!\n"
+description: ! "  This gem is used by GitHub to render any fancy markup such as\n
+  \ Markdown, Textile, Org-Mode, etc. Fork it and add your own!\n"
 email: chris@ozmm.org
-executables: 
+executables:
 - github-markup
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - README.md
 - LICENSE
-files: 
+files:
 - Gemfile
 - HISTORY.md
 - LICENSE
@@ -37,8 +29,6 @@ files:
 - bin/github-markup
 - github-markup.gemspec
 - lib/github-markup.rb
-- lib/github/commands/asciidoc2html
-- lib/github/commands/asciidocapi.py
 - lib/github/commands/rest2html
 - lib/github/markup.rb
 - lib/github/markup/rdoc.rb
@@ -48,6 +38,8 @@ files:
 - test/markups/README.asciidoc.html
 - test/markups/README.creole
 - test/markups/README.creole.html
+- test/markups/README.lhs
+- test/markups/README.lhs.html
 - test/markups/README.markdown
 - test/markups/README.markdown.html
 - test/markups/README.mediawiki
@@ -68,39 +60,29 @@ files:
 - test/markups/README.textile.html
 - test/markups/README.txt
 - test/markups/README.txt.html
-has_rdoc: true
 homepage: https://github.com/github/markup
 licenses: []
-
 post_install_message: 
-rdoc_options: 
+rdoc_options:
 - --charset=UTF-8
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+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 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 2
 summary: The code GitHub uses to render README.markup
 test_files: []
-

data/lib/github/commands/asciidoc2html

@@ -1,119 +0,0 @@
-#!/usr/bin/env python
-
-"""A small wrapper file for parsing AsciiDoc files at Github."""
-
-__author__ = "Devin Weaver" 
-__copyright__ = "Copyright (C) 2009 Devin Weaver" 
-__license__ = "Public Domain" 
-__version__ = "0.1" 
-
-"""
-github_asciidoc.py
-------------------
-
-This is a wrapper file for parsing AsciiDoc files at github. It wraps the
-current AsciiDoc API.
-
-AsciiDoc specifications suggest using the file extension of `.txt` however this
-causes conflict because there is no way to determine if a text file is an
-AsciiDoc or not without pre-processing the file. This gives us two simple
-options:
-
-1. **Parse all text files**. We could have all files ending in `.txt` or
-   ``README.txt`` be parsed through AsciiDoc. It will print pretty text fine
-   even if it isn't formatted as such. However this could be *not what the user
-   expects*.
-2. **Pick a unique extension**. We could pick a unique extension (i.e.
-   `.asciidoc`) to prevent clashing. Although not directly suggested by the
-   author of AsciiDoc there is no standard or practice to the contrary.
-
-Option two is recommended by myself.
-
-Requirements
-~~~~~~~~~~~~
-
-The AsciiDoc API comes in two parts. The first is the system installation of
-AsciiDoc which has a simple install_. The second part is the API script. You
-can either copy this to the current directory or the application's lib folder.
-There is more information on the `API page`_
-
-The `re` package is imported here for the purpose to accomplish E-Mail address
-cloaking. AsciiDoc does not offer it's own cloaking algorithm like docutils
-does. So I made a simple one here to do the same. **If the expense of regex's
-is too high it can be easily commented out.**
-
-.. tip::
-    AsciiDoc by default runs in *safe mode* which means it will not include
-    external files that are **not** in the same directory as the `infile`.
-    However since we use a StringIO through the API it should be based on the
-    current working directory.
-
-.. _install: http://www.methods.co.nz/asciidoc/userguide.html
-.. _API page: http://www.methods.co.nz/asciidoc/asciidocapi.html
-"""
-
-try:
-    import locale
-    locale.setlocale(locale.LC_ALL, '')
-except:
-    pass
-
-import sys
-import cStringIO # faster then StringIO
-from asciidocapi import AsciiDocAPI
-from asciidocapi import AsciiDocError
-import re # only needed to simulate cloak_email_addresses
-
-def main():
-    """
-    Parses the given AsciiDoc file or the redirected string input and returns
-    the HTML body.
-
-    Usage: asciidoc2html < README.rst
-           asciidoc2html README.rst
-    """
-    try:
-        text = open(sys.argv[1], 'r').read()
-    except IOError: # given filename could not be found
-        return ''
-    except IndexError: # no filename given
-        text = sys.stdin.read()
-
-    infile = cStringIO.StringIO(text)
-    outfile = cStringIO.StringIO()
-    asciidoc = AsciiDocAPI()
-    asciidoc.options('-s')
-
-    try:
-        asciidoc.execute(infile, outfile, 'xhtml11')
-    except AsciiDocError, strerror:
-        str = "%s" % (strerror)
-        str = str.replace("&", "&amp;") # Must be done first
-        str = str.replace("<", "%lt;")
-        str = str.replace(">", "%gt;")
-        outfile.write ("<blockquote><strong>AsciiDoc ERROR: %s</strong></blockquote>" % (str))
-
-    """
-    Cloak email addresses
-
-    AsciiDoc API does not have a `cloak_email_addresses` option. We can do the
-    same with a set of regex but that can be expensive. Keep section commented
-    to disable. So ``abc@mail.example.com`` becomes:
-
-    -----------
-    <a class="reference" href="mailto:abc&#37;&#52;&#48;mail&#46;example&#46;org">
-    abc<span>&#64;</span>mail<span>&#46;</span>example<span>&#46;</span>org</a>
-    -----------
-    """
-    def mangleEmail(matches):
-        email1 = "%s&#37;&#52;&#48;%s" % (matches.group(1), matches.group(2))
-        email1 = email1.replace(".", "&#46;")
-        email2 = "%s<span>&#64;</span>%s" % (matches.group(1), matches.group(2))
-        email2 = email2.replace(".", "<span>&#46;</span>")
-        return "<a class=\"reference\" href=\"mailto:%s\">%s</a>" % (email1, email2)
-
-    return re.sub(r'<a href="mailto:([^@]+)@([^@]+)">([^@]+)@([^@]+)</a>', mangleEmail, outfile.getvalue())
-    #return outfile.getvalue()
-
-if __name__ == '__main__':
-    print main()

data/lib/github/commands/asciidocapi.py

@@ -1,240 +0,0 @@
-#!/usr/bin/env python
-"""
-asciidocapi - AsciiDoc API wrapper class.
-
-The AsciiDocAPI class provides an API for executing asciidoc. Minimal example
-compiles `mydoc.txt` to `mydoc.html`:
-
-  import asciidocapi
-  asciidoc = asciidocapi.AsciiDocAPI()
-  asciidoc.execute('mydoc.txt')
-
-- Full documentation in asciidocapi.txt.
-- See the doctests below for more examples.
-
-Doctests:
-
-1. Check execution:
-
-   >>> import StringIO
-   >>> infile = StringIO.StringIO('Hello *{author}*')
-   >>> outfile = StringIO.StringIO()
-   >>> asciidoc = AsciiDocAPI()
-   >>> asciidoc.options('--no-header-footer')
-   >>> asciidoc.attributes['author'] = 'Joe Bloggs'
-   >>> asciidoc.execute(infile, outfile, backend='html4')
-   >>> print outfile.getvalue()
-   <p>Hello <strong>Joe Bloggs</strong></p>
-
-   >>> asciidoc.attributes['author'] = 'Bill Smith'
-   >>> infile = StringIO.StringIO('Hello _{author}_')
-   >>> outfile = StringIO.StringIO()
-   >>> asciidoc.execute(infile, outfile, backend='docbook')
-   >>> print outfile.getvalue()
-   <simpara>Hello <emphasis>Bill Smith</emphasis></simpara>
-
-2. Check error handling:
-
-   >>> import StringIO
-   >>> asciidoc = AsciiDocAPI()
-   >>> infile = StringIO.StringIO('---------')
-   >>> outfile = StringIO.StringIO()
-   >>> asciidoc.execute(infile, outfile)
-   Traceback (most recent call last):
-     File "<stdin>", line 1, in <module>
-     File "asciidocapi.py", line 189, in execute
-       raise AsciiDocError(self.messages[-1])
-   AsciiDocError: ERROR: <stdin>: line 1: [blockdef-listing] missing closing delimiter
-
-
-Copyright (C) 2009 Stuart Rackham. Free use of this software is granted
-under the terms of the GNU General Public License (GPL).
-
-"""
-
-import sys,os,re
-
-API_VERSION = '0.1.1'
-MIN_ASCIIDOC_VERSION = '8.4.1'  # Minimum acceptable AsciiDoc version.
-
-
-def find_in_path(fname, path=None):
-    """
-    Find file fname in paths. Return None if not found.
-    """
-    if path is None:
-        path = os.environ.get('PATH', '')
-    for dir in path.split(os.pathsep):
-        fpath = os.path.join(dir, fname)
-        if os.path.isfile(fpath):
-            return fpath
-    else:
-        return None
-
-
-class AsciiDocError(Exception):
-    pass
-
-
-class Options(object):
-    """
-    Stores asciidoc(1) command options.
-    """
-    def __init__(self, values=[]):
-        self.values = values[:]
-    def __call__(self, name, value=None):
-        """Shortcut for append method."""
-        self.append(name, value)
-    def append(self, name, value=None):
-        if type(value) in (int,float):
-            value = str(value)
-        self.values.append((name,value))
-
-
-class Version(object):
-    """
-    Parse and compare AsciiDoc version numbers. Instance attributes:
-
-    string: String version number '<major>.<minor>[.<micro>][suffix]'.
-    major:  Integer major version number.
-    minor:  Integer minor version number.
-    micro:  Integer micro version number.
-    suffix: Suffix (begins with non-numeric character) is ignored when
-            comparing.
-
-    Doctest examples:
-
-    >>> Version('8.2.5') < Version('8.3 beta 1')
-    True
-    >>> Version('8.3.0') == Version('8.3. beta 1')
-    True
-    >>> Version('8.2.0') < Version('8.20')
-    True
-    >>> Version('8.20').major
-    8
-    >>> Version('8.20').minor
-    20
-    >>> Version('8.20').micro
-    0
-    >>> Version('8.20').suffix
-    ''
-    >>> Version('8.20 beta 1').suffix
-    'beta 1'
-
-    """
-    def __init__(self, version):
-        self.string = version
-        reo = re.match(r'^(\d+)\.(\d+)(\.(\d+))?\s*(.*?)\s*$', self.string)
-        if not reo:
-            raise ValueError('invalid version number: %s' % self.string)
-        groups = reo.groups()
-        self.major = int(groups[0])
-        self.minor = int(groups[1])
-        self.micro = int(groups[3] or '0')
-        self.suffix = groups[4] or ''
-    def __cmp__(self, other):
-        result = cmp(self.major, other.major)
-        if result == 0:
-            result = cmp(self.minor, other.minor)
-            if result == 0:
-                result = cmp(self.micro, other.micro)
-        return result
-
-
-class AsciiDocAPI(object):
-    """
-    AsciiDoc API class.
-    """
-    def __init__(self, asciidoc_py=None):
-        """
-        Locate and import asciidoc.py.
-        Initialize instance attributes.
-        """
-        self.options = Options()
-        self.attributes = {}
-        self.messages = []
-        # Search for the asciidoc command file.
-        # Try ASCIIDOC_PY environment variable first.
-        cmd = os.environ.get('ASCIIDOC_PY')
-        if cmd:
-            if not os.path.isfile(cmd):
-                raise AsciiDocError('missing ASCIIDOC_PY file: %s' % cmd)
-        elif asciidoc_py:
-            # Next try path specified by caller.
-            cmd = asciidoc_py
-            if not os.path.isfile(cmd):
-                raise AsciiDocError('missing file: %s' % cmd)
-        else:
-            # Try shell search paths.
-            for fname in ['asciidoc.py','asciidoc.pyc','asciidoc']:
-                cmd = find_in_path(fname)
-                if cmd: break
-            else:
-                # Finally try current working directory.
-                for cmd in ['asciidoc.py','asciidoc.pyc','asciidoc']:
-                    if os.path.isfile(cmd): break
-                else:
-                    raise AsciiDocError('failed to locate asciidoc.py[c]')
-        cmd = os.path.realpath(cmd)
-        if os.path.splitext(cmd)[1] not in ['.py','.pyc']:
-            raise AsciiDocError('invalid Python module name: %s' % cmd)
-        sys.path.insert(0, os.path.dirname(cmd))
-        try:
-            try:
-                import asciidoc
-            except ImportError:
-                raise AsciiDocError('failed to import asciidoc')
-        finally:
-            del sys.path[0]
-        if Version(asciidoc.VERSION) < Version(MIN_ASCIIDOC_VERSION):
-            raise AsciiDocError(
-                'asciidocapi %s requires asciidoc %s or better'
-                % (API_VERSION, MIN_ASCIIDOC_VERSION))
-        self.asciidoc = asciidoc
-        self.cmd = cmd
-
-    def execute(self, infile, outfile=None, backend=None):
-        """
-        Compile infile to outfile using backend format.
-        infile can outfile can be file path strings or file like objects.
-        """
-        self.messages = []
-        opts = Options(self.options.values)
-        if outfile is not None:
-            opts('--out-file', outfile)
-        if backend is not None:
-            opts('--backend', backend)
-        for k,v in self.attributes.items():
-            if v == '' or k[-1] in '!@':
-                s = k
-            elif v is None: # A None value undefines the attribute.
-                s = k + '!'
-            else:
-                s = '%s=%s' % (k,v)
-            opts('--attribute', s)
-        args = [infile]
-        sys.path.insert(0, os.path.dirname(self.cmd))
-        try:
-            # The AsciiDoc command was designed to process source text then
-            # exit, there are globals and statics in asciidoc.py that have
-            # to be reinitialized before each run -- hence the reload.
-            reload(self.asciidoc)
-        finally:
-            del sys.path[0]
-        try:
-            try:
-                self.asciidoc.execute(self.cmd, opts.values, args)
-            finally:
-                self.messages = self.asciidoc.messages[:]
-        except SystemExit, e:
-            if e.code:
-                raise AsciiDocError(self.messages[-1])
-
-
-if __name__ == "__main__":
-    """
-    Run module doctests.
-    """
-    import doctest
-    options = doctest.NORMALIZE_WHITESPACE + doctest.ELLIPSIS
-    doctest.testmod(optionflags=options)