Skip to content

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

03fe782cacf9d9604f3771d47b1f790c513a0301148d1648a635538f7cc2353a

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:

deps-checker check [OPTIONS] <BINARY>

Options: - -p, --profile <NAME>: Dependency profile to use (default: full) - --db <PATH>: Path to external dependency database

Examples:

deps-checker check dns-switch
deps-checker check dns-switch --profile minimal
deps-checker check dns-switch --json
deps-checker check dns-switch --profile full --json

check-all

Check dependencies for all known binaries

Usage:

deps-checker check-all [OPTIONS]

Options: - -p, --profile <NAME>: Dependency profile to use (default: full) - --strict: Treat warnings as errors

Examples:

deps-checker check-all
deps-checker check-all --profile full
deps-checker check-all --json
deps-checker check-all --strict --json

install-missing

Install missing packages for specified binary or all

Usage:

deps-checker install-missing [OPTIONS] <BINARY|all>

Options: - -p, --profile <NAME>: Dependency profile to use (default: full) - --dry-run: Preview without executing

Examples:

deps-checker install-missing dns-leak
deps-checker install-missing all
deps-checker install-missing all --json

list-binaries

List all known binaries

Usage:

deps-checker list-binaries [OPTIONS]

Examples:

deps-checker list-binaries
deps-checker list-binaries --json

list-profiles

List available profiles for a binary

Usage:

deps-checker list-profiles [OPTIONS] <BINARY>

Examples:

deps-checker list-profiles health-control
deps-checker list-profiles health-control --json

Script Generation

generate-script

Generate installation script from JSON input

Usage:

deps-checker generate-script [OPTIONS]

Options: - --shell <TYPE>: Shell syntax for scripts (default: bash) - --execute: Execute the generated script - --dry-run: Preview without executing

Examples:

deps-checker check-all --json | deps-checker generate-script
deps-checker check-all --json | deps-checker generate-script --shell zsh
deps-checker check-all --json | deps-checker generate-script --execute

Examples

Basic Commands

Common dependency checking operations

Check single binary - shows profile, status, dependencies and conflicts

deps-checker check dns-switch
Expected Output: Dependency status report for dns-switch

Note

Shows all required packages and their status

JSON output for scripting

deps-checker check dns-switch --json
Expected Output: JSON formatted dependency report

Note

Includes exit codes and machine-readable format

Overview of all dependencies

deps-checker check-all
Expected Output: Summary of all binaries and their dependency status

Note

Shows counts and overall system status

Save full dependency check report to file

deps-checker check-all --json -o deps-check-report.json
Expected Output: JSON dependency report saved to file

Note

Useful for automated processing and CI/CD

Install for specific binary

sudo deps-checker install-missing dns-leak
Expected Output: Package installation status

Note

Only installs packages needed by dns-leak

Install all missing packages

sudo deps-checker install-missing all
Expected Output: Mass installation status

Note

Installs all missing dependencies system-wide

Show all supported binaries

deps-checker list-binaries
Expected Output: List of all supported Rust binaries

Note

Shows which binaries can be checked

Show available profiles (minimal/full)

deps-checker list-profiles health-control
Expected Output: Available dependency profiles

Note

Different dependency sets for different use cases

Profile Usage

Different dependency sets for specific use cases

Minimal profile - core dependencies only

deps-checker check health-control -p minimal
Expected Output: Essential packages for basic functionality

Note

Smallest footprint, core features only

Full profile - includes audio, security tools, etc

deps-checker check health-control -p full
Expected Output: Complete package list including optional features

Note

Maximum functionality, larger footprint

Apply full profile to all binaries

deps-checker check-all -p full
Expected Output: Full dependency check for all binaries

Note

Comprehensive system-wide analysis

Installation Script Generation

Generate automated installation scripts

Generate install script from check results

deps-checker check-all --json | deps-checker generate-script
Expected Output: Shell script to install missing packages

Note

Creates executable script based on current system state

Generate for zsh shell

deps-checker check-all --json | deps-checker generate-script --shell zsh
Expected Output: Zsh-compatible installation script

Note

Optimized for zsh shell environment

Preview script without executing

deps-checker check-all --json | deps-checker generate-script --dry-run
Expected Output: Script preview without installation

Note

Useful for reviewing changes before applying

Generate and execute installation

deps-checker check-all --json | sudo deps-checker generate-script --execute
Expected Output: Script generated and executed immediately

Note

One-step solution for installing all dependencies

Advanced Options

Advanced configuration and output control

Exit code 1 if warnings exist

deps-checker check-all --strict
Expected Output: Strict validation with non-zero exit on warnings

Note

Useful for CI/CD pipelines requiring zero warnings

Use custom TOML definitions

deps-checker check-all --db ./custom-deps-db
Expected Output: Dependency check using custom database

Note

Allows custom dependency definitions

Save single binary dependency check to file

deps-checker check dns-switch -o dns-switch-deps-report.json --json
Expected Output: JSON report saved to dns-switch-deps-report.json

Note

Targeted dependency report for specific binary

Save comprehensive dependency report to file

deps-checker check-all -o deps-check-full-report.json --json
Expected Output: Comprehensive JSON dependency report saved to file

Note

Complete system dependency analysis

Quick Information

Basic information and help commands

Show version

deps-checker --version
Expected Output: Version information

Show program details

deps-checker --info
Expected Output: Detailed program information

Note

Includes author, features, and system requirements

Show help

deps-checker --help
Expected Output: Command usage help

Show this examples page

deps-checker --examples
Expected Output: Usage examples

Common Workflows

Typical usage patterns and workflows

See what's missing

deps-checker check-all
Expected Output: Overview of missing dependencies

Note

First step in dependency management workflow

Install everything missing

sudo deps-checker install-missing all
Expected Output: Installation of all missing packages

Note

Follow-up command after checking dependencies

Generate dependency check report

deps-checker check-all -o deps-check-report.json --json
Expected Output: JSON dependency report saved for review

Note

Part of review-before-install workflow

Review dependency report summary

cat deps-check-report.json | jq '.summary'
Expected Output: Summary of dependency status

Note

Use jq to parse JSON report

Fail build on warnings

deps-checker check-all --strict || exit 1
Expected Output: Exit code 1 if any warnings exist

Note

CI/CD integration pattern

Check if all satisfied

deps-checker check-all --json | jq -e '.summary.with_missing == 0'
Expected Output: Boolean result of dependency satisfaction

Note

Automated validation for CI/CD

Get exit code for automation

deps-checker check-all --json | jq '.summary.exit_code'
Expected Output: Numeric exit code

Note

For automated decision making

Generate CycloneDX SBOM for software inventory

deps-checker check-all --sbom
Expected Output: Software Bill of Materials in CycloneDX format

Note

For security scanning and compliance

Save SBOM to file for compliance tracking

deps-checker check-all --sbom -o deps-check-sbom.json
Expected Output: SBOM saved to file

Note

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

Back to top