miscreaders 0.2.0

Parsers for output of various programs

miscreaders

This library provides parsers for output of various programs.

To learn more, please see the documentation.

List of readers

Program	Description
StayFree	Device usage statistics (mobile, desktop, browser)
Loop Habit Tracker	Habit tracker (Android)
Moonwatch.rs	Privacy-focused device usage statistics (desktop)

Installation

pip install miscreaders

Example

>>> from miscreaders.stayfree import StayfreeXlsReader
>>> reader = StayfreeXlsReader("StayFree Export - Total Usage - 8_9_24.xls")
>>> reader.get_usage_time_df()
shape: (6_222, 4)
┌────────────┬─────────────┬──────────────┬────────┐
│ date       ┆ app         ┆ duration     ┆ device │
│ ---        ┆ ---         ┆ ---          ┆ ---    │
│ date       ┆ str         ┆ duration[μs] ┆ str    │
╞════════════╪═════════════╪══════════════╪════════╡
│ 2023-11-10 ┆ addititious ┆ 0µs          ┆        │
│ 2023-11-11 ┆ addititious ┆ 0µs          ┆        │
│ 2023-11-12 ┆ addititious ┆ 0µs          ┆        │
│ 2023-11-13 ┆ addititious ┆ 0µs          ┆        │
│ 2023-11-14 ┆ addititious ┆ 6s           ┆        │
│ …          ┆ …           ┆ …            ┆ …      │
│ 2024-03-06 ┆ xylometer   ┆ 53m 8s       ┆        │
│ 2024-03-07 ┆ xylometer   ┆ 0µs          ┆        │
│ 2024-03-08 ┆ xylometer   ┆ 30m 54s      ┆        │
│ 2024-03-09 ┆ xylometer   ┆ 0µs          ┆        │
│ 2024-03-10 ┆ xylometer   ┆ 0µs          ┆        │
└────────────┴─────────────┴──────────────┴────────┘

License

MIT, see LICENSE.txt.