7 releases

0.0.7 Aug 29, 2024
0.0.6 Mar 14, 2024
0.0.4 Jul 7, 2023
0.0.2 Apr 26, 2023

#4 in #retrieve

Download history 7/week @ 2024-07-28 119/week @ 2024-08-25 10/week @ 2024-09-01 15/week @ 2024-09-15 21/week @ 2024-09-22 14/week @ 2024-09-29

51 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–19MB
~228K SLoC