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.
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/PKG-INFO +188 -50
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/README.md +182 -45
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/PKG-INFO +188 -50
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/SOURCES.txt +17 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/requires.txt +5 -4
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/pyproject.toml +7 -6
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_cli.py +50 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_cli_auto_updates.py +3 -0
- macversiontracker-1.1.0/tests/test_comparator_coverage.py +413 -0
- macversiontracker-1.1.0/tests/test_config_gaps.py +274 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_end_to_end_integration.py +51 -17
- macversiontracker-1.1.0/tests/test_enhanced_matching_coverage.py +138 -0
- macversiontracker-1.1.0/tests/test_exceptions_and_error_codes.py +420 -0
- macversiontracker-1.1.0/tests/test_finder_new_coverage.py +435 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_integration.py +42 -29
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_main.py +54 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_matcher_coverage.py +16 -5
- macversiontracker-1.1.0/tests/test_menubar_app.py +57 -0
- macversiontracker-1.1.0/tests/test_module_lazy_imports.py +54 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_outdated_handlers.py +94 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ui.py +21 -69
- macversiontracker-1.1.0/tests/test_version_parser.py +467 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/__init__.py +1 -1
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/__main__.py +14 -1
- macversiontracker-1.1.0/versiontracker/audit/__init__.py +88 -0
- macversiontracker-1.1.0/versiontracker/audit/auto_update.py +555 -0
- macversiontracker-1.1.0/versiontracker/audit/blocklist.py +154 -0
- macversiontracker-1.1.0/versiontracker/audit/discovery.py +378 -0
- macversiontracker-1.1.0/versiontracker/audit/homebrew.py +195 -0
- macversiontracker-1.1.0/versiontracker/audit/models.py +252 -0
- macversiontracker-1.1.0/versiontracker/audit/rendering.py +236 -0
- macversiontracker-1.1.0/versiontracker/audit/service.py +185 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/cli.py +27 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/__init__.py +2 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/app_handlers.py +2 -1
- macversiontracker-1.1.0/versiontracker/handlers/audit_handlers.py +111 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/config_handlers.py +2 -2
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/filter_handlers.py +1 -1
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/macos_handlers.py +1 -1
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/setup_handlers.py +5 -4
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/macos_integration.py +7 -2
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/menubar_app.py +2 -2
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/ui.py +21 -7
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/LICENSE +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/entry_points.txt +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/macversiontracker.egg-info/top_level.txt +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/setup.cfg +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_additional_functions.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_advanced_cache.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ai_module.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_app_store.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_extra.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_new.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_apps_new_pytest.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_homebrew.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_homebrew_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_integration.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_network.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_async_parity.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_advanced.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_edge_cases.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_integration.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_integration_flows.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_update_rollback.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_auto_updates.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_brew_candidates.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_brew_installability.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_cache.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_loader.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_save.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_validation_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_config_yaml.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_enhanced_matching.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_export.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_finder_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_homebrew.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_homebrew_advanced.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_001_discovery.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_002_recommendation.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_003_matching.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_int_004_async_parity.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_macos_integration.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ml_module.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_network_operations.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_parameterized_edge_cases.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_parameterized_version.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_platform_compatibility.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_profiling.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_profiling_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_project_consistency.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ui_enhanced.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_ui_new.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_utils.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_utils_comprehensive.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_utils_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_batch.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_comprehensive.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_edge_cases.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_fuzzy.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_homebrew.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_legacy_coverage.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/tests/test_version_utils.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/advanced_cache.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/ai/__init__.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/__init__.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/cache.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/finder.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/apps/matcher.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/async_homebrew.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/async_network.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/cache.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/config.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/deprecation.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/enhanced_matching.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/error_codes.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/exceptions.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/experimental/__init__.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/experimental/analytics.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/experimental/benchmarks.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/export.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/auto_update_types.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/backup_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/brew_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/error_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/export_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/outdated_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/ui_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/handlers/utils_handlers.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/homebrew.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/ml/__init__.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/plugins/__init__.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/plugins/example_plugins.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/profiling.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/py.typed +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/utils.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/__init__.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/batch.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/comparator.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/fuzzy.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/homebrew.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/models.py +0 -0
- {macversiontracker-1.0.0 → macversiontracker-1.1.0}/versiontracker/version/parser.py +0 -0
- {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.
|
|
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:
|
|
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>=
|
|
40
|
-
Requires-Dist: ruff
|
|
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.
|
|
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
|

|
|
@@ -68,8 +80,8 @@ Dynamic: license-file
|
|
|
68
80
|
|
|
69
81
|
## macOS Application Version Manager
|
|
70
82
|
|
|
71
|
-
[](TODO.md)
|
|
84
|
+
[](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
|
[](https://codecov.io/gh/docdyhr/versiontracker)
|
|
100
|
-
[](https://github.com/docdyhr/versiontracker)
|
|
113
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
|
|
102
114
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
103
115
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
104
116
|
[](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.
|
|
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:
|
|
141
|
-
* Code Quality:
|
|
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.
|
|
170
|
-
core CLI
|
|
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
|
|
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
|
-
#
|
|
431
|
-
python -m versiontracker --outdated
|
|
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: ≈
|
|
656
|
-
*
|
|
657
|
-
|
|
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
|
|
781
|
+
Why Some Coverage Is Lower:
|
|
661
782
|
|
|
662
|
-
*
|
|
663
|
-
* Async and I/O heavy branches
|
|
664
|
-
* Legacy compatibility
|
|
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
|
-
*
|
|
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
|
|
711
|
-
|
|
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
|
-
* **
|
|
714
|
-
*
|
|
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
|
-
|
|
723
|
-
|
|
724
|
-
* **
|
|
725
|
-
* **
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
*
|
|
730
|
-
*
|
|
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
|