cargo-fresh 0.9.3

A Rust tool for checking and updating globally installed Cargo packages with interactive mode and smart prerelease detection
cargo-fresh-0.9.3 is not a library.

cargo-fresh

Crates.io License: MIT

Language / 语言

English δΈ­ζ–‡

A Rust tool for checking and updating globally installed Cargo packages with interactive mode and smart prerelease detection. After installation, you can use it via the cargo fresh command. The tool automatically detects your system language and displays the interface in Chinese or English accordingly.

Features

  • πŸ” Automatically detect globally installed Cargo packages
  • πŸ“¦ Check for the latest version of each package
  • 🎨 Colored output with clear update status display
  • ⚑ Asynchronous processing for fast checking of multiple packages
  • πŸ› οΈ Command-line argument support for flexible usage
  • πŸ”„ Default interactive update mode with one-click package updates
  • 🧠 Smart prerelease version detection and prompting
  • 🌍 Automatic language detection (Chinese/English)
  • πŸš€ Cargo subcommand support (cargo fresh)
  • 🌐 Bilingual interface with smart language switching

Installation

Install from crates.io (Recommended)

cargo install cargo-fresh

Install from source

# Clone the repository
git clone https://github.com/jenkinpan/cargo-fresh.git
cd cargo-fresh

# Build and install
cargo install --path .

Install from GitHub

cargo install --git https://github.com/jenkinpan/cargo-fresh.git

Language Support

The tool automatically detects your system language and displays the interface accordingly:

  • Chinese Environment: Automatically displays Chinese interface
  • English Environment: Automatically displays English interface
  • Language Detection: Based on system environment variables (LANG, LC_ALL, LC_CTYPE)

You can also manually override the language by setting environment variables:

# Force English interface
LANG=en_US.UTF-8 cargo fresh

# Force Chinese interface  
LANG=zh_CN.UTF-8 cargo fresh

Usage

Basic Usage

After installation, you can use it in two ways:

# Method 1: As a cargo subcommand (recommended)
cargo fresh

# Method 2: Direct invocation
cargo-fresh

Command Line Options

  • -v, --verbose: Show detailed information
  • -u, --updates-only: Show only packages with updates
  • --no-interactive: Non-interactive mode (default is interactive mode)
  • --include-prerelease: Include prerelease versions (alpha, beta, rc, etc.)
  • -h, --help: Show help information
  • -V, --version: Show version information

Examples

# Check all packages and show detailed information
cargo fresh --verbose

# Show only packages with updates
cargo fresh --updates-only

# Combine options
cargo fresh --verbose --updates-only

# Default interactive mode (recommended)
cargo fresh

# Show only packages with updates (interactive mode)
cargo fresh --updates-only

# Non-interactive mode
cargo fresh --no-interactive

# Include prerelease version checks (interactive mode)
cargo fresh --include-prerelease

# Non-interactive mode + prerelease versions
cargo fresh --no-interactive --include-prerelease

# Generate shell completion scripts
cargo fresh completion zsh    # Generate zsh completion
cargo fresh completion bash   # Generate bash completion
cargo fresh completion fish   # Generate fish completion

# Generate cargo fresh subcommand completion
cargo fresh completion zsh --cargo-fresh    # Generate cargo fresh zsh completion
cargo fresh completion bash --cargo-fresh   # Generate cargo fresh bash completion

Output Examples

Interactive Mode (Default)

Checking for updates to globally installed Cargo packages...
Found 5 installed packages

The following packages have updates available:
Stable version updates:
  β€’ cargo-outdated (0.16.0 β†’ 0.17.0)
  β€’ devtool (0.2.4 β†’ 0.2.5)

Prerelease version updates:
  β€’ mdbook (0.4.52 β†’ 0.5.0-alpha.1) ⚠️ Prerelease version

Do you want to update these packages? [Y/n]: y
Include prerelease version updates? [y/N]: n

Select packages to update (use space to select, enter to confirm)
> [x] cargo-outdated
> [x] devtool

Starting to update selected packages...
Updating cargo-outdated...
βœ… cargo-outdated updated: 0.16.0 β†’ 0.17.0
Updating devtool...
βœ… devtool updated: 0.2.4 β†’ 0.2.5

Update completed!
Success: 2 packages

Non-Interactive Mode

Checking for updates to globally installed Cargo packages...
Found 5 installed packages
mdbook has updates available
  Current version: 0.4.52
  Latest version: 0.5.0-alpha.1

To update packages, use: cargo install --force <package_name>
Or remove --no-interactive flag for interactive updates

Shell Completion Support

cargo-fresh supports automatic completion for multiple shells, making command-line usage more convenient.

Supported Shells

  • Zsh - Full completion support
  • Bash - Basic completion support
  • Fish - Native completion support
  • PowerShell - Windows completion support
  • Elvish - Modern shell completion support

Installing Completions

Manual Installation

# 1. Generate completion script
cargo fresh completion zsh > ~/.zsh_completions/cargo-fresh.zsh

# 2. Add to zsh configuration
echo 'fpath=($HOME/.zsh_completions $fpath)' >> ~/.zshrc
echo 'autoload -U compinit && compinit' >> ~/.zshrc

# 3. Reload configuration
source ~/.zshrc

Cargo Fresh Subcommand Completion

For cargo fresh subcommand completion:

# Generate cargo fresh subcommand completion
cargo fresh completion zsh --cargo-fresh > cargo-fresh-completion.zsh
cargo fresh completion bash --cargo-fresh > cargo-fresh-completion.bash

# Install cargo fresh completion
source cargo-fresh-completion.zsh  # For zsh
source cargo-fresh-completion.bash # For bash

Other Shell Installation

# Bash completion
cargo fresh completion bash > ~/.bash_completions/cargo-fresh.bash
echo 'source ~/.bash_completions/cargo-fresh.bash' >> ~/.bashrc

# Fish completion
cargo fresh completion fish > ~/.config/fish/completions/cargo-fresh.fish

# PowerShell completion
cargo fresh completion powershell > cargo-fresh.ps1

Usage

After installation, you can use auto-completion in two ways:

Direct Command Completion

cargo fresh <TAB>
# Shows all available options:
# --completion  --help  --include-prerelease  --no-interactive
# --updates-only  --verbose  --version

Cargo Subcommand Completion

cargo <TAB>        # Shows 'fresh' as a subcommand
cargo fresh <TAB>  # Shows all fresh options and parameters

Technical Features

  • Asynchronous Processing: Uses Tokio async runtime for fast concurrent checking of multiple packages
  • Smart Version Detection: Automatically distinguishes between stable and prerelease versions
  • Interactive Interface: User-friendly command-line interaction experience
  • Colored Output: Beautiful terminal output with clear status display
  • Error Handling: Comprehensive error handling and retry mechanisms
  • Type Safety: Rust type system ensures code safety
  • Progress Bars: Real-time update progress display for better user experience
  • Shell Completion: Auto-completion support for multiple shells
  • Language Detection: Automatic system language detection and interface adaptation
  • Cargo Integration: Native cargo subcommand support for seamless workflow
  • Bilingual Support: Complete Chinese and English interface with smart switching
  • Modular Architecture: Clean, maintainable code structure with separate modules

Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the project
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Links