macversiontracker 1.0.0__tar.gz → 1.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/PKG-INFO +188 -50
  2. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/README.md +182 -45
  3. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/PKG-INFO +188 -50
  4. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/SOURCES.txt +17 -0
  5. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/requires.txt +5 -4
  6. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/pyproject.toml +7 -6
  7. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_cli.py +50 -0
  8. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_cli_auto_updates.py +3 -0
  9. macversiontracker-1.1.0/tests/test_comparator_coverage.py +413 -0
  10. macversiontracker-1.1.0/tests/test_config_gaps.py +274 -0
  11. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_end_to_end_integration.py +51 -17
  12. macversiontracker-1.1.0/tests/test_enhanced_matching_coverage.py +138 -0
  13. macversiontracker-1.1.0/tests/test_exceptions_and_error_codes.py +420 -0
  14. macversiontracker-1.1.0/tests/test_finder_new_coverage.py +435 -0
  15. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_integration.py +42 -29
  16. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_main.py +54 -0
  17. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_matcher_coverage.py +16 -5
  18. macversiontracker-1.1.0/tests/test_menubar_app.py +57 -0
  19. macversiontracker-1.1.0/tests/test_module_lazy_imports.py +54 -0
  20. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_outdated_handlers.py +94 -0
  21. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ui.py +21 -69
  22. macversiontracker-1.1.0/tests/test_version_parser.py +467 -0
  23. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/__init__.py +1 -1
  24. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/__main__.py +14 -1
  25. macversiontracker-1.1.0/versiontracker/audit/__init__.py +88 -0
  26. macversiontracker-1.1.0/versiontracker/audit/auto_update.py +555 -0
  27. macversiontracker-1.1.0/versiontracker/audit/blocklist.py +154 -0
  28. macversiontracker-1.1.0/versiontracker/audit/discovery.py +378 -0
  29. macversiontracker-1.1.0/versiontracker/audit/homebrew.py +195 -0
  30. macversiontracker-1.1.0/versiontracker/audit/models.py +252 -0
  31. macversiontracker-1.1.0/versiontracker/audit/rendering.py +236 -0
  32. macversiontracker-1.1.0/versiontracker/audit/service.py +185 -0
  33. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/cli.py +27 -0
  34. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/__init__.py +2 -0
  35. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/app_handlers.py +2 -1
  36. macversiontracker-1.1.0/versiontracker/handlers/audit_handlers.py +111 -0
  37. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/config_handlers.py +2 -2
  38. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/filter_handlers.py +1 -1
  39. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/macos_handlers.py +1 -1
  40. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/setup_handlers.py +5 -4
  41. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/macos_integration.py +7 -2
  42. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/menubar_app.py +2 -2
  43. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/ui.py +21 -7
  44. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/LICENSE +0 -0
  45. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
  46. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/entry_points.txt +0 -0
  47. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/top_level.txt +0 -0
  48. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/setup.cfg +0 -0
  49. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_additional_functions.py +0 -0
  50. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_advanced_cache.py +0 -0
  51. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ai_module.py +0 -0
  52. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_app_store.py +0 -0
  53. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps.py +0 -0
  54. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_coverage.py +0 -0
  55. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_extra.py +0 -0
  56. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_new.py +0 -0
  57. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_new_pytest.py +0 -0
  58. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_homebrew.py +0 -0
  59. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_homebrew_coverage.py +0 -0
  60. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_integration.py +0 -0
  61. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_network.py +0 -0
  62. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_parity.py +0 -0
  63. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_advanced.py +0 -0
  64. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_edge_cases.py +0 -0
  65. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_handlers.py +0 -0
  66. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_integration.py +0 -0
  67. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_integration_flows.py +0 -0
  68. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_rollback.py +0 -0
  69. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_updates.py +0 -0
  70. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_brew_candidates.py +0 -0
  71. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_brew_installability.py +0 -0
  72. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_cache.py +0 -0
  73. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config.py +0 -0
  74. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_coverage.py +0 -0
  75. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_loader.py +0 -0
  76. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_save.py +0 -0
  77. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_validation_coverage.py +0 -0
  78. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_yaml.py +0 -0
  79. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
  80. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_enhanced_matching.py +0 -0
  81. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_export.py +0 -0
  82. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_finder_coverage.py +0 -0
  83. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_homebrew.py +0 -0
  84. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_homebrew_advanced.py +0 -0
  85. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_001_discovery.py +0 -0
  86. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_002_recommendation.py +0 -0
  87. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_003_matching.py +0 -0
  88. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_004_async_parity.py +0 -0
  89. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_macos_integration.py +0 -0
  90. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ml_module.py +0 -0
  91. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_network_operations.py +0 -0
  92. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_parameterized_edge_cases.py +0 -0
  93. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_parameterized_version.py +0 -0
  94. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_platform_compatibility.py +0 -0
  95. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_profiling.py +0 -0
  96. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_profiling_coverage.py +0 -0
  97. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_project_consistency.py +0 -0
  98. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ui_enhanced.py +0 -0
  99. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ui_new.py +0 -0
  100. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_utils.py +0 -0
  101. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_utils_comprehensive.py +0 -0
  102. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_utils_coverage.py +0 -0
  103. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version.py +0 -0
  104. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_batch.py +0 -0
  105. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_comprehensive.py +0 -0
  106. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_edge_cases.py +0 -0
  107. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_fuzzy.py +0 -0
  108. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_homebrew.py +0 -0
  109. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_legacy_coverage.py +0 -0
  110. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_utils.py +0 -0
  111. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/advanced_cache.py +0 -0
  112. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/ai/__init__.py +0 -0
  113. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/__init__.py +0 -0
  114. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/cache.py +0 -0
  115. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/finder.py +0 -0
  116. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/matcher.py +0 -0
  117. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/async_homebrew.py +0 -0
  118. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/async_network.py +0 -0
  119. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/cache.py +0 -0
  120. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/config.py +0 -0
  121. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/deprecation.py +0 -0
  122. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/enhanced_matching.py +0 -0
  123. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/error_codes.py +0 -0
  124. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/exceptions.py +0 -0
  125. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/experimental/__init__.py +0 -0
  126. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/experimental/analytics.py +0 -0
  127. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/experimental/benchmarks.py +0 -0
  128. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/export.py +0 -0
  129. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
  130. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/auto_update_types.py +0 -0
  131. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/backup_handlers.py +0 -0
  132. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/brew_handlers.py +0 -0
  133. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
  134. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/error_handlers.py +0 -0
  135. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/export_handlers.py +0 -0
  136. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/outdated_handlers.py +0 -0
  137. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/ui_handlers.py +0 -0
  138. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/utils_handlers.py +0 -0
  139. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/homebrew.py +0 -0
  140. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/ml/__init__.py +0 -0
  141. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/plugins/__init__.py +0 -0
  142. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/plugins/example_plugins.py +0 -0
  143. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/profiling.py +0 -0
  144. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/py.typed +0 -0
  145. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/utils.py +0 -0
  146. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/__init__.py +0 -0
  147. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/batch.py +0 -0
  148. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/comparator.py +0 -0
  149. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/fuzzy.py +0 -0
  150. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/homebrew.py +0 -0
  151. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/models.py +0 -0
  152. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/parser.py +0 -0
  153. {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: macversiontracker
3
- Version: 1.0.0
3
+ Version: 1.1.0
4
4
  Summary: A command-line tool for tracking and managing applications installed outside of the Mac App Store
5
5
  Author-email: docdyhr <thomas@dyhr.com>
6
6
  License-Expression: MIT
@@ -29,19 +29,20 @@ Requires-Dist: pyyaml>=6.0.2
29
29
  Requires-Dist: tqdm>=4.65
30
30
  Requires-Dist: psutil>=6.0
31
31
  Requires-Dist: tabulate>=0.9.0
32
- Requires-Dist: aiohttp>=3.9.0
32
+ Requires-Dist: termcolor>=3.3.0
33
+ Requires-Dist: aiohttp>=3.14.0
33
34
  Provides-Extra: dev
34
35
  Requires-Dist: pytest>=8.0; extra == "dev"
35
36
  Requires-Dist: pytest-cov>=7.0; extra == "dev"
36
37
  Requires-Dist: pytest-timeout>=2.1; extra == "dev"
37
38
  Requires-Dist: pytest-mock>=3.14; extra == "dev"
38
39
  Requires-Dist: pytest-asyncio>=1.0; extra == "dev"
39
- Requires-Dist: black>=24.0; extra == "dev"
40
- Requires-Dist: ruff>=0.4; extra == "dev"
40
+ Requires-Dist: black>=26.3.1; extra == "dev"
41
+ Requires-Dist: ruff==0.16.0; extra == "dev"
41
42
  Requires-Dist: mypy>=1.10; extra == "dev"
42
43
  Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
43
44
  Requires-Dist: build>=1.0; extra == "dev"
44
- Requires-Dist: wheel>=0.44; extra == "dev"
45
+ Requires-Dist: wheel>=0.46.2; extra == "dev"
45
46
  Requires-Dist: twine>=6.0; extra == "dev"
46
47
  Provides-Extra: test
47
48
  Requires-Dist: pytest>=8.0; extra == "test"
@@ -60,6 +61,17 @@ Requires-Dist: numpy>=1.24.0; extra == "ml"
60
61
  Requires-Dist: scikit-learn>=1.3.0; extra == "ml"
61
62
  Dynamic: license-file
62
63
 
64
+ <!-- markdownlint-disable MD041 -->
65
+ <div align="right">
66
+
67
+ <a href="https://railway.com?referralCode=QhjuBc">
68
+
69
+ <img width="160" src="https://raw.githubusercontent.com/docdyhr/.github/main/assets/railway-corner-v2@2x.png" alt="Deploy on Railway — $20 free credits"> <!-- markdownlint-disable-line MD013 -->
70
+
71
+ </a>
72
+
73
+ </div>
74
+
63
75
  # Versiontracker Update tool for macOS
64
76
 
65
77
  ![Logo](assets/images/logo.png)
@@ -68,8 +80,8 @@ Dynamic: license-file
68
80
 
69
81
  ## macOS Application Version Manager
70
82
 
71
- [![Project Grade](https://img.shields.io/badge/Grade-B-blue?style=for-the-badge&logo=gradle&logoColor=white)](TODO.md)
72
- [![Status](https://img.shields.io/badge/Status-Beta%20%E2%80%94%20Stabilising-orange?style=for-the-badge&logo=checkmarx&logoColor=white)](TODO.md)
83
+ [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](TODO.md)
84
+ [![Status](https://img.shields.io/badge/Status-Production%2FStable-brightgreen?style=for-the-badge&logo=checkmarx&logoColor=white)](https://github.com/docdyhr/versiontracker/releases/latest)
73
85
 
74
86
  </div>
75
87
 
@@ -97,8 +109,8 @@ Dynamic: license-file
97
109
  ### 🔒 Security & Quality
98
110
 
99
111
  [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/master?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
100
- [![Test Coverage](https://img.shields.io/badge/Coverage-70%2B%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
101
- [![Tests Passing](https://img.shields.io/badge/Tests-2%2C173%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
112
+ [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
113
+ [![Tests Passing](https://img.shields.io/badge/Tests-2%2C477%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
102
114
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
103
115
  [![Security: pip-audit](https://img.shields.io/badge/pip--audit-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
104
116
  [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
@@ -133,12 +145,12 @@ Dynamic: license-file
133
145
  ---
134
146
 
135
147
  * Name: Versiontracker
136
- * Version: 0.9.0
148
+ * Version: 1.0.0
137
149
  * Programming language: Python 3.12+
138
150
  * Author: thomas
139
151
  * Purpose: CLI versiontracker and update tool for macOS
140
- * Release date: 21. Feb 2022 (Updated: March 2026)
141
- * Code Quality: **~78% overall test coverage with 2,173+ passing tests**,
152
+ * Release date: 21. Feb 2022 (Updated: April 2026)
153
+ * Code Quality: **86% overall test coverage with 2,477 passing tests**,
142
154
  **all previously identified high & medium complexity issues resolved**
143
155
 
144
156
  ## Quick Start
@@ -159,6 +171,9 @@ versiontracker --recommend
159
171
  # Check for outdated applications
160
172
  versiontracker --check-outdated
161
173
 
174
+ # Audit apps not managed by the App Store, Homebrew, or a local auto-updater
175
+ versiontracker --audit
176
+
162
177
  # Show help
163
178
  versiontracker --help
164
179
  ```
@@ -166,9 +181,8 @@ versiontracker --help
166
181
  ## Overview
167
182
 
168
183
  Versiontracker is a command-line tool for macOS that helps you manage applications
169
- installed outside of the App Store. Currently in active stabilisation (v0.9.x → v1.0):
170
- core CLI/config/Homebrew paths are being made operationally consistent before the v1.0 release.
171
- See [TODO.md](TODO.md) for the current stabilisation roadmap.
184
+ installed outside of the App Store. v1.0.0 is the first production-stable release —
185
+ core CLI, config, and Homebrew integration are fully operational.
172
186
 
173
187
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
174
188
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -196,6 +210,84 @@ using Homebrew casks, making it easier to keep your applications up to date.
196
210
  * Adaptive rate limiting based on CPU and memory usage
197
211
  * Support for saving and loading query filters
198
212
  * **Auto-updates detection** for Homebrew casks with filtering options
213
+ * **Unmanaged application audit** (`--audit`): identifies apps with no App
214
+ Store, Homebrew, or local auto-update coverage, with full per-signal
215
+ evidence and JSON/YAML/CSV export
216
+
217
+ ## Advanced Features
218
+
219
+ ### ML-Powered App Matching (optional)
220
+
221
+ VersionTracker includes an optional machine-learning engine that improves
222
+ app-to-cask matching accuracy using TF-IDF embeddings and a logistic regression
223
+ confidence model.
224
+
225
+ **Install the ML extras:**
226
+
227
+ ```bash
228
+ pip install macversiontracker[ml]
229
+ # or via Homebrew tap (installs core only; add ML extras via pip after)
230
+ ```
231
+
232
+ **What it provides** (`versiontracker.ml`):
233
+
234
+ * `MLRecommendationEngine` — semantic similarity matching between installed apps
235
+ and Homebrew casks using TF-IDF + cosine similarity
236
+ * `MatchingConfidenceModel` — scikit-learn classifier that scores each candidate
237
+ match; trained model is cached under `~/.config/versiontracker/ml_models/`
238
+ * `UsageAnalyzer` — records user accept/reject feedback to personalise the
239
+ confidence threshold over time
240
+ * `is_ml_available()` — runtime check; returns `False` gracefully when
241
+ `numpy`/`scikit-learn` are absent
242
+
243
+ ```python
244
+ from versiontracker.ml import is_ml_available, MLRecommendationEngine
245
+
246
+ if is_ml_available():
247
+ engine = MLRecommendationEngine()
248
+ engine.initialize(apps, casks)
249
+ recommendations = engine.get_recommendations(apps, casks)
250
+ ```
251
+
252
+ Without the ML extras the standard fuzzy-matching engine is used automatically
253
+ — there is no degraded behaviour or error.
254
+
255
+ ### Experimental Modules
256
+
257
+ The `versiontracker.experimental` package contains two modules that are
258
+ implemented but not yet wired to a CLI command. Their APIs may change between
259
+ minor versions.
260
+
261
+ **`versiontracker.experimental.analytics`** — SQLite-backed session analytics:
262
+
263
+ ```python
264
+ from versiontracker.experimental.analytics import AnalyticsEngine
265
+
266
+ engine = AnalyticsEngine()
267
+ with engine.session():
268
+ engine.record_event("app_scan_started", {"app_count": 42})
269
+ ```
270
+
271
+ Tracks: session durations, per-command event counts, performance metrics,
272
+ and usage patterns. Data is stored in
273
+ `~/.config/versiontracker/analytics.db`.
274
+
275
+ **`versiontracker.experimental.benchmarks`** — function-level performance
276
+ benchmarking with statistical analysis:
277
+
278
+ ```python
279
+ from versiontracker.experimental.benchmarks import BenchmarkRunner
280
+
281
+ runner = BenchmarkRunner()
282
+ runner.run_all()
283
+ runner.print_report()
284
+ ```
285
+
286
+ Tracks: min/mean/max execution time, memory usage, CPU load per operation.
287
+ Useful for regression detection during development.
288
+
289
+ To promote either module to stable status: wire it to a CLI entry point,
290
+ add ≥ 60% test coverage, and move it out of `experimental/`.
199
291
 
200
292
  ## Requirements
201
293
 
@@ -296,6 +388,12 @@ Export options:
296
388
  --output-file OUTPUT_FILE
297
389
  Specify the output file for export (default: print to stdout)
298
390
 
391
+ Audit options (used with --audit):
392
+ --all Show every audited application, not just those needing attention
393
+ --status {attention,unknown,managed}
394
+ Show only applications in this audit status
395
+ --explain Show full evidence per application instead of a compact table
396
+
299
397
  Configuration options:
300
398
  --generate-config Generate a default configuration file at ~/.config/versiontracker/config.yaml
301
399
  --config-path CONFIG_PATH
@@ -306,7 +404,8 @@ Configuration options:
306
404
  -a, --apps return Apps in Applications/ that is not updated by App Store
307
405
  -b, --brews return installable brews
308
406
  -r, --recommend return recommendations for brew
309
- -o, --outdated check for outdated applications compared to Homebrew versions
407
+ -o, --check-outdated check for outdated applications compared to Homebrew versions
408
+ --audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
310
409
  -V, --version show program's version number and exit
311
410
  ```
312
411
 
@@ -339,13 +438,36 @@ python3 versiontracker-cli.py --recommend
339
438
  ### Check for outdated applications
340
439
 
341
440
  ```shell
342
- python3 versiontracker-cli.py --outdated
441
+ python3 versiontracker-cli.py --check-outdated
343
442
  ```
344
443
 
345
444
  Or if installed:
346
445
 
347
446
  ```shell
348
- versiontracker --outdated
447
+ versiontracker --check-outdated
448
+ ```
449
+
450
+ ### Audit unmanaged applications
451
+
452
+ Identify user-facing applications that aren't App Store-managed, aren't
453
+ Homebrew-owned, have no confirmed local auto-update path, and aren't
454
+ blocklisted — with full per-signal evidence rather than a bare yes/no.
455
+
456
+ ```shell
457
+ # Default view: applications needing attention or with incomplete evidence
458
+ versiontracker --audit
459
+
460
+ # Show every audited application, including already-managed ones
461
+ versiontracker --audit --all
462
+
463
+ # Show full evidence per application instead of a compact table
464
+ versiontracker --audit --explain
465
+
466
+ # Show only one audit status
467
+ versiontracker --audit --status unknown
468
+
469
+ # Export full evidence as versioned JSON
470
+ versiontracker --audit --export json --output-file audit.json
349
471
  ```
350
472
 
351
473
  ### Handle applications with auto-updates
@@ -427,8 +549,8 @@ python -m versiontracker --install-service
427
549
  # Check service status
428
550
  python -m versiontracker --service-status
429
551
 
430
- # Send notification with outdated app results
431
- python -m versiontracker --outdated --notify
552
+ # Check for outdated applications
553
+ python -m versiontracker --check-outdated
432
554
 
433
555
  # Launch menubar application for quick access
434
556
  python -m versiontracker --menubar
@@ -652,24 +774,22 @@ VersionTracker intentionally uses a heavy mocking approach to:
652
774
 
653
775
  Current Coverage Profile:
654
776
 
655
- * Reported line coverage: ≈10–11%
656
- * Effective logical path coverage for core decision branches: substantially higher (most comparison and
657
- matching branches exercised)
658
- * High mock call volume (5,000+ patched interactions) reduces counted executable lines while still validating behavior
777
+ * Reported line coverage: ≈86% overall
778
+ * Core modules (matcher, finder, config) have 78–98% coverage
779
+ * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
659
780
 
660
- Why Coverage Is Not Higher:
781
+ Why Some Coverage Is Lower:
661
782
 
662
- * Many modules rely on guarded platform / network code paths that are mocked out
663
- * Async and I/O heavy branches prefer behavioral contract tests instead of executing real subprocess or network calls
664
- * Legacy compatibility layers (fallback logic) are thin wrappers rarely worth direct line coverage
783
+ * Platform / network code paths are mocked out in CI for portability
784
+ * Async and I/O heavy branches use behavioral contract tests instead of real subprocess/network calls
785
+ * Legacy compatibility adapters are thin wrappers at the CLI/config boundary
665
786
 
666
787
  Planned Improvements:
667
788
 
668
789
  * Add end-to-end integration tests for: discovery → recommendation → outdated flow
669
790
  * Introduce cold vs warm cache performance validation tests
670
791
  * Add semantic regression test matrix for prerelease/build metadata edge cases
671
- * Incremental async Homebrew operations tests once migration begins
672
- * Raise coverage target after integration suite (goal: 25–30% meaningful executable coverage with higher branch coverage)
792
+ * Raise coverage to 85%+ across all core modules
673
793
 
674
794
  Quality Guarantees Beyond Coverage:
675
795
 
@@ -707,33 +827,51 @@ be managed through Homebrew.
707
827
 
708
828
  ## Project Status
709
829
 
710
- VersionTracker has completed major technical debt cleanup and is now production-ready.
711
- All critical and medium-priority complexity issues have been resolved. Key completed improvements include:
830
+ VersionTracker v1.0.0 is production-stable. All critical technical debt has been resolved
831
+ and the tool is fully operational on macOS. Key highlights:
712
832
 
713
- * **Complete Code Complexity Resolution**: All 10 high & medium-priority complex functions refactored
714
- * Refactored the codebase to follow the command pattern with dedicated handlers
715
- * Improved project structure with better module separation
716
- * Enhanced error handling with custom exceptions and proper type hints
717
- * Added support for smart progress indicators and adaptive rate limiting
718
- * Moved handler functions to a dedicated `handlers/` directory
719
- * **70%+ test coverage** with 950+ passing tests and 0 failing tests
833
+ * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
834
+ * **86% test coverage** with 2,477 passing tests and 0 failing tests
720
835
  * **Zero high-severity security vulnerabilities**
721
-
722
- ## Recent Major Achievements
723
-
724
- * **Technical Debt Elimination**: Reduced function complexity by 60-90% across 10 critical functions
725
- * **Type Safety**: All type checking passes with proper None handling and NoReturn annotations
726
- * Improved test coverage with parameterized tests for version comparison
727
- * Created a mock server for network operation testing with simulated failures
728
- * Implemented an advanced caching mechanism for Homebrew queries
729
- * Added request batching to reduce network calls
730
- * Enhanced error handling for network operations with focused helper functions
836
+ * **Complete complexity resolution**: all high & medium-priority complex functions refactored
837
+ * **Async Homebrew API**: install and update candidate checks use async operations by default
838
+ * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
839
+ * **Lazy config initialisation**: no subprocess on import — fast startup
840
+ * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
841
+
842
+ ## Known Limitations
843
+
844
+ * **macOS only** — VersionTracker runs on macOS only; Linux and Windows are not supported.
845
+ * **macOS 10.15 Catalina or later** — older releases are not tested. Tested through macOS Sequoia.
846
+ * **Homebrew required for version checks** — `--check-outdated` and `--recommend` require Homebrew;
847
+ `--apps` works without it.
848
+ * **Apple Silicon vs Intel** — both paths are detected automatically (`/opt/homebrew/bin/brew`
849
+ and `/usr/local/bin/brew`). Mixed-architecture Rosetta environments may need a manual
850
+ `--config-path` with a generated config.
851
+ * **Package managers not yet supported** — MacPorts and Mac App Store (`mas-cli`) integration
852
+ are on the roadmap. See `TODO.md → Future Enhancements`.
853
+ * **ML features require optional dependencies** — the ML matching engine (`versiontracker.ml`)
854
+ needs `numpy` and `scikit-learn`. Install with `pip install macversiontracker[ml]`.
855
+ * **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
856
+ `versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
857
+ may change without notice between minor versions.
858
+ * **16 tests skipped in default runs** — 13 ML-dep tests skip without the `[ml]` extras;
859
+ 2 platform-guard tests skip on macOS; 1 colour test skips in non-TTY environments. All expected.
860
+
861
+ ## Recent Major Achievements (v1.0.0)
862
+
863
+ * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
864
+ * **Thread-safety fix**: resolved `patch("builtins.print")` race condition in concurrent tests
865
+ that polluted the full test suite
866
+ * **Async deadlock fix**: `async_to_sync` decorator usage audited; `process_all_async()` used in async contexts
867
+ * **ConfigLoader extraction**: file I/O, env-var loading, and brew detection separated from `Config` data class
868
+ * **Module migration complete**: deleted `version_legacy.py` (−2,110 lines) and `app_finder.py` (−1,579 lines)
869
+ * **CI/CD pipeline hardened**: CodeQL, Sigstore signing, Trusted Publisher PyPI, Homebrew tap formula test
731
870
 
732
871
  ## Planned Improvements
733
872
 
734
873
  * Add more package managers support (MacPorts, etc.)
735
874
  * Implement automatic update capabilities for Homebrew-manageable applications
736
- * Explore using `asyncio` for network operations
737
875
  * Add GUI interface
738
876
 
739
877
  ## License