1个不稳定版本
0.1.0 | 2022年12月31日 |
---|
#9 in #ipfs-api
用于ipfs-api
12KB
79 行
ipfs-api
组件
名称 | 文档 | 库 |
---|---|---|
ipfs-api-prelude | ||
ipfs-api-backend-actix | ||
ipfs-api-backend-hyper | ||
ipfs-api (已弃用) |
使用Hyper/Actix连接到IPFS HTTP API的Rust库。
用法
使用Hyper
要使用Hyper后端,声明
[dependencies]
ipfs-api-backend-hyper = "0.6"
您可以选择指定with-hyper-rustls
或with-hyper-tls
(互斥)功能以启用TLS支持。
使用Actix
要使用Actix后端,声明
[dependencies]
ipfs-api-backend-actix = "0.7"
构建器模式
使用Hyper或Actix后端时,您可以通过指定with-builder
功能来启用用于构建请求的构建器模式。
用法(已弃用)
[dependencies]
ipfs-api = "0.17.0"
功能标志(已弃用)
您可以使用actix-web
作为后端而不是hyper
。
[dependencies]
ipfs-api = { version = "0.17.0", features = ["with-actix"], default-features = false }
您还可以选择使用rustls
而不是原生TLS
[dependencies]
ipfs-api = { version = "0.17.0", features = ["with-hyper-rustls"], default-features = false }
要启用构建器模式(默认)使用with-builder
功能
[dependencies]
ipfs-api = { version = "0.17.0", features = ["with-hyper-rustls", "with-builder"], default-features = false }
示例
将文件写入IPFS
使用Hyper
use ipfs_api::{IpfsApi, IpfsClient};
use std::io::Cursor;
#[tokio::main]
async fn main() {
let client = IpfsClient::default();
let data = Cursor::new("Hello World!");
match client.add(data).await {
Ok(res) => println!("{}", res.hash),
Err(e) => eprintln!("error adding file: {}", e)
}
}
使用Actix
use ipfs_api::{IpfsApi, IpfsClient};
use std::io::Cursor;
#[actix_rt::main]
async fn main() {
let client = IpfsClient::default();
let data = Cursor::new("Hello World!");
match client.add(data).await {
Ok(res) => println!("{}", res.hash),
Err(e) => eprintln!("error adding file: {}", e)
}
}
从IPFS读取文件
使用Hyper
use futures::TryStreamExt;
use ipfs_api::{IpfsApi, IpfsClient};
use std::io::{self, Write};
#[tokio::main]
async fn main() {
let client = IpfsClient::default();
match client
.get("/test/file.json")
.map_ok(|chunk| chunk.to_vec())
.try_concat()
.await
{
Ok(res) => {
let out = io::stdout();
let mut out = out.lock();
out.write_all(&res).unwrap();
}
Err(e) => eprintln!("error getting file: {}", e)
}
}
使用Actix
use futures::TryStreamExt;
use ipfs_api::{IpfsApi, IpfsClient};
use std::io::{self, Write};
#[actix_rt::main]
async fn main() {
let client = IpfsClient::default();
match client
.get("/test/file.json")
.map_ok(|chunk| chunk.to_vec())
.try_concat()
.await
{
Ok(res) => {
let out = io::stdout();
let mut out = out.lock();
out.write_all(&res).unwrap();
}
Err(e) => eprintln!("error getting file: {}", e)
}
}
其他示例
项目中还包括一些示例,我使用它们进行测试
要获取示例列表,请运行
$ cargo run --example
您可以使用cargo运行任何示例
$ cargo run --example add_file
许可
根据您的选择,许可为以下之一
- Apache许可证第2版 (LICENSE-APACHE 或 https://apache.ac.cn/licenses/LICENSE-2.0)
- MIT许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)
。
贡献
除非您明确声明,否则您提交的任何贡献,根据Apache-2.0许可证定义,应作为上述双重许可,不附加任何额外条款或条件。
依赖项
~82KB