add a command line tool for this project.

Author: ikirudennis

setup.py

@@ -40,6 +40,7 @@ def get_version():
         ':python_version=="2.6"': ['ordereddict>=1.1'],
         'develop': ['regex', 'pytest', 'pytest-cov'],
     },
+    entry_points={'console_scripts': ['textile=textile.__main__:main']},
     setup_requires=['pytest-runner'],
     tests_require=['pytest', 'pytest-cov'],
     include_package_data=True,

tests/test_cli.py

@@ -0,0 +1,7 @@
+import subprocess
+
+def test_console_script():
+    result = subprocess.check_output(['python', '-m', 'textile', 'README.textile'])
+    with open('tests/fixtures/README.txt') as f:
+        expect = ''.join(f.readlines())
+    assert result == expect

textile/__main__.py

@@ -0,0 +1,31 @@
+import argparse
+import sys
+import textile
+
+
+def main():
+    """A CLI tool in the style of python's json.tool.  In fact, this is mostly
+    copied directly from that module.  This allows us to create a stand-alone
+    tool as well as invoking it via `python -m textile`."""
+    prog = 'textile'
+    description = ('A simple command line interface for textile module '
+                   'to convert textile input to HTML output.  This script '
+                   'accepts input as a file or stdin and can write out to '
+                   'a file or stdout.')
+    parser = argparse.ArgumentParser(prog=prog, description=description)
+    parser.add_argument('infile', nargs='?', type=argparse.FileType(),
+                        help='a textile file to be converted')
+    parser.add_argument('outfile', nargs='?', type=argparse.FileType('w'),
+                        help='write the output of infile to outfile')
+    options = parser.parse_args()
+
+    infile = options.infile or sys.stdin
+    outfile = options.outfile or sys.stdout
+    with infile:
+        output = textile.textile(''.join(infile.readlines()))
+    with outfile:
+        outfile.write(output)
+
+
+if __name__ == '__main__': #pragma: no cover
+    main()