Template di Script Shell

Un moderno template per script Bash con formattazione dell'output colorato e funzioni di utilità per creare strumenti da riga di comando professionali.

Caratteristiche

• 🎨 Output Colorizzato: Schemi di colori predefiniti e funzioni di formattazione
• 📝 Messaggi Standardizzati: Formati di messaggio coerenti per info, successo, avviso ed errore
• 🔧 Funzioni di Utilità: Funzioni pronte all'uso per operazioni comuni negli script shell
• 📦 Design Modulare: File di libreria separato per un facile riutilizzo tra progetti
• ⚡ Configurazione Semplice: Meccanismo di sourcing semplice per un uso immediato

Avvio Rapido

1. Clona o scarica questo template
2. Rendi eseguibile il tuo script:
   root@kitploit:~

   chmod +x script.sh
   

3. Esegui lo script di esempio:
   root@kitploit:~

   ./script.sh
   

Utilizzo

Struttura Base del Template

#!/bin/bash

LIB="lib"
source $LIB/format.sh

section "Your Script Section"
info "Information message"
ok "Success message" 
warn "Warning message"
error "Error message"

Funzioni Disponibili

Tipi di Messaggio

• info "message" - Visualizza messaggi informativi con prefisso ciano [i]
• ok "message" - Visualizza messaggi di successo con prefisso verde [+]
• warn "message" - Visualizza messaggi di avviso con prefisso giallo [!]
• error "message" - Visualizza messaggi di errore con prefisso rosso [-] (inviati a stderr)

Funzioni Interattive

• prompt "question" - Mostra un prompt con prefisso magenta [?] e attende l'input dell'utente
• section "title" - Crea un'intestazione di sezione formattata

Formattazione del Testo

• bold "text" - Visualizza il testo in grassetto

Costanti di Colore

Le seguenti costanti di colore sono disponibili per la formattazione personalizzata:

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
MAGENTA='\033[0;35m'
CYAN='\033[0;36m'
WHITE='\033[1;37m'
BOLD='\033[1m'
UNDERLINE='\033[4m'
RESET='\033[0m'

Output di Esempio

Quando esegui lo script di esempio, vedrai:

=== Start ===
[i] Running exploit setup...
[+] Everything is ready
[!] This might break your system
[-] Something failed
[?] Continue? [y/N]:

Struttura dei File

shell_template/
├── script.sh          # Example script demonstrating usage
├── lib/
│   └── format.sh       # Core formatting library
├── LICENSE             # MIT License
└── README.md          # This file

Personalizzazione

Aggiungere Nuovi Tipi di Messaggio

Puoi estendere la libreria aggiungendo nuovi tipi di messaggio in lib/format.sh:

DEBUG="${BLUE}[D]${RESET}"
debug() { echo -e "${DEBUG} $*"; }

Colori Personalizzati

Definisci i tuoi schemi di colore modificando le costanti di colore o creandone di nuove:

PURPLE='\033[0;35m'
CUSTOM_PREFIX="${PURPLE}[*]${RESET}"
custom() { echo -e "${CUSTOM_PREFIX} $*"; }

Migliori Pratiche

1. Includi sempre la libreria: Includi source $LIB/format.sh all'inizio dei tuoi script
2. Usa i tipi di messaggio appropriati: Scegli la funzione giusta per il contesto (info, ok, warn, error)
3. Struttura con sezioni: Usa section per organizzare l'output del tuo script
4. Gestisci gli errori correttamente: Usa error per i messaggi di errore e reindirizza a stderr
5. Rendi eseguibili gli script: Non dimenticare chmod +x per i tuoi script

Contributi

Sentiti libero di segnalare problemi, fare il fork del repository e creare pull request per qualsiasi miglioramento.

Licenza

Questo progetto è concesso in licenza sotto la Licenza MIT - consulta il file LICENSE per i dettagli.

Autore

Creato da Christoph Huy