citations 0.1.0

Structs to store citations and functions to create formatted citations.
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

use chrono::naive::NaiveDate;

/// Struct to store all of the information about a citation.
#[derive(Clone)]
pub struct Citation {
    /// The title of the publication.
    pub title: Option<String>,
    /// The list of contributors to the publication. 
    pub contributors: Option<Vec<Contributor>>,
    /// The date of publication.
    pub date: Option<NaiveDate>,
    /// The date the publication was accessed on.
    pub accessed: Option<NaiveDate>,
    /// The ISBN of the publication.
    pub isbn: Option<String>,
    /// The publisher of the publication.
    pub publisher: Option<String>,
    /// The city where the publication was published.
    pub city_published: Option<String>,
    /// The volume of the publication.
    pub volume: Option<String>,
    /// The issue of the publication.
    pub issue: Option<String>,
    /// The chapter cited.
    pub chapter: Option<String>,
    /// The pages cited.
    pub pages: Option<(u32, Option<u32>)>,
    /// The URL of the publication.
    pub url: Option<String>,
    /// The source of the publication.
    pub source: Option<String>,
    /// The number of the publication.
    pub number: Option<String>,
    /// The language of the publication.
    pub language: Option<String>,
    /// The edition of the publication.
    pub edition: Option<String>,
    /// The DOI of the publication.
    pub doi: Option<String>,
}

/// Struct to store information about a contributor to a publication.
#[derive(Clone)]
pub struct Contributor {
    /// Whether the contributor is an organization or a person. 
    /// True if the contributor is an organization, false if the contributor is a person.
    pub organization: bool,
    /// The last name of the contributor.
    pub last_name: Option<String>,
    /// The first name of the contributor.
    /// If the contributor is an organization, this field is used for the name of the organization.
    pub name: Option<String>,
    /// The middle name of the contributor.
    pub middle_name: Option<String>,
    /// The suffix of the contributor.
    pub suffix: Option<String>,
    /// The position of the contributor. 
    pub position: ContributorType,
}

/// Enum to store the type of contributor.
#[derive(Clone, Debug, PartialEq)]
pub enum ContributorType {
    /// The contributor is an author.
    Author,
    /// The contributor is an authority.
    Authority,
    /// The contributor is an editor.
    Editor,
    /// The contributor is a translator.
    Translator,
    /// The contributor is a reviewer.
    Reviewer,
    /// The contributor is a director.
    Director,
    /// The contributor is a composer.
    Composer,
}