https://github.com/premailer/css_parser

Ruby CSS Parser
https://github.com/premailer/css_parser

css-parser ruby

Last synced: 4 days ago
JSON representation

Ruby CSS Parser

• Host: GitHub
• URL: https://github.com/premailer/css_parser
• Owner: premailer
• License: other
• Created: 2009-12-08T17:22:24.000Z (about 15 years ago)
• Default Branch: master
• Last Pushed: 2024-12-14T04:42:06.000Z (about 2 months ago)
• Last Synced: 2024-12-28T09:00:07.795Z (about 1 month ago)
• Topics: css-parser, ruby
• Language: Ruby
• Homepage:
• Size: 649 KB
• Stars: 280
• Watchers: 12
• Forks: 110
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: MIT-LICENSE

Awesome Lists containing this project

README

        
# Ruby CSS Parser [![Build Status](https://github.com/premailer/css_parser/workflows/Run%20css_parser%20CI/badge.svg)](https://github.com/ojab/css_parser/actions?query=workflow%3A%22Run+css_parser+CI%22) [![Gem Version](https://badge.fury.io/rb/css_parser.svg)](https://badge.fury.io/rb/css_parser)

Load, parse and cascade CSS rule sets in Ruby.

# Setup

```Bash

gem install css_parser

```

# Usage

```Ruby

require 'css_parser'

include CssParser

parser = CssParser::Parser.new

parser.load_uri!('http://example.com/styles/style.css')

parser = CssParser::Parser.new

parser.load_uri!('file://home/user/styles/style.css')

# load a remote file, setting the base_uri and media_types

parser.load_uri!('../style.css', {base_uri: 'http://example.com/styles/inc/', media_types: [:screen, :handheld]})

# load a local file, setting the base_dir and media_types

parser.load_file!('print.css', '~/styles/', :print)

# load a string

parser = CssParser::Parser.new

parser.load_string! 'a { color: hotpink; }'

# lookup a rule by a selector

parser.find_by_selector('#content')

#=> 'font-size: 13px; line-height: 1.2;'

# lookup a rule by a selector and media type

parser.find_by_selector('#content', [:screen, :handheld])

# iterate through selectors by media type

parser.each_selector(:screen) do |selector, declarations, specificity|

  ...

end

# add a block of CSS

css = <<-EOT

  body { margin: 0 1em; }

EOT

parser.add_block!(css)

# output all CSS rules in a single stylesheet

parser.to_s

=> #content { font-size: 13px; line-height: 1.2; }

   body { margin: 0 1em; }

# capturing byte offsets within a file

parser.load_uri!('../style.css', {base_uri: 'http://example.com/styles/inc/', capture_offsets: true)

content_rule = parser.find_rule_sets(['#content']).first

content_rule.filename

#=> 'http://example.com/styles/styles.css'

content_rule.offset

#=> 10703..10752

# capturing byte offsets within a string

parser.load_string!('a { color: hotpink; }', {filename: 'index.html', capture_offsets: true)

content_rule = parser.find_rule_sets(['a']).first

content_rule.filename

#=> 'index.html'

content_rule.offset

#=> 0..21

```

# Testing

```Bash

bundle

bundle exec rake

```

Runs on Ruby 3.0/JRuby 9.4 or above.

# Credits

By Alex Dunae (dunae.ca, e-mail 'code' at the same domain), 2007-11.

License: MIT

Thanks to [all the wonderful contributors](http://github.com/premailer/css_parser/contributors) for their updates.

Made on Vancouver Island.