6 releases

0.0.6 Mar 14, 2024
0.0.5 Mar 5, 2024
0.0.4 Jul 7, 2023
0.0.2 Apr 26, 2023

#8 in #retrieve

Download history 37/week @ 2023-12-18 1/week @ 2023-12-25 24/week @ 2024-01-01 39/week @ 2024-01-15 49/week @ 2024-01-22 60/week @ 2024-01-29 17/week @ 2024-02-19 67/week @ 2024-02-26 168/week @ 2024-03-04 176/week @ 2024-03-11 14/week @ 2024-03-18 110/week @ 2024-04-01

307 downloads per month

MIT license

18KB
324 lines

Introduction

This crate provides a simple interface for fetching oEmbed data from known providers based on the oembed specification.

Usage

use oembed_rs::{find_provider, fetch, ConsumerRequest};

async fn example() {
    let url = "https://twitter.com/user/status/1000000000000000000";
    let (_, endpoint) = find_provider(url).expect("unknown provider");

    let response = fetch(
       &endpoint.url,
       ConsumerRequest {
           url,
           max_width: Some(1000),
           max_height: Some(500),
           ..ConsumerRequest::default()
       },
    )
    .await
    .expect("failed to fetch oembed data");
}

Roadmap

  • Add support for custom providers
  • Return known errors from the specification properly
  • Support the discovery flow

lib.rs:

Documentation

This crate provides a simple interface for fetching oEmbed data from known providers.

Example

use oembed_rs::{find_provider, fetch, ConsumerRequest};

async fn example() {
    let url = "https://twitter.com/user/status/1000000000000000000";
    let (_, endpoint) = find_provider(url).expect("unknown provider");

    let response = fetch(
       &endpoint.url,
       ConsumerRequest {
           url,
           max_width: Some(1000),
           max_height: Some(500),
           ..ConsumerRequest::default()
       },
    )
    .await
    .expect("failed to fetch oembed data");
}

Dependencies

~4–17MB
~247K SLoC