openalex 0.2.2

A rust module to to access metadata from openalex.org
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

use serde_derive::{Deserialize, Serialize};

use crate::{
    api_entities::{
        common_types::{
            CountByYear, DehydratedInstitution, DehydratedTopic, DehydratedTopicShare,
            International, Meta, Role, SummaryStats,
        },
        APIEntity,
    },
    impl_try_from_for_entity_response, impl_try_from_for_single_entity,
    utils::deserialize_opt_string_from_uint_null_missing,
};

#[derive(Deserialize, Serialize, Debug)]
pub struct AssociatedInstitution {
    #[serde(flatten)]
    pub institution: DehydratedInstitution,
    pub relationship: String,
}

#[derive(Deserialize, Serialize, Debug)]
pub struct Geo {
    pub city: String,
    pub geonames_city_id: Option<String>,
    pub region: Option<String>,
    pub country_code: Option<String>,
    pub country: String,
    pub latitude: f32,
    pub longitude: f32,
}

#[derive(Deserialize, Serialize, Debug)]
pub struct InstitutionIds {
    pub openalex: String,
    pub ror: String,
    pub grid: Option<String>,
    pub wikipedia: Option<String>,
    pub wikidata: Option<String>,
    #[serde(
        default,
        deserialize_with = "deserialize_opt_string_from_uint_null_missing"
    )]
    pub mag: Option<String>,
}

#[derive(Deserialize, Serialize, Debug)]
pub struct Repository {
    pub id: String,
    pub display_name: String,
    pub host_organization: String,
    pub host_organization_name: String,
    pub host_organization_lineage: Vec<String>,
}

#[derive(Deserialize, Serialize, Debug)]
pub struct Institution {
    pub associated_institutions: Vec<AssociatedInstitution>,
    pub cited_by_count: u32,
    pub country_code: Option<String>,
    pub counts_by_year: Vec<CountByYear>,
    pub created_date: String,
    pub display_name: String,
    pub display_name_acronyms: Vec<String>,
    pub display_name_alternatives: Vec<String>,
    pub geo: Geo,
    pub homepage_url: Option<String>,
    pub id: String,
    pub ids: InstitutionIds,
    pub image_thumbnail_url: Option<String>,
    pub image_url: Option<String>,
    pub international: International,
    pub lineage: Vec<String>,
    pub repositories: Vec<Repository>,
    pub roles: Vec<Role>,
    pub ror: String,
    pub summary_stats: SummaryStats,
    #[serde(rename = "type")]
    pub institution_type: String,
    pub updated_date: String,
    pub works_api_url: String,
    pub works_count: u32,

    pub topics: Vec<DehydratedTopic>,
    pub topic_share: Vec<DehydratedTopicShare>,
}

#[derive(Deserialize, Serialize, Debug)]
pub struct InstitutionResponse {
    pub meta: Meta,
    pub results: Vec<Institution>,
}

impl_try_from_for_single_entity!(Institution);
impl_try_from_for_entity_response!(InstitutionResponse);

impl APIEntity<Institution, InstitutionResponse> for Institution {
    const API_URL: &'static str = "https://api.openalex.org/institutions";
}