Home

Awesome

sqlite-html

A SQLite extension for querying, manipulating, and creating HTML elements.

sqlite-html's API is modeled after the official JSON1 SQLite extension.

This extension is written in Go, thanks to riyaz-ali/sqlite. While this library aims to be fast and efficient, it is overall slower than what a pure C SQLite extension could be, but in practice you may not notice much of a difference.

Usage

.load ./html0
select html_extract('<p> Anakin <b>Skywalker</b> </p>', 'b');
-- "<b>Skywalker</b>"

sqlite-html is similar to other HTML scraping tools like BeautifulSoup (Python) or cheerio (Node.js) or nokogiri (Ruby). You can use CSS selectors to extract individual elements or groups of elements to query data from HTML sources.

For example, here we find all href links in an index.html file.

select
  text as name,
  html_attribute_get(anchors, 'a', 'href') as href
from html_each(readfile('index.html'), 'a') as anchors

We can also safely generate HTML with html_element, modeled after React's React.createElement.

select html_element('p', null,
  'Luke, I am your',
  html_element('b', null, 'father'),
  '!',

  html_element('img', json_object(
    'src', 'https://images.dog.ceo/breeds/groenendael/n02105056_4600.jpg',
    'width', 200
  ))
);

-- "<p>Luke, I am your<b>father</b>!<img src="https://images.dog.ceo/breeds/groenendael/n02105056_4600.jpg" width="200.000000"/></p>"

Documentation

See docs.md for a full API reference.

Installing

LanguageInstall
Pythonpip install sqlite-htmlPyPI
Datasettedatasette install datasette-sqlite-htmlDatasette
Node.jsnpm install sqlite-htmlnpm
Denodeno.land/x/sqlite_htmldeno.land/x release
Rubygem install sqlite-htmlGem
Github ReleaseGitHub tag (latest SemVer pre-release)
<!-- | Elixir | [`hex.pm/packages/sqlite_html`](https://hex.pm/packages/sqlite_html) | [![Hex.pm](https://img.shields.io/hexpm/v/sqlite_html?color=purple&logo=elixir)](https://hex.pm/packages/sqlite_html) | | Go | `go get -u github.com/asg017/sqlite-html/bindings/go` | [![Go Reference](https://pkg.go.dev/badge/github.com/asg017/sqlite-html/bindings/go.svg)](https://pkg.go.dev/github.com/asg017/sqlite-html/bindings/go) | | Rust | `cargo add sqlite-html` | [![Crates.io](https://img.shields.io/crates/v/sqlite-html?logo=rust)](https://crates.io/crates/sqlite-html) | -->

The Releases page contains pre-built binaries for Linux amd64, MacOS amd64 (no arm), and Windows.

As a loadable extension

If you want to use sqlite-html as a Runtime-loadable extension, Download the html0.dylib (for MacOS), html0.so (Linux), or html0.dll (Windows) file from a release and load it into your SQLite environment.

Note: The 0 in the filename (html0.dylib/ html0.so/html0.dll) denotes the major version of sqlite-html. Currently sqlite-html is pre v1, so expect breaking changes in future versions.

For example, if you are using the SQLite CLI, you can load the library like so:

.load ./html0
select html_version();
-- v0.0.1

Or in Python, using the builtin sqlite3 module:

import sqlite3

con = sqlite3.connect(":memory:")

con.enable_load_extension(True)
con.load_extension("./html0")

print(con.execute("select html_version()").fetchone())
# ('v0.0.1',)

Or in Node.js using better-sqlite3:

const Database = require("better-sqlite3");
const db = new Database(":memory:");

db.loadExtension("./html0");

console.log(db.prepare("select html_version()").get());
// { 'html_version()': 'v0.0.1' }

Or with Datasette:

datasette data.db --load-extension ./html0

See also