Skip to content

A Fast 'WHATWG' Compliant URL Parser

1packages depend
45.8Kdownloads / year
36.5%test coverage
10/13flavors OK

Overview

About

A wrapper for 'ada-url', a 'WHATWG' compliant and fast URL parser written in modern 'C++'. Also contains auxiliary functions such as a public suffix extractor.

Changes in 0.4.0

Breaking changes

  • privately registered suffixes (github.io, blogspot.com, s3.amazonaws.com, ...) are now part of the public suffix list lookup (#65). public_suffix() and ada_get_domain() gained an icann_only argument, defaulting to FALSE; pass icann_only = TRUE for the previous behaviour. `` r public_suffix("foo.github.io") # "github.io" (was "io") ada_get_domain("https://foo.github.io/p") # "foo.github.io" ada_get_domain("https://foo.github.io/p", icann_only = TRUE) # "github.io" ``

Other changes

  • public_suffix() now honours the exception (!) rules of the public suffix list, which were previously stored with their ! prefix and could never match. public_suffix("city.kobe.jp") is now "kobe.jp" rather than "city.kobe.jp", and ada_get_domain() returns a domain instead of "" for hosts under those rules
Show all changes in 0.4.0Hide the rest of the changes in 0.4.0
  • ada_get_domain() no longer strips a leading www. before looking up the suffix; the result is unchanged for ordinary hosts but www.ck and similar no longer come back as NA
  • the C++ loops check for a user interrupt, so long vectors can be cancelled with Ctrl-C (#49)
  • fixed url_decode2() dropping the remainder of a string after a % that is not followed by two hex digits (the escape is now passed through verbatim)
  • fixed public_suffix() erroring on two or more bare hostnames matching a wildcard rule, e.g. public_suffix(c("a.b.ck", "c.d.ck"))
  • public_suffix() now accepts full URLs with a path (#54), and returns the same suffix for a URL and its hostname
  • ada_get_domain() now accepts a bare domain, so it is idempotent (#36); schemeless input with a path is still NA
  • ada_get_basename() gained the decode argument the other getters have, and no longer appends // for schemes without an authority component
  • all exported functions now error on non-character input instead of silently returning NA

From NEWS.md in the release

Install

Health

CRAN checks
3ERROR10OK
Check messages
ERRORwhether package can be installedr-oldrel-macos-arm64, r-oldrel-macos-x86_64, r-release-macos-x86_64

r-oldrel-macos-arm64

Installation failed.
See ‘/Volumes/Builds/packages/big-sur-arm64/results/4.5/adaR.Rcheck/00install.out’ for details.

r-oldrel-macos-x86_64

Installation failed.
See ‘/Volumes/Builds/packages/big-sur-x86_64/results/4.5/adaR.Rcheck/00install.out’ for details.

r-release-macos-x86_64

Installation failed.
See ‘/Volumes/Builds/packages/big-sur-x86_64/results/4.6/adaR.Rcheck/00install.out’ for details.

CRAN check page ↗

Slowest check: 3.2 min · r-devel-windows-x86_64
Status changes
  • ERROR10 OK, 3 ERRORNow
  • ERROR10 OK, 4 ERROR2026-03-10
Advisories

none known

Documentation

In release 0.4.0
READMEYes · 335 wordsVignettesYes · 1 · dynamicNEWSYes · 100% structured · mentions 0.4.0Citation fileNoWebsiteYes · pkgdown
Help pages
7
Examples that run
100%7 run in a plain check
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
0%
Vignettes (1)

Downloads

45.8K
CRAN downloads in the past year
Rank #4,937 · ~126/day · ~3.8K/mo
Daily download trend is not available in this view yet.
86830 days
1.7K90 days
45.8K1 year
Compare downloads with other packages →
Also on412 r2u42 autocran

Repository

27Stars
4Forks
2Open issues
1Open PRs
8Releases
169Commits
4Commit identities
rrstatsurl-parserrstats-package
169 commits · Last activity 2026-09-22 · +3.8% stars, 30d
Responsiveness
How these are sampled
PRs merged (all time)
96%
Median days to close, 50 most recently updated closed issues
0
Median days to close, 50 most recently updated closed PRs
0

Stars over time

2025-02-19 · 252026-09-24 · 27
PracticesBeta

14 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/gesistsa/adar on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (5)
README.RmdpkgdownQuarto project

GitHub Pages site last deployed 2026-09-22 · The repository has a site deploy workflow

Coverage (2)
Coverage reporting (Codecov).covrignore
Reproducibility and dev environment (2)
data-raw/Binder
Show all practicesHide 3 practices
CRAN release process (1)
cran-comments.md
Research and citation (1)
CITATION.cff
Lint, format, editor (1)
EditorConfig
How this is detected·Detection ruleset v3 (2026-09-26)

Dependencies

Declared dependencies
6 external dependencies (excludes base and recommended)

Installing adaR adds 2 packages (2 with compiled code, 1.8 MB of source tarballs). Heaviest: Rcpp 1.8 MB, triebeard 31 KB.

Depends (1)
R >= 4.2
Imports (2)
LinkingTo (1)
Enhances (0)
none
Reverse dependencies
1direct
0indirect
Imports 1
Depends, Imports or LinkingTo, most downloaded first

People & History

People (4)
Author, Maintainer since 0.2.0 (2023)
Contributor, Copyright holder
author of ada-url : <https://github.com/ada-url/ada>
Contributor, Copyright holder
author of ada-url : <https://github.com/ada-url/ada>
Releases (8)

Pick two releases to compare their code metrics.

  • 0.4.0Latest
    record
    2026-09-22 · current release · diff ↗
  • R
    R 4.6.0 released · 2026-04-24
  • 0.3.5
    record
    2026-02-21 · diff ↗
  • R
    R 4.5.0 released · 2025-04-11
  • 0.3.4
    record
    2025-01-16 · diff ↗
  • 0.3.3
    record
    2024-07-12 · diff ↗
  • R
    R 4.4.0 released · 2024-04-24
  • 0.3.2
    record
    2024-02-08 · diff ↗
  • 0.3.1
    record
    2023-11-16 · diff ↗
  • 0.3.0
    record
    2023-10-16 · diff ↗ ·
    added 14 exports
    ada_clear_hash, ada_clear_port, ada_clear_search, ada_get_basename, ada_set_hash, ada_set_host, ada_set_hostname, ada_set_href, ada_set_password, ada_set_pathname, ada_set_port, ada_set_protocol, ada_set_search, ada_set_username
  • 0.2.0
    record
    2023-10-01
  • R
    R 4.3.0 released · 2023-04-21

Package metadata

First published
2023-10-01
Total releases
8 / 3 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 4.2
Download size
523 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("adaR")
Schoch, D., Chan, C., Lemire, D., & Nizipli, Y. (2026). adaR: A Fast 'WHATWG' Compliant URL Parser (Version 0.4.0) [Computer software]. https://doi.org/10.32614/CRAN.package.adaR

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

The repository also keeps a CITATION.cff.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for adaR version 0.4.0 [Data set]. HJJB, LLC. Data release v2026-10-22. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-22, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy