minicss 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b31b0ee62d4d3638efdefc213d952351190bf264fd55161f0a31202a5017cdaf
-  data.tar.gz: d34ac8bce2f2a7ebe262ba138213c8ad129c8295e9c5b998e195377ff8a94365
+  metadata.gz: 16612d43e7df5f3009024e820ff052502397894b193a68bc89132d9c495b5b25
+  data.tar.gz: 9647f9e3c808d1a55296d4b8f43ba6f4a251ba9d30c686fe0d97052a696ada5f
 SHA512:
-  metadata.gz: 499001401bd13f3d0210dd808cfd89328270267427e19abd18322b07c78bfb8e014f530c9a5c8338d3025ad736de0c5430dafa2a3ab5efe8292a3ae3bd18649c
-  data.tar.gz: fa90afda73f0ea372b8c150e5a6127c13e8b867f62f8d5c6a695924c5410c8b0630237c64469a580d9312150127db1f5097f65493e0ac27a6ab54a1b0528e00f
+  metadata.gz: 0cb89925ade3b7e37d9de3cc747f7dd9273490ffc7cdd09e052d65000b2286e07e6f42afda093d35f112294c413b86bc07134ac80fc6a6f2229ad0bffc9452be
+  data.tar.gz: 112f32326403cce9b098c2f0ca65f580e3cc075b21e656aad858e33215d79f860753da6b2c90387f516b443c906505c81b87ac35253947069c61e7ef9b729bf0

data/.rubocop.yml

@@ -1,3 +1,5 @@
+plugins: rubocop-performance
+
 AllCops:
   TargetRubyVersion: 3.4
   NewCops: enable
@@ -5,6 +7,7 @@ AllCops:
   Exclude:
     - spec/parsing_tests/*
     - vendor/**/*
+    - benchmarks/**/*
 
 Style/StringLiterals:
   EnforcedStyle: double_quotes

data/.ruby-version

@@ -0,0 +1 @@
+3.4.5

data/README.md

@@ -1,14 +1,12 @@
 # MiniCSS
 
-MiniCSS is a pure Ruby implementation of the CSS Syntax Level 3 tokenizer,
+MiniCSS is a Ruby implementation of the CSS Syntax Level 3 tokenizer,
 parser, serializer, and selector toolkit. It provides fast, dependency-free
-primitives for building linters, minifiers, and other CSS-aware tooling
-without reaching for native extensions.
+primitives for building linters, minifiers, and other CSS-aware tooling.
 
 ## Features
 
-- Pure Ruby tokenizer and parser with zero native dependencies and support
-for Ruby 3.4+.
+- C tokenizer and parser for Ruby 3.4+.
 - Battle-tested against the JSON-based `css-parsing-tests` suite for
 standards-compliant parsing.
 - High-level AST wrappers (`MiniCSS::AST::Rule`, `Decl`, `AtRule`, `Function`,
@@ -137,6 +135,7 @@ You can introspect the original token stream to report accurate diagnostics.
 - Clone the repository, and run `git submodule update --init` to fetch the
   required fixtures.
 - Install dependencies: `bundle install`
+- Compile native extensions: `bundle exec rake compile`
 - Run the test suite: `bundle exec rspec`
 - Check style and linting: `bundle exec rubocop`
 - Run everything: `bundle exec rake`
@@ -146,6 +145,126 @@ Helpful utilities:
 - `bin/console` starts an IRB session with MiniCSS preloaded.
 - `bin/gen-specs.rb` regenerates the specs under `spec/parsing_tests` from the
 external `css-parsing-tests` fixtures.
+- `benchmarks/ruby_prof.rb` runs tokenization, parsing, and serialization against
+ruby-prof for spotting slow code.
+- `benchmarks/stylesheet.rb` runs a benchmark for each parsing and serialization
+step against Crass.
+- `benchmarks/selectors.rb` runs a benchmark for selector parsing, serialization,
+and specificity.
+
+
+## Benchmarks
+
+As MiniCSS now relies on C extensions for performance, comparisons below are not
+really fair, considering Crass is a pure-ruby solution. However, MiniCSS
+provides support for extra CSS features and a different way of handling ASTs.
+
+Results below are running MiniCSS and Crass on the Bootstrap 4 CSS on both
+minified and unminified versions:
+
+### Tokenizing
+
+> [!WARNING]
+> MiniCSS uses C extension for full tokenization. Comparisons below are not
+> fair.
+
+```
+== Tokenize bootstrap-4.css ==
+ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]
+Warming up --------------------------------------
+    MiniCSS tokenize     3.000 i/100ms
+      Crass tokenize     1.000 i/100ms
+Calculating -------------------------------------
+    MiniCSS tokenize     31.449 (± 3.2%) i/s   (31.80 ms/i) -    159.000 in   5.058992s
+      Crass tokenize     12.731 (± 0.0%) i/s   (78.55 ms/i) -     64.000 in   5.036126s
+
+Comparison:
+    MiniCSS tokenize:       31.4 i/s
+      Crass tokenize:       12.7 i/s - 2.47x  slower
+
+== Tokenize bootstrap-4.min.css ==
+ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]
+Warming up --------------------------------------
+    MiniCSS tokenize     4.000 i/100ms
+      Crass tokenize     1.000 i/100ms
+Calculating -------------------------------------
+    MiniCSS tokenize     39.820 (± 2.5%) i/s   (25.11 ms/i) -    200.000 in   5.026530s
+      Crass tokenize     15.902 (± 6.3%) i/s   (62.89 ms/i) -     80.000 in   5.036493s
+
+Comparison:
+    MiniCSS tokenize:       39.8 i/s
+      Crass tokenize:       15.9 i/s - 2.50x  slower
+```
+
+### Parsing
+
+> [!NOTE]
+> MiniCSS uses a pure-ruby implementation for this section, except for the
+> `TokenStream` class, which relies on a C extension.
+
+```
+== Parse bootstrap-4.css ==
+ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]
+Warming up --------------------------------------
+       MiniCSS parse     1.000 i/100ms
+         Crass parse     1.000 i/100ms
+Calculating -------------------------------------
+       MiniCSS parse      7.837 (± 0.0%) i/s  (127.61 ms/i) -     40.000 in   5.105947s
+         Crass parse      8.554 (±11.7%) i/s  (116.90 ms/i) -     43.000 in   5.061931s
+
+Comparison:
+         Crass parse:        8.6 i/s
+       MiniCSS parse:        7.8 i/s - same-ish: difference falls within error
+
+== Parse bootstrap-4.min.css ==
+ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]
+Warming up --------------------------------------
+       MiniCSS parse     1.000 i/100ms
+         Crass parse     1.000 i/100ms
+Calculating -------------------------------------
+       MiniCSS parse     10.086 (± 0.0%) i/s   (99.15 ms/i) -     51.000 in   5.058562s
+         Crass parse     11.333 (± 0.0%) i/s   (88.24 ms/i) -     57.000 in   5.035570s
+
+Comparison:
+         Crass parse:       11.3 i/s
+       MiniCSS parse:       10.1 i/s - 1.12x  slower
+```
+
+### Serializing
+
+> [!NOTE]
+> MiniCSS uses a pure-ruby implementaiton for this section. No C extensions are
+> leveraged.
+
+```
+== Serialize bootstrap-4.css ==
+ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]
+Warming up --------------------------------------
+   MiniCSS serialize    26.000 i/100ms
+     Crass stringify    13.000 i/100ms
+Calculating -------------------------------------
+   MiniCSS serialize    267.680 (± 1.1%) i/s    (3.74 ms/i) -      1.352k in   5.051372s
+     Crass stringify    134.551 (± 3.0%) i/s    (7.43 ms/i) -    676.000 in   5.028420s
+
+Comparison:
+   MiniCSS serialize:      267.7 i/s
+     Crass stringify:      134.6 i/s - 1.99x  slower
+
+== Serialize bootstrap-4.min.css ==
+ruby 3.4.5 (2025-07-16 revision 20cda200d3) +PRISM [arm64-darwin24]
+Warming up --------------------------------------
+   MiniCSS serialize    26.000 i/100ms
+     Crass stringify    18.000 i/100ms
+Calculating -------------------------------------
+   MiniCSS serialize    255.343 (± 5.1%) i/s    (3.92 ms/i) -      1.300k in   5.105550s
+     Crass stringify    181.703 (± 5.0%) i/s    (5.50 ms/i) -    918.000 in   5.065818s
+
+Comparison:
+   MiniCSS serialize:      255.3 i/s
+     Crass stringify:      181.7 i/s - 1.41x  slower
+```
+
+
 
 ## Contributing
 

data/Rakefile

@@ -2,6 +2,7 @@
 
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
+require "rake/extensiontask"
 
 RSpec::Core::RakeTask.new(:spec)
 
@@ -9,4 +10,27 @@ require "rubocop/rake_task"
 
 RuboCop::RakeTask.new
 
-task default: %i[spec rubocop]
+task default: %i[compile spec rubocop]
+
+namespace :bench do
+  desc "Run stylesheet benchmarks"
+  task :stylesheet do
+    ruby "benchmarks/stylesheet.rb"
+  end
+
+  desc "Run selector benchmarks"
+  task :selectors do
+    ruby "benchmarks/selectors.rb"
+  end
+end
+
+desc "Run all benchmarks"
+task bench: %w[bench:stylesheet bench:selectors]
+
+Rake::ExtensionTask.new("minicss_scanner") do |ext|
+  ext.lib_dir = "lib"
+end
+
+Rake::ExtensionTask.new("minicss_token_stream") do |ext|
+  ext.lib_dir = "lib"
+end