Welcome to daylio-parser’s documentation!¶

Installation¶

Via pip:

pip3 install --user daylio-parser

Via Pipenv:

pipenv install daylio-parser

Via Poetry:

poetry add daylio-parser

Config¶

daylio-parser comes with a default config that works for the default Daylio setup after installing the app. That is, there’s just 5 moods, called awful, bad, meh, good, rad.

Each mood has its class:

class Mood¶

name: str¶: Name of the mood, must correspond with mood name in the exported CSV.

level: int¶: Assigned numeral level for the mood (higher = better mood).

color: str¶: Any hex color.

boundaries: Tuple[float, float]¶: A tuple with lower and upper bound for the mood. Any average mood that falls withing these boundaries will be colored using the Mood.color.

The whole mood config for your app will be constructed using the MoodConfig class.

class MoodConfig(mood_list=None)¶

Creates a config with mood_list. If the mood list isn’t provided, DEFAULT_MOODS will be used. All moods are automatically numbered (levels are assigned) and boundaries are also calculated. Each boundary is exactly 1 in size, with the first one and the last one being only 0.5 in size.

Parameters: mood_list (List[Tuple[str, str]]) – A list of moods with (name, color)

from_list(mood_list) → None¶

Updates the config with a new list of moods.

Parameters: mood_list (List[Tuple[str, str]]) – A list of moods with (name, color)

get(mood_name) → Mood ¶

Returns a Mood by its name.

Parameters: mood_name (str) – Mood name

Parser¶

class Entry¶

A class that holds data for an entry in the diary. One day can have multiple entries.

datetime: datetime.datetime¶

mood: Mood¶

activities: List[str]¶

notes: str¶

class Parser(config=None)¶

Parser for the CSV file. If config is not provided, a default one will be created.

Parameters: config (MoodConfig) – MoodConfig for the parser

load_csv(path) → List[Entry]¶

Load entries from a CSV file.

Parameters: path (str) – Path to the CSV file

load_from_buffer(f) → List[Entry]¶

Actually reads the entries from a CSV file.

Parameters: f – A file-like object

PlotData¶

class PlotData(entries, config=None)¶

A class that provides some data for easier plotting.

Parameters

entries (List[Entry]) – A list of parsed entries
config (MoodConfig) – MoodConfig for the parser (if none is provided, a default one will be created)

split_into_bands(moods)¶: Splits input moods into bands, given their boundaries. See Mood.boundaries.

interpolate(avg_moods=None, interpolate_steps=360)¶

Interpolates moods to make a smooth chart.

Parameters

avg_moods – Average moods to iterate over. If not provided, these are generated by Stats.average_moods()
interpolate_steps (int) – Number of steps for one day (midnight to midnight)