History

Nick Mathewson 82766e74e4 Improve display for tor-dircache errors. These errors no longer use Debug to dump the `Option<SourceInfo>`, but instead produce reasonable text. Also, I've fixed the SourceInfo Display implementation so that it now says that it got the error "from $source via $circuit" rather than the other way around.		2022-07-07 14:07:04 -04:00
..
src	Improve display for tor-dircache errors.	2022-07-07 14:07:04 -04:00
Cargo.toml	Bump crate and dependency versions.	2022-06-24 12:00:22 -04:00
README.md	run ./maint/readmes.sh	2021-11-29 21:29:28 +10:00
semver.md	dirclient: Generalize MdSha256Empty to EmptyRequest.	2022-07-07 14:07:04 -04:00

README.md

tor-dirclient

tor-dirclient: Implements a minimal directory client for Tor.

Overview

Tor makes its directory requests as HTTP/1.0 requests tunneled over Tor circuits. For most objects, Tor uses a one-hop tunnel. Tor also uses a few strange and ad-hoc HTTP headers to select particular functionality, such as asking for diffs, compression, or multiple documents.

This crate provides an API for downloading Tor directory resources over a Tor circuit.

This crate is part of Arti, a project to implement Tor in Rust.

Features

xz -- enable XZ compression. This can be expensive in RAM and CPU, but it saves a lot of bandwidth. (On by default.)

zstd -- enable ZSTD compression. (On by default.)

routerdesc -- Add support for downloading router descriptors.

License: MIT OR Apache-2.0