#tor #arti #encoding


Helpers for encoding and decoding byte-orientted data, as used by Tor

16 unstable releases (7 breaking)

0.7.0 May 3, 2023
0.6.3 Mar 31, 2023
0.6.2 Feb 28, 2023
0.6.0 Nov 30, 2022
0.0.0 Jun 24, 2021

#238 in Encoding

Download history 236/week @ 2023-02-04 203/week @ 2023-02-11 483/week @ 2023-02-18 373/week @ 2023-02-25 214/week @ 2023-03-04 119/week @ 2023-03-11 236/week @ 2023-03-18 274/week @ 2023-03-25 210/week @ 2023-04-01 165/week @ 2023-04-08 198/week @ 2023-04-15 75/week @ 2023-04-22 345/week @ 2023-04-29 201/week @ 2023-05-06 196/week @ 2023-05-13 89/week @ 2023-05-20

838 downloads per month
Used in 26 crates (7 directly)




Utilities to decode/encode things into bytes.


The tor-bytes crate is part of Arti, a project to implement Tor in Rust. Other crates in Arti use it to build and handle all the byte-encoded objects from the Tor protocol. For textual directory items, see the [tor-netdoc] crate.

This crate is generally useful for encoding and decoding byte-oriented formats that are not regular enough to qualify for serde, and not complex enough to need a full meta-language. It is probably not suitable for handling anything bigger than a few kilobytes in size.


The Reader/Writer traits in std::io are more appropriate for operations that can fail because of some IO problem. This crate can't handle that: it is for handling things that are already in memory.

TODO: Look into using the "bytes" crate more here.

TODO: The "untrusted" crate has similar goals to our [Reader], but takes more steps to make sure it can never panic. Perhaps we should see if we can learn any tricks from it.

TODO: Do we really want to keep Reader as a struct and Writer as a trait?

Contents and concepts

This crate is structured around four key types:

  • [Reader]: A view of a byte slice, from which data can be decoded.
  • [Writer]: Trait to represent a growable buffer of bytes. (Vec<u8> and [bytes::BytesMut] implement this.)
  • [Writeable]: Trait for an object that can be encoded onto a [Writer]
  • [Readable]: Trait for an object that can be decoded from a [Reader].

Every object you want to encode or decode should implement [Writeable] or [Readable] respectively.

Once you implement these traits, you can use Reader and Writer to handle your type, and other types that are built around it.

License: MIT OR Apache-2.0


~263K SLoC