css_inline 0.10.0 → 0.10.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +22 -13
- data/ext/css_inline/Cargo.toml +1 -1
- data/ext/css_inline/src/lib.rs +4 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: b2bee3426a27caa1fd94d837cc8f9178d78167bffd47cd4f9fbe967683a737be
|
|
4
|
+
data.tar.gz: eafaddb32401278885056597da4dab0403a5cc902e3acbf5e0bf279c4083fb30
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: fcf9fde86b859f76c7b2259a5ceb3c1f49cb5dd3a66efa5b25f2582da9c40330535d78495d8eecbb331defaf68d48bf99fde24854d11eec2e8e1862be5aa63ba
|
|
7
|
+
data.tar.gz: 5b31912053524cfff826837921316ebcac19ce8ed85b49886260d506fcd4619f25dde8a8e40eb98aa6e06fe37a9f462f14da12de2022cb6342f41c0ec3a64ec8
|
data/README.md
CHANGED
|
@@ -5,16 +5,15 @@
|
|
|
5
5
|
[<img alt="codecov.io" src="https://img.shields.io/codecov/c/gh/Stranger6667/css-inline?logo=codecov&style=flat-square&token=tOzvV4kDY0" height="20">](https://app.codecov.io/github/Stranger6667/css-inline)
|
|
6
6
|
[<img alt="gitter" src="https://img.shields.io/gitter/room/Stranger6667/css-inline?style=flat-square" height="20">](https://gitter.im/Stranger6667/css-inline)
|
|
7
7
|
|
|
8
|
-
`css_inline`
|
|
8
|
+
`css_inline` is a high-performance library for inlining CSS into HTML 'style' attributes.
|
|
9
9
|
|
|
10
|
-
This
|
|
10
|
+
This library is designed for scenarios such as preparing HTML emails or embedding HTML into third-party web pages.
|
|
11
11
|
|
|
12
12
|
For instance, the library transforms HTML like this:
|
|
13
13
|
|
|
14
14
|
```html
|
|
15
15
|
<html>
|
|
16
16
|
<head>
|
|
17
|
-
<title>Test</title>
|
|
18
17
|
<style>h1 { color:blue; }</style>
|
|
19
18
|
</head>
|
|
20
19
|
<body>
|
|
@@ -27,16 +26,14 @@ into:
|
|
|
27
26
|
|
|
28
27
|
```html
|
|
29
28
|
<html>
|
|
30
|
-
<head>
|
|
31
|
-
<title>Test</title>
|
|
32
|
-
</head>
|
|
29
|
+
<head></head>
|
|
33
30
|
<body>
|
|
34
31
|
<h1 style="color:blue;">Big Text</h1>
|
|
35
32
|
</body>
|
|
36
33
|
</html>
|
|
37
34
|
```
|
|
38
35
|
|
|
39
|
-
- Uses reliable components from Mozilla's Servo
|
|
36
|
+
- Uses reliable components from Mozilla's Servo project
|
|
40
37
|
- Inlines CSS from `style` and `link` tags
|
|
41
38
|
- Removes `style` and `link` tags
|
|
42
39
|
- Resolves external stylesheets (including local files)
|
|
@@ -66,6 +63,20 @@ puts inlined
|
|
|
66
63
|
# Outputs: "<html><head></head><body><h1 style=\"color:blue;\">Big Text</h1></body></html>"
|
|
67
64
|
```
|
|
68
65
|
|
|
66
|
+
When there is a need to inline multiple HTML documents simultaneously, `css_inline` offers the `inline_many` function.
|
|
67
|
+
This feature allows for concurrent processing of several inputs, significantly improving performance when dealing with a large number of documents.
|
|
68
|
+
|
|
69
|
+
```ruby
|
|
70
|
+
require 'css_inline'
|
|
71
|
+
|
|
72
|
+
inlined = CSSInline.inline_many(["...", "..."])
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Under the hood, `inline_many`, spawns threads at the Rust layer to handle the parallel processing of inputs.
|
|
76
|
+
This results in faster execution times compared to employing parallel processing techniques at the Ruby level.
|
|
77
|
+
|
|
78
|
+
**Note**: To fully benefit from `inline_many`, you should run your application on a multicore machine.
|
|
79
|
+
|
|
69
80
|
## Configuration
|
|
70
81
|
|
|
71
82
|
For customization options use the `CSSInliner` class:
|
|
@@ -88,7 +99,6 @@ You can also skip CSS inlining for an HTML tag by adding the `data-css-inline="i
|
|
|
88
99
|
|
|
89
100
|
```html
|
|
90
101
|
<head>
|
|
91
|
-
<title>Test</title>
|
|
92
102
|
<style>h1 { color:blue; }</style>
|
|
93
103
|
</head>
|
|
94
104
|
<body>
|
|
@@ -101,7 +111,6 @@ The `data-css-inline="ignore"` attribute also allows you to skip `link` and `sty
|
|
|
101
111
|
|
|
102
112
|
```html
|
|
103
113
|
<head>
|
|
104
|
-
<title>Test</title>
|
|
105
114
|
<!-- Styles below are ignored -->
|
|
106
115
|
<style data-css-inline="ignore">h1 { color:blue; }</style>
|
|
107
116
|
</head>
|
|
@@ -129,9 +138,9 @@ The table below provides a detailed comparison between `css_inline` and `premail
|
|
|
129
138
|
|
|
130
139
|
| | `css_inline 0.10.0` | `premailer 1.21.0 with Nokogiri 1.15.2` | Difference |
|
|
131
140
|
|-------------------|---------------------|------------------------------------------------|------------|
|
|
132
|
-
| Basic usage |
|
|
133
|
-
| Realistic email 1 |
|
|
134
|
-
| Realistic email 2 |
|
|
141
|
+
| Basic usage | 9.77 µs | 414.42 µs | **42.42x** |
|
|
142
|
+
| Realistic email 1 | 249.62 µs | 10.75 ms | **42.97x** |
|
|
143
|
+
| Realistic email 2 | 162.33 µs | Error: Cannot parse 0 calc((100% - 500px) / 2) | - |
|
|
135
144
|
|
|
136
145
|
Please refer to the `test/bench.rb` file to review the benchmark code.
|
|
137
146
|
The results displayed above were measured using stable `rustc 1.70` on Ruby `3.2.2`.
|
|
@@ -140,7 +149,7 @@ The results displayed above were measured using stable `rustc 1.70` on Ruby `3.2
|
|
|
140
149
|
|
|
141
150
|
`css_inline` supports Ruby 2.7 and 3.2.
|
|
142
151
|
|
|
143
|
-
##
|
|
152
|
+
## Further reading
|
|
144
153
|
|
|
145
154
|
If you want to know how this library was created & how it works internally, you could take a look at these articles:
|
|
146
155
|
|
data/ext/css_inline/Cargo.toml
CHANGED
data/ext/css_inline/src/lib.rs
CHANGED
|
@@ -16,13 +16,16 @@
|
|
|
16
16
|
missing_debug_implementations,
|
|
17
17
|
trivial_casts,
|
|
18
18
|
trivial_numeric_casts,
|
|
19
|
+
unreachable_pub,
|
|
19
20
|
unused_extern_crates,
|
|
20
21
|
unused_import_braces,
|
|
21
22
|
unused_qualifications,
|
|
22
23
|
variant_size_differences,
|
|
23
24
|
rust_2018_idioms,
|
|
24
|
-
rust_2018_compatibility
|
|
25
|
+
rust_2018_compatibility,
|
|
26
|
+
rust_2021_compatibility
|
|
25
27
|
)]
|
|
28
|
+
#[allow(clippy::module_name_repetitions)]
|
|
26
29
|
use css_inline as rust_inline;
|
|
27
30
|
use magnus::{
|
|
28
31
|
class, define_module, function, method,
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: css_inline
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.10.
|
|
4
|
+
version: 0.10.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Dmitry Dygalo
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2023-06-
|
|
11
|
+
date: 2023-06-25 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: rake-compiler
|