rust-wistia

rust-wistia is a rust crate which provides an async wrapper API that lets you easily interact with the Wistia API.

This is inspired in part by [wystia], a Python library I created for the Wistia API.

This crate works with Cargo with a Cargo.toml like:

toml [dependencies] rust-wistia = "0.2.1" tokio = { version = "1", features = ["full"] }

Table of Contents

• Getting Started
• Examples
• Dependencies and Features
• Contributing
• License
• Authors

Getting Started

Getting started with the rust-wistia library is easy:

1. Set WISTIAAPITOKEN in your environment; you can also use the from_token constructor to explicitly set the token value. Find out more about Authentication and Access Tokens in the Wistia API Documentation.

2. Add some usage to your application.

   Here's an example of uploading a media, via a public URL link:

   ```rust use rust_wistia::UrlUploader;

   [tokio::main]

   async fn main() -> std::result::Result<(), Box> { let res = UrlUploader::new("my-url-link")? .name("My Video Name") .send() .await?;

   println!("Response: {res:#?}");

   // Print out some useful attributes println!("Video ID: {}", res.hashed_id);

   Ok(()) } ```

Examples

You can check out sample usage of API methods in the examples/ folder in the project repo on GitHub.

Dependencies and Features

This library uses only the minimum required dependencies, in order to keep the overall size small. This crate uses [hyper][] and [hyper-rustls][] internally, to make HTTPS requests to the Wistia API.

While hyper-rustls was chosen as the default TLS implementation because it works without issue when cross-compiling for the x86_64-unknown-linux-musl target as is common for AWS Lambda deployments, it is still possible to instead use the native [hyper-tls][] implementation, which relies on OpenSSL.

To do this, disable the default "rust-tls" feature and enable the "native-tls" feature:

toml [dependencies] rust-wistia = { version = "0.2.1", default-features = false, features = ["native-tls", "logging", "serde-std"] }

Contributing

Contributions are welcome! Open a pull request to fix a bug, or open an issue to discuss a new feature or change.

Check out the Contributing section in the docs for more info.

License

This project is proudly licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT).

rust-wistia can be distributed according to the MIT license. Contributions will be accepted under the same license.

Authors

• Ritvik Nag