BtBencode

BtBencode is a library which can help with Bencode encoding/decoding. Bencode is primarily used in BitTorrent related applications.

It uses the Serde library to serialize and deserialize Bencode data.

Documentation

• Latest API Docs

Installation

toml [dependencies] bt_bencode = "0.6.1"

Examples

An example serializing a standard Rust collection type and then deserializing into a custom type:

```rust use std::collections::BTreeMap; use serde_derive::Deserialize;

let mut dict: BTreeMap = BTreeMap::new(); dict.insert(String::from("url"), String::from("https://example.com/"));

let serializedbytes = btbencode::to_vec(&dict)?;

[derive(Deserialize)]

struct Info { url: String, }

let info: Info = btbencode::fromslice(&serializedbytes)?; asserteq!(info.url, "https://example.com/");

Ok::<(), bt_bencode::Error>(())

```

An example deserializing from a slice of bytes into a general Value representation and then from the Value instance into a more strongly typed data structure.

```rust use serde_derive::{Serialize, Deserialize};

use bt_bencode::Value;

[derive(Serialize, Deserialize)]

struct Info { t: String, url: String, }

let serializedbytes = btbencode::to_vec(&Info { t: String::from("query"), url: String::from("https://example.com/"), })?;

let value: Value = btbencode::fromslice(&serializedbytes)?; asserteq!(value["t"].asstr().unwrap(), "query"); asserteq!( value.get("url").andthen(|url| url.asstr()).unwrap(), "https://example.com/" );

let info: Info = btbencode::fromvalue(value)?; asserteq!(info.t, "query"); asserteq!(info.url, "https://example.com/");

Ok::<(), bt_bencode::Error>(())

```

License

Licensed under either of Apache License, Version 2.0 or MIT License at your option.

Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.