feat(toggl): setup notebook for harvest conversion

Author: thekaveman

.env.sample

@@ -1 +1,2 @@
 HARVEST_DATA=data/harvest-sample.csv
+TOGGL_DATA=data/toggl-sample.csv

notebooks/toggl-to-harvest.ipynb

@@ -0,0 +1,73 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import os\n",
+    "from pathlib import Path\n",
+    "import pandas as pd\n",
+    "\n",
+    "\n",
+    "def str_timedelta(td):\n",
+    "    \"\"\"\n",
+    "    Convert a string formatted duration (e.g. 01:30) to a timedelta.\n",
+    "    \"\"\"\n",
+    "    return pd.to_timedelta(pd.to_datetime(td, format=\"%H:%M\").strftime(\"%H:%M:%S\"))\n",
+    "\n",
+    "\n",
+    "DATA_DIR = Path(\"./data\")\n",
+    "DATA_SOURCE = Path(os.environ.get(\"TOGGL_DATA\", \"./data/toggl-sample.csv\"))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# assign category dtype for efficiency on repeating text columns\n",
+    "dtypes = {\n",
+    "    \"Email\": \"category\",\n",
+    "    \"Project\": \"category\",\n",
+    "    \"Task\": \"category\",\n",
+    "    \"Client\": \"category\"\n",
+    "}\n",
+    "# skip reading the columns we don't care about for Harvest\n",
+    "cols = list(dtypes) + [\n",
+    "    \"Start Date\",\n",
+    "    \"Start Time\",\n",
+    "    \"Duration\",\n",
+    "]\n",
+    "# read CSV file, parsing dates and times\n",
+    "source = pd.read_csv(DATA_SOURCE, dtype=dtypes, usecols=cols, parse_dates=[\"Start Date\"], cache_dates=True)\n",
+    "source[\"Start Time\"] = source[\"Start Time\"].apply(str_timedelta)\n",
+    "source[\"Duration\"] = source[\"Duration\"].apply(str_timedelta)\n",
+    "source.dtypes"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.6"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}