Skip to content

zudno/cli-tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cli_tool 🦀

Una sencilla pero vistosa herramienta de línea de comandos (CLI) construida en Rust. Imprime un banner colorido (con texto verde brillante) y permite saludar a un usuario o elemento de forma repetida, demostrando el uso de argumentos por línea de comandos con diseño en la terminal.

Características ✨

  • Banner Interactivo: Muestra un banner al inicio usando caracteres ANSI en color verde brillante.
  • Argumentos CLI: Utiliza clap para manejar argumentos fácilmente.
  • Salida con Formato: Usa la caja (crate) colored para brindar información de estado y ejecución estilizada a la terminal.

Requisitos Previos 📋

Para compilar y ejecutar este proyecto, necesitas tener instalado Rust y su gestor de paquetes Cargo.

Puedes instalar rustup (que incluye rustc y cargo) desde su sitio web oficial:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Instalación y Ejecución 🚀

  1. Clona el repositorio o asegúrate de estar en el directorio del proyecto:

    cd d:\Projects\Sandbox\rust\cli_tool
  2. Compila el proyecto (modo desarrollo):

    cargo build
  3. Ejecuta el proyecto: Puedes probar el proyecto directamente con cargo run y pasándole argumentos:

    cargo run -- --nombre "Mundo" --veces 3

    O ejecutar directamente el binario compilado (en macOS/Linux):

    ./target/debug/cli_tool -n "Mundo" -v 3

    En Windows (PowerShell/CMD):

    .\target\debug\cli_tool.exe -n "Mundo" -v 3

Uso 💻

El CLI espera dos parámetros principales:

  • -n, --nombre <NOMBRE>: El nombre de la persona o cosa que deseas saludar. (Dato requerido).
  • -v, --veces <VECES>: La cantidad de veces que quieres imprimir el saludo. (Dato numérico opcional. El valor por defecto es 1).

Ejemplos

Saludo básico (1 vez por defecto):

cargo run -- -n "Alexis"

Saludo repetido:

cargo run -- --nombre "Comunidad Rust" --veces 5

Ayuda: La herramienta soporta autogeneración de manuales de uso (con la ayuda de clap). Puedes ver los comandos disponibles así:

cargo run -- --help

Dependencias 📦

Este proyecto utiliza las siguientes librerías de Rust:

  • clap: Para el análisis y estructuración de los argumentos de la terminal de forma declarativa.
  • colored: Para pintar la salida y el banner en la terminal.

Licencia 📄

Este proyecto está disponible bajo las condiciones de tu preferencia (ej. MIT).

About

CLI interactivo en Rust que utiliza 'clap' y 'colored' para mostrar banners y generar saludos con estilo en la terminal.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages