Replace arrow with humanize

This is good enough for our use case and is much lighter weight.

Signed-off-by: Stephen Finucane <stephen@that.guru>

Author: stephenfin

.pre-commit-config.yaml

@@ -9,7 +9,7 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.10
+    rev: v0.17.1
     hooks:
       - id: ruff-check
         args: ['--fix', '--unsafe-fixes']

README.rst

@@ -47,14 +47,14 @@ dependencies.  On Fedora, run:
 .. code-block:: bash
 
    $ sudo dnf install python3-requests python3-click python3-pbr \
-       python3-arrow python3-tabulate python3-yaml
+       python3-humanize python3-tabulate python3-yaml
 
 On Ubuntu, run:
 
 .. code-block:: bash
 
    $ sudo apt-get install python3-requests python3-click python3-pbr \
-       python3-arrow python3-tabulate python3-yaml
+       python3-humanize python3-tabulate python3-yaml
 
 Once dependencies are installed, clone this repo and install with ``pip``:
 

git_pw/patch.py

@@ -8,7 +8,6 @@
 import sys
 from typing import Any
 
-import arrow
 import click
 
 from git_pw import api
@@ -442,7 +441,7 @@ def list_cmd(
     for patch in patches:
         item = [
             patch.get('id'),
-            arrow.get(patch['date']).humanize(),
+            utils.humanize_date(patch['date']),
             utils.trim(patch.get('name') or ''),
             '{} ({})'.format(
                 (patch.get('submitter') or {}).get('name'),

git_pw/series.py

@@ -8,7 +8,6 @@
 import sys
 from typing import Any
 
-import arrow
 import click
 
 from git_pw import api
@@ -257,7 +256,7 @@ def list_cmd(
     for series_ in series:
         item = [
             series_.get('id'),
-            arrow.get(series_['date']).humanize(),
+            utils.humanize_date(series_['date']),
             utils.trim(series_.get('name') or ''),
             series_.get('version'),
             '{} ({})'.format(

git_pw/utils.py

@@ -4,6 +4,7 @@
 
 from collections.abc import Callable, Sequence
 import csv
+import datetime
 import io
 import logging
 import os
@@ -12,6 +13,7 @@
 from typing import Any, TypeVar, overload
 
 import click
+import humanize
 from tabulate import tabulate
 import yaml
 
@@ -35,6 +37,14 @@ def trim(string: str, length: int = 70) -> str:
     return (string[: length - 1] + '...') if len(string) > length else string
 
 
+def humanize_date(value: str) -> str:
+    """Format an API timestamp as a relative date, assuming UTC if naive."""
+    date = datetime.datetime.fromisoformat(value)
+    if date.tzinfo is None:
+        date = date.replace(tzinfo=datetime.UTC)
+    return humanize.naturaltime(datetime.datetime.now(datetime.UTC) - date)
+
+
 def git_config(value: str) -> str:
     """Parse config from ``git-config`` cache.
 

pyproject.toml

@@ -12,8 +12,8 @@ readme = {file = "README.rst", content-type = "text/x-rst"}
 license = "MIT"
 dynamic = ["version"]
 dependencies = [
-    "arrow>=0.10",
     "click>=8.0",
+    "humanize>=4.0",
     "PyYAML>=5.1",
     "requests>=2.0",
     "tabulate>=0.8",

tests/test_utils.py

@@ -1,15 +1,38 @@
 """Unit tests for ``git_pw/utils.py``."""
 
+import datetime
 import subprocess
 import textwrap
 import os
 
+import pytest
 import yaml
 from unittest import mock
 
 from git_pw import utils
 
 
+@pytest.mark.parametrize(
+    'value',
+    [
+        '2026-01-02 10:00:00',
+        '2026-01-02T10:00:00Z',
+        '2026-01-02T12:00:00+02:00',
+    ],
+)
+@mock.patch.object(utils.humanize, 'naturaltime')
+def test_humanize_date(mock_naturaltime, value):
+    now = datetime.datetime(2026, 1, 2, 12, tzinfo=datetime.UTC)
+    with mock.patch.object(utils, 'datetime', wraps=datetime) as mock_datetime:
+        mock_datetime.UTC = datetime.UTC
+        mock_datetime.datetime.now.return_value = now
+
+        assert utils.humanize_date(value) == mock_naturaltime.return_value
+        mock_datetime.datetime.now.assert_called_once_with(datetime.UTC)
+
+    mock_naturaltime.assert_called_once_with(datetime.timedelta(hours=2))
+
+
 @mock.patch.object(utils.subprocess, 'check_output', return_value=b' bar ')
 def test_git_config(mock_subprocess):
     value = utils.git_config('foo')