Home

Awesome

hq

A HTML processor inspired by jq (https://github.com/stedolan/jq)

Building & Usage

Building

Dependencies

Build

meson build && ninja -C build

The executable will be built to build/hq.

Usage

Dependencies

Use

Application help text:

hq (html query) - commandline HTML processor © Mara Robin Broda, 2018
Usage: build/hq [options] <selector> <mode> [mode argument]

Options:
  -h, --help
    show this text
  -f, --file <file>
    file to read (defaults to stdin)
  -d, --delimiter <delim>
    delimiter character to use between results (defaults to newline)
  -0, --null
    uses \0 as delimiter

  <selector>
    CSS selector to match against
  <mode>
    processing mode
    may be one of { data, text, attr }:
      data - return raw html of matching elements
      text - return inner text of matching elements
        [mode argument: formatting]
          supported modes: { plain, ansi, md }
          default: plain
          for plain, ANSI, or markdown formatted output respectively
      attr - return attribute value of matching elements
        <mode argument: attr>
          attribute to return

Examples:
  curl -sSL https://example.com | build/hq a data
  curl -sSL https://example.com | build/hq a attr href

Example usage:

curl -s https://coderobe.net | hq a data

<a href="https://keybase.io/coderobe">Keybase (coderobe)</a>
<a href="https://github.com/coderobe">Github (coderobe)</a>
<a href="https://twitter.com/coderobe">Twitter (coderobe)</a>

curl -s https://coderobe.net | hq a text

Keybase (coderobe)
Github (coderobe)
Twitter (coderobe)

curl -s https://coderobe.net | hq a attr href

https://keybase.io/coderobe
https://github.com/coderobe
https://twitter.com/coderobe

You get the idea.

License

This work, written by Mara Robin Broda (coderobe) in 2018, is licensed under the terms of the GNU Affero General Public License v3.0