https://github.com/pydsigner/python-lightningcss

Opinionated Python bindings for lightningcss.
https://github.com/pydsigner/python-lightningcss

css cssminifier minifier webdevelopment

Last synced: 5 months ago
JSON representation

Opinionated Python bindings for lightningcss.

• Host: GitHub
• URL: https://github.com/pydsigner/python-lightningcss
• Owner: pydsigner
• License: apache-2.0
• Created: 2023-08-11T05:26:04.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2025-12-18T02:05:10.000Z (6 months ago)
• Last Synced: 2025-12-19T08:49:21.019Z (6 months ago)
• Topics: css, cssminifier, minifier, webdevelopment
• Language: Rust
• Homepage: https://pypi.org/project/lightningcss/
• Size: 48.8 KB
• Stars: 8
• Watchers: 1
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![PyPI - Project Version](https://img.shields.io/pypi/v/lightningcss)](https://pypi.org/project/lightningcss)

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/lightningcss)](https://pypi.org/project/lightningcss)

[![GitHub - Project License](https://img.shields.io/github/license/pydsigner/python-lightningcss)](https://github.com/pydsigner/python-lightningcss)

# python-lightningcss

python-lightningcss offers PyO3 bindings to the lightningcss library. Presently

only a subset of functionality is exposed, intended for integration into a

Python-centric web application rather than a JavaScript-based workflow. If the

latter is needed, consider using the [official npm lightningcss module, parcel,

or webpack](https://lightningcss.dev/docs.html) instead.

## Installation

python-lightningcss includes wheels which can be installed for most platforms

using pip:

    $ pip install lightningcss

Alternatively, python-lightningcss may be installed directly from source:

    $ pip install git+https://github.com/pydsigner/python-lightningcss

This will require that the Rust toolchain be installed.

## Usage

```py

import lightningcss

parser_flags = lightningcss.calc_parser_flags(nesting=True)

input_css = """

.navbar {

    margin: 0;

    a {

        padding-left: 0;

        padding-right: 0;

        padding-top: 5px;

        padding-bottom: 5px;

    }

}

"""

output_css = lightningcss.process_stylesheet(

    input_css,

    filename="abc.css",

    parser_flags = parser_flags,

    browsers_list = ['defaults'],

    minify = True,

)

```

The `filename` keyword parameter is only used for displaying error messages from

the parser. When using `browsers_list`, lightningcss will try to transpile the

code to be compatible with the specified

[browserslist target](https://browsersl.ist/).

This package also supports creating a CSS bundle where all `@import` rules are

resolved into a single stylesheet:

```py

bundled_css = lightningcss.bundle_css(

    "main.css",

    browsers_list = ["defaults"],

    minify = False,

)

```

All resources referenced via `@import` are resolved relative to the main file.