Crate letterboxd

This crate wraps the Letterboxd API which provides easy and flexible access to data on the Letterboxd.com website.

The client's API follows the following rules:

• All Letterboxd API calls are asynchronous.
• A client is always created from API key and secret. If auth token, is provided, client calls will be authenticated. Client can be created from username/password. A token can be set after client was created.
• API key and secret can be created from default environment variables.
• Except GET calls all methods include a path parameter.

Further, most of the Client's methods take a request struct, which is then serialized to url encoded parameters, and return a response type, which is deserialized from JSON. However, some methods omit the request or/and the response struct.

Entities are identified in the API by Letterboxd ID (or LID), an alpha-numeric string value that is returned where appropriate. For films, lists and reviews, the LID can also be found through the Letterboxd website as the path portion of the entity’s shareable boxd.it link.

For more information, cf. API docs at http://api-docs.letterboxd.com.

Examples

Client without authentication:

use tokio::runtime::Runtime;

let api_key_pair = letterboxd::ApiKeyPair::from_env().unwrap();
let client = letterboxd::Client::new(api_key_pair);

let req = letterboxd::FilmsRequest {
    per_page: Some(1),
    ..Default::default()
};
let resp = client.films(&req);

let mut rt = Runtime::new().unwrap();
let resp = rt.block_on(resp).unwrap();
println!("{:?}", resp);

Create and authenticate client with username/password:

use tokio::runtime::Runtime;

let api_key_pair = letterboxd::ApiKeyPair::from_env().unwrap();
let username = std::env::var("LETTERBOXD_USERNAME").unwrap();
let password = std::env::var("LETTERBOXD_PASSWORD").unwrap();

let res = async {
    let client = letterboxd::Client::authenticate(api_key_pair, &username, &password).await?;
    // token can be retrieved after authentication for e.g. caching it on disk
    println!("{:?}", client.token().unwrap());

    let req = letterboxd::FilmRelationshipUpdateRequest {
        watched: Some(true),
        ..Default::default()
    };
    client.update_film_relationship("2a9q", &req).await?; // Fight Club

    Ok::<_, letterboxd::Error>(())
};

let mut rt = Runtime::new().unwrap();
let resp = rt.block_on(res).unwrap();
println!("{:?}", resp);

Structs

AccessToken
ApiKeyPair	API key/secret pair.
Client	Letterboxd asynchronous client.
CommentCreationRequest
Contributor
ContributorSummary
DiaryDetails
Error	Error type returned by Client.
Film
FilmAvailability
FilmAvailabilityResponse
FilmContributions
FilmIdentifier
FilmRelationship
FilmRelationshipUpdateRequest	When PATCHing a film relationship, you may send all of the current property struct values, or just those you wish to change. Properties that violate business rules (see watched below) or contain invalid values will be ignored.
FilmRelationshipUpdateResponse
FilmServicesResponse
FilmStatistics
FilmStatisticsCounts
FilmSummary
FilmTrailer
FilmsRequest
FilmsResponse
Genre
GenresResponse
Image
ImageSize
List
ListCreateEntry
ListCreateResponse
ListCreationRequest
ListEntriesRequest
ListEntriesResponse
ListEntry
ListEntrySummary
ListIdentifier
ListSummary
ListUpdateEntry
ListUpdateRequest
ListUpdateResponse
ListsRequest
ListsResponse
LogEntry
MemberFilmRelationship
MemberFilmRelationshipsRequest
MemberFilmRelationshipsResponse
MemberSummary
Pronoun
RatingsHistogramBar
Review
SearchRequest
SearchResponse
Service
Tag

Enums

AbstractSearchItem
ContributionType
Country
FilmAvailabilityService
FilmRelationshipType
FilmRelationshipUpdateMessage
FilmRelationshipUpdateMessageCode
FilmRequestSort
FilmStatus
IncludeFriends
Link
ListCreateMessage
ListCreateMessageCode
ListEntriesRequestSort
ListMemberRelationship
ListRequestFilter
ListRequestSort
ListStatus
ListUpdateMessage
ListUpdateMessageCode
MemberFilmRelationshipsRequestSort
MemberStatus
SearchMethod
SearchResultType
ThirdPartyService
WatchlistSort

Type Definitions

Cursor	A cursor is a String value provided by the API. It should be treated as an opaque value — don’t change it.
Result	Result type returned by Client.