/xupg-rs

(WIP) update you xampp , Paragon modules and with ease

Primary LanguageRust

xupg-rs

xupg-rs is a unified CLI tool for managing and updating versions of PHP, MySQL, Node.js, and more. Whether you use standalone tools or environments like XAMPP, Laragon, or Node.js, xupg-rs helps you stay organized by simplifying version management.

Features

  • List installed and available tool versions (locally and online).
  • Install specific versions of tools to custom paths.
  • Manage PHP versions within XAMPP seamlessly.
  • Support for multiple environments: XAMPP, Laragon, Node.js, etc.

Installation

Option 1: Install via cargo from Crates.io

(Requires Rust and Cargo installed on your machine.)

cargo install xupg-rs

Verify the installation:

xupg --version

Option 2: Build and Install from Source

If you want to build the project from the source:

  1. Clone the repository:

    git clone https://github.com/codad5/xupg-rs.git
cd xupg-rs

  2. Build and install the project with Cargo:

    cargo install --path .

    This will build the binary and place it in your Cargo bin directory (~/.cargo/bin by default).

  3. Verify the installation:

    xupg --version

    If Cargo’s bin directory isn’t in your PATH, you may need to add it:

    export PATH="$HOME/.cargo/bin:$PATH"

Usage

Here are some common commands for managing tools using xupg-rs.

1. List Available Versions

xupg list -p
  • -p, --php: List all available PHP versions.
  • -o, --online: Fetch online versions for download.

Example:

xupg list -p -o

This lists online-available PHP versions.

xupg list -p

This lists locally-installed PHP versions.

2. Install a Specific Tool Version

xupg install -p <version> -pa <path>
  • -p, --php <version>: Install a specific PHP version.
  • -pa, --path <path>: (Optional) Specify installation path.

Example:

xupg install -p 8.1.0

This installs PHP version 8.1.0 to the default path.

3. Set PHP Version for XAMPP

xupg xampp php -s <version> -p <path>
  • -s, --set <version>: Set a specific PHP version for XAMPP.
  • -p, --path [path]: (Optional) Specify the XAMPP path.

Example:

xupg xampp php -s 8.0.0 -p c:/zampp/

This sets PHP version 8.0.0 as the default for XAMPP installed at c:/zampp/.

4. Install and Set PHP for XAMPP Automatically

To install PHP 7.4.0 directly into XAMPP’s PHP directory:

xupg xampp php -s 7.4.0

This would install PHP 7.4.0 and set it as the default PHP version for XAMPP.

  • On Windows, the default XAMPP path is C:\xampp.
  • On Linux, the default XAMPP path is /opt/lampp.

Dependencies

  • cached: Caches data for improved performance.
  • colored: Adds color to terminal output.
  • dirs-next: Manages directories and paths.
  • fli: A framework for building CLI applications.
  • indicatif: Displays progress bars during installation.
  • reqwest: Handles HTTP requests (e.g., fetching online versions).
  • serde and serde_json: Parse JSON data.
  • tokio: Supports asynchronous operations.
  • zip: Manages compressed files during downloads.

Contributing

  1. Fork the repository on GitHub.
  2. Create a new branch: 
    git checkout -b feature-branch
  3. Make your changes and commit: 
    git commit -m "Add new feature"
  4. Push your branch: 
    git push origin feature-branch
  5. Open a Pull Request on GitHub.

License

This project is licensed under the MIT License. See the LICENSE file for more information.

Contact

Future Improvements

  • Add Docker support for managing tools in containers.
  • Enhance Windows support for Laragon integration.
  • Promote the tool on crates.io for community feedback and adoption.

With xupg-rs, managing versions across environments becomes straightforward and efficient. Install it today and simplify your workflow! 🚀