docs: update docs to reflect current code
This commit is contained in:
parent
914db27a98
commit
ce50afa635
3 changed files with 28 additions and 36 deletions
|
@ -1,4 +1,4 @@
|
||||||
//! Contains structs, enums and implementations for the main bunny.net API
|
//! Contains structs, enums and implementations for the main Bunny.net API
|
||||||
|
|
||||||
use url::Url;
|
use url::Url;
|
||||||
|
|
||||||
|
@ -24,7 +24,7 @@ pub struct BunnyClient {
|
||||||
}
|
}
|
||||||
|
|
||||||
impl BunnyClient {
|
impl BunnyClient {
|
||||||
/// Creates a new BunnyClient using the supplied `api_key`
|
/// Creates a new Bunny.net API Client using the supplied `api_key`
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{BunnyClient, error::Error};
|
/// use bunny_api_tokio::{BunnyClient, error::Error};
|
||||||
|
@ -54,12 +54,12 @@ impl BunnyClient {
|
||||||
/// Returns a list of countries and tax rates
|
/// Returns a list of countries and tax rates
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error};
|
/// use bunny_api_tokio::{BunnyClient, error::Error};
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// // Bunny.net api key
|
/// // Bunny.net api key
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = BunnyClient::new("api_key").await?;
|
||||||
///
|
///
|
||||||
/// let countries = client.get_country_list().await?;
|
/// let countries = client.get_country_list().await?;
|
||||||
///
|
///
|
||||||
|
@ -87,12 +87,12 @@ impl BunnyClient {
|
||||||
/// Returns a list of API Keys
|
/// Returns a list of API Keys
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error};
|
/// use bunny_api_tokio::{BunnyClient, error::Error};
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// // Bunny.net api key
|
/// // Bunny.net api key
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = BunnyClient::new("api_key").await?;
|
||||||
///
|
///
|
||||||
/// let api_keys = client.list_api_keys(1, 1000).await?;
|
/// let api_keys = client.list_api_keys(1, 1000).await?;
|
||||||
///
|
///
|
||||||
|
@ -124,12 +124,12 @@ impl BunnyClient {
|
||||||
/// Returns a list of Regions
|
/// Returns a list of Regions
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error};
|
/// use bunny_api_tokio::{BunnyClient, error::Error};
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// // Bunny.net api key
|
/// // Bunny.net api key
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = BunnyClient::new("api_key").await?;
|
||||||
///
|
///
|
||||||
/// let regions = client.region_list().await?;
|
/// let regions = client.region_list().await?;
|
||||||
///
|
///
|
||||||
|
@ -156,12 +156,12 @@ impl BunnyClient {
|
||||||
/// Purges a URL from the cache
|
/// Purges a URL from the cache
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error};
|
/// use bunny_api_tokio::{BunnyClient, error::Error};
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// // Bunny.net api key
|
/// // Bunny.net api key
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = BunnyClient::new("api_key").await?;
|
||||||
///
|
///
|
||||||
/// client.purge_url("https://url_to_purge.com".parse()?, false).await?;
|
/// client.purge_url("https://url_to_purge.com".parse()?, false).await?;
|
||||||
///
|
///
|
||||||
|
|
|
@ -20,7 +20,7 @@ pub struct EdgeStorageClient {
|
||||||
}
|
}
|
||||||
|
|
||||||
impl<'a> EdgeStorageClient {
|
impl<'a> EdgeStorageClient {
|
||||||
/// Creates a new EdgeStorageClient using the supplied `api_key`
|
/// Creates a new EdgeStorageClient
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{EdgeStorageClient, error::Error, edge_storage::Endpoint};
|
/// use bunny_api_tokio::{EdgeStorageClient, error::Error, edge_storage::Endpoint};
|
||||||
|
@ -53,19 +53,17 @@ impl<'a> EdgeStorageClient {
|
||||||
/// Uploads a file to the Storage Zone
|
/// Uploads a file to the Storage Zone
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error, edge_storage::Endpoint};
|
/// use bunny_api_tokio::{EdgeStorageClient, error::Error, edge_storage::Endpoint};
|
||||||
/// use tokio::fs;
|
/// use tokio::fs;
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = EdgeStorageClient::new("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
||||||
///
|
|
||||||
/// client.storage.init("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
|
||||||
///
|
///
|
||||||
/// let file_bytes = fs::read("path/to/file.png").await.unwrap();
|
/// let file_bytes = fs::read("path/to/file.png").await.unwrap();
|
||||||
///
|
///
|
||||||
/// // Will put a file in STORAGE_ZONE/images/file.png
|
/// // Will put a file in STORAGE_ZONE/images/file.png
|
||||||
/// client.storage.upload("/images/file.png", file_bytes.into()).await?;
|
/// client.upload("/images/file.png", file_bytes.into()).await?;
|
||||||
///
|
///
|
||||||
/// Ok(())
|
/// Ok(())
|
||||||
/// }
|
/// }
|
||||||
|
@ -91,18 +89,16 @@ impl<'a> EdgeStorageClient {
|
||||||
/// Downloads a file from the Storage Zone
|
/// Downloads a file from the Storage Zone
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error, edge_storage::Endpoint};
|
/// use bunny_api_tokio::{EdgeStorageClient, error::Error, edge_storage::Endpoint};
|
||||||
/// use tokio::fs;
|
/// use tokio::fs;
|
||||||
/// use tokio::io::AsyncWriteExt;
|
/// use tokio::io::AsyncWriteExt;
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = EdgeStorageClient::new("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
||||||
///
|
///
|
||||||
/// client.storage.init("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
|
||||||
///
|
|
||||||
/// // Will download the file STORAGE_ZONE/images/file.png
|
/// // Will download the file STORAGE_ZONE/images/file.png
|
||||||
/// let contents = client.storage.download("/images/file.png").await?;
|
/// let contents = client.download("/images/file.png").await?;
|
||||||
///
|
///
|
||||||
/// let mut file = fs::File::create("file.png").await.unwrap();
|
/// let mut file = fs::File::create("file.png").await.unwrap();
|
||||||
/// file.write_all(&contents).await.unwrap();
|
/// file.write_all(&contents).await.unwrap();
|
||||||
|
@ -130,16 +126,14 @@ impl<'a> EdgeStorageClient {
|
||||||
/// Deletes a file from the Storage Zone
|
/// Deletes a file from the Storage Zone
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error, edge_storage::Endpoint};
|
/// use bunny_api_tokio::{EdgeStorageClient, error::Error, edge_storage::Endpoint};
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = EdgeStorageClient::new("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
||||||
///
|
///
|
||||||
/// client.storage.init("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
|
||||||
///
|
|
||||||
/// // Will delete the file STORAGE_ZONE/images/file.png
|
/// // Will delete the file STORAGE_ZONE/images/file.png
|
||||||
/// client.storage.delete("/images/file.png").await?;
|
/// client.delete("/images/file.png").await?;
|
||||||
///
|
///
|
||||||
/// Ok(())
|
/// Ok(())
|
||||||
/// }
|
/// }
|
||||||
|
@ -163,16 +157,14 @@ impl<'a> EdgeStorageClient {
|
||||||
/// Lists files on the Storage Zone
|
/// Lists files on the Storage Zone
|
||||||
///
|
///
|
||||||
/// ```
|
/// ```
|
||||||
/// use bunny_api_tokio::{Client, error::Error, edge_storage::Endpoint};
|
/// use bunny_api_tokio::{EdgeStorageClient, error::Error, edge_storage::Endpoint};
|
||||||
///
|
///
|
||||||
/// #[tokio::main]
|
/// #[tokio::main]
|
||||||
/// async fn main() -> Result<(), Error> {
|
/// async fn main() -> Result<(), Error> {
|
||||||
/// let mut client = Client::new("api_key").await?;
|
/// let mut client = EdgeStorageClient::new("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
||||||
///
|
///
|
||||||
/// client.storage.init("storage_zone_api_key", Endpoint::Frankfurt, "MyStorageZone").await?;
|
|
||||||
///
|
|
||||||
/// // Will list the files in STORAGE_ZONE/images/
|
/// // Will list the files in STORAGE_ZONE/images/
|
||||||
/// let files = client.storage.list("/images/").await?;
|
/// let files = client.list("/images/").await?;
|
||||||
///
|
///
|
||||||
/// println!("{:#?}", files);
|
/// println!("{:#?}", files);
|
||||||
///
|
///
|
||||||
|
|
|
@ -8,11 +8,11 @@
|
||||||
//! 2. Start coding
|
//! 2. Start coding
|
||||||
//!
|
//!
|
||||||
//! ```
|
//! ```
|
||||||
//! use bunny_api_tokio::{Client, error::Error};
|
//! use bunny_api_tokio::{BunnyClient, error::Error};
|
||||||
//!
|
//!
|
||||||
//! #[tokio::main]
|
//! #[tokio::main]
|
||||||
//! async fn main() -> Result<(), Error> {
|
//! async fn main() -> Result<(), Error> {
|
||||||
//! let mut client = Client::new("api_key").await?;
|
//! let mut client = BunnyClient::new("api_key").await?;
|
||||||
//!
|
//!
|
||||||
//! Ok(())
|
//! Ok(())
|
||||||
//! }
|
//! }
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue