Anki/rslib/src/config/mod.rs
2021-03-30 23:44:35 +02:00

367 lines
10 KiB
Rust

// Copyright: Ankitects Pty Ltd and contributors
// License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html
mod bool;
mod deck;
mod notetype;
pub(crate) mod schema11;
mod string;
pub(crate) mod undo;
pub use self::{bool::BoolKey, string::StringKey};
use crate::browser_table;
use crate::prelude::*;
use serde::{de::DeserializeOwned, Serialize};
use serde_derive::Deserialize;
use serde_repr::{Deserialize_repr, Serialize_repr};
use slog::warn;
use strum::IntoStaticStr;
/// Only used when updating/undoing.
#[derive(Debug)]
pub(crate) struct ConfigEntry {
pub key: String,
pub value: Vec<u8>,
pub usn: Usn,
pub mtime: TimestampSecs,
}
impl ConfigEntry {
pub(crate) fn boxed(key: &str, value: Vec<u8>, usn: Usn, mtime: TimestampSecs) -> Box<Self> {
Box::new(Self {
key: key.into(),
value,
usn,
mtime,
})
}
}
#[derive(IntoStaticStr)]
#[strum(serialize_all = "camelCase")]
pub(crate) enum ConfigKey {
CreationOffset,
FirstDayOfWeek,
LocalOffset,
Rollover,
#[strum(to_string = "timeLim")]
AnswerTimeLimitSecs,
#[strum(to_string = "sortType")]
BrowserSortKind,
#[strum(to_string = "noteSortType")]
BrowserNoteSortKind,
#[strum(to_string = "curDeck")]
CurrentDeckId,
#[strum(to_string = "curModel")]
CurrentNotetypeId,
#[strum(to_string = "lastUnburied")]
LastUnburiedDay,
#[strum(to_string = "collapseTime")]
LearnAheadSecs,
#[strum(to_string = "newSpread")]
NewReviewMix,
#[strum(to_string = "nextPos")]
NextNewCardPosition,
#[strum(to_string = "schedVer")]
SchedulerVersion,
DesktopBrowserCardColumns,
DesktopBrowserNoteColumns,
}
#[derive(PartialEq, Serialize_repr, Deserialize_repr, Clone, Copy, Debug)]
#[repr(u8)]
pub(crate) enum SchedulerVersion {
V1 = 1,
V2 = 2,
}
impl Collection {
/// Get config item, returning None if missing/invalid.
pub(crate) fn get_config_optional<'a, T, K>(&self, key: K) -> Option<T>
where
T: DeserializeOwned,
K: Into<&'a str>,
{
let key = key.into();
match self.storage.get_config_value(key) {
Ok(Some(val)) => Some(val),
Ok(None) => None,
Err(e) => {
warn!(self.log, "error accessing config key"; "key"=>key, "err"=>?e);
None
}
}
}
// /// Get config item, returning default value if missing/invalid.
pub(crate) fn get_config_default<T, K>(&self, key: K) -> T
where
T: DeserializeOwned + Default,
K: Into<&'static str>,
{
self.get_config_optional(key).unwrap_or_default()
}
pub(crate) fn set_config<'a, T: Serialize, K>(&mut self, key: K, val: &T) -> Result<()>
where
K: Into<&'a str>,
{
let entry = ConfigEntry::boxed(
key.into(),
serde_json::to_vec(val)?,
self.usn()?,
TimestampSecs::now(),
);
self.set_config_undoable(entry)
}
pub(crate) fn remove_config<'a, K>(&mut self, key: K) -> Result<()>
where
K: Into<&'a str>,
{
self.remove_config_undoable(key.into())
}
/// Remove all keys starting with provided prefix, which must end with '_'.
pub(crate) fn remove_config_prefix(&self, key: &str) -> Result<()> {
for (key, _val) in self.storage.get_config_prefix(key)? {
self.storage.remove_config(&key)?;
}
Ok(())
}
pub(crate) fn get_browser_sort_kind(&self) -> SortKind {
self.get_config_default(ConfigKey::BrowserSortKind)
}
pub(crate) fn get_browser_note_sort_kind(&self) -> SortKind {
self.get_config_default(ConfigKey::BrowserNoteSortKind)
}
pub(crate) fn get_desktop_browser_card_columns(&self) -> Option<Vec<browser_table::Column>> {
self.get_config_optional(ConfigKey::DesktopBrowserCardColumns)
}
pub(crate) fn set_desktop_browser_card_columns(
&mut self,
columns: Vec<browser_table::Column>,
) -> Result<()> {
self.set_config(ConfigKey::DesktopBrowserCardColumns, &columns)
}
pub(crate) fn get_desktop_browser_note_columns(&self) -> Option<Vec<browser_table::Column>> {
self.get_config_optional(ConfigKey::DesktopBrowserNoteColumns)
}
pub(crate) fn set_desktop_browser_note_columns(
&mut self,
columns: Vec<browser_table::Column>,
) -> Result<()> {
self.set_config(ConfigKey::DesktopBrowserNoteColumns, &columns)
}
pub(crate) fn get_creation_utc_offset(&self) -> Option<i32> {
self.get_config_optional(ConfigKey::CreationOffset)
}
pub(crate) fn set_creation_utc_offset(&mut self, mins: Option<i32>) -> Result<()> {
if let Some(mins) = mins {
self.set_config(ConfigKey::CreationOffset, &mins)
} else {
self.remove_config(ConfigKey::CreationOffset)
}
}
pub(crate) fn get_configured_utc_offset(&self) -> Option<i32> {
self.get_config_optional(ConfigKey::LocalOffset)
}
pub(crate) fn set_configured_utc_offset(&mut self, mins: i32) -> Result<()> {
self.set_config(ConfigKey::LocalOffset, &mins)
}
pub(crate) fn get_v2_rollover(&self) -> Option<u8> {
self.get_config_optional::<u8, _>(ConfigKey::Rollover)
.map(|r| r.min(23))
}
pub(crate) fn set_v2_rollover(&mut self, hour: u32) -> Result<()> {
self.set_config(ConfigKey::Rollover, &hour)
}
pub(crate) fn get_next_card_position(&self) -> u32 {
self.get_config_default(ConfigKey::NextNewCardPosition)
}
pub(crate) fn get_and_update_next_card_position(&mut self) -> Result<u32> {
let pos: u32 = self
.get_config_optional(ConfigKey::NextNewCardPosition)
.unwrap_or_default();
self.set_config(ConfigKey::NextNewCardPosition, &pos.wrapping_add(1))?;
Ok(pos)
}
pub(crate) fn set_next_card_position(&mut self, pos: u32) -> Result<()> {
self.set_config(ConfigKey::NextNewCardPosition, &pos)
}
pub(crate) fn scheduler_version(&self) -> SchedulerVersion {
self.get_config_optional(ConfigKey::SchedulerVersion)
.unwrap_or(SchedulerVersion::V1)
}
/// Caution: this only updates the config setting.
pub(crate) fn set_scheduler_version_config_key(&mut self, ver: SchedulerVersion) -> Result<()> {
self.set_config(ConfigKey::SchedulerVersion, &ver)
}
pub(crate) fn learn_ahead_secs(&self) -> u32 {
self.get_config_optional(ConfigKey::LearnAheadSecs)
.unwrap_or(1200)
}
pub(crate) fn set_learn_ahead_secs(&mut self, secs: u32) -> Result<()> {
self.set_config(ConfigKey::LearnAheadSecs, &secs)
}
pub(crate) fn get_new_review_mix(&self) -> NewReviewMix {
match self.get_config_default::<u8, _>(ConfigKey::NewReviewMix) {
1 => NewReviewMix::ReviewsFirst,
2 => NewReviewMix::NewFirst,
_ => NewReviewMix::Mix,
}
}
pub(crate) fn set_new_review_mix(&mut self, mix: NewReviewMix) -> Result<()> {
self.set_config(ConfigKey::NewReviewMix, &(mix as u8))
}
pub(crate) fn get_first_day_of_week(&self) -> Weekday {
self.get_config_optional(ConfigKey::FirstDayOfWeek)
.unwrap_or(Weekday::Sunday)
}
pub(crate) fn set_first_day_of_week(&mut self, weekday: Weekday) -> Result<()> {
self.set_config(ConfigKey::FirstDayOfWeek, &weekday)
}
pub(crate) fn get_answer_time_limit_secs(&self) -> u32 {
self.get_config_optional(ConfigKey::AnswerTimeLimitSecs)
.unwrap_or_default()
}
pub(crate) fn set_answer_time_limit_secs(&mut self, secs: u32) -> Result<()> {
self.set_config(ConfigKey::AnswerTimeLimitSecs, &secs)
}
pub(crate) fn get_last_unburied_day(&self) -> u32 {
self.get_config_optional(ConfigKey::LastUnburiedDay)
.unwrap_or_default()
}
pub(crate) fn set_last_unburied_day(&mut self, day: u32) -> Result<()> {
self.set_config(ConfigKey::LastUnburiedDay, &day)
}
}
#[derive(Deserialize, PartialEq, Debug, Clone, Copy)]
#[serde(rename_all = "camelCase")]
pub enum SortKind {
NoteCards,
#[serde(rename = "noteCrt")]
NoteCreation,
NoteDue,
NoteEase,
#[serde(rename = "noteIvl")]
NoteInterval,
NoteLapses,
NoteMod,
#[serde(rename = "noteFld")]
NoteField,
NoteReps,
#[serde(rename = "note")]
Notetype,
NoteTags,
CardMod,
CardReps,
CardDue,
CardEase,
CardLapses,
#[serde(rename = "cardIvl")]
CardInterval,
#[serde(rename = "deck")]
CardDeck,
#[serde(rename = "template")]
CardTemplate,
}
impl Default for SortKind {
fn default() -> Self {
Self::NoteCreation
}
}
// 2021 scheduler moves this into deck config
pub(crate) enum NewReviewMix {
Mix = 0,
ReviewsFirst = 1,
NewFirst = 2,
}
impl Default for NewReviewMix {
fn default() -> Self {
NewReviewMix::Mix
}
}
#[derive(PartialEq, Serialize_repr, Deserialize_repr, Clone, Copy)]
#[repr(u8)]
pub(crate) enum Weekday {
Sunday = 0,
Monday = 1,
Friday = 5,
Saturday = 6,
}
#[cfg(test)]
mod test {
use super::SortKind;
use crate::collection::open_test_collection;
use crate::decks::DeckId;
#[test]
fn defaults() {
let col = open_test_collection();
assert_eq!(col.get_current_deck_id(), DeckId(1));
assert_eq!(col.get_browser_sort_kind(), SortKind::NoteField);
}
#[test]
fn get_set() {
let mut col = open_test_collection();
// missing key
assert_eq!(col.get_config_optional::<Vec<i64>, _>("test"), None);
// normal retrieval
col.set_config("test", &vec![1, 2]).unwrap();
assert_eq!(
col.get_config_optional::<Vec<i64>, _>("test"),
Some(vec![1, 2])
);
// invalid type conversion
assert_eq!(col.get_config_optional::<i64, _>("test"), None,);
// invalid json
col.storage
.db
.execute(
"update config set val=? where key='test'",
&[b"xx".as_ref()],
)
.unwrap();
assert_eq!(col.get_config_optional::<i64, _>("test"), None,);
}
}