Packaging

Author: dahlia

README.rst

@@ -0,0 +1,66 @@
+libsass: SASS_ for Python
+=========================
+
+This package provides a simple Python extension module `sass` which is
+binding Libsass_ (written in C/C++ by Hampton Catlin and Aaron Leung).
+It's very straightforward and there isn't any headache related Python
+distribution/deployment.  That means you can add just ``libsass`` into
+your ``setup.py``'s ``install_requires`` list or ``requirements.txt`` file.
+
+It currently supports CPython 2.5, 2.6, 2.7, and PyPy 1.9!
+
+.. _SASS: http://sass-lang.com/
+.. _Libsass: https://github.com/hcatlin/libsass
+
+
+Install
+-------
+
+Use ``easy_install`` or ``pip``::
+
+    $ easy_install libsass
+
+
+``sass.compile()``
+------------------
+
+It takes a source ``string`` or a ``filename`` and returns the compiled
+CSS string.
+
+``string`` (required)
+   The string of SASS source code to compile.  It's exclusive to ``filename``
+   parameter.
+
+``filename`` (required)
+   The filename of SASS source code to compile.  It's exclusive to ``string``
+   parameter.
+
+``output_style`` (optional)
+   The coding style of the compiled result.  Choose one in:
+
+   - ``'nested'`` (default)
+   - ``'expanded'``
+   - ``'compact'``
+   - ``'compressed'``
+
+``includes_paths`` (optional)
+   The list of paths to find ``@import``\ ed SASS/CSS source files.
+
+``image_path`` (optional)
+   The path to find images.
+
+
+Credit
+------
+
+Hong Minhee wrote this Python binding of Libsass_.
+
+Hampton Catlin and Aaron Leung wrote Libsass_, which is portable C/C++
+implementation of SASS_.
+
+Hampton Catlin originally designed SASS_ language and wrote the first
+reference implementation of it in Ruby.
+
+The above three softwares are all distributed under `MIT license`_.
+
+.. _MIT licence: http://mit-license.org/

setup.py

@@ -1,3 +1,7 @@
+from __future__ import with_statement
+
+import os.path
+
 try:
     from setuptools import Extension, setup
 except ImportError:
@@ -29,8 +33,16 @@
     extra_link_args=['-fPIC'],
 )
 
+
+def readme():
+    with open(os.path.join(os.path.dirname(__file__), 'README.rst')) as f:
+        return f.read()
+
 setup(
     name='libsass',
+    description='SASS for Python: '
+                'A straightforward binding of libsass for Python.',
+    long_description=readme(),
     version=version,
     ext_modules=[sass_extension],
     py_modules=['sasstests'],
@@ -41,5 +53,22 @@
     url='https://github.com/dahlia/libsass-python',
     tests_require=['Attest'],
     test_loader='attest:auto_reporter.test_loader',
-    test_suite='sasstests.suite'
+    test_suite='sasstests.suite',
+    classifiers=[
+        'Development Status :: 4 - Beta',
+        'Environment :: Web Environment',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Programming Language :: C',
+        'Programming Language :: C++',
+        'Programming Language :: Python :: 2.5',
+        'Programming Language :: Python :: 2.6',
+        'Programming Language :: Python :: 2.7',
+        'Programming Language :: Python :: 2 :: Only',
+        'Topic :: Internet :: WWW/HTTP',
+        'Topic :: Internet :: WWW/HTTP :: Dynamic Content',
+        'Topic :: Software Development :: Code Generators',
+        'Topic :: Software Development :: Compilers'
+    ]
 )

test/b.sass

@@ -0,0 +1,5 @@
+b {
+  i {
+    font-size: 20px;
+  }
+}