open-library-api-rs 0.1.0

Async Rust client for the Open Library API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

// v0.0.1
use serde::{Deserialize, Serialize};

use super::common::{Key, Link, TextOrValue};

/// A Work is a top-level creative entity (e.g. a novel).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Work {
    pub key: String,
    #[serde(default)]
    pub title: Option<String>,
    #[serde(default)]
    pub subtitle: Option<String>,
    #[serde(default)]
    pub description: Option<TextOrValue>,
    #[serde(default)]
    pub authors: Option<Vec<WorkAuthorRef>>,
    #[serde(default)]
    pub subjects: Option<Vec<String>>,
    #[serde(default)]
    pub subject_places: Option<Vec<String>>,
    #[serde(default)]
    pub subject_people: Option<Vec<String>>,
    #[serde(default)]
    pub subject_times: Option<Vec<String>>,
    #[serde(default)]
    pub covers: Option<Vec<i64>>,
    #[serde(default)]
    pub links: Option<Vec<Link>>,
    #[serde(default)]
    pub first_publish_date: Option<String>,
    #[serde(default)]
    pub created: Option<DateValue>,
    #[serde(default)]
    pub last_modified: Option<DateValue>,
    #[serde(default)]
    pub latest_revision: Option<i64>,
    #[serde(default)]
    pub revision: Option<i64>,
}

/// Author reference inside a Work.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WorkAuthorRef {
    pub author: Key,
    #[serde(rename = "type")]
    #[serde(default)]
    pub role: Option<Key>,
}

/// Timestamp wrapper used by the Open Library API for `created` / `last_modified`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DateValue {
    #[serde(rename = "type")]
    pub kind: String,
    pub value: String,
}

/// Response from `GET /works/{id}/editions.json`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WorkEditions {
    #[serde(default)]
    pub entries: Vec<WorkEditionEntry>,
    #[serde(default)]
    pub size: Option<u64>,
    #[serde(default)]
    pub links: Option<super::common::PaginationLinks>,
}

/// A minimal edition entry returned in the work editions list.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WorkEditionEntry {
    pub key: String,
    #[serde(default)]
    pub title: Option<String>,
    #[serde(default)]
    pub covers: Option<Vec<i64>>,
    #[serde(default)]
    pub languages: Option<Vec<Key>>,
    #[serde(default)]
    pub publish_date: Option<String>,
    #[serde(default)]
    pub publishers: Option<Vec<String>>,
    #[serde(default)]
    pub isbn_10: Option<Vec<String>>,
    #[serde(default)]
    pub isbn_13: Option<Vec<String>>,
}

/// Response from `GET /works/{id}/ratings.json`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WorkRatings {
    #[serde(default)]
    pub summary: Option<RatingsSummary>,
    #[serde(default)]
    pub counts: Option<RatingsCounts>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RatingsSummary {
    #[serde(default)]
    pub average: Option<f64>,
    #[serde(default)]
    pub count: Option<u64>,
    #[serde(default)]
    pub sortable: Option<f64>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct RatingsCounts {
    #[serde(rename = "1", default)]
    pub one: Option<u64>,
    #[serde(rename = "2", default)]
    pub two: Option<u64>,
    #[serde(rename = "3", default)]
    pub three: Option<u64>,
    #[serde(rename = "4", default)]
    pub four: Option<u64>,
    #[serde(rename = "5", default)]
    pub five: Option<u64>,
}

/// Response from `GET /works/{id}/bookshelves.json`.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WorkBookshelves {
    #[serde(default)]
    pub counts: Option<BookshelfCounts>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct BookshelfCounts {
    #[serde(default)]
    pub want_to_read: Option<u64>,
    #[serde(default)]
    pub currently_reading: Option<u64>,
    #[serde(default)]
    pub already_read: Option<u64>,
}