git-time-tracker/git_time_tracker/__init__.py

import argparse
import sys
import time
import dataclasses
import git
import datetime
from collections.abc import Iterator, Sequence
from pathlib import Path

def parse_arguments():
    parser = argparse.ArgumentParser()
    parser.add_argument('repositories', action='extend', nargs='+', type=Path)
    return parser.parse_args()

@dataclasses.dataclass(frozen=True, order=True)
class WorkSample:
    registered_at: datetime.datetime
    labels: Sequence[str]


def determine_default(repo: git.Repo):
    try:
        repo.commit('main')
        return 'main'
    except:
        return 'master'

HIDDEN_LABEL_PREFIX = '__'
HIDDEN_LABEL_TOTAL = HIDDEN_LABEL_PREFIX + 'TOTAL'

def get_samples_from_project(repo: git.Repo) -> Iterator[WorkSample]:
    labels = [HIDDEN_LABEL_TOTAL]
    labels.append(repo.remotes.origin.url.removeprefix('git@gitfub.space:'))

    # TODO: Branch on main or master or default

    repo.commit()

    for commit in repo.iter_commits(determine_default(repo)):
        yield WorkSample(datetime.datetime.fromtimestamp(commit.authored_date, tz=datetime.UTC), tuple(labels))
        yield WorkSample(datetime.datetime.fromtimestamp(commit.committed_date, tz=datetime.UTC), tuple(labels))

DEFAULT_EST_TIME=datetime.timedelta(hours=1)

ZERO_DURATION = datetime.timedelta(seconds = 0)
HOUR = datetime.timedelta(hours = 1)

def generate_report(samples: list[WorkSample]) -> Iterator[str]:

    # Time spent per label
    time_per_label: dict[str, datetime.timedelta] = {}
    prev_time = datetime.datetime.fromtimestamp(0, datetime.UTC)
    for sample in samples:
        est_time: datetime.timedelta = DEFAULT_EST_TIME
        est_time = min(sample.registered_at - prev_time, est_time)

        for label in sample.labels:
            time_per_label.setdefault(label,ZERO_DURATION)
            time_per_label[label] += est_time

        prev_time = sample.registered_at
        del sample, est_time

    time_and_label = [(duration, label) for label,duration in time_per_label.items()]
    time_and_label.sort(reverse=True)

    #
    yield '-' * 56
    yield '\n'
    for (total_time, label) in time_and_label:
        if label.startswith(HIDDEN_LABEL_PREFIX):
            continue
        yield f'  {label:40}  {total_time / HOUR:-4.0f} hours\n'
        del label, total_time

    yield '-' * 56
    yield '\n'

    yield '  {label:40}  {hours:-4.0f} hours\n'.format(label='TOTAL', hours = time_per_label[HIDDEN_LABEL_TOTAL] / HOUR)

def main():
    args = parse_arguments()

    shared_time_stamps: set[WorkSample] = set()
    for repo_path in args.repositories:
        repo = git.Repo(repo_path)
        shared_time_stamps |= set(get_samples_from_project(repo))

    shared_time_stamps = sorted(shared_time_stamps)

    for t in generate_report(shared_time_stamps):
        sys.stdout.write(t)