Lib.rs

Cargo Features

[dependencies]
read-url = { version = "0.0.3", default-features = false, features = ["async", "blocking", "file", "git", "gzip", "http", "internal", "tar", "zip", "zstd"] }

default = file, git, gzip, http, internal, tar, zip, zstd

These default features are set whenever read-url is added without default-features = false somewhere in the dependency tree.

async

Enables tokio, async of kutil-io

Affects url::AsyncReadRef, url::OpenAsyncFuture, url::ConformAsyncFuture, url::URL.conform_async, url::URL.open_async…

blocking

Enables blocking of kutil-io

Affects url::URL.conform, url::URL.open…

file default

Affects read-url::file…

git default = gix

Affects read-url::git…

gzip default

Enables async-compression and flate2

async-compression:

extra features:

http default

Enables futures, reqwest, and tokio

Affects context::UrlContext.http_client, read-url::http…

internal default

tar default

Enables krata-tokio-tar and tar

krata-tokio-tar:

most up-to-date tokio-compatible fork of async-tar; see: https://github.com/astral-sh/uv/pull/7271

Affects read-url::tar…

zip default

Enables positioned-io, rc-zip-sync, and rc-zip-tokio

rc-zip-sync:

extra features for both rc-zip? bzip2, deflate64, lzma, zstd

Affects read-url::zip…

zstd default

this is for both tar and for zip

Enables zstd, zstd of async-compression, rc-zip-sync, and rc-zip-tokio

Features from optional dependencies

In crates that don't use the dep: syntax, optional dependencies automatically become Cargo features. These features may have been created by mistake, and this functionality may be removed in the future.

gix git