parse-css 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 65c805a944d8d10b13a41d955bc4f06231bded1a436ca09942484872eeae2952
+  data.tar.gz: e3c85fd4f482b45f3cd29c95b4dccec5a1b61e0663d9106677c54b311ba8a732
+SHA512:
+  metadata.gz: 1a4742ed47acf9426d3c989f09b9b7fdee689fe914d34b387f67caed0a3ec919514021b197516389d89d07de363ab77143e92e97c89944d29d823a6348b2cae4
+  data.tar.gz: 014c990d7d981bb9b2d91972003a96ebb11743ccda4098e4538c843d9a2335d73099496bce2f4750cb26b33afd3cffed995c7b167c6d321e6909c2dc78baf6bd

data/CHANGELOG.md

@@ -0,0 +1,2 @@
+# 1.0.0
+* Birthday!

data/Gemfile

@@ -0,0 +1,12 @@
+source "https://rubygems.org"
+
+gemspec
+
+group :development, :test do
+  gem "rake"
+  gem "debug"
+end
+
+group :test do
+  gem "minitest"
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Cameron Dutro
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+## parse-css
+
+![Unit Tests](https://github.com/camertron/parse-css/actions/workflows/unit_tests.yml/badge.svg?branch=main)
+
+## What is this thing?
+
+parse-css is a Ruby wrapper around the [parse-css](https://github.com/tabatkins/parse-css) JavaScript library. A number of CSS parsing libraries already exist for Ruby, but none of the ones I tested were able to handle nested CSS. The parse-css JavaScript library is small, fast, handles nested CSS, and doesn't have any dependencies or use special Node.js APIs.
+
+Since this library is a wrapper around the JavaScript one, all the same limitations apply. For example, it doesn't try to validate the CSS it's given, or interpret it in any way. It's just a parser. Your mileage may vary.
+
+## Usage
+
+The API of this gem is very simple:
+
+```ruby
+require "parse-css"
+
+ParseCSS.parse("body { color: red; }")  # => [{...}]
+```
+
+The `.parse` method produces a simple data structure made up of arrays, hashes, strings, and numbers.
+
+That's it, that's all it does.
+
+## How does it work?
+
+Yeah, so how can a library written in JavaScript be used from Ruby? parse-css is made possible by [mini_racer](https://github.com/rubyjs/mini_racer), a minimal, embeddable JavaScript runtime for Ruby.
+
+## Running Tests
+
+`bundle exec rake` should do the trick.
+
+## License
+
+Licensed under the MIT license. See LICENSE for details.
+
+## Authors
+
+* Cameron C. Dutro: http://github.com/camertron

data/Rakefile

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require "rake/testtask"
+require "rubygems/package_task"
+
+Bundler::GemHelper.install_tasks
+
+Rake::TestTask.new("test") do |t|
+  t.warning = false
+  t.libs << "test"
+  t.test_files = FileList[
+    "test/**/*_test.rb"
+  ]
+end
+
+task default: [:test]

data/lib/parse-css/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ParseCSS
+  VERSION = "1.0.0"
+end

data/lib/parse-css.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "mini_racer"
+
+module ParseCSS
+  class << self
+    def parse(source)
+      context.call("parseAStylesheetsContents", source)
+    end
+
+    private
+
+    def context
+      @context ||= MiniRacer::Context.new.tap do |context|
+        context.eval(File.read(File.join(vendor_dir, "parse-css.js")))
+      end
+    end
+
+    def vendor_dir
+      @vendor_dir ||= File.join(__dir__, "..", "vendor")
+    end
+  end
+end

data/parse-css.gemspec

@@ -0,0 +1,18 @@
+$:.unshift File.join(File.dirname(__FILE__), 'lib')
+require "parse-css/version"
+
+Gem::Specification.new do |s|
+  s.name     = "parse-css"
+  s.version  = ::ParseCSS::VERSION
+  s.authors  = ["Cameron Dutro"]
+  s.email    = ["camertron@gmail.com"]
+  s.homepage = "http://github.com/camertron/parse-css"
+  s.description = s.summary = "A Ruby wrapper around the parse-css JavaScript library."
+  s.platform = Gem::Platform::RUBY
+
+  s.require_path = "lib"
+
+  s.add_dependency "mini_racer", "~> 0.19"
+
+  s.files = Dir["{lib,test}/**/*", "Gemfile", "LICENSE", "CHANGELOG.md", "README.md", "Rakefile", "parse-css.gemspec"]
+end

data/test/parse_css_test.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "test_helper"
+
+class ParseCSSTest < Minitest::Test
+  def test_parse
+    assert_equal(
+      ParseCSS.parse("body { color: red; }"), [{
+        "type" => "QUALIFIED-RULE",
+        "prelude" => [{
+          "type" => "IDENT",
+          "value" => "body"
+        }, {
+          "type" => "WHITESPACE"
+        }],
+
+        "declarations" => [{
+          "type" => "DECLARATION",
+          "name" => "color",
+          "value" => [{
+            "type" => "IDENT",
+            "value" => "red"
+          }],
+
+          "important" => false
+        }],
+
+        "rules" => []
+      }]
+    )
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "parse-css"
+require "minitest/autorun"

metadata

@@ -0,0 +1,63 @@
+--- !ruby/object:Gem::Specification
+name: parse-css
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Cameron Dutro
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mini_racer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+description: A Ruby wrapper around the parse-css JavaScript library.
+email:
+- camertron@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/parse-css.rb
+- lib/parse-css/version.rb
+- parse-css.gemspec
+- test/parse_css_test.rb
+- test/test_helper.rb
+homepage: http://github.com/camertron/parse-css
+licenses: []
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: A Ruby wrapper around the parse-css JavaScript library.
+test_files: []