feat: helpers to calculate prior (local) month range

by default use the America/Los_Angeles time zone

override with TZ_NAME env var

Author: thekaveman

.env.sample

@@ -8,3 +8,5 @@ TOGGL_USER_INFO=data/toggl-user-info-sample.json
 TOGGL_API_TOKEN=token
 TOGGL_CLIENT_ID=client
 TOGGL_WORKSPACE_ID=workspace
+
+TZ_NAME=America/Los_Angeles

compiler_admin/main.py

@@ -1,5 +1,8 @@
 from argparse import ArgumentParser, _SubParsersAction
+from datetime import datetime, timedelta
+import os
 import sys
+from zoneinfo import ZoneInfo
 
 from compiler_admin import __version__ as version
 from compiler_admin.commands.info import info
@@ -9,6 +12,24 @@
 from compiler_admin.commands.user.convert import ACCOUNT_TYPE_OU
 
 
+TZINFO = ZoneInfo(os.environ.get("TZ_NAME", "America/Los_Angeles"))
+
+
+def local_now():
+    return datetime.now(tz=TZINFO)
+
+
+def prior_month_end():
+    now = local_now()
+    first = now.replace(day=1)
+    return first - timedelta(days=1)
+
+
+def prior_month_start():
+    end = prior_month_end()
+    return end.replace(day=1)
+
+
 def add_sub_cmd_parser(parser: ArgumentParser, dest="subcommand", help=None):
     """Helper adds a subparser for the given dest."""
     return parser.add_subparsers(dest=dest, help=help)

pyproject.toml

@@ -13,6 +13,7 @@ requires-python = ">=3.11"
 dependencies = [
     "advanced-gam-for-google-workspace @ git+https://github.com/taers232c/GAMADV-XTD3.git@v7.00.05#subdirectory=src",
     "pandas==2.2.3",
+    "tzdata",
 ]
 
 [project.urls]