css-inline

Fast CSS inlining written in Rust

These details have not been verified by PyPI

Project links

Homepage

Project description

Fast CSS inlining for Python implemented in Rust.

Features:

Removing style tags after inlining;
Resolving external stylesheets (including local files);
… more features will be available soon

NOTE. This library is in active development and provides a small number of features at the moment, see Limitations sections below for more information.

Installation

To install css_inline via pip run the following command:

pip install css_inline

Usage

To inline CSS in a HTML document:

import css_inline

HTML = """<html>
<head>
    <title>Test</title>
    <style>h1 { color:blue; }</style>
</head>
<body>
    <h1>Big Text</h1>
</body>
</html>"""

inlined = css_inline.inline(HTML)

If you want to inline many HTML documents then you can utilize inline_many that processes the input in parallel.

import css_inline

css_inline.inline_many(["...", "..."])

For customization options use CSSInliner class:

import css_inline

inliner = css_inline.CSSInliner(remove_style_tags=True)
inliner.inline("...")

Performance

Due to the usage of efficient tooling from Mozilla’s Servo project (html5ever, rust-cssparser and others) this library has good performance characteristics. In comparison with other Python projects, it is ~7-15x faster than the nearest competitor.

For inlining CSS in the html document from the Usage section above we have the following breakdown in our benchmarks:

css_inline 0.3.1 - 23.31 us
premailer 3.7.0 - 335 us (x14.37)
inlinestyler 0.2.4 - 2.48 ms (x106.64)
pynliner 0.8.0 - 2.82 ms (x121.27)

And for a more realistic email:

css_inline 0.3.1 - 482.79 us
premailer 3.7.0 - 3.38 ms (x7)
inlinestyler 0.2.4 - 62.64 ms (x129.75)
pynliner 0.8.0 - 92.18 ms (x190.94)

You can take a look at the benchmarks’ code at benches/bench.py file. The results above were measured with rustc 1.46, Python 3.8 on i8700K, and 32GB RAM.

Limitations

Currently (as of 0.3.0) there are the following notable limitations:

Inlined CSS is not minimized (#12)
class and id attributes are not removed (#13)

Python support

css_inline supports Python 3.5, 3.6, 3.7, and 3.8.

License

The code in this project is licensed under MIT license. By contributing to css_inline, you agree that your contributions will be licensed under its MIT license.

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

0.14.1

Apr 27, 2024

0.14.0

Apr 1, 2024

0.13.0

Jan 19, 2024

0.12.0

Dec 28, 2023

0.11.2

Dec 9, 2023

0.11.1

Dec 9, 2023

0.11.0

Sep 26, 2023

0.10.5

Aug 30, 2023

0.10.4

Aug 11, 2023

0.10.3

Jul 1, 2023

0.10.2

Jun 25, 2023

0.10.1

Jun 18, 2023

0.10.0

Jun 16, 2023

0.9.0 yanked

Jun 10, 2023

Reason this release was yanked:

security vulnerability in HTML serialization

0.8.7

Jan 30, 2023

0.8.6

Nov 10, 2022

0.8.5

Nov 2, 2022

0.8.4

Oct 21, 2022

0.8.3

Jul 21, 2022

0.8.2

Apr 1, 2022

0.8.1

Jan 11, 2022

0.8.0

Jan 10, 2022

0.7.8

Jan 8, 2022

0.7.7

Jan 7, 2022

0.7.6

Aug 6, 2021

0.7.5

Jul 24, 2021

0.7.4

Jul 6, 2021

0.7.3

Jun 24, 2021

0.7.2

Jun 22, 2021

0.7.1

Jun 10, 2021

0.7.0

Jun 9, 2021

0.6.2

Jan 28, 2021

0.6.1

Dec 7, 2020

0.6.0

Nov 2, 2020

0.5.0

Aug 7, 2020

0.4.0

Jul 13, 2020

0.3.2

Jul 9, 2020

This version

0.3.1

Jul 7, 2020

0.3.0

Jun 27, 2020

0.2.0

Jun 25, 2020

0.1.0

Jun 24, 2020

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

css_inline-0.3.1.tar.gz (5.3 kB view hashes)

Uploaded Jul 7, 2020 Source

Built Distributions

css_inline-0.3.1-cp38-cp38-win_amd64.whl (865.0 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.8 Windows x86-64

css_inline-0.3.1-cp38-cp38-manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded Jul 7, 2020 CPython 3.8

css_inline-0.3.1-cp38-cp38-macosx_10_15_x86_64.whl (908.8 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.8 macOS 10.15+ x86-64

css_inline-0.3.1-cp37-cp37m-win_amd64.whl (865.0 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.7m Windows x86-64

css_inline-0.3.1-cp37-cp37m-manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded Jul 7, 2020 CPython 3.7m

css_inline-0.3.1-cp37-cp37m-macosx_10_15_x86_64.whl (908.8 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.7m macOS 10.15+ x86-64

css_inline-0.3.1-cp36-cp36m-win_amd64.whl (865.4 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.6m Windows x86-64

css_inline-0.3.1-cp36-cp36m-manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded Jul 7, 2020 CPython 3.6m

css_inline-0.3.1-cp36-cp36m-macosx_10_15_x86_64.whl (909.0 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.6m macOS 10.15+ x86-64

css_inline-0.3.1-cp35-cp35m-win_amd64.whl (865.4 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.5m Windows x86-64

css_inline-0.3.1-cp35-cp35m-manylinux2014_x86_64.whl (3.5 MB view hashes)

Uploaded Jul 7, 2020 CPython 3.5m

css_inline-0.3.1-cp35-cp35m-macosx_10_15_x86_64.whl (909.0 kB view hashes)

Uploaded Jul 7, 2020 CPython 3.5m macOS 10.15+ x86-64

Hashes for css_inline-0.3.1.tar.gz

Hashes for css_inline-0.3.1.tar.gz
Algorithm	Hash digest
SHA256	`67fcb8c5104e4396cf07818ca80d611519bb44a9c7cfc098d9f1898b9f4f3945`
MD5	`37ade900acebc9eb4051d71d43570c22`
BLAKE2b-256	`fd6034637f5556c21a0bd25413c017844507f3a8bb70a730c8a266df595c2b4a`

Hashes for css_inline-0.3.1-cp38-cp38-win_amd64.whl

Hashes for css_inline-0.3.1-cp38-cp38-win_amd64.whl
Algorithm	Hash digest
SHA256	`a1be43bae76e809046439565e709fdb01f8ed1d1be2a0782da3a6e7db99d01ed`
MD5	`812292339ef526af99fa4210853f038b`
BLAKE2b-256	`a6831634ed615902bdd366e763ddef58a1b42caadf92859f1f07a953cba9e266`

Hashes for css_inline-0.3.1-cp38-cp38-manylinux2014_x86_64.whl

Hashes for css_inline-0.3.1-cp38-cp38-manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`6bcf29b99d513bc6fcc51d960d5aed739ac35bc69ca587b0fa6d523d02182edc`
MD5	`c34d83d24ccae93ce1d155c55020fe29`
BLAKE2b-256	`9a39ab084b3aba0d4255a86648ab93c4e8cf9164a721d06eeca8be2504890861`

Hashes for css_inline-0.3.1-cp38-cp38-macosx_10_15_x86_64.whl

Hashes for css_inline-0.3.1-cp38-cp38-macosx_10_15_x86_64.whl
Algorithm	Hash digest
SHA256	`a84229fab820de241630c5908fc0a195164cc898f3cb8986184e181e7130557f`
MD5	`39c895798e88517f4783a74d24896757`
BLAKE2b-256	`f036aaefa284a5ed4a210d18b4ab71324c3fe56682ec7c51b2797dac7cff2fa6`

Hashes for css_inline-0.3.1-cp37-cp37m-win_amd64.whl

Hashes for css_inline-0.3.1-cp37-cp37m-win_amd64.whl
Algorithm	Hash digest
SHA256	`63d082e14020bacc09c01e823341fa9bb90626c92c03ac957047a004e543bcde`
MD5	`b66be70165068e7c3f6ea061e6ade899`
BLAKE2b-256	`ce6058a2f4347c2af877ac7bf28ce82110df523c98ab60d787de698c58d15870`

Hashes for css_inline-0.3.1-cp37-cp37m-manylinux2014_x86_64.whl

Hashes for css_inline-0.3.1-cp37-cp37m-manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`cd7cf6d9ce81f18f8c3607723ea81033c834a2f0085e0278b63c20848559b077`
MD5	`ada4a097902180559c3cf40563151b1d`
BLAKE2b-256	`33efebf538d19aefcdc37ab8039c7f9344fe6a752a5d86c6895cbf958b0d05ae`

Hashes for css_inline-0.3.1-cp37-cp37m-macosx_10_15_x86_64.whl

Hashes for css_inline-0.3.1-cp37-cp37m-macosx_10_15_x86_64.whl
Algorithm	Hash digest
SHA256	`3169b1c2de534c7e7a32e62202c6b9c960ee2f989250031db484a50a269937ff`
MD5	`c5227c6e072690f4d582a4875beaa2f2`
BLAKE2b-256	`9ab3664056362938310fda0145837c55070cac55032a3c773c9a7677e8e35b83`

Hashes for css_inline-0.3.1-cp36-cp36m-win_amd64.whl

Hashes for css_inline-0.3.1-cp36-cp36m-win_amd64.whl
Algorithm	Hash digest
SHA256	`695b8ecac700a0f4b648ed010ac9d7e369554f791667adc95e09eb3ff8d7b051`
MD5	`5c124b57ae75d96f2f2e872a1b5c79f1`
BLAKE2b-256	`fe2742a2ec5a2b64d15325f44c4c93be33c347b0e4826ae561ef8e7243f0cd42`

Hashes for css_inline-0.3.1-cp36-cp36m-manylinux2014_x86_64.whl

Hashes for css_inline-0.3.1-cp36-cp36m-manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`7b23d176a974d4eb929e2c10315678b2c546cf8e0b503c06a97b7cc37ab6c981`
MD5	`246567135ef578bb3d0ab94c4c415bdf`
BLAKE2b-256	`cf5ddca1c5e157d838ae16cfba4693f27c630d73d56f780410efc2b09aead5ff`

Hashes for css_inline-0.3.1-cp36-cp36m-macosx_10_15_x86_64.whl

Hashes for css_inline-0.3.1-cp36-cp36m-macosx_10_15_x86_64.whl
Algorithm	Hash digest
SHA256	`4dfa7c7e5a38a00c04e5955f78672a85df6a796cae1678a3963577e9cd8dab39`
MD5	`18d3b537b38787f295a571c55bb6350c`
BLAKE2b-256	`4fd4cafcacd468002d63afff7d4b3d28a8c95af3c3761f5c5291de6368aeeadf`

Hashes for css_inline-0.3.1-cp35-cp35m-win_amd64.whl

Hashes for css_inline-0.3.1-cp35-cp35m-win_amd64.whl
Algorithm	Hash digest
SHA256	`96d801b52bd6671e28762e86554c4607efa563d0989166ff9cb3df4eb5494f96`
MD5	`156d402c814ec0959c2fcee9322f6e49`
BLAKE2b-256	`bc0ff280f6300ba46a3fafbeb04c6a6cf7b422df36b5f286349303135379bf57`

Hashes for css_inline-0.3.1-cp35-cp35m-manylinux2014_x86_64.whl

Hashes for css_inline-0.3.1-cp35-cp35m-manylinux2014_x86_64.whl
Algorithm	Hash digest
SHA256	`63c305413a9d2b68ad3479275ae7a484729144fe3fe07224c14db8054dc52edd`
MD5	`536c9edb755a1efd67144d59ca173a89`
BLAKE2b-256	`4d022e9a685b8aa426515289d9a85c2210910182cd9b6eafa5067f81ae1f41c9`

Hashes for css_inline-0.3.1-cp35-cp35m-macosx_10_15_x86_64.whl

Hashes for css_inline-0.3.1-cp35-cp35m-macosx_10_15_x86_64.whl
Algorithm	Hash digest
SHA256	`d74d2c0c60ef32fd29cebf2fd690bea0dea33b165e4e28dc214b9f86ff9eba10`
MD5	`e0089f44dcf6db25dec58cf6cfd60986`
BLAKE2b-256	`0e09b55590c5d954644a86d419f22202e991344d4a10d8a4ed7a15e0f548f988`