gitmole 0.9.0__tar.gz → 0.9.1__tar.gz

{gitmole-0.9.0 → gitmole-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitmole
-Version: 0.9.0
+Version: 0.9.1
 Summary: Offline git repository analysis with a terminal report: hotspots, coupling, ownership, code age, secrets, repo health.
 License: MIT
 Project-URL: Homepage, https://github.com/antvinni/gitmole
@@ -96,7 +96,7 @@ since 2013, at a pinned commit:
   ork.js                                            commitLayoutEffectOnFiber() complexity 72       
   packages/react-reconciler/src/ReactFiberBeginWo   changed 361 times · fixed once in six months ·  
   rk.js                                             beginWork() complexity 52                       
-  ranked by revisions × lines of code; the reasons say what else counts against each file           
+  ranked by revisions × lines of code alone; the reasons say what to look at there                  
   6 months ago this list would have named 11 of the 46 files fixed since (a random 15 of the 1802   
   files that had changed more than once would name 0.3; the 15 most changed would name 7)           
 ```

{gitmole-0.9.0 → gitmole-0.9.1}/README.md

@@ -76,7 +76,7 @@ since 2013, at a pinned commit:
   ork.js                                            commitLayoutEffectOnFiber() complexity 72       
   packages/react-reconciler/src/ReactFiberBeginWo   changed 361 times · fixed once in six months ·  
   rk.js                                             beginWork() complexity 52                       
-  ranked by revisions × lines of code; the reasons say what else counts against each file           
+  ranked by revisions × lines of code alone; the reasons say what to look at there                  
   6 months ago this list would have named 11 of the 46 files fixed since (a random 15 of the 1802   
   files that had changed more than once would name 0.3; the 15 most changed would name 7)           
 ```

{gitmole-0.9.0 → gitmole-0.9.1}/gitmole/__init__.py

@@ -1,3 +1,3 @@
 """gitmole: offline git repository analysis with a terminal report."""
 
-__version__ = "0.9.0"
+__version__ = "0.9.1"

{gitmole-0.9.0 → gitmole-0.9.1}/gitmole/render.py

@@ -297,10 +297,14 @@ def watch_section(report: dict, full: bool = True, width=None) -> dict:
     rows = [(r["file"], " · ".join(r["reasons"])) for r in ranked[:limit]]
     columns = [("file", PATH), ("why", {"overflow": "fold", "ratio": 3})]
     since = report["meta"].get("since")
-    notes = ["ranked by revisions × lines of code; the reasons say what else counts against each file" + (f"; commits since {since}" if since else "")]
+    # "alone": the reasons never move a file; a reader who sees fixes and ownership beside each row
+    # would otherwise take them for the ranking
+    notes = ["ranked by revisions × lines of code alone; the reasons say what to look at there" + (f"; commits since {since}" if since else "")]
     bt = watch.backtest(report)
     status = report["meta"].get("backtest") or {}
-    if bt:
+    if bt and not bt["fixed"]:
+        notes.append("nothing has been fixed since the cut-off six months ago, so there is nothing to score the list against")
+    elif bt:
         notes.append(f"6 months ago this list would have named {bt['hits']} of the {bt['fixed']} files fixed since "
                      f"(a random {bt['listed']} of the {bt['pool']} files that had changed more than once would name {bt['expected']}; "
                      f"the {bt['listed']} most changed would name {bt['baselines']['churn']})"

{gitmole-0.9.0 → gitmole-0.9.1}/gitmole/watch.py

@@ -1,4 +1,4 @@
-"""The watch list: the source files most likely to be fixed next, and what else counts against each.
+"""The watch list: the source files most likely to be fixed next, and what to look at in each.
 
 Each source file that is still in the tree and changed more than once is ranked by revisions × lines
 of code, the product the Hotspots table uses: measured at six cut-offs on three repositories

{gitmole-0.9.0 → gitmole-0.9.1}/gitmole.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitmole
-Version: 0.9.0
+Version: 0.9.1
 Summary: Offline git repository analysis with a terminal report: hotspots, coupling, ownership, code age, secrets, repo health.
 License: MIT
 Project-URL: Homepage, https://github.com/antvinni/gitmole
@@ -96,7 +96,7 @@ since 2013, at a pinned commit:
   ork.js                                            commitLayoutEffectOnFiber() complexity 72       
   packages/react-reconciler/src/ReactFiberBeginWo   changed 361 times · fixed once in six months ·  
   rk.js                                             beginWork() complexity 52                       
-  ranked by revisions × lines of code; the reasons say what else counts against each file           
+  ranked by revisions × lines of code alone; the reasons say what to look at there                  
   6 months ago this list would have named 11 of the 46 files fixed since (a random 15 of the 1802   
   files that had changed more than once would name 0.3; the 15 most changed would name 7)           
 ```

{gitmole-0.9.0 → gitmole-0.9.1}/tests/test_render.py

@@ -307,6 +307,16 @@ class Report(unittest.TestCase):
         self.assertEqual(render.to_json(r, [])["watch_backtest"]["pool"], 2)
         self.assertEqual(render.to_json(r, [])["watch_backtest"]["baselines"]["churn"], 1)
 
+    def test_nothing_fixed_since_the_cut_off_is_one_sentence_not_three_zeros(self):
+        r = sample_report()
+        past = sample_report()
+        past["meta"] = {"now": "2026-03-10"}
+        r["backtest"] = past
+        r["fixes"] = [{"entity": "static/index.html", "n-fixes": 1, "last-fix": "2026-01-01", "recent-fixes": 0}]   # before the cut-off
+        caption = next(x for x in render.sections(r, full=False) if x["id"] == "watch")["caption"]
+        self.assertIn("nothing has been fixed since the cut-off six months ago, so there is nothing to score the list against", caption)
+        self.assertNotIn("0 of the 0", caption)
+        self.assertEqual(render.to_json(r, [])["watch_backtest"]["fixed"], 0, "the JSON keeps the numbers")
 
     def test_backtest_caption_says_whole_history_under_a_window(self):
         r = sample_report()
@@ -317,7 +327,7 @@ class Report(unittest.TestCase):
                       {"entity": "static/other.html", "n-fixes": 1, "last-fix": "2026-08-01", "recent-fixes": 1}]
         r["meta"]["since"] = "2026-01-01"
         caption = next(x for x in render.sections(r, full=False) if x["id"] == "watch")["caption"]
-        self.assertIn("ranked by revisions × lines of code; the reasons say what else counts against each file; commits since 2026-01-01", caption)
+        self.assertIn("ranked by revisions × lines of code alone; the reasons say what to look at there; commits since 2026-01-01", caption)
         self.assertTrue(caption.endswith("the 2 most changed would name 1); whole history"), caption)
 
     def test_markdown_hotspots_hide_test_files_and_say_so(self):
@@ -707,7 +717,7 @@ class WatchList(unittest.TestCase):
         self.assertIn("◎ Watch list", text)
         self.assertRegex(text, r"static/index.html\s+changed 51 times · only Ann has touched it")
         self.assertRegex(text, r"static/apps-metadata.json\s+changed 128 times · fixed 4 times in six months")
-        self.assertIn("ranked by revisions × lines of code; the reasons say what else counts against each file", text)
+        self.assertIn("ranked by revisions × lines of code alone; the reasons say what to look at there", text)
 
     def test_capped_at_five_by_default_and_fifteen_in_full(self):
         r = sample_report()
@@ -748,7 +758,7 @@ class WatchList(unittest.TestCase):
         r = sample_report()
         r["meta"]["since"] = "2025-01-01"
         sec = next(x for x in render.sections(r, full=False) if x["id"] == "watch")
-        self.assertEqual(sec["caption"], "ranked by revisions × lines of code; the reasons say what else counts against each file; commits since 2025-01-01")
+        self.assertEqual(sec["caption"], "ranked by revisions × lines of code alone; the reasons say what to look at there; commits since 2025-01-01")
 
 
 class FullOnlySections(unittest.TestCase):