libsass-python: Sass_/SCSS for Python
=====================================
.. image:: https://badge.fury.io/py/libsass.svg
:alt: PyPI
:target: https://pypi.org/pypi/libsass/
.. image:: https://github.com/sass/libsass-python/actions/workflows/main.yml/badge.svg
:target: https://github.com/sass/libsass-python/actions/workflows/main.yml
:alt: Build Status
.. image:: https://results.pre-commit.ci/badge/github/sass/libsass-python/main.svg
:target: https://results.pre-commit.ci/latest/github/sass/libsass-python/main
:alt: pre-commit.ci status
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 to Python
distribution/deployment. That means you can add just ``libsass`` into
your ``setup.py``'s ``install_requires`` list or ``requirements.txt`` file.
No need for Ruby nor Node.js.
It currently supports CPython 3.7+, and PyPy 3!
.. _Sass: https://sass-lang.com/
.. _LibSass: https://github.com/sass/libsass
Features
--------
- You don't need any Ruby/Node.js stack at all, for development or deployment
either.
- Fast. (LibSass_ is written in C++.)
- Simple API. See the below example code for details.
- Custom functions.
- ``@import`` callbacks.
- Support both tabbed (Sass) and braces (SCSS) syntax.
- WSGI middleware for ease of development.
It automatically compiles Sass/SCSS files for each request.
- ``setuptools``/``distutils`` integration.
You can build all Sass/SCSS files using
``setup.py build_sass`` command.
- Works also on PyPy.
- Provides prebuilt wheel_ binaries for Linux, Windows, and Mac.
.. _wheel: https://www.python.org/dev/peps/pep-0427/
Install
-------
It's available on PyPI_, so you can install it using ``pip`` (or
``easy_install``):
.. code-block:: console
$ pip install libsass
.. note::
libsass requires some features introduced by the recent C++ standard.
You need a C++ compiler that support those features.
See also libsass project's README_ file.
.. _PyPI: https://pypi.org/pypi/libsass/
.. _README: https://github.com/sass/libsass#readme
.. _example:
Example
-------
.. code-block:: pycon
>>> import sass
>>> print sass.compile(string='a { b { color: blue; } }')
a b {
color: blue; }
Docs
----
There's the user guide manual and the full API reference for ``libsass``:
https://sass.github.io/libsass-python/
You can build the docs by yourself:
.. code-block:: console
$ cd docs/
$ make html
The built docs will go to ``docs/_build/html/`` directory.
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 are all distributed under `MIT license`_.
.. _MIT license: https://mit-license.org/
Raw data
{
"_id": null,
"home_page": "https://sass.github.io/libsass-python/",
"name": "libsass-wheel",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Hong Minhee",
"author_email": "minhee@dahlia.kr",
"download_url": null,
"platform": null,
"description": "libsass-python: Sass_/SCSS for Python\n=====================================\n\n.. image:: https://badge.fury.io/py/libsass.svg\n :alt: PyPI\n :target: https://pypi.org/pypi/libsass/\n\n.. image:: https://github.com/sass/libsass-python/actions/workflows/main.yml/badge.svg\n :target: https://github.com/sass/libsass-python/actions/workflows/main.yml\n :alt: Build Status\n\n.. image:: https://results.pre-commit.ci/badge/github/sass/libsass-python/main.svg\n :target: https://results.pre-commit.ci/latest/github/sass/libsass-python/main\n :alt: pre-commit.ci status\n\nThis package provides a simple Python extension module ``sass`` which is\nbinding LibSass_ (written in C/C++ by Hampton Catlin and Aaron Leung).\nIt's very straightforward and there isn't any headache related to Python\ndistribution/deployment. That means you can add just ``libsass`` into\nyour ``setup.py``'s ``install_requires`` list or ``requirements.txt`` file.\nNo need for Ruby nor Node.js.\n\nIt currently supports CPython 3.7+, and PyPy 3!\n\n.. _Sass: https://sass-lang.com/\n.. _LibSass: https://github.com/sass/libsass\n\n\nFeatures\n--------\n\n- You don't need any Ruby/Node.js stack at all, for development or deployment\n either.\n- Fast. (LibSass_ is written in C++.)\n- Simple API. See the below example code for details.\n- Custom functions.\n- ``@import`` callbacks.\n- Support both tabbed (Sass) and braces (SCSS) syntax.\n- WSGI middleware for ease of development.\n It automatically compiles Sass/SCSS files for each request.\n- ``setuptools``/``distutils`` integration.\n You can build all Sass/SCSS files using\n ``setup.py build_sass`` command.\n- Works also on PyPy.\n- Provides prebuilt wheel_ binaries for Linux, Windows, and Mac.\n\n.. _wheel: https://www.python.org/dev/peps/pep-0427/\n\n\nInstall\n-------\n\nIt's available on PyPI_, so you can install it using ``pip`` (or\n``easy_install``):\n\n.. code-block:: console\n\n $ pip install libsass\n\n.. note::\n\n libsass requires some features introduced by the recent C++ standard.\n You need a C++ compiler that support those features.\n See also libsass project's README_ file.\n\n.. _PyPI: https://pypi.org/pypi/libsass/\n.. _README: https://github.com/sass/libsass#readme\n\n\n.. _example:\n\nExample\n-------\n\n.. code-block:: pycon\n\n >>> import sass\n >>> print sass.compile(string='a { b { color: blue; } }')\n a b {\n color: blue; }\n\n\nDocs\n----\n\nThere's the user guide manual and the full API reference for ``libsass``:\n\nhttps://sass.github.io/libsass-python/\n\nYou can build the docs by yourself:\n\n.. code-block:: console\n\n $ cd docs/\n $ make html\n\nThe built docs will go to ``docs/_build/html/`` directory.\n\n\nCredit\n------\n\nHong Minhee wrote this Python binding of LibSass_.\n\nHampton Catlin and Aaron Leung wrote LibSass_, which is portable C/C++\nimplementation of Sass_.\n\nHampton Catlin originally designed Sass_ language and wrote the first\nreference implementation of it in Ruby.\n\nThe above three are all distributed under `MIT license`_.\n\n.. _MIT license: https://mit-license.org/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Sass for Python: A straightforward binding of libsass for Python.",
"version": "0.23.0",
"project_urls": {
"Homepage": "https://sass.github.io/libsass-python/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2884c982e094052df266ca5cd0cebff57e1699916d3a4e5fabef59d2fbc32107",
"md5": "77d924274026b4f4c3ce5151118ed67a",
"sha256": "dd84c734826dbac7af4d8cb7a392b7d18d4b14866b7dd8b107e5729dbf8d9851"
},
"downloads": -1,
"filename": "libsass_wheel-0.23.0-cp312-abi3-musllinux_1_2_aarch64.whl",
"has_sig": false,
"md5_digest": "77d924274026b4f4c3ce5151118ed67a",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": ">=3.8",
"size": 13591005,
"upload_time": "2024-11-26T23:54:18",
"upload_time_iso_8601": "2024-11-26T23:54:18.734610Z",
"url": "https://files.pythonhosted.org/packages/28/84/c982e094052df266ca5cd0cebff57e1699916d3a4e5fabef59d2fbc32107/libsass_wheel-0.23.0-cp312-abi3-musllinux_1_2_aarch64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-26 23:54:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "libsass-wheel"
}
JSON