Finish push; New version v0.7a0: Added invoice functionality

Author: dvklopfenstein

.timetracker/.gitignore

@@ -2,6 +2,7 @@
 
 # Summary
 * [**Unreleased**](#unreleased)
+* [**Release 2025-06-21 v0.7a0**](#release-2025-06-21-v07a0) Much added functionality for invoicing
 * [**Release 2025-05-27 v0.6a0**](#release-2025-05-27-v06a0) Added functions to collect various groups of csv files
 * [**Release 2025-05-18 v0.5a7**](#release-2025-05-18-v05a7) Add starttime to `report`; Bug fix in `cancel`
 * [**Release 2025-05-16 v0.5a6**](#release-2025-05-16-v05a6) Add options to `projects` command; Fix `report` command
@@ -30,6 +31,8 @@
 # Details
 
 ## Unreleased
+
+## Release 2025-06-21 v0.7a0
 * ADDED command, `trk invoice`
 * ADDED command option, `-b` or `--billable` to `trk stop`
   to add a `Billable` tag when running `tag stop`
@@ -39,6 +42,7 @@
 * ADDED `--no-git-add` and `-A` options to the `trk init` command
 * CHANGED "Run `trk init`" message so it is clearer that no trk command
   will be run until the project is initialized
+* CHANGED imports to improve speed
 
 ## Release 2025-05-27 v0.6a0
 * ADDED `trk hours` options `--global` to show hours for all projects for a single username

.timetracker/config

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "timetracker-csv"
 description = "Pandas-friendly time tracking from the CLI"
-version = "0.6a0"
+version = "0.7a0"
 license = "AGPL-3.0-or-later"
 authors = [
   {name = 'DV Klopfenstein, PhD', email = 'dvklopfenstein@protonmail.com'},

CHANGELOG.md

@@ -0,0 +1,41 @@
+"""Command line interface (CLI) for timetracking"""
+# https://stackoverflow.com/questions/42703908/how-do-i-use-importlib-lazyloader
+# https://python.plainenglish.io/lazy-imports-the-secret-to-faster-python-code-c33ae9eb1b13
+
+__copyright__ = 'Copyright (C) 2025-present, DV Klopfenstein, PhD. All rights reserved.'
+__author__ = "DV Klopfenstein, PhD"
+
+
+from timetracker.cmd.init      import cli_run_init
+from timetracker.cmd.start     import cli_run_start
+from timetracker.cmd.stop      import cli_run_stop
+from timetracker.cmd.projects  import cli_run_projects
+from timetracker.cmd.cancel    import cli_run_cancel
+from timetracker.cmd.hours     import cli_run_hours
+from timetracker.cmd.csv       import cli_run_csv
+from timetracker.cmd.report    import cli_run_report
+from timetracker.cmd.invoice    import cli_run_invoice
+from timetracker.cmd.paid       import cli_run_paid
+#from timetracker.cmd.tag       import cli_run_tag
+from timetracker.cmd.activity  import cli_run_activity
+#from timetracker.cmd.csvloc   import cli_run_csvloc
+
+
+FNCS = {
+    'init'     : cli_run_init,
+    'start'    : cli_run_start,
+    'stop'     : cli_run_stop,
+    'cancel'   : cli_run_cancel,
+    'hours'    : cli_run_hours,
+    'csv'      : cli_run_csv,
+    'report'   : cli_run_report,
+    'invoice'  : cli_run_invoice,
+    'paid'     : cli_run_paid,
+    #'tag'      : cli_run_tag,
+    'activity' : cli_run_activity,
+    'projects' : cli_run_projects,
+    #'csvloc'   : cli_run_csvloc,
+}
+
+
+# Copyright (C) 2025-present, DV Klopfenstein, PhD. All rights reserved.

pyproject.toml

@@ -0,0 +1,80 @@
+#!/usr/bin/env python
+"""Test speed savings from lazy import"""
+
+from timeit import default_timer
+from datetime import timedelta
+
+
+def test_tt_fncs(num_p_batch=1):
+    """Test speed savings from lazy import"""
+    # pylint: disable=import-outside-toplevel
+    mintime_slow = timedelta(seconds=1000)
+    for _ in range(num_p_batch):
+        tic = default_timer()
+        import tests.pkgtttest.fncs
+        del tests
+        mintime_slow = min(mintime_slow, timedelta(seconds=default_timer()-tic))
+    print(mintime_slow)
+
+    mintime_fast = timedelta(seconds=1000)
+    for _ in range(num_p_batch):
+        tic = default_timer()
+        import timetracker.cmd.fncs
+        del timetracker
+        mintime_fast = min(mintime_fast, timedelta(seconds=default_timer()-tic))
+    print(mintime_fast)
+
+    assert mintime_fast < mintime_slow
+
+    faster = mintime_slow.total_seconds()/mintime_fast.total_seconds()
+    print(f'{faster:10.1f} times faster is import fncs compared to regular import')
+
+
+def test_tt_ospath(num_p_batch=1):
+    """Test speed savings from lazy import"""
+    # pylint: disable=import-outside-toplevel,too-many-locals
+    mintime_slow = timedelta(seconds=1000)
+    for _ in range(num_p_batch):
+        tic = default_timer()
+        from os.path import exists
+        from os.path import relpath
+        from os.path import abspath
+        from os.path import dirname
+        from os.path import join
+        from os.path import ismount
+        from os.path import basename
+        from os.path import normpath
+        from os.path import realpath
+        from logging import debug
+        from timetracker.consts import DIRTRK
+        del exists
+        del relpath
+        del abspath
+        del dirname
+        del join
+        del ismount
+        del basename
+        del normpath
+        del realpath
+        del debug
+        del DIRTRK
+        mintime_slow = min(mintime_slow, timedelta(seconds=default_timer()-tic))
+    print(mintime_slow)
+
+    mintime_fast = timedelta(seconds=1000)
+    for _ in range(num_p_batch):
+        tic = default_timer()
+        import os.path as os_path
+        del os_path
+        mintime_fast = min(mintime_fast, timedelta(seconds=default_timer()-tic))
+    print(mintime_fast)
+
+    assert mintime_fast < mintime_slow
+
+    faster = mintime_slow.total_seconds()/mintime_fast.total_seconds()
+    print(f'{faster:10.1f} times faster is import fncs compared to regular import')
+
+
+if __name__ == '__main__':
+    test_tt_fncs()
+    test_tt_ospath()

tests/pkgtttest/fncs.py

@@ -2,6 +2,6 @@
 
 __copyright__ = 'Copyright (C) 2025-present, DV Klopfenstein, PhD. All rights reserved'
 __author__ = 'DV Klopfenstein, PhD'
-__version__ = '0.6a0'
+__version__ = '0.7a0'
 
 # Copyright (C) 2025-present, DV Klopfenstein, PhD. All rights reserved