Add sassc executable script

Author: dahlia

docs/changes.rst

@@ -6,6 +6,7 @@ Version 0.2.4
 
 To be released.
 
+- Added :mod:`sassc` CLI executable script.
 - Added :const:`sass.OUTPUT_STYLES` constant map.
 
 

docs/index.rst

@@ -51,6 +51,7 @@ References
 .. toctree::
    :maxdepth: 2
 
+   sassc
    sass
    sassutils
 

docs/sassc.rst

@@ -0,0 +1,5 @@
+
+.. program:: sassc
+
+.. automodule:: sassc
+   :members:

sassc.py

@@ -0,0 +1,87 @@
+""":mod:`sassc` --- SassC compliant command line interface
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This provides SassC_ compliant CLI executable named :program:`sassc`:
+
+.. sourcecode:: console
+
+   $ sassc
+   Usage: sassc [options] SCSS_FILE...
+
+There are options as well:
+
+.. option:: -s <style>, --output-style <style>
+
+   Coding style of the compiled result.  The same as :func:`sass.compile()`
+   function's ``output_style`` keyword argument.  Default is ``nested``.
+
+.. option:: -I <dir>, --include-path <dir>
+
+   Optional directory path to find ``@import``\ ed (S)CSS files.
+   Can be multiply used.
+
+.. option:: -i <dir>, --image-path <dir>
+
+   Path to find images.  Default is the current directory (:file:`./`).
+
+.. option:: -v, --version
+
+   Prints the program version.
+
+.. option:: -h, --help
+
+   Prints the help message.
+
+.. _SassC: https://github.com/hcatlin/sassc
+
+"""
+import optparse
+import sys
+
+from sass import __version__ as VERSION, OUTPUT_STYLES, CompileError, compile
+
+
+def main(argv=sys.argv, stdout=sys.stdout, stderr=sys.stderr):
+    parser = optparse.OptionParser(usage='%prog [options] SCSS_FILE...',
+                                   version='%prog ' + VERSION)
+    output_styles = list(OUTPUT_STYLES)
+    output_styles = ', '.join(output_styles[:-1]) + ', or ' + output_styles[-1]
+    parser.add_option('-s', '--output-style', metavar='STYLE', type='choice',
+                      choices=list(OUTPUT_STYLES), default='nested',
+                      help='Coding style of the compiled result.  Choose one '
+                           'of ' + output_styles + '. [default: %default]')
+    parser.add_option('-I', '--include-path', metavar='DIR',
+                      dest='include_paths', action='append',
+                      help='Path to find "@import"ed (S)CSS source files.  '
+                           'Can be multiply used.')
+    parser.add_option('-i', '--image-path', metavar='DIR', default='./',
+                      help='Path to find images. [default: %default]')
+    options, args = parser.parse_args(argv[1:])
+    if not args:
+        parser.print_usage(stderr)
+        print >> stderr, parser.get_prog_name() + ': error:', \
+                         'too few arguments'
+        return 2
+    elif len(args) > 1:
+        parser.print_usage(stderr)
+        print >> stderr, parser.get_prog_name() + ': error:', \
+                         'too many arguments'
+        return 2
+    for filename in args:
+        try:
+            css = compile(
+                filename=filename,
+                output_style=options.output_style,
+                include_paths=options.include_paths,
+                image_path=options.image_path
+            )
+        except CompileError as e:
+            print >> stderr, parser.get_prog_name() + ': error:', e
+            return 1
+        else:
+            print css
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

setup.py

@@ -127,8 +127,9 @@ def run(self):
     version=version,
     ext_modules=[sass_extension],
     packages=['sassutils'],
-    py_modules=['sasstests'],
+    py_modules=['sassc', 'sasstests'],
     package_data={'': ['README.rst', 'test/*.sass']},
+    scripts=['sassc.py'],
     license='MIT License',
     author='Hong Minhee',
     author_email='minhee' '@' 'dahlia.kr',
@@ -139,6 +140,9 @@ def run(self):
         ],
         'distutils.setup_keywords': [
             'sass_manifests = sassutils.distutils:validate_manifests'
+        ],
+        'console_scripts': [
+            ['sassc = sassc:main']
         ]
     },
     tests_require=['Attest', 'Werkzeug'],