caniuse-serde 0.0.6

A more modern wrapping for parsing and querying the caniuse.com JSON database using Serde 1.0
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

// This file is part of caniuse-serde. It is subject to the license terms in the COPYRIGHT file found in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/caniuse-serde/master/COPYRIGHT. No part of predicator, including this file, may be copied, modified, propagated, or distributed except according to the terms contained in the COPYRIGHT file.
// Copyright © 2017 The developers of caniuse-serde. See the COPYRIGHT file in the top-level directory of this distribution and at https://raw.githubusercontent.com/lemonrock/caniuse-serde/master/COPYRIGHT.


#[derive(Deserialize, Debug, Clone)]
struct FeatureDetail
{
	#[serde(default)] title: String,
	#[serde(default)] description: String,
	#[serde(with = "url_serde", rename = "spec")] specification_url: Url,
	#[serde(default)] status: Status,
	#[serde(default)] links: Vec<Link>,
	#[serde(default)] bugs: Vec<Bug>,
	#[serde(default)] categories: Vec<Category>,
	#[serde(default, rename = "stats")] implementations_by_agents: HashMap<AgentName, BTreeMap<Version, SupportDetail>>,
	#[serde(default)] notes: String,
	#[serde(default, rename = "notes_by_num")] notes_by_one_based_number: BTreeMap<u8, String>,
	#[serde(default, deserialize_with = "FeatureDetail::deserialize_parent")] parent: Option<FeatureName>,
	#[serde(default, rename="usage_perc_y")] supported_by_default_usage: UsagePercentage,
	#[serde(default, rename="usage_perc_a")] almost_supported_usage: UsagePercentage,
	#[serde(default, rename="ucprefix")] upper_case_prefix: bool,
	#[serde(default, deserialize_with = "FeatureDetail::deserialize_comma_separated_strings")] keywords: Vec<String>,
	#[serde(default, deserialize_with = "FeatureDetail::deserialize_comma_separated_strings", rename="ie_id")] internet_explorer_feature_identifiers: Vec<String>,
	#[serde(default, deserialize_with = "FeatureDetail::deserialize_comma_separated_strings", rename="chrome_id")] blink_feature_identifiers: Vec<String>,
	#[serde(default, deserialize_with = "FeatureDetail::deserialize_comma_separated_strings", rename="firefox_id")] firefox_feature_identifiers: Vec<String>,
	#[serde(default, deserialize_with = "FeatureDetail::deserialize_comma_separated_strings", rename="webkit_id")] webkit_feature_identifiers: Vec<String>,
	#[serde(default = "FeatureDetail::shown_default")] shown: bool,
}

impl FeatureDetail
{
	#[inline(always)]
	fn deserialize_parent<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Option<FeatureName>, D::Error>
	{
		struct ParentVisitor;
		
		impl<'de> Visitor<'de> for ParentVisitor
		{
			type Value = Option<FeatureName>;
			
			fn expecting(&self, formatter: &mut Formatter) -> fmt::Result
			{
				formatter.write_str("a string which contains comma separated sub-strings")
			}
			
			fn visit_str<E: de::Error>(self, v: &str) -> Result<Self::Value, E>
			{
				if v.is_empty()
				{
					Ok(None)
				}
				else
				{
					Ok(Some(FeatureName(v.to_owned())))
				}
			}
			
			fn visit_string<E: de::Error>(self, v: String) -> Result<Self::Value, E>
			{
				if v.is_empty()
				{
					Ok(None)
				}
				else
				{
					Ok(Some(FeatureName(v)))
				}
			}
		}
		
		deserializer.deserialize_str(ParentVisitor)
	}
	
	#[inline(always)]
	fn deserialize_comma_separated_strings<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Vec<String>, D::Error>
	{
		struct CommaSeparatedStringsVisitor;
		
		impl<'de> Visitor<'de> for CommaSeparatedStringsVisitor
		{
			type Value = Vec<String>;
			
			fn expecting(&self, formatter: &mut Formatter) -> fmt::Result
			{
				formatter.write_str("a string which contains comma separated sub-strings")
			}
			
			fn visit_str<E: de::Error>(self, v: &str) -> Result<Self::Value, E>
			{
				if v.is_empty()
				{
					return Ok(vec![]);
				}
				
				let mut strings = Vec::with_capacity(16);
				for string in v.split(',')
				{
					let trimmed = string.trim();
					if !trimmed.is_empty()
					{
						strings.push(trimmed.to_owned());
					}
				}
				strings.shrink_to_fit();
				Ok(strings)
			}
		}
		
		deserializer.deserialize_str(CommaSeparatedStringsVisitor)
	}
	
	#[inline(always)]
	fn shown_default() -> bool
	{
		true
	}
}