coctus 0.3.0

Command line tool for playing CodinGame puzzles and Clash of Code
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

mod public_handle;
mod testcase;

pub use public_handle::PublicHandle;
use serde::{Deserialize, Serialize};
use testcase::deserialize_testcases;
pub use testcase::Testcase;

/// `Clash` represents a deserialized Clash of Code or I/O puzzle.
#[derive(Debug, Serialize, Deserialize)]
pub struct Clash {
    id: u32,
    #[serde(rename = "publicHandle")]
    public_handle: PublicHandle,
    #[serde(rename = "lastVersion")]
    last_version: ClashVersion,
    #[serde(rename = "type")]
    puzzle_type: PuzzleType,
    #[serde(rename = "upVotes")]
    upvotes: i32,
    #[serde(rename = "downVotes")]
    downvotes: i32,
}

#[derive(Debug, Serialize, Deserialize)]
enum PuzzleType {
    #[serde(rename = "CLASHOFCODE")]
    Clash,
    #[serde(rename = "PUZZLE_INOUT")]
    ClassicInOut,
}

#[derive(Debug, Serialize, Deserialize)]
struct ClashVersion {
    version: u32,
    data: ClashData,
    #[serde(rename = "statementHTML")]
    statement_html: Option<String>,
}

#[derive(Debug, Serialize, Deserialize)]
struct ClashData {
    title: String,

    // apparently some of these fields are missing in very old clashes, default to false
    #[serde(default)]
    fastest: bool,
    #[serde(default)]
    reverse: bool,
    #[serde(default)]
    shortest: bool,

    statement: String,

    #[serde(rename = "testCases")]
    #[serde(deserialize_with = "deserialize_testcases")]
    testcases: Vec<Testcase>,

    constraints: Option<String>,
    #[serde(rename = "stubGenerator")]
    stub_generator: Option<String>,
    #[serde(rename = "inputDescription")]
    input_description: String,
    #[serde(rename = "outputDescription")]
    output_description: String,
}

impl Clash {
    pub fn testcases(&self) -> &Vec<Testcase> {
        &self.last_version.data.testcases
    }

    pub fn codingame_link(&self) -> String {
        format!("https://www.codingame.com/contribute/view/{}", self.public_handle)
    }

    pub fn title(&self) -> &str {
        &self.last_version.data.title
    }

    pub fn statement(&self) -> &str {
        &self.last_version.data.statement
    }

    pub fn constraints(&self) -> Option<&str> {
        self.last_version.data.constraints.as_deref()
    }

    pub fn stub_generator(&self) -> Option<&str> {
        self.last_version.data.stub_generator.as_deref()
    }

    pub fn input_description(&self) -> &str {
        &self.last_version.data.input_description
    }

    pub fn output_description(&self) -> &str {
        &self.last_version.data.output_description
    }

    pub fn is_reverse(&self) -> bool {
        self.last_version.data.reverse
    }

    pub fn is_fastest(&self) -> bool {
        self.last_version.data.fastest
    }

    pub fn is_shortest(&self) -> bool {
        self.last_version.data.shortest
    }

    pub fn is_reverse_only(&self) -> bool {
        self.is_reverse() && !self.is_fastest() && !self.is_shortest()
    }
}