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

#2046 in Network programming

Download history 770/week @ 2024-08-16 1144/week @ 2024-08-23 1256/week @ 2024-08-30 1227/week @ 2024-09-06 851/week @ 2024-09-13 916/week @ 2024-09-20 1447/week @ 2024-09-27 786/week @ 2024-10-04 757/week @ 2024-10-11 1040/week @ 2024-10-18 1035/week @ 2024-10-25 2219/week @ 2024-11-01 1092/week @ 2024-11-08 2402/week @ 2024-11-15 1486/week @ 2024-11-22 1982/week @ 2024-11-29

7,162 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
~489K SLoC