xsshend-0.2.7 is not a library.

Visit the last successful build: xsshend-0.5.2

🚀 xsshend

xsshend est un outil Rust moderne et efficace pour le téléversement parallèle de fichiers vers multiples serveurs SSH. Il offre une interface TUI (Terminal User Interface) hiérarchique intuitive avec suivi en temps réel des transferts.

🔧 Installation

Via Cargo (recommandé)

cargo install xsshend

Depuis les sources

git clone https://github.com/WillIsback/xsshend.git
cd xsshend
cargo install --path .

📚 Documentation

✨ Fonctionnalités principales

🌳 Interface hiérarchique moderne pour la sélection de serveurs
🔄 Téléversement parallèle vers plusieurs serveurs SSH simultanément
🎯 Barres de progression en temps réel pour chaque serveur
🔍 Recherche intégrée pour filtrer rapidement les serveurs
🔐 Authentification sécurisée par clés SSH avec support agent SSH
🔑 Sélection interactive de clés SSH avec découverte automatique
🎛️ Sélection CLI de clés SSH avec options --ssh-key et --ssh-key-interactive
📊 Configuration hiérarchique des serveurs (environnements, régions, types)
⚡ Performance optimisée avec threading natif Rust
🛡️ Gestion d'erreurs robuste avec rapports détaillés
📁 Support multi-fichiers avec sélection interactive
🎮 Modes d'utilisation flexibles : interface complète, interactif, ligne de commande
🎨 Thème adaptatif : Détection automatique des thèmes clair/sombre du terminal
🌈 Interface optimisée : Couleurs et contrastes adaptés pour une meilleure lisibilité

🎮 Interface utilisateur

Interface hiérarchique de sélection

L'interface organise vos serveurs en arbre navigable :

📂 Production
├── 🌐 Region-A  
│   ├── 📊 Public
│   │   ├── ✅ WEB_SERVER_01 (web01@prod-web-01.example.com)
│   │   └── �️ API_SERVER_01 (api01@prod-api-01.example.com)
│   └── 📋 Private
│       └── 🖥️ DATABASE_01 (db01@prod-db-01.example.com)
└── 🌐 Region-B
    └── 📊 Public
        └── 🖥️ CACHE_SERVER_01 (cache01@prod-cache-01.example.com)

Navigation intuitive

↑↓ : Navigation dans l'arbre
→ ← : Déplier/réduire les nœuds
Espace : Sélectionner des serveurs
/ : Recherche en temps réel
a : Sélectionner tout / c : Vider la sélection

🏗️ Architecture de configuration

Production/
├── Region-A/
│   ├── Public/     # Serveurs publics
│   └── Private/    # Serveurs internes
└── Region-B/
    ├── Public/
    └── Private/

Staging/
├── Region-A/
└── Region-B/

Development/
└── Local/

🚀 Installation

Prérequis

Rust 2024 ou plus récent
OpenSSH configuré avec clés SSH
Fichier de configuration ~/.ssh/hosts.json

Compilation

# Cloner le projet
git clone https://github.com/username/xsshend.git
cd xsshend

# Compiler en mode release
cargo build --release

# Installer globalement
cargo install --path .

🔑 Gestion des clés SSH

Détection automatique

xsshend détecte automatiquement les clés SSH disponibles dans ~/.ssh/ :

Clés supportées : id_ed25519, id_rsa, id_ecdsa, id_dsa
Gestion des clés avec passphrase
Support complet de ssh-agent

Sélection de clés en ligne de commande

# Sélection interactive - affiche un menu pour choisir parmi les clés disponibles
xsshend upload file.txt --ssh-key-interactive

# Spécification directe par nom de fichier (sans extension)
xsshend upload file.txt --ssh-key id_ed25519
xsshend upload file.txt --ssh-key company_key

# Sélection automatique forcée de la meilleure clé (Ed25519 > RSA > ECDSA)
xsshend upload file.txt --ssh-key-auto

# Comportement par défaut : sélection intelligente
xsshend upload file.txt
# Affiche les clés détectées et sélectionne automatiquement la meilleure
# Suggère l'utilisation de --ssh-key-interactive pour un choix manuel

Priorité de sélection automatique

Ed25519 - Recommandé pour la sécurité et les performances
RSA - Compatibilité étendue
ECDSA - Alternative moderne
Autres - Support basique

Intégration ssh-agent

Si aucune clé n'est sélectionnée ou disponible, xsshend utilise automatiquement ssh-agent pour l'authentification.

🎨 Thèmes et accessibilité

Détection automatique du thème

xsshend s'adapte automatiquement au thème de votre terminal :

Thème sombre : Couleurs optimisées pour les fonds sombres
Thème clair : Contraste amélioré pour les fonds clairs
Détection intelligente : Utilise les APIs du terminal pour la détection

Lisibilité optimisée

Contraste automatique pour tous les éléments
Titres de panneaux bien visibles
Éléments non sélectionnés lisibles
Panneau d'aide avec bon contraste

⚙️ Configuration

Fichier hosts.json

Créez le fichier ~/.ssh/hosts.json avec la structure suivante :

{
  "Production": {
    "Region-A": {
      "Public": {
        "WEB_SERVER_01": {
          "alias": "web01@prod-web-01.example.com",
          "env": "PROD"
        },
        "API_SERVER_01": {
          "alias": "api01@prod-api-01.example.com",
          "env": "PROD"
        }
      },
      "Private": {
        "INTERNAL_WEB_01": {
          "alias": "iweb01@prod-internal-01.example.com",
          "env": "PROD"
        }
      }
    }
  },
  "Staging": {
    "Region-A": {
      "Public": {
        "STAGE_WEB_01": {
          "alias": "web01@stage-web-01.example.com",
          "env": "STAGE"
        }
      }
    }
  }
}

Clés SSH

Assurez-vous que vos clés SSH publiques sont déployées sur tous les serveurs cibles :

# Copier votre clé publique vers un serveur
ssh-copy-id user@server.example.com

# Ou ajouter manuellement dans ~/.ssh/authorized_keys sur le serveur distant

🎮 Utilisation

1. Interface complète (recommandé)

Lancez l'application pour accéder à l'interface hiérarchique complète :

# Interface TUI complète avec workflow guidé
xsshend

# Ou explicitément en mode interactif  
xsshend --interactive

Workflow guidé :

Sélection des fichiers - Navigateur de fichiers intuitif
Sélection des serveurs - Interface hiérarchique avec recherche
Destination - Saisie du répertoire cible
Téléversement - Progression en temps réel

2. Mode interactif avec fichiers pré-sélectionnés

# Avec fichiers spécifiés, interface pour serveurs et destination
xsshend --interactive file1.txt file2.txt directory/

# Ou via sous-commande
xsshend upload file1.txt file2.txt --interactive

3. Mode ligne de commande

# Téléversement direct avec filtres
xsshend upload file.txt --region Production --dest /opt/app/

# Filtrer par région
xsshend upload *.log --region Region-A --dest /var/log/

# Filtrage par environnement (nouveau!)
xsshend upload ./config.json --env Production
xsshend upload ./staging-config.json --env Staging

# Filtrage combiné environnement + région
xsshend upload ./regional-config.json --env Production --region Region-A

# Filtrage combiné environnement + type
xsshend upload ./app.war --env Production --type Public

# Gestion des clés SSH - nouvelles options!
# Sélection interactive de la clé SSH
xsshend upload file.txt --ssh-key-interactive

# Spécifier une clé SSH par nom (sans extension)
xsshend upload file.txt --ssh-key id_rsa
xsshend upload file.txt --ssh-key company_key

# Forcer la sélection automatique de la meilleure clé
xsshend upload file.txt --ssh-key-auto

# Par défaut : sélection intelligente avec suggestion
xsshend upload file.txt  # Sélectionne automatiquement la meilleure clé disponible

4. Lister les serveurs avec étiquettes hiérarchiques

# Lister les serveurs disponibles avec étiquettes CLI
xsshend list
# ou
xsshend -l

Exemple de sortie enrichie :

🔍 Liste des cibles SSH disponibles:

📁 Production (--env Production)
  📂 Region-A (--region Region-A)
    📂 Public (--type Public)
      🖥️  WEB_SERVER_01 → web01@prod-web-01.example.com (PROD)
      🖥️  API_SERVER_01 → api01@prod-api-01.example.com (PROD)
    📂 Private (--type Private)
      �️  DATABASE_01 → db01@prod-db-01.example.com (PROD)

📁 Staging (--env Staging)
  📂 Region-A (--region Region-A)
    📂 Public (--type Public)
      🖥️  STAGE_WEB_01 → web01@stage-web-01.example.com (STAGE)

📊 Total: 4 cibles disponibles

�💡 Exemples d'utilisation:
   xsshend upload --env Production file.txt
   xsshend upload --env Staging --region Region-A file.txt
   xsshend upload --region Region-A --type Public file.txt

5. Gestion robuste des serveurs déconnectés

xsshend gère maintenant gracieusement les serveurs inaccessibles :

# Vérification de connectivité avant l'interface TUI
xsshend --online-only

# Les timeouts de connexion sont configurés pour éviter les blocages
# Les erreurs de connexion sont logguées mais n'interrompent pas les autres transferts
   xsshend upload --region Region-A --type Public file.txt

5. Modes de filtrage avancés

# Filtrage par environnement complet
xsshend upload file.txt --env Production --dest /opt/app/

# Filtrage par environnement et région
xsshend upload file.txt --env Staging --region Region-A --dest /var/log/

# Filtrage par environnement et type de serveurs
xsshend upload config.json --env Production --type Public --dest /etc/app/

# Filtrage traditionnel par région ou type uniquement
xsshend upload *.log --region Region-A --dest /var/log/
xsshend upload config.json --type Public --dest /etc/app/

# Vérification de connectivité avant transfert
xsshend --online-only

Workflow interactif en 4 étapes :

📁 Sélection de fichiers - Naviguez et sélectionnez vos fichiers
🖥️ Sélection de serveurs - Choisissez vos serveurs cibles
📂 Saisie de destination - Spécifiez le répertoire de destination ⭐
⚡ Transferts parallèles - Surveillez les transferts en temps réel

⭐ Important : L'étape de saisie du répertoire de destination est présente et fonctionnelle dans le TUI. Utilisez Tab/Entrée pour naviguer entre les étapes.

Interface en Ligne de Commande

# Téléverser un fichier vers tous les serveurs disponibles
xsshend upload ./myfile.tar.gz

# Téléverser vers un environnement spécifique
xsshend upload ./app.jar --env Production

# Téléverser vers une région spécifique
xsshend upload ./app.jar --region Region-A

# Téléverser vers des serveurs publics uniquement
xsshend upload ./config.json --type Public

# Téléverser vers un environnement ET une région
xsshend upload ./config.json --env Staging --region Region-A

# Téléverser vers un environnement ET un type
xsshend upload ./app.war --env Production --type Public

# Téléverser plusieurs fichiers
xsshend upload ./file1.txt ./file2.json

# Mode interactif avec sélection de serveurs
xsshend upload ./deploy.sh --interactive

# Spécifier le répertoire de destination
xsshend upload ./app.war --dest /opt/apps/

# Mode verbeux avec logs détaillés
xsshend upload ./script.sh --verbose

# Vérifier la connectivité avant le TUI (n'affiche que les serveurs en ligne)
xsshend --online-only

Interface de Progression

L'interface de progression se lance automatiquement et affiche des barres de progression en temps réel :

🚀 Début du téléversement:
   📁 1 fichier(s)
   🖥️  3 serveur(s)
   📂 Destination: /opt/uploads/

📤 Téléversement de ./myapp.jar vers /opt/uploads/myapp.jar...
   Taille: 2.3 MB

web01@prod-web-01... [████████████████████████████████] 2.3MB/2.3MB (00:02)
api01@prod-api-01... [██████████████████              ] 1.5MB/2.3MB (00:01)
db01@stage-db-01.... [████████████████████████████     ] 2.1MB/2.3MB (00:00)

📊 Résumé du téléversement:
  ✅ WEB_SERVER_01 - 2,359,296 octets
  ✅ API_SERVER_01 - 2,359,296 octets  
  ✅ DATABASE_01 - 2,359,296 octets

✅ Téléversement terminé avec succès!

Options Avancées

# Exclure certains serveurs
xsshend upload ./file.txt --exclude WEB_SERVER_01,API_SERVER_02

# Timeout personnalisé
xsshend upload ./largefile.bin --timeout 300

# Nombre max de connexions parallèles
xsshend upload ./file.txt --max-parallel 5

# Mode dry-run (simulation)
xsshend upload ./file.txt --dry-run

# Forcer l'écrasement de fichiers existants
xsshend upload ./file.txt --force

# Utiliser SCP au lieu de SFTP
xsshend upload ./file.txt --protocol scp

🔧 Stack Technologique

Crates Principales

ssh2 - Connectivité SSH/SFTP robuste
indicatif - Barres de progression multi-threads
dialoguer - Prompts interactifs élégants
clap - Parsing d'arguments CLI moderne
rayon - Parallélisation efficace
crossterm - Contrôle terminal cross-platform
serde - Sérialisation JSON
rpassword - Saisie sécurisée de passphrase
anyhow - Gestion d'erreurs ergonomique

📋 Note : Une interface TUI complète avec contrôles interactifs (pause, reprise, logs) est prévue pour la version 0.2.0

Architecture du Code

src/
├── main.rs              # Point d'entrée et CLI
├── config/
│   ├── mod.rs
│   └── hosts.rs         # Parsing hosts.json
├── ssh/
│   ├── mod.rs
│   ├── client.rs        # Client SSH/SFTP
│   ├── auth.rs          # Authentification (placeholder)
│   └── transfer.rs      # Transfert avec barres de progression
├── ui/
│   ├── mod.rs
│   └── prompts.rs       # Dialogues interactifs
├── core/
│   ├── mod.rs
│   ├── uploader.rs      # Orchestrateur principal
│   ├── parallel.rs      # Gestion parallélisme (placeholder)
│   └── validator.rs     # Validation fichiers/serveurs
└── utils/
    ├── mod.rs
    ├── env_expansion.rs # Expansion variables d'environnement
    ├── errors.rs        # Types d'erreurs
    └── logger.rs        # Système de logs (placeholder)

🛠️ Développement

Prérequis Développement

# Installer les outils de développement
rustup component add clippy rustfmt

# Installer cargo-watch pour le développement
cargo install cargo-watch

Commandes Utiles

# Développement avec rechargement automatique
cargo watch -x "run -- upload examples/test.txt --env Development"

# Tests
cargo test
cargo test -- --nocapture  # Avec output des prints

# Linting
cargo clippy -- -D warnings

# Formatage
cargo fmt

# Vérification complète
cargo check --all-targets --all-features

# Benchmark de performance
cargo bench

# Documentation
cargo doc --open

Structure des Tests

tests/
├── integration/
│   ├── mod.rs
│   ├── ssh_tests.rs     # Tests SSH réels
│   ├── config_tests.rs  # Tests de configuration
│   └── upload_tests.rs  # Tests de téléversement
├── fixtures/
│   ├── test_hosts.json  # Fichier hosts de test
│   └── test_files/      # Fichiers de test
└── mock/
    ├── ssh_mock.rs      # Mock serveur SSH
    └── helpers.rs       # Utilitaires de test

🧪 Tests et Validation

Tests Unitaires

cargo test                # Tests des modules
cargo test --verbose     # Tests avec détails

Tests d'Intégration en Conditions Réelles

Un module de test complet avec Multipass permet de tester xsshend sur de vraies VMs Ubuntu :

# Démonstration complète automatisée
cd test/
./demo.sh

# Ou setup manuel
./test-vms.sh launch-all           # Lance 5 VMs Ubuntu configurées
./generate-test-files.sh           # Génère fichiers de test variés
./run-integration-tests.sh         # Exécute 9 tests automatisés

Environnement de Test

5 VMs Ubuntu 22.04 simulant Dev/Staging/Production
SSH configuré automatiquement avec clés de test
Tests parallèles sur plusieurs serveurs simultanément
Fichiers variés : texte, JSON, binaires, gros fichiers (1MB)
Isolation complète : aucun impact sur vos serveurs

Suite de Tests Automatisés

✅ Interface CLI et aide
✅ Configuration hosts.json et filtrage
✅ Mode dry-run (simulation)
✅ Transfert simple et multiple
✅ Barres de progression (gros fichiers)
✅ Transferts parallèles multi-serveurs
✅ Gestion d'erreurs robuste
✅ Tests de performance et stress

Résultat attendu : 9/9 tests passent = prêt pour production !

📖 Documentation

Consultez la documentation complète dans le répertoire docs/ :

Guide d'utilisation - Utilisation détaillée de l'interface hiérarchique
Configuration - Configuration avancée et personnalisation

Liens rapides

Navigation dans l'interface : docs/usage.md#navigation-dans-linterface
Configuration des serveurs : docs/configuration.md#fichier-de-configuration-principal
Raccourcis et alias : docs/configuration.md#raccourcis-et-personnalisation

🔧 Configuration avancée

Voir le guide de configuration pour :

Organisation optimale de l'infrastructure
Variables d'environnement et personnalisation
Raccourcis shell et scripts de déploiement
Résolution des problèmes courants

� Dépannage

Problèmes courants

Erreur: "Permission denied (publickey)"

# Vérifier la configuration SSH
ssh -v user@server.example.com

# Vérifier l'agent SSH
ssh-add -l

# Ajouter la clé si nécessaire
ssh-add ~/.ssh/id_rsa

Erreur: "hosts.json not found"

# Créer le fichier de configuration
mkdir -p ~/.ssh
# Créer et éditer avec vos serveurs
nano ~/.ssh/hosts.json

Serveurs déconnectés ou inaccessibles

# Utiliser --online-only pour pré-filtrer les serveurs accessibles
xsshend --online-only

# Les timeouts de connexion sont configurés automatiquement (5 secondes par défaut)
# En cas d'échec de connexion, xsshend continue avec les autres serveurs

# Vérifier la connectivité manuellement
ssh -o ConnectTimeout=5 user@server.example.com

# Logs d'erreur détaillés pour identifier les problèmes
RUST_LOG=debug xsshend upload file.txt --env Production

Performances lentes

# Réduire le parallélisme via variable d'environnement
export XSSHEND_MAX_PARALLEL=5
xsshend upload largefile.zip

Consultez le guide de configuration pour plus de solutions.

📝 Logs et Debug

# Mode verbeux
RUST_LOG=debug xsshend upload file.txt --region Production

# Affichage détaillé des transferts
xsshend upload file.txt --region Production --verbose

# Mode trace pour debugging SSH
RUST_LOG=ssh2=trace xsshend upload file.txt --region Production

🤝 Contribution

Les contributions sont les bienvenues ! Veuillez suivre ces étapes :

Fork le projet
Créer une branche feature (git checkout -b feature/ma-fonctionnalite)
Commiter vos changements (git commit -am 'Ajoute ma fonctionnalité')
Pousser vers la branche (git push origin feature/ma-fonctionnalite)
Ouvrir une Pull Request

Standards de Code

Code formaté avec cargo fmt
Linting sans warnings avec cargo clippy
Tests passants avec cargo test
Documentation mise à jour

📄 Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

🙏 Remerciements

clap-rs pour l'excellent framework CLI
ssh2-rs pour les bindings SSH robustes
indicatif pour les barres de progression élégantes
Communauté Rust pour l'écosystème exceptionnel

xsshend - Téléversement SSH parallèle, simple et efficace 🚀

xsshend 0.2.7