macversiontracker 0.9.0__tar.gz → 1.0.1__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 (143) hide show
  1. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/PKG-INFO +55 -48
  2. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/README.md +49 -43
  3. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/macversiontracker.egg-info/PKG-INFO +55 -48
  4. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/macversiontracker.egg-info/SOURCES.txt +11 -1
  5. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/macversiontracker.egg-info/requires.txt +4 -3
  6. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/pyproject.toml +10 -7
  7. macversiontracker-1.0.1/tests/test_ai_module.py +367 -0
  8. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_apps_extra.py +11 -21
  9. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_apps_new_pytest.py +1 -1
  10. macversiontracker-1.0.1/tests/test_async_homebrew_coverage.py +245 -0
  11. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_updates.py +13 -4
  12. macversiontracker-1.0.1/tests/test_comparator_coverage.py +413 -0
  13. macversiontracker-1.0.1/tests/test_config_gaps.py +274 -0
  14. macversiontracker-1.0.1/tests/test_config_validation_coverage.py +138 -0
  15. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_end_to_end_integration.py +51 -17
  16. macversiontracker-1.0.1/tests/test_enhanced_matching_coverage.py +138 -0
  17. macversiontracker-1.0.1/tests/test_exceptions_and_error_codes.py +420 -0
  18. macversiontracker-1.0.1/tests/test_finder_new_coverage.py +435 -0
  19. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_homebrew_advanced.py +22 -15
  20. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_int_004_async_parity.py +25 -65
  21. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_integration.py +68 -5
  22. macversiontracker-1.0.1/tests/test_ml_module.py +286 -0
  23. macversiontracker-1.0.1/tests/test_module_lazy_imports.py +54 -0
  24. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_outdated_handlers.py +96 -3
  25. macversiontracker-1.0.1/tests/test_profiling_coverage.py +395 -0
  26. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_project_consistency.py +3 -2
  27. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_ui.py +21 -69
  28. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_fuzzy.py +29 -15
  29. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/__init__.py +1 -1
  30. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/__main__.py +83 -13
  31. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/ai/__init__.py +2 -2
  32. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/apps/finder.py +2 -2
  33. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/async_homebrew.py +79 -0
  34. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/cli.py +30 -0
  35. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/config.py +9 -5
  36. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/enhanced_matching.py +11 -0
  37. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/outdated_handlers.py +1 -2
  38. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/setup_handlers.py +5 -4
  39. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/homebrew.py +24 -11
  40. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/ui.py +10 -7
  41. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/fuzzy.py +25 -18
  42. macversiontracker-0.9.0/versiontracker/async_homebrew_prototype.py +0 -384
  43. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/LICENSE +0 -0
  44. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/macversiontracker.egg-info/dependency_links.txt +0 -0
  45. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/macversiontracker.egg-info/entry_points.txt +0 -0
  46. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/macversiontracker.egg-info/top_level.txt +0 -0
  47. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/setup.cfg +0 -0
  48. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_additional_functions.py +0 -0
  49. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_advanced_cache.py +0 -0
  50. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_app_store.py +0 -0
  51. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_apps.py +0 -0
  52. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_apps_coverage.py +0 -0
  53. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_apps_new.py +0 -0
  54. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_async_homebrew.py +0 -0
  55. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_async_integration.py +0 -0
  56. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_async_network.py +0 -0
  57. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_async_parity.py +0 -0
  58. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_update_advanced.py +0 -0
  59. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_update_edge_cases.py +0 -0
  60. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_update_handlers.py +0 -0
  61. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_update_integration.py +0 -0
  62. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_update_integration_flows.py +0 -0
  63. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_auto_update_rollback.py +0 -0
  64. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_brew_candidates.py +0 -0
  65. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_brew_installability.py +0 -0
  66. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_cache.py +0 -0
  67. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_cli.py +0 -0
  68. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_cli_auto_updates.py +0 -0
  69. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_config.py +0 -0
  70. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_config_coverage.py +0 -0
  71. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_config_loader.py +0 -0
  72. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_config_save.py +0 -0
  73. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_config_yaml.py +0 -0
  74. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_enhanced_auto_update_handlers.py +0 -0
  75. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_enhanced_matching.py +0 -0
  76. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_export.py +0 -0
  77. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_finder_coverage.py +0 -0
  78. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_homebrew.py +0 -0
  79. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_int_001_discovery.py +0 -0
  80. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_int_002_recommendation.py +0 -0
  81. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_int_003_matching.py +0 -0
  82. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_macos_integration.py +0 -0
  83. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_main.py +0 -0
  84. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_matcher_coverage.py +0 -0
  85. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_network_operations.py +0 -0
  86. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_parameterized_edge_cases.py +0 -0
  87. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_parameterized_version.py +0 -0
  88. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_platform_compatibility.py +0 -0
  89. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_profiling.py +0 -0
  90. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_ui_enhanced.py +0 -0
  91. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_ui_new.py +0 -0
  92. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_utils.py +0 -0
  93. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_utils_comprehensive.py +0 -0
  94. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_utils_coverage.py +0 -0
  95. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version.py +0 -0
  96. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_batch.py +0 -0
  97. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_comprehensive.py +0 -0
  98. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_edge_cases.py +0 -0
  99. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_homebrew.py +0 -0
  100. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_legacy_coverage.py +0 -0
  101. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/tests/test_version_utils.py +0 -0
  102. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/advanced_cache.py +0 -0
  103. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/apps/__init__.py +0 -0
  104. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/apps/cache.py +0 -0
  105. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/apps/matcher.py +0 -0
  106. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/async_network.py +0 -0
  107. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/cache.py +0 -0
  108. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/deprecation.py +0 -0
  109. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/error_codes.py +0 -0
  110. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/exceptions.py +0 -0
  111. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/experimental/__init__.py +0 -0
  112. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/experimental/analytics.py +0 -0
  113. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/experimental/benchmarks.py +0 -0
  114. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/export.py +0 -0
  115. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/__init__.py +0 -0
  116. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/app_handlers.py +0 -0
  117. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/auto_update_handlers.py +0 -0
  118. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/auto_update_types.py +0 -0
  119. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/backup_handlers.py +0 -0
  120. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/brew_handlers.py +0 -0
  121. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/config_handlers.py +0 -0
  122. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
  123. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/error_handlers.py +0 -0
  124. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/export_handlers.py +0 -0
  125. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/filter_handlers.py +0 -0
  126. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/macos_handlers.py +0 -0
  127. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/ui_handlers.py +0 -0
  128. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/handlers/utils_handlers.py +0 -0
  129. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/macos_integration.py +0 -0
  130. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/menubar_app.py +0 -0
  131. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/ml/__init__.py +0 -0
  132. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/plugins/__init__.py +0 -0
  133. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/plugins/example_plugins.py +0 -0
  134. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/profiling.py +0 -0
  135. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/py.typed +0 -0
  136. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/utils.py +0 -0
  137. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/__init__.py +0 -0
  138. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/batch.py +0 -0
  139. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/comparator.py +0 -0
  140. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/homebrew.py +0 -0
  141. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/models.py +0 -0
  142. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/parser.py +0 -0
  143. {macversiontracker-0.9.0 → macversiontracker-1.0.1}/versiontracker/version/utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: macversiontracker
3
- Version: 0.9.0
3
+ Version: 1.0.1
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
@@ -11,7 +11,7 @@ Project-URL: Source Code, https://github.com/docdyhr/versiontracker
11
11
  Project-URL: Changelog, https://github.com/docdyhr/versiontracker/blob/master/CHANGELOG.md
12
12
  Project-URL: PyPI, https://pypi.org/project/macversiontracker/
13
13
  Keywords: macos,homebrew,version,tracking,updates,cask
14
- Classifier: Development Status :: 4 - Beta
14
+ Classifier: Development Status :: 5 - Production/Stable
15
15
  Classifier: Environment :: Console
16
16
  Classifier: Intended Audience :: System Administrators
17
17
  Classifier: Intended Audience :: End Users/Desktop
@@ -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.13.4
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: black>=26.3.1; extra == "dev"
40
41
  Requires-Dist: ruff>=0.4; 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"
@@ -66,10 +67,10 @@ Dynamic: license-file
66
67
 
67
68
  <div align="center">
68
69
 
69
- ## 🚀 Production-Ready macOS Application Manager
70
+ ## macOS Application Version Manager
70
71
 
71
- [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](PROJECT_REVIEW.md)
72
- [![Production Ready](https://img.shields.io/badge/Status-Production%20Ready-success?style=for-the-badge&logo=checkmarx&logoColor=white)](PROJECT_REVIEW.md)
72
+ [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](TODO.md)
73
+ [![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
74
 
74
75
  </div>
75
76
 
@@ -83,13 +84,22 @@ Dynamic: license-file
83
84
  [![CodeQL](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/codeql-analysis.yml?branch=master&label=CodeQL&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
84
85
  [![Coverage](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/coverage.yml?branch=master&label=Coverage&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
85
86
  [![Performance](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/performance.yml?branch=master&label=Performance&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
86
- [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Release)](https://github.com/docdyhr/versiontracker/releases/latest)
87
+ [![Release Workflow](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/release.yml?label=Release%20Pipeline&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
88
+ [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Latest%20Release)](https://github.com/docdyhr/versiontracker/releases/latest)
89
+ [![PyPI](https://img.shields.io/pypi/v/macversiontracker?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/macversiontracker/)
90
+
91
+ #### 🧪 Test Matrix
92
+
93
+ | Platform | Python 3.12 | Python 3.13 |
94
+ |----------|:-----------:|:-----------:|
95
+ | **Ubuntu 22.04** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
96
+ | **macOS Latest** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
87
97
 
88
98
  ### 🔒 Security & Quality
89
99
 
90
100
  [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/master?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
91
- [![Test Coverage](https://img.shields.io/badge/Coverage-70%2B%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
92
- [![Tests Passing](https://img.shields.io/badge/Tests-1,136%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
101
+ [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
102
+ [![Tests Passing](https://img.shields.io/badge/Tests-2%2C385%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
93
103
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
94
104
  [![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)
95
105
  [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
@@ -124,14 +134,13 @@ Dynamic: license-file
124
134
  ---
125
135
 
126
136
  * Name: Versiontracker
127
- * Version: 0.8.1
137
+ * Version: 1.0.0
128
138
  * Programming language: Python 3.12+
129
139
  * Author: thomas
130
140
  * Purpose: CLI versiontracker and update tool for macOS
131
- * Release date: 21. Feb 2022 (Updated: January 2026)
132
- * Code Quality: **70%+ test coverage with 1,230+ passing tests**,
133
- **all previously identified high & medium complexity issues resolved**,
134
- **AI/ML capabilities and advanced analytics platform**
141
+ * Release date: 21. Feb 2022 (Updated: April 2026)
142
+ * Code Quality: **70%+ overall test coverage with 2,194+ passing tests**,
143
+ **all previously identified high & medium complexity issues resolved**
135
144
 
136
145
  ## Quick Start
137
146
 
@@ -158,8 +167,8 @@ versiontracker --help
158
167
  ## Overview
159
168
 
160
169
  Versiontracker is a command-line tool for macOS that helps you manage applications
161
- installed outside of the App Store. Recently undergone complete technical debt cleanup
162
- with **70%+ test coverage** and **all high & medium-priority complexity issues resolved**.
170
+ installed outside of the App Store. v1.0.0 is the first production-stable release —
171
+ core CLI, config, and Homebrew integration are fully operational.
163
172
 
164
173
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
165
174
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -643,24 +652,22 @@ VersionTracker intentionally uses a heavy mocking approach to:
643
652
 
644
653
  Current Coverage Profile:
645
654
 
646
- * Reported line coverage: ≈10–11%
647
- * Effective logical path coverage for core decision branches: substantially higher (most comparison and
648
- matching branches exercised)
649
- * High mock call volume (5,000+ patched interactions) reduces counted executable lines while still validating behavior
655
+ * Reported line coverage: ≈70%+ overall
656
+ * Core modules (matcher, finder, config) have 78–98% coverage
657
+ * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
650
658
 
651
- Why Coverage Is Not Higher:
659
+ Why Some Coverage Is Lower:
652
660
 
653
- * Many modules rely on guarded platform / network code paths that are mocked out
654
- * Async and I/O heavy branches prefer behavioral contract tests instead of executing real subprocess or network calls
655
- * Legacy compatibility layers (fallback logic) are thin wrappers rarely worth direct line coverage
661
+ * Platform / network code paths are mocked out in CI for portability
662
+ * Async and I/O heavy branches use behavioral contract tests instead of real subprocess/network calls
663
+ * Legacy compatibility adapters are thin wrappers at the CLI/config boundary
656
664
 
657
665
  Planned Improvements:
658
666
 
659
667
  * Add end-to-end integration tests for: discovery → recommendation → outdated flow
660
668
  * Introduce cold vs warm cache performance validation tests
661
669
  * Add semantic regression test matrix for prerelease/build metadata edge cases
662
- * Incremental async Homebrew operations tests once migration begins
663
- * Raise coverage target after integration suite (goal: 25–30% meaningful executable coverage with higher branch coverage)
670
+ * Raise coverage to 85%+ across all core modules
664
671
 
665
672
  Quality Guarantees Beyond Coverage:
666
673
 
@@ -698,34 +705,34 @@ be managed through Homebrew.
698
705
 
699
706
  ## Project Status
700
707
 
701
- VersionTracker has completed major technical debt cleanup and is now production-ready.
702
- All critical and medium-priority complexity issues have been resolved. Key completed improvements include:
708
+ VersionTracker v1.0.0 is production-stable. All critical technical debt has been resolved
709
+ and the tool is fully operational on macOS. Key highlights:
703
710
 
704
- * **Complete Code Complexity Resolution**: All 10 high & medium-priority complex functions refactored
705
- * Refactored the codebase to follow the command pattern with dedicated handlers
706
- * Improved project structure with better module separation
707
- * Enhanced error handling with custom exceptions and proper type hints
708
- * Added support for smart progress indicators and adaptive rate limiting
709
- * Moved handler functions to a dedicated `handlers/` directory
710
- * **70%+ test coverage** with 950+ passing tests and 0 failing tests
711
+ * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
712
+ * **70%+ test coverage** with 2,194+ passing tests and 0 failing tests
711
713
  * **Zero high-severity security vulnerabilities**
712
-
713
- ## Recent Major Achievements
714
-
715
- * **Technical Debt Elimination**: Reduced function complexity by 60-90% across 10 critical functions
716
- * **Type Safety**: All type checking passes with proper None handling and NoReturn annotations
717
- * Improved test coverage with parameterized tests for version comparison
718
- * Created a mock server for network operation testing with simulated failures
719
- * Implemented an advanced caching mechanism for Homebrew queries
720
- * Added request batching to reduce network calls
721
- * Enhanced error handling for network operations with focused helper functions
714
+ * **Complete complexity resolution**: all high & medium-priority complex functions refactored
715
+ * **Async Homebrew API**: install and update candidate checks use async operations by default
716
+ * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
717
+ * **Lazy config initialisation**: no subprocess on import — fast startup
718
+ * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
719
+
720
+ ## Recent Major Achievements (v1.0.0)
721
+
722
+ * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
723
+ * **Thread-safety fix**: resolved `patch("builtins.print")` race condition in concurrent tests
724
+ that polluted the full test suite
725
+ * **Async deadlock fix**: `async_to_sync` decorator usage audited; `process_all_async()` used in async contexts
726
+ * **ConfigLoader extraction**: file I/O, env-var loading, and brew detection separated from `Config` data class
727
+ * **Module migration complete**: deleted `version_legacy.py` (−2,110 lines) and `app_finder.py` (−1,579 lines)
728
+ * **CI/CD pipeline hardened**: CodeQL, Sigstore signing, Trusted Publisher PyPI, Homebrew tap formula test
722
729
 
723
730
  ## Planned Improvements
724
731
 
725
732
  * Add more package managers support (MacPorts, etc.)
726
733
  * Implement automatic update capabilities for Homebrew-manageable applications
727
- * Explore using `asyncio` for network operations
728
734
  * Add GUI interface
735
+ * Raise test coverage to 85%+ across all core modules
729
736
 
730
737
  ## License
731
738
 
@@ -4,10 +4,10 @@
4
4
 
5
5
  <div align="center">
6
6
 
7
- ## 🚀 Production-Ready macOS Application Manager
7
+ ## macOS Application Version Manager
8
8
 
9
- [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](PROJECT_REVIEW.md)
10
- [![Production Ready](https://img.shields.io/badge/Status-Production%20Ready-success?style=for-the-badge&logo=checkmarx&logoColor=white)](PROJECT_REVIEW.md)
9
+ [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](TODO.md)
10
+ [![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)
11
11
 
12
12
  </div>
13
13
 
@@ -21,13 +21,22 @@
21
21
  [![CodeQL](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/codeql-analysis.yml?branch=master&label=CodeQL&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
22
22
  [![Coverage](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/coverage.yml?branch=master&label=Coverage&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
23
23
  [![Performance](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/performance.yml?branch=master&label=Performance&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
24
- [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Release)](https://github.com/docdyhr/versiontracker/releases/latest)
24
+ [![Release Workflow](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/release.yml?label=Release%20Pipeline&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
25
+ [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Latest%20Release)](https://github.com/docdyhr/versiontracker/releases/latest)
26
+ [![PyPI](https://img.shields.io/pypi/v/macversiontracker?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/macversiontracker/)
27
+
28
+ #### 🧪 Test Matrix
29
+
30
+ | Platform | Python 3.12 | Python 3.13 |
31
+ |----------|:-----------:|:-----------:|
32
+ | **Ubuntu 22.04** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
33
+ | **macOS Latest** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
25
34
 
26
35
  ### 🔒 Security & Quality
27
36
 
28
37
  [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/master?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
29
- [![Test Coverage](https://img.shields.io/badge/Coverage-70%2B%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
30
- [![Tests Passing](https://img.shields.io/badge/Tests-1,136%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
38
+ [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
39
+ [![Tests Passing](https://img.shields.io/badge/Tests-2%2C385%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
31
40
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
32
41
  [![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)
33
42
  [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
@@ -62,14 +71,13 @@
62
71
  ---
63
72
 
64
73
  * Name: Versiontracker
65
- * Version: 0.8.1
74
+ * Version: 1.0.0
66
75
  * Programming language: Python 3.12+
67
76
  * Author: thomas
68
77
  * Purpose: CLI versiontracker and update tool for macOS
69
- * Release date: 21. Feb 2022 (Updated: January 2026)
70
- * Code Quality: **70%+ test coverage with 1,230+ passing tests**,
71
- **all previously identified high & medium complexity issues resolved**,
72
- **AI/ML capabilities and advanced analytics platform**
78
+ * Release date: 21. Feb 2022 (Updated: April 2026)
79
+ * Code Quality: **70%+ overall test coverage with 2,194+ passing tests**,
80
+ **all previously identified high & medium complexity issues resolved**
73
81
 
74
82
  ## Quick Start
75
83
 
@@ -96,8 +104,8 @@ versiontracker --help
96
104
  ## Overview
97
105
 
98
106
  Versiontracker is a command-line tool for macOS that helps you manage applications
99
- installed outside of the App Store. Recently undergone complete technical debt cleanup
100
- with **70%+ test coverage** and **all high & medium-priority complexity issues resolved**.
107
+ installed outside of the App Store. v1.0.0 is the first production-stable release —
108
+ core CLI, config, and Homebrew integration are fully operational.
101
109
 
102
110
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
103
111
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -581,24 +589,22 @@ VersionTracker intentionally uses a heavy mocking approach to:
581
589
 
582
590
  Current Coverage Profile:
583
591
 
584
- * Reported line coverage: ≈10–11%
585
- * Effective logical path coverage for core decision branches: substantially higher (most comparison and
586
- matching branches exercised)
587
- * High mock call volume (5,000+ patched interactions) reduces counted executable lines while still validating behavior
592
+ * Reported line coverage: ≈70%+ overall
593
+ * Core modules (matcher, finder, config) have 78–98% coverage
594
+ * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
588
595
 
589
- Why Coverage Is Not Higher:
596
+ Why Some Coverage Is Lower:
590
597
 
591
- * Many modules rely on guarded platform / network code paths that are mocked out
592
- * Async and I/O heavy branches prefer behavioral contract tests instead of executing real subprocess or network calls
593
- * Legacy compatibility layers (fallback logic) are thin wrappers rarely worth direct line coverage
598
+ * Platform / network code paths are mocked out in CI for portability
599
+ * Async and I/O heavy branches use behavioral contract tests instead of real subprocess/network calls
600
+ * Legacy compatibility adapters are thin wrappers at the CLI/config boundary
594
601
 
595
602
  Planned Improvements:
596
603
 
597
604
  * Add end-to-end integration tests for: discovery → recommendation → outdated flow
598
605
  * Introduce cold vs warm cache performance validation tests
599
606
  * Add semantic regression test matrix for prerelease/build metadata edge cases
600
- * Incremental async Homebrew operations tests once migration begins
601
- * Raise coverage target after integration suite (goal: 25–30% meaningful executable coverage with higher branch coverage)
607
+ * Raise coverage to 85%+ across all core modules
602
608
 
603
609
  Quality Guarantees Beyond Coverage:
604
610
 
@@ -636,34 +642,34 @@ be managed through Homebrew.
636
642
 
637
643
  ## Project Status
638
644
 
639
- VersionTracker has completed major technical debt cleanup and is now production-ready.
640
- All critical and medium-priority complexity issues have been resolved. Key completed improvements include:
645
+ VersionTracker v1.0.0 is production-stable. All critical technical debt has been resolved
646
+ and the tool is fully operational on macOS. Key highlights:
641
647
 
642
- * **Complete Code Complexity Resolution**: All 10 high & medium-priority complex functions refactored
643
- * Refactored the codebase to follow the command pattern with dedicated handlers
644
- * Improved project structure with better module separation
645
- * Enhanced error handling with custom exceptions and proper type hints
646
- * Added support for smart progress indicators and adaptive rate limiting
647
- * Moved handler functions to a dedicated `handlers/` directory
648
- * **70%+ test coverage** with 950+ passing tests and 0 failing tests
648
+ * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
649
+ * **70%+ test coverage** with 2,194+ passing tests and 0 failing tests
649
650
  * **Zero high-severity security vulnerabilities**
650
-
651
- ## Recent Major Achievements
652
-
653
- * **Technical Debt Elimination**: Reduced function complexity by 60-90% across 10 critical functions
654
- * **Type Safety**: All type checking passes with proper None handling and NoReturn annotations
655
- * Improved test coverage with parameterized tests for version comparison
656
- * Created a mock server for network operation testing with simulated failures
657
- * Implemented an advanced caching mechanism for Homebrew queries
658
- * Added request batching to reduce network calls
659
- * Enhanced error handling for network operations with focused helper functions
651
+ * **Complete complexity resolution**: all high & medium-priority complex functions refactored
652
+ * **Async Homebrew API**: install and update candidate checks use async operations by default
653
+ * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
654
+ * **Lazy config initialisation**: no subprocess on import — fast startup
655
+ * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
656
+
657
+ ## Recent Major Achievements (v1.0.0)
658
+
659
+ * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
660
+ * **Thread-safety fix**: resolved `patch("builtins.print")` race condition in concurrent tests
661
+ that polluted the full test suite
662
+ * **Async deadlock fix**: `async_to_sync` decorator usage audited; `process_all_async()` used in async contexts
663
+ * **ConfigLoader extraction**: file I/O, env-var loading, and brew detection separated from `Config` data class
664
+ * **Module migration complete**: deleted `version_legacy.py` (−2,110 lines) and `app_finder.py` (−1,579 lines)
665
+ * **CI/CD pipeline hardened**: CodeQL, Sigstore signing, Trusted Publisher PyPI, Homebrew tap formula test
660
666
 
661
667
  ## Planned Improvements
662
668
 
663
669
  * Add more package managers support (MacPorts, etc.)
664
670
  * Implement automatic update capabilities for Homebrew-manageable applications
665
- * Explore using `asyncio` for network operations
666
671
  * Add GUI interface
672
+ * Raise test coverage to 85%+ across all core modules
667
673
 
668
674
  ## License
669
675
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: macversiontracker
3
- Version: 0.9.0
3
+ Version: 1.0.1
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
@@ -11,7 +11,7 @@ Project-URL: Source Code, https://github.com/docdyhr/versiontracker
11
11
  Project-URL: Changelog, https://github.com/docdyhr/versiontracker/blob/master/CHANGELOG.md
12
12
  Project-URL: PyPI, https://pypi.org/project/macversiontracker/
13
13
  Keywords: macos,homebrew,version,tracking,updates,cask
14
- Classifier: Development Status :: 4 - Beta
14
+ Classifier: Development Status :: 5 - Production/Stable
15
15
  Classifier: Environment :: Console
16
16
  Classifier: Intended Audience :: System Administrators
17
17
  Classifier: Intended Audience :: End Users/Desktop
@@ -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.13.4
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: black>=26.3.1; extra == "dev"
40
41
  Requires-Dist: ruff>=0.4; 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"
@@ -66,10 +67,10 @@ Dynamic: license-file
66
67
 
67
68
  <div align="center">
68
69
 
69
- ## 🚀 Production-Ready macOS Application Manager
70
+ ## macOS Application Version Manager
70
71
 
71
- [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](PROJECT_REVIEW.md)
72
- [![Production Ready](https://img.shields.io/badge/Status-Production%20Ready-success?style=for-the-badge&logo=checkmarx&logoColor=white)](PROJECT_REVIEW.md)
72
+ [![Project Grade](https://img.shields.io/badge/Grade-A-brightgreen?style=for-the-badge&logo=gradle&logoColor=white)](TODO.md)
73
+ [![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
74
 
74
75
  </div>
75
76
 
@@ -83,13 +84,22 @@ Dynamic: license-file
83
84
  [![CodeQL](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/codeql-analysis.yml?branch=master&label=CodeQL&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
84
85
  [![Coverage](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/coverage.yml?branch=master&label=Coverage&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
85
86
  [![Performance](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/performance.yml?branch=master&label=Performance&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
86
- [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Release)](https://github.com/docdyhr/versiontracker/releases/latest)
87
+ [![Release Workflow](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/release.yml?label=Release%20Pipeline&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
88
+ [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Latest%20Release)](https://github.com/docdyhr/versiontracker/releases/latest)
89
+ [![PyPI](https://img.shields.io/pypi/v/macversiontracker?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/macversiontracker/)
90
+
91
+ #### 🧪 Test Matrix
92
+
93
+ | Platform | Python 3.12 | Python 3.13 |
94
+ |----------|:-----------:|:-----------:|
95
+ | **Ubuntu 22.04** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
96
+ | **macOS Latest** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
87
97
 
88
98
  ### 🔒 Security & Quality
89
99
 
90
100
  [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/master?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
91
- [![Test Coverage](https://img.shields.io/badge/Coverage-70%2B%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
92
- [![Tests Passing](https://img.shields.io/badge/Tests-1,136%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
101
+ [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
102
+ [![Tests Passing](https://img.shields.io/badge/Tests-2%2C385%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
93
103
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
94
104
  [![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)
95
105
  [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
@@ -124,14 +134,13 @@ Dynamic: license-file
124
134
  ---
125
135
 
126
136
  * Name: Versiontracker
127
- * Version: 0.8.1
137
+ * Version: 1.0.0
128
138
  * Programming language: Python 3.12+
129
139
  * Author: thomas
130
140
  * Purpose: CLI versiontracker and update tool for macOS
131
- * Release date: 21. Feb 2022 (Updated: January 2026)
132
- * Code Quality: **70%+ test coverage with 1,230+ passing tests**,
133
- **all previously identified high & medium complexity issues resolved**,
134
- **AI/ML capabilities and advanced analytics platform**
141
+ * Release date: 21. Feb 2022 (Updated: April 2026)
142
+ * Code Quality: **70%+ overall test coverage with 2,194+ passing tests**,
143
+ **all previously identified high & medium complexity issues resolved**
135
144
 
136
145
  ## Quick Start
137
146
 
@@ -158,8 +167,8 @@ versiontracker --help
158
167
  ## Overview
159
168
 
160
169
  Versiontracker is a command-line tool for macOS that helps you manage applications
161
- installed outside of the App Store. Recently undergone complete technical debt cleanup
162
- with **70%+ test coverage** and **all high & medium-priority complexity issues resolved**.
170
+ installed outside of the App Store. v1.0.0 is the first production-stable release —
171
+ core CLI, config, and Homebrew integration are fully operational.
163
172
 
164
173
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
165
174
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -643,24 +652,22 @@ VersionTracker intentionally uses a heavy mocking approach to:
643
652
 
644
653
  Current Coverage Profile:
645
654
 
646
- * Reported line coverage: ≈10–11%
647
- * Effective logical path coverage for core decision branches: substantially higher (most comparison and
648
- matching branches exercised)
649
- * High mock call volume (5,000+ patched interactions) reduces counted executable lines while still validating behavior
655
+ * Reported line coverage: ≈70%+ overall
656
+ * Core modules (matcher, finder, config) have 78–98% coverage
657
+ * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
650
658
 
651
- Why Coverage Is Not Higher:
659
+ Why Some Coverage Is Lower:
652
660
 
653
- * Many modules rely on guarded platform / network code paths that are mocked out
654
- * Async and I/O heavy branches prefer behavioral contract tests instead of executing real subprocess or network calls
655
- * Legacy compatibility layers (fallback logic) are thin wrappers rarely worth direct line coverage
661
+ * Platform / network code paths are mocked out in CI for portability
662
+ * Async and I/O heavy branches use behavioral contract tests instead of real subprocess/network calls
663
+ * Legacy compatibility adapters are thin wrappers at the CLI/config boundary
656
664
 
657
665
  Planned Improvements:
658
666
 
659
667
  * Add end-to-end integration tests for: discovery → recommendation → outdated flow
660
668
  * Introduce cold vs warm cache performance validation tests
661
669
  * Add semantic regression test matrix for prerelease/build metadata edge cases
662
- * Incremental async Homebrew operations tests once migration begins
663
- * Raise coverage target after integration suite (goal: 25–30% meaningful executable coverage with higher branch coverage)
670
+ * Raise coverage to 85%+ across all core modules
664
671
 
665
672
  Quality Guarantees Beyond Coverage:
666
673
 
@@ -698,34 +705,34 @@ be managed through Homebrew.
698
705
 
699
706
  ## Project Status
700
707
 
701
- VersionTracker has completed major technical debt cleanup and is now production-ready.
702
- All critical and medium-priority complexity issues have been resolved. Key completed improvements include:
708
+ VersionTracker v1.0.0 is production-stable. All critical technical debt has been resolved
709
+ and the tool is fully operational on macOS. Key highlights:
703
710
 
704
- * **Complete Code Complexity Resolution**: All 10 high & medium-priority complex functions refactored
705
- * Refactored the codebase to follow the command pattern with dedicated handlers
706
- * Improved project structure with better module separation
707
- * Enhanced error handling with custom exceptions and proper type hints
708
- * Added support for smart progress indicators and adaptive rate limiting
709
- * Moved handler functions to a dedicated `handlers/` directory
710
- * **70%+ test coverage** with 950+ passing tests and 0 failing tests
711
+ * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
712
+ * **70%+ test coverage** with 2,194+ passing tests and 0 failing tests
711
713
  * **Zero high-severity security vulnerabilities**
712
-
713
- ## Recent Major Achievements
714
-
715
- * **Technical Debt Elimination**: Reduced function complexity by 60-90% across 10 critical functions
716
- * **Type Safety**: All type checking passes with proper None handling and NoReturn annotations
717
- * Improved test coverage with parameterized tests for version comparison
718
- * Created a mock server for network operation testing with simulated failures
719
- * Implemented an advanced caching mechanism for Homebrew queries
720
- * Added request batching to reduce network calls
721
- * Enhanced error handling for network operations with focused helper functions
714
+ * **Complete complexity resolution**: all high & medium-priority complex functions refactored
715
+ * **Async Homebrew API**: install and update candidate checks use async operations by default
716
+ * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
717
+ * **Lazy config initialisation**: no subprocess on import — fast startup
718
+ * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
719
+
720
+ ## Recent Major Achievements (v1.0.0)
721
+
722
+ * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
723
+ * **Thread-safety fix**: resolved `patch("builtins.print")` race condition in concurrent tests
724
+ that polluted the full test suite
725
+ * **Async deadlock fix**: `async_to_sync` decorator usage audited; `process_all_async()` used in async contexts
726
+ * **ConfigLoader extraction**: file I/O, env-var loading, and brew detection separated from `Config` data class
727
+ * **Module migration complete**: deleted `version_legacy.py` (−2,110 lines) and `app_finder.py` (−1,579 lines)
728
+ * **CI/CD pipeline hardened**: CodeQL, Sigstore signing, Trusted Publisher PyPI, Homebrew tap formula test
722
729
 
723
730
  ## Planned Improvements
724
731
 
725
732
  * Add more package managers support (MacPorts, etc.)
726
733
  * Implement automatic update capabilities for Homebrew-manageable applications
727
- * Explore using `asyncio` for network operations
728
734
  * Add GUI interface
735
+ * Raise test coverage to 85%+ across all core modules
729
736
 
730
737
  ## License
731
738