WARNING: This library is no longer maintained because something wonderful has come along. Try to enjoy: Lexbor.

hq.cr

a simple wrapper for crystal-xml and myhtml

gateway pattern : suppress errors until values are referenced
handy accessors : provide useful extractors and conversions

Installation

crystal: 0.23.x

Add this to your application's shard.yml:

dependencies:
  hq:
    github: maiha/hq.cr
    version: 0.2.3

xpath

require "hq"

node = Hq.parse("<html><body><div>82 users</div></body></html>")
node.xpath("/html/body/div").text # => "82 users"
node.xpath("/html/body/div").int  # => 82
node.xpath("/html/body/nav").int? # => nil
node.xpath("/html/body").path     # => "/html/body"
node.xpath("/html/div").text      # raise Hq::NotFound.new(key: "/html/div")

css

css selector

nodes = Hq::Css.parse <<-EOF
  <ul>
    <li>foo</li>
    <li>bar</li>
  </ul>
  EOF
nodes.css("li").map(&.text)  # => ["foo", "bar"]

node attributes

nodes = Hq::Css.parse <<-EOF
  <a href="https://github.com/crystal-lang/crystal" class="official">crystal</a>
  <a href="https://github.com/maiha/hq.cr">hq.cr</a>
  EOF
nodes.css("a").each do |a|
  p [a["href"], a["class"]?]
end

# => ["https://github.com/crystal-lang/crystal", "official"]
# => ["https://github.com/maiha/hq.cr", nil]

Roadmap

0.2.0

support css(tag)

0.3.0

support css(tag_with_class)
support Css::Node#attributes

0.4.0

support Hq.mapping like jq.cr

Contributing

Fork it ( https://github.com/maiha/hq.cr/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create a new Pull Request

Contributors

maiha maiha - creator, maintainer

Repository

hq.cr

Owner

maiha

Statistic

7
1
2
1
2
over 2 years ago
November 13, 2016

License

MIT License

Links

Synced at

Sat, 04 May 2024 09:54:35 GMT

Languages

Crystal 97.47% Makefile 2.53%