macversiontracker 1.1.0__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.1.0 → macversiontracker-1.2.0}/PKG-INFO +60 -38
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/README.md +57 -33
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/PKG-INFO +60 -38
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/SOURCES.txt +2 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/requires.txt +1 -3
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/pyproject.toml +9 -10
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_advanced_cache.py +134 -7
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ai_module.py +24 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_homebrew.py +25 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_network.py +25 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_parity.py +1 -2
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_integration_flows.py +5 -5
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_brew_candidates.py +11 -2
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_cli.py +85 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_cli_auto_updates.py +6 -3
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_export.py +58 -1
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_finder_coverage.py +8 -11
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_finder_new_coverage.py +75 -8
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_homebrew.py +5 -5
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_homebrew_advanced.py +69 -1
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_002_recommendation.py +4 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_003_matching.py +4 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_004_async_parity.py +2 -2
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_integration.py +1 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_macos_integration.py +130 -21
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_main.py +75 -1
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_matcher_coverage.py +17 -2
- macversiontracker-1.2.0/tests/test_menubar_app.py +162 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ml_module.py +23 -16
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_outdated_handlers.py +29 -15
- macversiontracker-1.2.0/tests/test_plugins.py +41 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_project_consistency.py +67 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_batch.py +21 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/__init__.py +1 -1
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/__main__.py +10 -5
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/advanced_cache.py +118 -34
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/ai/__init__.py +20 -5
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/finder.py +48 -25
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/matcher.py +5 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/async_homebrew.py +18 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/async_network.py +18 -2
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/cli.py +68 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/export.py +107 -32
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/__init__.py +2 -0
- macversiontracker-1.2.0/versiontracker/handlers/ai_handlers.py +125 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/app_handlers.py +34 -13
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/backup_handlers.py +2 -1
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/brew_handlers.py +76 -44
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/export_handlers.py +4 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/filter_handlers.py +17 -6
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/macos_handlers.py +1 -1
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/outdated_handlers.py +50 -22
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/setup_handlers.py +21 -13
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/utils_handlers.py +0 -43
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/homebrew.py +3 -3
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/macos_integration.py +25 -86
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/menubar_app.py +22 -29
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/ml/__init__.py +2 -2
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/plugins/__init__.py +3 -4
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/utils.py +43 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/batch.py +11 -6
- macversiontracker-1.1.0/tests/test_menubar_app.py +0 -57
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/LICENSE +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/entry_points.txt +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/top_level.txt +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/setup.cfg +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_additional_functions.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_app_store.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_extra.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_new.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_new_pytest.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_homebrew_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_integration.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_advanced.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_edge_cases.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_integration.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_rollback.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_updates.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_brew_installability.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_cache.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_comparator_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_gaps.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_loader.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_save.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_validation_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_yaml.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_end_to_end_integration.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_enhanced_matching.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_enhanced_matching_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_exceptions_and_error_codes.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_001_discovery.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_module_lazy_imports.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_network_operations.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_parameterized_edge_cases.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_parameterized_version.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_platform_compatibility.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_profiling.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_profiling_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ui.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ui_enhanced.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ui_new.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_utils.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_utils_comprehensive.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_utils_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_comprehensive.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_edge_cases.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_fuzzy.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_homebrew.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_legacy_coverage.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_parser.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_utils.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/__init__.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/cache.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/__init__.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/auto_update.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/blocklist.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/discovery.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/homebrew.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/models.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/rendering.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/service.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/cache.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/config.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/deprecation.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/enhanced_matching.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/error_codes.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/exceptions.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/experimental/__init__.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/experimental/analytics.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/experimental/benchmarks.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/audit_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_types.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/config_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/error_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/ui_handlers.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/plugins/example_plugins.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/profiling.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/py.typed +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/ui.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/__init__.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/comparator.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/fuzzy.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/homebrew.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/models.py +0 -0
- {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/parser.py +0 -0
- {macversiontracker-1.1.0 → 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.
|
|
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
|
|
@@ -37,8 +37,7 @@ 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.16.0; 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
|
|
@@ -89,31 +87,28 @@ Dynamic: license-file
|
|
|
89
87
|
|
|
90
88
|
### 🏗️ Build & CI/CD Pipeline
|
|
91
89
|
|
|
92
|
-
[](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)
|
|
98
96
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
|
|
99
97
|
[](https://github.com/docdyhr/versiontracker/releases/latest)
|
|
100
98
|
[](https://pypi.org/project/macversiontracker/)
|
|
101
99
|
|
|
102
100
|
#### 🧪 Test Matrix
|
|
103
101
|
|
|
104
|
-
| Platform
|
|
105
|
-
|
|
106
|
-
| **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) |
|
|
108
106
|
|
|
109
107
|
### 🔒 Security & Quality
|
|
110
108
|
|
|
111
|
-
[](https://github.com/docdyhr/versiontracker)
|
|
113
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
|
|
109
|
+
[](https://codecov.io/gh/docdyhr/versiontracker)
|
|
114
110
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
115
111
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
116
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
117
112
|
|
|
118
113
|
### 🎨 Code Standards
|
|
119
114
|
|
|
@@ -129,7 +124,7 @@ Dynamic: license-file
|
|
|
129
124
|
[](https://github.com/docdyhr/versiontracker/pulls)
|
|
130
125
|
[](https://github.com/docdyhr/versiontracker/network)
|
|
131
126
|
[](https://github.com/docdyhr/versiontracker/stargazers)
|
|
132
|
-
[](https://github.com/docdyhr/versiontracker/commits/
|
|
127
|
+
[](https://github.com/docdyhr/versiontracker/commits/main)
|
|
133
128
|
[](https://github.com/docdyhr/versiontracker/graphs/contributors)
|
|
134
129
|
[](https://opensource.org/licenses/MIT)
|
|
135
130
|
|
|
@@ -145,12 +140,13 @@ Dynamic: license-file
|
|
|
145
140
|
---
|
|
146
141
|
|
|
147
142
|
* Name: Versiontracker
|
|
148
|
-
* Version: 1.
|
|
143
|
+
* Version: 1.2.0
|
|
149
144
|
* Programming language: Python 3.12+
|
|
150
145
|
* Author: thomas
|
|
151
146
|
* Purpose: CLI versiontracker and update tool for macOS
|
|
152
|
-
* Release date: 21. Feb 2022
|
|
153
|
-
* 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),
|
|
154
150
|
**all previously identified high & medium complexity issues resolved**
|
|
155
151
|
|
|
156
152
|
## Quick Start
|
|
@@ -174,15 +170,17 @@ versiontracker --check-outdated
|
|
|
174
170
|
# Audit apps not managed by the App Store, Homebrew, or a local auto-updater
|
|
175
171
|
versiontracker --audit
|
|
176
172
|
|
|
173
|
+
# Ask a natural-language question, routed to a supported action
|
|
174
|
+
versiontracker --ask "which apps need manual updates"
|
|
175
|
+
|
|
177
176
|
# Show help
|
|
178
177
|
versiontracker --help
|
|
179
178
|
```
|
|
180
179
|
|
|
181
180
|
## Overview
|
|
182
181
|
|
|
183
|
-
Versiontracker is a command-line tool for macOS that helps you manage applications
|
|
184
|
-
installed outside of the App Store
|
|
185
|
-
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.
|
|
186
184
|
|
|
187
185
|
It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
|
|
188
186
|
using Homebrew casks, making it easier to keep your applications up to date.
|
|
@@ -213,6 +211,10 @@ using Homebrew casks, making it easier to keep your applications up to date.
|
|
|
213
211
|
* **Unmanaged application audit** (`--audit`): identifies apps with no App
|
|
214
212
|
Store, Homebrew, or local auto-update coverage, with full per-signal
|
|
215
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
|
|
216
218
|
|
|
217
219
|
## Advanced Features
|
|
218
220
|
|
|
@@ -406,6 +408,7 @@ Configuration options:
|
|
|
406
408
|
-r, --recommend return recommendations for brew
|
|
407
409
|
-o, --check-outdated check for outdated applications compared to Homebrew versions
|
|
408
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
|
|
409
412
|
-V, --version show program's version number and exit
|
|
410
413
|
```
|
|
411
414
|
|
|
@@ -470,6 +473,25 @@ versiontracker --audit --status unknown
|
|
|
470
473
|
versiontracker --audit --export json --output-file audit.json
|
|
471
474
|
```
|
|
472
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"
|
|
493
|
+
```
|
|
494
|
+
|
|
473
495
|
### Handle applications with auto-updates
|
|
474
496
|
|
|
475
497
|
```shell
|
|
@@ -772,11 +794,11 @@ VersionTracker intentionally uses a heavy mocking approach to:
|
|
|
772
794
|
2. Deterministically simulate Homebrew and filesystem behaviors
|
|
773
795
|
3. Keep test execution fast and CI-friendly
|
|
774
796
|
|
|
775
|
-
Current Coverage Profile:
|
|
797
|
+
Current Coverage Profile (see the Codecov badge above for the live, up-to-date number):
|
|
776
798
|
|
|
777
|
-
*
|
|
778
|
-
*
|
|
779
|
-
|
|
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
|
|
780
802
|
|
|
781
803
|
Why Some Coverage Is Lower:
|
|
782
804
|
|
|
@@ -810,7 +832,7 @@ This strategy favors maintainability, determinism, and clear behavioral guarante
|
|
|
810
832
|
VersionTracker uses GitHub Actions for continuous integration and deployment:
|
|
811
833
|
|
|
812
834
|
* **Testing**: Automatically runs the test suite on multiple Python versions
|
|
813
|
-
* **Linting**:
|
|
835
|
+
* **Linting**: Enforces linting and formatting with Ruff, plus type checking with mypy
|
|
814
836
|
* **Releases**: Automatically publishes new versions to PyPI when a release is created
|
|
815
837
|
|
|
816
838
|
The CI/CD pipeline helps maintain code quality and ensures that the application is always in a deployable state.
|
|
@@ -827,12 +849,12 @@ be managed through Homebrew.
|
|
|
827
849
|
|
|
828
850
|
## Project Status
|
|
829
851
|
|
|
830
|
-
VersionTracker
|
|
852
|
+
VersionTracker is production-stable. All critical technical debt has been resolved
|
|
831
853
|
and the tool is fully operational on macOS. Key highlights:
|
|
832
854
|
|
|
833
|
-
* **
|
|
834
|
-
* **
|
|
835
|
-
* **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
|
|
836
858
|
* **Complete complexity resolution**: all high & medium-priority complex functions refactored
|
|
837
859
|
* **Async Homebrew API**: install and update candidate checks use async operations by default
|
|
838
860
|
* **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
|
|
@@ -855,8 +877,8 @@ and the tool is fully operational on macOS. Key highlights:
|
|
|
855
877
|
* **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
|
|
856
878
|
`versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
|
|
857
879
|
may change without notice between minor versions.
|
|
858
|
-
* **
|
|
859
|
-
|
|
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.
|
|
860
882
|
|
|
861
883
|
## Recent Major Achievements (v1.0.0)
|
|
862
884
|
|
|
@@ -876,7 +898,7 @@ and the tool is fully operational on macOS. Key highlights:
|
|
|
876
898
|
|
|
877
899
|
## License
|
|
878
900
|
|
|
879
|
-
[MIT](https://github.com/docdyhr/versiontracker/blob/
|
|
901
|
+
[MIT](https://github.com/docdyhr/versiontracker/blob/main/LICENSE)
|
|
880
902
|
|
|
881
903
|
### Blocklist Terminology Migration
|
|
882
904
|
|
|
@@ -26,31 +26,28 @@
|
|
|
26
26
|
|
|
27
27
|
### 🏗️ Build & CI/CD Pipeline
|
|
28
28
|
|
|
29
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
|
|
30
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/lint.yml)
|
|
31
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
32
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
|
|
33
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
|
|
34
|
+
[](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
|
|
35
35
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
|
|
36
36
|
[](https://github.com/docdyhr/versiontracker/releases/latest)
|
|
37
37
|
[](https://pypi.org/project/macversiontracker/)
|
|
38
38
|
|
|
39
39
|
#### 🧪 Test Matrix
|
|
40
40
|
|
|
41
|
-
| Platform
|
|
42
|
-
|
|
43
|
-
| **Ubuntu 22.04** | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
|
|
44
|
+
| **macOS Latest** | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
|
|
45
45
|
|
|
46
46
|
### 🔒 Security & Quality
|
|
47
47
|
|
|
48
|
-
[](https://github.com/docdyhr/versiontracker)
|
|
50
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
|
|
48
|
+
[](https://codecov.io/gh/docdyhr/versiontracker)
|
|
51
49
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
52
50
|
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
53
|
-
[](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
|
|
54
51
|
|
|
55
52
|
### 🎨 Code Standards
|
|
56
53
|
|
|
@@ -66,7 +63,7 @@
|
|
|
66
63
|
[](https://github.com/docdyhr/versiontracker/pulls)
|
|
67
64
|
[](https://github.com/docdyhr/versiontracker/network)
|
|
68
65
|
[](https://github.com/docdyhr/versiontracker/stargazers)
|
|
69
|
-
[](https://github.com/docdyhr/versiontracker/commits/
|
|
66
|
+
[](https://github.com/docdyhr/versiontracker/commits/main)
|
|
70
67
|
[](https://github.com/docdyhr/versiontracker/graphs/contributors)
|
|
71
68
|
[](https://opensource.org/licenses/MIT)
|
|
72
69
|
|
|
@@ -82,12 +79,13 @@
|
|
|
82
79
|
---
|
|
83
80
|
|
|
84
81
|
* Name: Versiontracker
|
|
85
|
-
* Version: 1.
|
|
82
|
+
* Version: 1.2.0
|
|
86
83
|
* Programming language: Python 3.12+
|
|
87
84
|
* Author: thomas
|
|
88
85
|
* Purpose: CLI versiontracker and update tool for macOS
|
|
89
|
-
* Release date: 21. Feb 2022
|
|
90
|
-
* Code Quality: **
|
|
86
|
+
* Release date: 21. Feb 2022
|
|
87
|
+
* Code Quality: **comprehensive automated test suite with high branch coverage**, enforced in CI
|
|
88
|
+
(see the CI Pipeline and Codecov badges above),
|
|
91
89
|
**all previously identified high & medium complexity issues resolved**
|
|
92
90
|
|
|
93
91
|
## Quick Start
|
|
@@ -111,15 +109,17 @@ versiontracker --check-outdated
|
|
|
111
109
|
# Audit apps not managed by the App Store, Homebrew, or a local auto-updater
|
|
112
110
|
versiontracker --audit
|
|
113
111
|
|
|
112
|
+
# Ask a natural-language question, routed to a supported action
|
|
113
|
+
versiontracker --ask "which apps need manual updates"
|
|
114
|
+
|
|
114
115
|
# Show help
|
|
115
116
|
versiontracker --help
|
|
116
117
|
```
|
|
117
118
|
|
|
118
119
|
## Overview
|
|
119
120
|
|
|
120
|
-
Versiontracker is a command-line tool for macOS that helps you manage applications
|
|
121
|
-
installed outside of the App Store
|
|
122
|
-
core CLI, config, and Homebrew integration are fully operational.
|
|
121
|
+
Versiontracker is a production-stable command-line tool for macOS that helps you manage applications
|
|
122
|
+
installed outside of the App Store — core CLI, config, and Homebrew integration are fully operational.
|
|
123
123
|
|
|
124
124
|
It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
|
|
125
125
|
using Homebrew casks, making it easier to keep your applications up to date.
|
|
@@ -150,6 +150,10 @@ using Homebrew casks, making it easier to keep your applications up to date.
|
|
|
150
150
|
* **Unmanaged application audit** (`--audit`): identifies apps with no App
|
|
151
151
|
Store, Homebrew, or local auto-update coverage, with full per-signal
|
|
152
152
|
evidence and JSON/YAML/CSV export
|
|
153
|
+
* **Natural-language queries** (`--ask`): ask plain-English questions like
|
|
154
|
+
"which apps need manual updates" and get routed to the matching command;
|
|
155
|
+
unsupported or unclear queries always print a clear message instead of
|
|
156
|
+
guessing
|
|
153
157
|
|
|
154
158
|
## Advanced Features
|
|
155
159
|
|
|
@@ -343,6 +347,7 @@ Configuration options:
|
|
|
343
347
|
-r, --recommend return recommendations for brew
|
|
344
348
|
-o, --check-outdated check for outdated applications compared to Homebrew versions
|
|
345
349
|
--audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
|
|
350
|
+
--ask QUERY ask a natural-language question, routed to a supported action
|
|
346
351
|
-V, --version show program's version number and exit
|
|
347
352
|
```
|
|
348
353
|
|
|
@@ -407,6 +412,25 @@ versiontracker --audit --status unknown
|
|
|
407
412
|
versiontracker --audit --export json --output-file audit.json
|
|
408
413
|
```
|
|
409
414
|
|
|
415
|
+
### Ask a natural-language question
|
|
416
|
+
|
|
417
|
+
Route a plain-English query to a supported action instead of remembering the
|
|
418
|
+
exact flag. Recognizes a handful of phrasings for auditing, listing apps,
|
|
419
|
+
Homebrew recommendations, and checking for outdated apps; anything it doesn't
|
|
420
|
+
recognize (or isn't confident about) prints a clear message instead of
|
|
421
|
+
guessing.
|
|
422
|
+
|
|
423
|
+
```shell
|
|
424
|
+
# Routed to --audit
|
|
425
|
+
versiontracker --ask "which apps need manual updates"
|
|
426
|
+
|
|
427
|
+
# Combines with modifier flags exactly like the literal flag would
|
|
428
|
+
versiontracker --ask "which apps need manual updates" --export json
|
|
429
|
+
|
|
430
|
+
# Routed to --apps
|
|
431
|
+
versiontracker --ask "list my applications"
|
|
432
|
+
```
|
|
433
|
+
|
|
410
434
|
### Handle applications with auto-updates
|
|
411
435
|
|
|
412
436
|
```shell
|
|
@@ -709,11 +733,11 @@ VersionTracker intentionally uses a heavy mocking approach to:
|
|
|
709
733
|
2. Deterministically simulate Homebrew and filesystem behaviors
|
|
710
734
|
3. Keep test execution fast and CI-friendly
|
|
711
735
|
|
|
712
|
-
Current Coverage Profile:
|
|
736
|
+
Current Coverage Profile (see the Codecov badge above for the live, up-to-date number):
|
|
713
737
|
|
|
714
|
-
*
|
|
715
|
-
*
|
|
716
|
-
|
|
738
|
+
* Core modules (matcher, finder, config) carry the highest coverage
|
|
739
|
+
* High mock call volume for platform/network code paths ensures behavioral correctness without
|
|
740
|
+
requiring macOS-specific execution
|
|
717
741
|
|
|
718
742
|
Why Some Coverage Is Lower:
|
|
719
743
|
|
|
@@ -747,7 +771,7 @@ This strategy favors maintainability, determinism, and clear behavioral guarante
|
|
|
747
771
|
VersionTracker uses GitHub Actions for continuous integration and deployment:
|
|
748
772
|
|
|
749
773
|
* **Testing**: Automatically runs the test suite on multiple Python versions
|
|
750
|
-
* **Linting**:
|
|
774
|
+
* **Linting**: Enforces linting and formatting with Ruff, plus type checking with mypy
|
|
751
775
|
* **Releases**: Automatically publishes new versions to PyPI when a release is created
|
|
752
776
|
|
|
753
777
|
The CI/CD pipeline helps maintain code quality and ensures that the application is always in a deployable state.
|
|
@@ -764,12 +788,12 @@ be managed through Homebrew.
|
|
|
764
788
|
|
|
765
789
|
## Project Status
|
|
766
790
|
|
|
767
|
-
VersionTracker
|
|
791
|
+
VersionTracker is production-stable. All critical technical debt has been resolved
|
|
768
792
|
and the tool is fully operational on macOS. Key highlights:
|
|
769
793
|
|
|
770
|
-
* **
|
|
771
|
-
* **
|
|
772
|
-
* **Zero high-severity security vulnerabilities**
|
|
794
|
+
* **Actively maintained** — available on PyPI (`pip install macversiontracker`) and Homebrew
|
|
795
|
+
* **Comprehensive automated test suite** with high branch coverage, enforced in CI (see badges above)
|
|
796
|
+
* **Zero high-severity security vulnerabilities** — enforced by the required Security Analysis CI check
|
|
773
797
|
* **Complete complexity resolution**: all high & medium-priority complex functions refactored
|
|
774
798
|
* **Async Homebrew API**: install and update candidate checks use async operations by default
|
|
775
799
|
* **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
|
|
@@ -792,8 +816,8 @@ and the tool is fully operational on macOS. Key highlights:
|
|
|
792
816
|
* **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
|
|
793
817
|
`versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
|
|
794
818
|
may change without notice between minor versions.
|
|
795
|
-
* **
|
|
796
|
-
|
|
819
|
+
* **A small number of tests are skipped in default runs** — ML-dep tests skip without the `[ml]`
|
|
820
|
+
extras; platform-guard tests skip on macOS; a colour test skips in non-TTY environments. All expected.
|
|
797
821
|
|
|
798
822
|
## Recent Major Achievements (v1.0.0)
|
|
799
823
|
|
|
@@ -813,7 +837,7 @@ and the tool is fully operational on macOS. Key highlights:
|
|
|
813
837
|
|
|
814
838
|
## License
|
|
815
839
|
|
|
816
|
-
[MIT](https://github.com/docdyhr/versiontracker/blob/
|
|
840
|
+
[MIT](https://github.com/docdyhr/versiontracker/blob/main/LICENSE)
|
|
817
841
|
|
|
818
842
|
### Blocklist Terminology Migration
|
|
819
843
|
|