macversiontracker 1.0.1__tar.gz → 1.2.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.1 → macversiontracker-1.2.0}/PKG-INFO +205 -43
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/README.md +201 -37
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/PKG-INFO +205 -43
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/SOURCES.txt +13 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/requires.txt +2 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/pyproject.toml +10 -11
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_advanced_cache.py +134 -7
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ai_module.py +24 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_homebrew.py +25 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_network.py +25 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_parity.py +1 -2
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_integration_flows.py +5 -5
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_brew_candidates.py +11 -2
- macversiontracker-1.2.0/tests/test_cli.py +272 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_cli_auto_updates.py +9 -3
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_export.py +58 -1
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_finder_coverage.py +8 -11
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_finder_new_coverage.py +75 -8
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_homebrew.py +5 -5
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_homebrew_advanced.py +69 -1
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_002_recommendation.py +4 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_003_matching.py +4 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_004_async_parity.py +2 -2
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_integration.py +36 -24
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_macos_integration.py +130 -21
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_main.py +128 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_matcher_coverage.py +31 -5
- macversiontracker-1.2.0/tests/test_menubar_app.py +162 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ml_module.py +23 -16
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_outdated_handlers.py +29 -15
- macversiontracker-1.2.0/tests/test_plugins.py +41 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_project_consistency.py +67 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_batch.py +21 -0
- macversiontracker-1.2.0/tests/test_version_parser.py +467 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/__init__.py +1 -1
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/__main__.py +24 -6
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/advanced_cache.py +118 -34
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/ai/__init__.py +20 -5
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/finder.py +48 -25
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/matcher.py +5 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/async_homebrew.py +18 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/async_network.py +18 -2
- macversiontracker-1.2.0/versiontracker/audit/__init__.py +88 -0
- macversiontracker-1.2.0/versiontracker/audit/auto_update.py +555 -0
- macversiontracker-1.2.0/versiontracker/audit/blocklist.py +154 -0
- macversiontracker-1.2.0/versiontracker/audit/discovery.py +378 -0
- macversiontracker-1.2.0/versiontracker/audit/homebrew.py +195 -0
- macversiontracker-1.2.0/versiontracker/audit/models.py +252 -0
- macversiontracker-1.2.0/versiontracker/audit/rendering.py +236 -0
- macversiontracker-1.2.0/versiontracker/audit/service.py +185 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/cli.py +95 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/export.py +107 -32
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/__init__.py +4 -0
- macversiontracker-1.2.0/versiontracker/handlers/ai_handlers.py +125 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/app_handlers.py +36 -14
- macversiontracker-1.2.0/versiontracker/handlers/audit_handlers.py +111 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/backup_handlers.py +2 -1
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/brew_handlers.py +76 -44
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/config_handlers.py +2 -2
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/export_handlers.py +4 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/filter_handlers.py +18 -7
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/macos_handlers.py +1 -1
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/outdated_handlers.py +50 -22
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/setup_handlers.py +26 -17
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/utils_handlers.py +0 -43
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/homebrew.py +3 -3
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/macos_integration.py +25 -81
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/menubar_app.py +24 -31
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/ml/__init__.py +2 -2
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/plugins/__init__.py +3 -4
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/ui.py +11 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/utils.py +43 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/batch.py +11 -6
- macversiontracker-1.0.1/tests/test_cli.py +0 -137
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/LICENSE +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/entry_points.txt +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/top_level.txt +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/setup.cfg +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_additional_functions.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_app_store.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_extra.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_new.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_new_pytest.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_homebrew_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_integration.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_advanced.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_edge_cases.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_handlers.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_integration.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_rollback.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_updates.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_brew_installability.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_cache.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_comparator_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_gaps.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_loader.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_save.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_validation_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_yaml.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_end_to_end_integration.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_enhanced_matching.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_enhanced_matching_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_exceptions_and_error_codes.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_001_discovery.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_module_lazy_imports.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_network_operations.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_parameterized_edge_cases.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_parameterized_version.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_platform_compatibility.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_profiling.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_profiling_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ui.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ui_enhanced.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ui_new.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_utils.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_utils_comprehensive.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_utils_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_comprehensive.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_edge_cases.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_fuzzy.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_homebrew.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_legacy_coverage.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_utils.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/__init__.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/cache.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/cache.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/config.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/deprecation.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/enhanced_matching.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/error_codes.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/exceptions.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/experimental/__init__.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/experimental/analytics.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/experimental/benchmarks.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_types.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/error_handlers.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/ui_handlers.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/plugins/example_plugins.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/profiling.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/py.typed +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/__init__.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/comparator.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/fuzzy.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/homebrew.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/models.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/parser.py +0 -0
- {macversiontracker-1.0.1 → macversiontracker-1.2.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
|
|
3
|
+
Version: 1.2.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
|
|
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://github.com/docdyhr/versiontracker
|
|
|
8
8
|
Project-URL: Bug Tracker, https://github.com/docdyhr/versiontracker/issues
|
|
9
9
|
Project-URL: Documentation, https://github.com/docdyhr/versiontracker
|
|
10
10
|
Project-URL: Source Code, https://github.com/docdyhr/versiontracker
|
|
11
|
-
Project-URL: Changelog, https://github.com/docdyhr/versiontracker/blob/
|
|
11
|
+
Project-URL: Changelog, https://github.com/docdyhr/versiontracker/blob/main/CHANGELOG.md
|
|
12
12
|
Project-URL: PyPI, https://pypi.org/project/macversiontracker/
|
|
13
13
|
Keywords: macos,homebrew,version,tracking,updates,cask
|
|
14
14
|
Classifier: Development Status :: 5 - Production/Stable
|
|
@@ -30,15 +30,14 @@ Requires-Dist: tqdm>=4.65
|
|
|
30
30
|
Requires-Dist: psutil>=6.0
|
|
31
31
|
Requires-Dist: tabulate>=0.9.0
|
|
32
32
|
Requires-Dist: termcolor>=3.3.0
|
|
33
|
-
Requires-Dist: aiohttp>=3.
|
|
33
|
+
Requires-Dist: aiohttp>=3.14.0
|
|
34
34
|
Provides-Extra: dev
|
|
35
35
|
Requires-Dist: pytest>=8.0; extra == "dev"
|
|
36
36
|
Requires-Dist: pytest-cov>=7.0; extra == "dev"
|
|
37
37
|
Requires-Dist: pytest-timeout>=2.1; extra == "dev"
|
|
38
38
|
Requires-Dist: pytest-mock>=3.14; extra == "dev"
|
|
39
39
|
Requires-Dist: pytest-asyncio>=1.0; extra == "dev"
|
|
40
|
-
Requires-Dist:
|
|
41
|
-
Requires-Dist: ruff>=0.4; extra == "dev"
|
|
40
|
+
Requires-Dist: ruff==0.16.10; extra == "dev"
|
|
42
41
|
Requires-Dist: mypy>=1.10; extra == "dev"
|
|
43
42
|
Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
|
|
44
43
|
Requires-Dist: build>=1.0; extra == "dev"
|
|
@@ -53,7 +52,6 @@ Requires-Dist: pytest-asyncio>=1.0; extra == "test"
|
|
|
53
52
|
Provides-Extra: security
|
|
54
53
|
Requires-Dist: bandit[toml]>=1.8; extra == "security"
|
|
55
54
|
Requires-Dist: pip-audit>=2.9; extra == "security"
|
|
56
|
-
Requires-Dist: safety>=3.0; extra == "security"
|
|
57
55
|
Provides-Extra: fuzzy
|
|
58
56
|
Requires-Dist: rapidfuzz>=3.0; extra == "fuzzy"
|
|
59
57
|
Provides-Extra: ml
|
|
@@ -61,6 +59,17 @@ Requires-Dist: numpy>=1.24.0; extra == "ml"
|
|
|
61
59
|
Requires-Dist: scikit-learn>=1.3.0; extra == "ml"
|
|
62
60
|
Dynamic: license-file
|
|
63
61
|
|
|
62
|
+
<!-- markdownlint-disable MD041 -->
|
|
63
|
+
<div align="right">
|
|
64
|
+
|
|
65
|
+
<a href="https://railway.com?referralCode=QhjuBc">
|
|
66
|
+
|
|
67
|
+
<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 -->
|
|
68
|
+
|
|
69
|
+
</a>
|
|
70
|
+
|
|
71
|
+
</div>
|
|
72
|
+
|
|
64
73
|
# Versiontracker Update tool for macOS
|
|
65
74
|
|
|
66
75
|

|
|
@@ -78,31 +87,28 @@ Dynamic: license-file
|
|
|
78
87
|
|
|
79
88
|
### 🏗️ Build & CI/CD Pipeline
|
|
80
89
|
|
|
81
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
|
|
91
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/lint.yml)
|
|
92
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
93
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
|
|
94
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
|
|
95
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
|
|
87
96
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
|
|
88
97
|
[](https://github.com/docdyhr/versiontracker/releases/latest)
|
|
89
98
|
[](https://pypi.org/project/macversiontracker/)
|
|
90
99
|
|
|
91
100
|
#### 🧪 Test Matrix
|
|
92
101
|
|
|
93
|
-
| Platform
|
|
94
|
-
|
|
95
|
-
| **Ubuntu 22.04** | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
|
|
105
|
+
| **macOS Latest** | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
|
|
97
106
|
|
|
98
107
|
### 🔒 Security & Quality
|
|
99
108
|
|
|
100
|
-
[](https://github.com/docdyhr/versiontracker)
|
|
102
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
|
|
109
|
+
[](https://codecov.io/gh/docdyhr/versiontracker)
|
|
103
110
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
104
111
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
105
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
106
112
|
|
|
107
113
|
### 🎨 Code Standards
|
|
108
114
|
|
|
@@ -118,7 +124,7 @@ Dynamic: license-file
|
|
|
118
124
|
[](https://github.com/docdyhr/versiontracker/pulls)
|
|
119
125
|
[](https://github.com/docdyhr/versiontracker/network)
|
|
120
126
|
[](https://github.com/docdyhr/versiontracker/stargazers)
|
|
121
|
-
[](https://github.com/docdyhr/versiontracker/commits/
|
|
127
|
+
[](https://github.com/docdyhr/versiontracker/commits/main)
|
|
122
128
|
[](https://github.com/docdyhr/versiontracker/graphs/contributors)
|
|
123
129
|
[](https://opensource.org/licenses/MIT)
|
|
124
130
|
|
|
@@ -134,12 +140,13 @@ Dynamic: license-file
|
|
|
134
140
|
---
|
|
135
141
|
|
|
136
142
|
* Name: Versiontracker
|
|
137
|
-
* Version: 1.
|
|
143
|
+
* Version: 1.2.0
|
|
138
144
|
* Programming language: Python 3.12+
|
|
139
145
|
* Author: thomas
|
|
140
146
|
* Purpose: CLI versiontracker and update tool for macOS
|
|
141
|
-
* Release date: 21. Feb 2022
|
|
142
|
-
* Code Quality: **
|
|
147
|
+
* Release date: 21. Feb 2022
|
|
148
|
+
* Code Quality: **comprehensive automated test suite with high branch coverage**, enforced in CI
|
|
149
|
+
(see the CI Pipeline and Codecov badges above),
|
|
143
150
|
**all previously identified high & medium complexity issues resolved**
|
|
144
151
|
|
|
145
152
|
## Quick Start
|
|
@@ -160,15 +167,20 @@ versiontracker --recommend
|
|
|
160
167
|
# Check for outdated applications
|
|
161
168
|
versiontracker --check-outdated
|
|
162
169
|
|
|
170
|
+
# Audit apps not managed by the App Store, Homebrew, or a local auto-updater
|
|
171
|
+
versiontracker --audit
|
|
172
|
+
|
|
173
|
+
# Ask a natural-language question, routed to a supported action
|
|
174
|
+
versiontracker --ask "which apps need manual updates"
|
|
175
|
+
|
|
163
176
|
# Show help
|
|
164
177
|
versiontracker --help
|
|
165
178
|
```
|
|
166
179
|
|
|
167
180
|
## Overview
|
|
168
181
|
|
|
169
|
-
Versiontracker is a command-line tool for macOS that helps you manage applications
|
|
170
|
-
installed outside of the App Store
|
|
171
|
-
core CLI, config, and Homebrew integration are fully operational.
|
|
182
|
+
Versiontracker is a production-stable command-line tool for macOS that helps you manage applications
|
|
183
|
+
installed outside of the App Store — core CLI, config, and Homebrew integration are fully operational.
|
|
172
184
|
|
|
173
185
|
It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
|
|
174
186
|
using Homebrew casks, making it easier to keep your applications up to date.
|
|
@@ -196,6 +208,88 @@ using Homebrew casks, making it easier to keep your applications up to date.
|
|
|
196
208
|
* Adaptive rate limiting based on CPU and memory usage
|
|
197
209
|
* Support for saving and loading query filters
|
|
198
210
|
* **Auto-updates detection** for Homebrew casks with filtering options
|
|
211
|
+
* **Unmanaged application audit** (`--audit`): identifies apps with no App
|
|
212
|
+
Store, Homebrew, or local auto-update coverage, with full per-signal
|
|
213
|
+
evidence and JSON/YAML/CSV export
|
|
214
|
+
* **Natural-language queries** (`--ask`): ask plain-English questions like
|
|
215
|
+
"which apps need manual updates" and get routed to the matching command;
|
|
216
|
+
unsupported or unclear queries always print a clear message instead of
|
|
217
|
+
guessing
|
|
218
|
+
|
|
219
|
+
## Advanced Features
|
|
220
|
+
|
|
221
|
+
### ML-Powered App Matching (optional)
|
|
222
|
+
|
|
223
|
+
VersionTracker includes an optional machine-learning engine that improves
|
|
224
|
+
app-to-cask matching accuracy using TF-IDF embeddings and a logistic regression
|
|
225
|
+
confidence model.
|
|
226
|
+
|
|
227
|
+
**Install the ML extras:**
|
|
228
|
+
|
|
229
|
+
```bash
|
|
230
|
+
pip install macversiontracker[ml]
|
|
231
|
+
# or via Homebrew tap (installs core only; add ML extras via pip after)
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
**What it provides** (`versiontracker.ml`):
|
|
235
|
+
|
|
236
|
+
* `MLRecommendationEngine` — semantic similarity matching between installed apps
|
|
237
|
+
and Homebrew casks using TF-IDF + cosine similarity
|
|
238
|
+
* `MatchingConfidenceModel` — scikit-learn classifier that scores each candidate
|
|
239
|
+
match; trained model is cached under `~/.config/versiontracker/ml_models/`
|
|
240
|
+
* `UsageAnalyzer` — records user accept/reject feedback to personalise the
|
|
241
|
+
confidence threshold over time
|
|
242
|
+
* `is_ml_available()` — runtime check; returns `False` gracefully when
|
|
243
|
+
`numpy`/`scikit-learn` are absent
|
|
244
|
+
|
|
245
|
+
```python
|
|
246
|
+
from versiontracker.ml import is_ml_available, MLRecommendationEngine
|
|
247
|
+
|
|
248
|
+
if is_ml_available():
|
|
249
|
+
engine = MLRecommendationEngine()
|
|
250
|
+
engine.initialize(apps, casks)
|
|
251
|
+
recommendations = engine.get_recommendations(apps, casks)
|
|
252
|
+
```
|
|
253
|
+
|
|
254
|
+
Without the ML extras the standard fuzzy-matching engine is used automatically
|
|
255
|
+
— there is no degraded behaviour or error.
|
|
256
|
+
|
|
257
|
+
### Experimental Modules
|
|
258
|
+
|
|
259
|
+
The `versiontracker.experimental` package contains two modules that are
|
|
260
|
+
implemented but not yet wired to a CLI command. Their APIs may change between
|
|
261
|
+
minor versions.
|
|
262
|
+
|
|
263
|
+
**`versiontracker.experimental.analytics`** — SQLite-backed session analytics:
|
|
264
|
+
|
|
265
|
+
```python
|
|
266
|
+
from versiontracker.experimental.analytics import AnalyticsEngine
|
|
267
|
+
|
|
268
|
+
engine = AnalyticsEngine()
|
|
269
|
+
with engine.session():
|
|
270
|
+
engine.record_event("app_scan_started", {"app_count": 42})
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
Tracks: session durations, per-command event counts, performance metrics,
|
|
274
|
+
and usage patterns. Data is stored in
|
|
275
|
+
`~/.config/versiontracker/analytics.db`.
|
|
276
|
+
|
|
277
|
+
**`versiontracker.experimental.benchmarks`** — function-level performance
|
|
278
|
+
benchmarking with statistical analysis:
|
|
279
|
+
|
|
280
|
+
```python
|
|
281
|
+
from versiontracker.experimental.benchmarks import BenchmarkRunner
|
|
282
|
+
|
|
283
|
+
runner = BenchmarkRunner()
|
|
284
|
+
runner.run_all()
|
|
285
|
+
runner.print_report()
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
Tracks: min/mean/max execution time, memory usage, CPU load per operation.
|
|
289
|
+
Useful for regression detection during development.
|
|
290
|
+
|
|
291
|
+
To promote either module to stable status: wire it to a CLI entry point,
|
|
292
|
+
add ≥ 60% test coverage, and move it out of `experimental/`.
|
|
199
293
|
|
|
200
294
|
## Requirements
|
|
201
295
|
|
|
@@ -296,6 +390,12 @@ Export options:
|
|
|
296
390
|
--output-file OUTPUT_FILE
|
|
297
391
|
Specify the output file for export (default: print to stdout)
|
|
298
392
|
|
|
393
|
+
Audit options (used with --audit):
|
|
394
|
+
--all Show every audited application, not just those needing attention
|
|
395
|
+
--status {attention,unknown,managed}
|
|
396
|
+
Show only applications in this audit status
|
|
397
|
+
--explain Show full evidence per application instead of a compact table
|
|
398
|
+
|
|
299
399
|
Configuration options:
|
|
300
400
|
--generate-config Generate a default configuration file at ~/.config/versiontracker/config.yaml
|
|
301
401
|
--config-path CONFIG_PATH
|
|
@@ -306,7 +406,9 @@ Configuration options:
|
|
|
306
406
|
-a, --apps return Apps in Applications/ that is not updated by App Store
|
|
307
407
|
-b, --brews return installable brews
|
|
308
408
|
-r, --recommend return recommendations for brew
|
|
309
|
-
-o, --outdated
|
|
409
|
+
-o, --check-outdated check for outdated applications compared to Homebrew versions
|
|
410
|
+
--audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
|
|
411
|
+
--ask QUERY ask a natural-language question, routed to a supported action
|
|
310
412
|
-V, --version show program's version number and exit
|
|
311
413
|
```
|
|
312
414
|
|
|
@@ -339,13 +441,55 @@ python3 versiontracker-cli.py --recommend
|
|
|
339
441
|
### Check for outdated applications
|
|
340
442
|
|
|
341
443
|
```shell
|
|
342
|
-
python3 versiontracker-cli.py --outdated
|
|
444
|
+
python3 versiontracker-cli.py --check-outdated
|
|
343
445
|
```
|
|
344
446
|
|
|
345
447
|
Or if installed:
|
|
346
448
|
|
|
347
449
|
```shell
|
|
348
|
-
versiontracker --outdated
|
|
450
|
+
versiontracker --check-outdated
|
|
451
|
+
```
|
|
452
|
+
|
|
453
|
+
### Audit unmanaged applications
|
|
454
|
+
|
|
455
|
+
Identify user-facing applications that aren't App Store-managed, aren't
|
|
456
|
+
Homebrew-owned, have no confirmed local auto-update path, and aren't
|
|
457
|
+
blocklisted — with full per-signal evidence rather than a bare yes/no.
|
|
458
|
+
|
|
459
|
+
```shell
|
|
460
|
+
# Default view: applications needing attention or with incomplete evidence
|
|
461
|
+
versiontracker --audit
|
|
462
|
+
|
|
463
|
+
# Show every audited application, including already-managed ones
|
|
464
|
+
versiontracker --audit --all
|
|
465
|
+
|
|
466
|
+
# Show full evidence per application instead of a compact table
|
|
467
|
+
versiontracker --audit --explain
|
|
468
|
+
|
|
469
|
+
# Show only one audit status
|
|
470
|
+
versiontracker --audit --status unknown
|
|
471
|
+
|
|
472
|
+
# Export full evidence as versioned JSON
|
|
473
|
+
versiontracker --audit --export json --output-file audit.json
|
|
474
|
+
```
|
|
475
|
+
|
|
476
|
+
### Ask a natural-language question
|
|
477
|
+
|
|
478
|
+
Route a plain-English query to a supported action instead of remembering the
|
|
479
|
+
exact flag. Recognizes a handful of phrasings for auditing, listing apps,
|
|
480
|
+
Homebrew recommendations, and checking for outdated apps; anything it doesn't
|
|
481
|
+
recognize (or isn't confident about) prints a clear message instead of
|
|
482
|
+
guessing.
|
|
483
|
+
|
|
484
|
+
```shell
|
|
485
|
+
# Routed to --audit
|
|
486
|
+
versiontracker --ask "which apps need manual updates"
|
|
487
|
+
|
|
488
|
+
# Combines with modifier flags exactly like the literal flag would
|
|
489
|
+
versiontracker --ask "which apps need manual updates" --export json
|
|
490
|
+
|
|
491
|
+
# Routed to --apps
|
|
492
|
+
versiontracker --ask "list my applications"
|
|
349
493
|
```
|
|
350
494
|
|
|
351
495
|
### Handle applications with auto-updates
|
|
@@ -427,8 +571,8 @@ python -m versiontracker --install-service
|
|
|
427
571
|
# Check service status
|
|
428
572
|
python -m versiontracker --service-status
|
|
429
573
|
|
|
430
|
-
#
|
|
431
|
-
python -m versiontracker --outdated
|
|
574
|
+
# Check for outdated applications
|
|
575
|
+
python -m versiontracker --check-outdated
|
|
432
576
|
|
|
433
577
|
# Launch menubar application for quick access
|
|
434
578
|
python -m versiontracker --menubar
|
|
@@ -650,11 +794,11 @@ VersionTracker intentionally uses a heavy mocking approach to:
|
|
|
650
794
|
2. Deterministically simulate Homebrew and filesystem behaviors
|
|
651
795
|
3. Keep test execution fast and CI-friendly
|
|
652
796
|
|
|
653
|
-
Current Coverage Profile:
|
|
797
|
+
Current Coverage Profile (see the Codecov badge above for the live, up-to-date number):
|
|
654
798
|
|
|
655
|
-
*
|
|
656
|
-
*
|
|
657
|
-
|
|
799
|
+
* Core modules (matcher, finder, config) carry the highest coverage
|
|
800
|
+
* High mock call volume for platform/network code paths ensures behavioral correctness without
|
|
801
|
+
requiring macOS-specific execution
|
|
658
802
|
|
|
659
803
|
Why Some Coverage Is Lower:
|
|
660
804
|
|
|
@@ -688,7 +832,7 @@ This strategy favors maintainability, determinism, and clear behavioral guarante
|
|
|
688
832
|
VersionTracker uses GitHub Actions for continuous integration and deployment:
|
|
689
833
|
|
|
690
834
|
* **Testing**: Automatically runs the test suite on multiple Python versions
|
|
691
|
-
* **Linting**:
|
|
835
|
+
* **Linting**: Enforces linting and formatting with Ruff, plus type checking with mypy
|
|
692
836
|
* **Releases**: Automatically publishes new versions to PyPI when a release is created
|
|
693
837
|
|
|
694
838
|
The CI/CD pipeline helps maintain code quality and ensures that the application is always in a deployable state.
|
|
@@ -705,18 +849,37 @@ be managed through Homebrew.
|
|
|
705
849
|
|
|
706
850
|
## Project Status
|
|
707
851
|
|
|
708
|
-
VersionTracker
|
|
852
|
+
VersionTracker is production-stable. All critical technical debt has been resolved
|
|
709
853
|
and the tool is fully operational on macOS. Key highlights:
|
|
710
854
|
|
|
711
|
-
* **
|
|
712
|
-
* **
|
|
713
|
-
* **Zero high-severity security vulnerabilities**
|
|
855
|
+
* **Actively maintained** — available on PyPI (`pip install macversiontracker`) and Homebrew
|
|
856
|
+
* **Comprehensive automated test suite** with high branch coverage, enforced in CI (see badges above)
|
|
857
|
+
* **Zero high-severity security vulnerabilities** — enforced by the required Security Analysis CI check
|
|
714
858
|
* **Complete complexity resolution**: all high & medium-priority complex functions refactored
|
|
715
859
|
* **Async Homebrew API**: install and update candidate checks use async operations by default
|
|
716
860
|
* **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
|
|
717
861
|
* **Lazy config initialisation**: no subprocess on import — fast startup
|
|
718
862
|
* **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
|
|
719
863
|
|
|
864
|
+
## Known Limitations
|
|
865
|
+
|
|
866
|
+
* **macOS only** — VersionTracker runs on macOS only; Linux and Windows are not supported.
|
|
867
|
+
* **macOS 10.15 Catalina or later** — older releases are not tested. Tested through macOS Sequoia.
|
|
868
|
+
* **Homebrew required for version checks** — `--check-outdated` and `--recommend` require Homebrew;
|
|
869
|
+
`--apps` works without it.
|
|
870
|
+
* **Apple Silicon vs Intel** — both paths are detected automatically (`/opt/homebrew/bin/brew`
|
|
871
|
+
and `/usr/local/bin/brew`). Mixed-architecture Rosetta environments may need a manual
|
|
872
|
+
`--config-path` with a generated config.
|
|
873
|
+
* **Package managers not yet supported** — MacPorts and Mac App Store (`mas-cli`) integration
|
|
874
|
+
are on the roadmap. See `TODO.md → Future Enhancements`.
|
|
875
|
+
* **ML features require optional dependencies** — the ML matching engine (`versiontracker.ml`)
|
|
876
|
+
needs `numpy` and `scikit-learn`. Install with `pip install macversiontracker[ml]`.
|
|
877
|
+
* **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
|
|
878
|
+
`versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
|
|
879
|
+
may change without notice between minor versions.
|
|
880
|
+
* **A small number of tests are skipped in default runs** — ML-dep tests skip without the `[ml]`
|
|
881
|
+
extras; platform-guard tests skip on macOS; a colour test skips in non-TTY environments. All expected.
|
|
882
|
+
|
|
720
883
|
## Recent Major Achievements (v1.0.0)
|
|
721
884
|
|
|
722
885
|
* **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
|
|
@@ -732,11 +895,10 @@ and the tool is fully operational on macOS. Key highlights:
|
|
|
732
895
|
* Add more package managers support (MacPorts, etc.)
|
|
733
896
|
* Implement automatic update capabilities for Homebrew-manageable applications
|
|
734
897
|
* Add GUI interface
|
|
735
|
-
* Raise test coverage to 85%+ across all core modules
|
|
736
898
|
|
|
737
899
|
## License
|
|
738
900
|
|
|
739
|
-
[MIT](https://github.com/docdyhr/versiontracker/blob/
|
|
901
|
+
[MIT](https://github.com/docdyhr/versiontracker/blob/main/LICENSE)
|
|
740
902
|
|
|
741
903
|
### Blocklist Terminology Migration
|
|
742
904
|
|