deps-checker
Dependency checker for Kodachi OS Rust binaries - Validates system dependencies and generates installation scripts
Version: 9.0.1 | Size: 4.6MB | Author: Warith Al Maawali
License: Proprietary | Website: https://www.digi77.com
File Information
Property | Value |
---|---|
Binary Name | deps-checker |
Version | 9.0.1 |
Build Date | 2025-09-23T19:19:58.412769713Z |
Rust Version | rustc 1.88.0 (6b00bc388 2025-06-23) |
File Size | 4.6MB |
JSON Data | View Raw JSON |
SHA256 Checksum
Features
Feature | Description |
---|---|
Feature | Multi-profile dependency checking (minimal/full) |
Feature | Automatic missing package installation |
Feature | Installation script generation for multiple shells |
Feature | Software Bill of Materials (SBOM) generation |
Feature | External dependency database support |
Feature | Comprehensive JSON output for automation |
Feature | Strict mode for CI/CD pipelines |
Feature | Dry-run mode for safe previewing |
Security Features
Feature | Description |
---|---|
Authentication | Secure package repository authentication |
Encryption | TLS for all package downloads |
Inputvalidation | All user inputs are validated and sanitized |
Ratelimiting | Built-in rate limiting for package operations |
System Requirements
Requirement | Value |
---|---|
OS | Linux (Debian-based, Kodachi OS) |
Privileges | root/sudo required for package installation |
Dependencies | apt-get, dpkg, curl |
Global Options
Flag | Description |
---|---|
-h, --help |
Print help information |
-v, --version |
Print version information |
-n, --info |
Display detailed information |
-e, --examples |
Show usage examples |
--json |
Output in JSON format |
--json-pretty |
Pretty-print JSON output with indentation |
--json-human |
Enhanced JSON output with improved formatting (like jq) |
--verbose |
Enable verbose output |
--quiet |
Suppress non-essential output |
--no-color |
Disable colored output |
--config <FILE> |
Use custom configuration file |
--timeout <SECS> |
Set timeout (default: 30) |
--retry <COUNT> |
Retry attempts (default: 3) |
-p, --profile <NAME> |
Dependency profile to use (minimal/full) |
--shell <TYPE> |
Shell syntax for scripts (bash/zsh/fish) |
-o, --output <FILE> |
Write output to file instead of stdout |
--db <PATH> |
Path to external dependency database |
--strict |
Treat warnings as errors (exit code 1) |
--dry-run |
Don't execute network operations |
--execute |
Execute generated installation script |
--sbom |
Generate Software Bill of Materials in CycloneDX JSON |
Commands
Dependency Checking
check
Check dependencies for a specific binary
Usage:
Options:
- -p, --profile <NAME>
: Dependency profile to use (default: full)
- --db <PATH>
: Path to external dependency database
Examples:
check-all
Check dependencies for all known binaries
Usage:
Options:
- -p, --profile <NAME>
: Dependency profile to use (default: full)
- --strict
: Treat warnings as errors
Examples:
install-missing
Install missing packages for specified binary or all
Usage:
Options:
- -p, --profile <NAME>
: Dependency profile to use (default: full)
- --dry-run
: Preview without executing
Examples:
list-binaries
List all known binaries
Usage:
Examples:
list-profiles
List available profiles for a binary
Usage:
Examples:
Script Generation
generate-script
Generate installation script from JSON input
Usage:
Options:
- --shell <TYPE>
: Shell syntax for scripts (default: bash)
- --execute
: Execute the generated script
- --dry-run
: Preview without executing
Examples:
Examples
Basic Commands
Common dependency checking operations
Check single binary - shows profile, status, dependencies and conflicts
Expected Output: Dependency status report for dns-switchNote
Shows all required packages and their status
JSON output for scripting
Expected Output: JSON formatted dependency reportNote
Includes exit codes and machine-readable format
Overview of all dependencies
Expected Output: Summary of all binaries and their dependency statusNote
Shows counts and overall system status
Save full dependency check report to file
Expected Output: JSON dependency report saved to fileNote
Useful for automated processing and CI/CD
Install for specific binary
Expected Output: Package installation statusNote
Only installs packages needed by dns-leak
Install all missing packages
Expected Output: Mass installation statusNote
Installs all missing dependencies system-wide
Show all supported binaries
Expected Output: List of all supported Rust binariesNote
Shows which binaries can be checked
Show available profiles (minimal/full)
Expected Output: Available dependency profilesNote
Different dependency sets for different use cases
Profile Usage
Different dependency sets for specific use cases
Minimal profile - core dependencies only
Expected Output: Essential packages for basic functionalityNote
Smallest footprint, core features only
Full profile - includes audio, security tools, etc
Expected Output: Complete package list including optional featuresNote
Maximum functionality, larger footprint
Apply full profile to all binaries
Expected Output: Full dependency check for all binariesNote
Comprehensive system-wide analysis
Installation Script Generation
Generate automated installation scripts
Generate install script from check results
Expected Output: Shell script to install missing packagesNote
Creates executable script based on current system state
Generate for zsh shell
Expected Output: Zsh-compatible installation scriptNote
Optimized for zsh shell environment
Preview script without executing
Expected Output: Script preview without installationNote
Useful for reviewing changes before applying
Generate and execute installation
Expected Output: Script generated and executed immediatelyNote
One-step solution for installing all dependencies
Advanced Options
Advanced configuration and output control
Exit code 1 if warnings exist
Expected Output: Strict validation with non-zero exit on warningsNote
Useful for CI/CD pipelines requiring zero warnings
Use custom TOML definitions
Expected Output: Dependency check using custom databaseNote
Allows custom dependency definitions
Save single binary dependency check to file
Expected Output: JSON report saved to dns-switch-deps-report.jsonNote
Targeted dependency report for specific binary
Save comprehensive dependency report to file
Expected Output: Comprehensive JSON dependency report saved to fileNote
Complete system dependency analysis
Quick Information
Basic information and help commands
Show version
Expected Output: Version informationShow program details
Expected Output: Detailed program informationNote
Includes author, features, and system requirements
Show help
Expected Output: Command usage helpShow this examples page
Expected Output: Usage examplesCommon Workflows
Typical usage patterns and workflows
See what's missing
Expected Output: Overview of missing dependenciesNote
First step in dependency management workflow
Install everything missing
Expected Output: Installation of all missing packagesNote
Follow-up command after checking dependencies
Generate dependency check report
Expected Output: JSON dependency report saved for reviewNote
Part of review-before-install workflow
Review dependency report summary
Expected Output: Summary of dependency statusNote
Use jq to parse JSON report
Fail build on warnings
Expected Output: Exit code 1 if any warnings existNote
CI/CD integration pattern
Check if all satisfied
Expected Output: Boolean result of dependency satisfactionNote
Automated validation for CI/CD
Get exit code for automation
Expected Output: Numeric exit codeNote
For automated decision making
Generate CycloneDX SBOM for software inventory
Expected Output: Software Bill of Materials in CycloneDX formatNote
For security scanning and compliance
Save SBOM to file for compliance tracking
Expected Output: SBOM saved to fileNote
Persistent SBOM for audit trails
Environment Variables
Variable | Description | Default | Values |
---|---|---|---|
RUST_LOG |
Set logging level | info | error |
NO_COLOR |
Disable all colored output when set | unset | 1 |
DEPS_CHECKER_CONFIG |
Path to configuration file | ~/.config/deps-checker/config.json | /path/to/config.json |
Exit Codes
Code | Description |
---|---|
0 | Success |
1 | General error |
2 | Invalid arguments |
3 | Permission denied |
4 | Network error |
5 | File not found |