8 breaking releases

new 0.25.0 Dec 2, 2024
0.24.0 Oct 31, 2024
0.23.0 Sep 30, 2024
0.20.0 Jun 27, 2024

#2047 in Network programming

Download history 615/week @ 2024-08-12 1100/week @ 2024-08-19 1046/week @ 2024-08-26 1417/week @ 2024-09-02 856/week @ 2024-09-09 882/week @ 2024-09-16 1346/week @ 2024-09-23 1215/week @ 2024-09-30 526/week @ 2024-10-07 766/week @ 2024-10-14 1219/week @ 2024-10-21 1390/week @ 2024-10-28 1835/week @ 2024-11-04 1535/week @ 2024-11-11 2093/week @ 2024-11-18 1933/week @ 2024-11-25

7,569 downloads per month
Used in 32 crates (5 directly)

MIT/Apache and maybe LGPL-3.0-only

1.5MB
21K SLoC

tor-relay-selection

Logic to select Tor relays for specific purposes

Overview

The tor-relay-selection crate provides higher-level functions in order to select Tor relays for specific purposes, or check whether they are suitable for those purposes. It wraps lower-level functionality from tor-netdir.

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

Design

Our main types are RelayUsage, RelayExclusion, RelayRestriction, and RelaySelector.

A RelayUsage answers the question "what is this relay for?"

A RelayExclusion excludes one or more relays as having already been selected, or as sharing families with already-selected relays.

A RelayRestriction imposes additional restrictions on a relay.

A RelaySelector is a collection of a usage, an exclusion, and any number of restrictions.

In a RelaySelector, usages and restrictions can be strict or flexible. If we fail to pick a relay, and there are any flexible usages/restrictions, then we remove those usages/restrictions to produce a relaxed selector and we try again.

License: MIT OR Apache-2.0

Dependencies

~21–32MB
~487K SLoC