nceco-cli

v1.1.0

Published

5 months ago

CLI tool for web ecoconception analysis based on GreenIT best practices. Validates W3C compliance, cache headers, and other performance optimizations.

0High
0Medium
0Low

sgortaisnc

ecoconception greenit web-performance sustainability cli validation w3c cache optimization

Eco-CLI

Un outil CLI pour l'analyse d'écoconception web basé sur les bonnes pratiques GreenIT.

🚀 Installation

npm install -g nceco-cli

📖 Utilisation

Analyse d'une URL simple

eco https://example.com

Analyse avec configuration

eco --config eco-config.json

Exemple de fichier de configuration

{
  "urls": [
    "https://example.com",
    "https://example.org"
  ],
  "options": {
    "ignoreViteHashedFiles": true,
    "skipW3cValidation": false,
    "w3cValidation": {
      "tolerant": true,
      "maxErrors": 5
    },
    "cacheHeaders": {
      "ignorePatterns": [
        "\\.(js|css|png|jpg|jpeg|gif|svg|woff|woff2|ttf|eot)$"
      ]
    }
  }
}

🔧 Tests disponibles

Tests Automatisables

✅ RWEB_0009 - Limiter le nombre de requêtes HTTP
✅ RWEB_0101 - Ajouter des en-têtes Expires ou Cache-Control
✅ RWEB_0077 - Minifier les fichiers CSS et JavaScript
✅ RWEB_0099 - Utiliser un cache HTTP
✅ RWEB_0010 - Stocker les données statiques localement
✅ RWEB_0011 - Avoir un titre de page et une metadescription pertinents
✅ RWEB_0019 - Remplacer les boutons officiels de partage des réseaux sociaux
✅ RWEB_0027 - Fournir une CSS print
✅ RWEB_0029 - Favoriser les polices standards
✅ RWEB_0031 - Valider les pages auprès du W3C
✅ RWEB_0032 - Externaliser les CSS et JavaScript
✅ RWEB_0034 - Dimensionner correctement les images côté navigateur
✅ RWEB_0037 - Utiliser le chargement paresseux
✅ RWEB_0078 - Compresser les fichiers texte
✅ RWEB_0079 - Combiner les fichiers CSS et JavaScript
✅ RWEB_0080 - Optimiser les images
✅ RWEB_0082 - Optimiser la taille des cookies
✅ RWEB_0095 - Éviter les redirections
✅ RWEB_0107 - Compresser les documents
✅ RWEB_4006 - Privilégier HTTP/2 à HTTP/1
✅ RWEB_4007 - Économiser la bande passante grâce aux service workers
✅ RWEB_4008 - Mettre en place un sitemap efficient

⚙️ Configuration

Options W3C Validation

{
  "w3cValidation": {
    "tolerant": true,     // Mode tolérant activé
    "maxErrors": 5        // Maximum 5 erreurs acceptées
  }
}

Options Cache Headers

{
  "ignoreViteHashedFiles": true,  // Ignorer les fichiers Vite avec hash
  "cacheHeaders": {
    "ignorePatterns": [
      "\\.(js|css|png|jpg|jpeg|gif|svg|woff|woff2|ttf|eot)$"
    ]
  }
}

🆕 Nouveautés v1.1.0

✅ Validation W3C améliorée : Validation directe du HTML pour URLs locales et publiques
✅ Support Vite : Détection automatique des fichiers avec hash
✅ Mode tolérant : Configuration flexible pour les erreurs W3C
✅ Meilleure gestion des erreurs : Détails plus précis et robustesse améliorée
✅ Configuration étendue : Plus d'options de personnalisation

🔍 Exemple de sortie

Analyzing https://example.com..

--- Eco-Conception Analysis Report ---
[PASS] Limiter le nombre de requêtes HTTP: Le nombre de requêtes HTTP (15) doit être inférieur ou égal à 40.
[PASS] Ajouter des en-têtes Expires ou Cache-Control: Le nombre de ressources sans en-tête de cache (0) doit être inférieur ou égal à 0.
[PASS] Valider les pages auprès du W3C: The page is valid according to the W3C validator (HTML content validation).
[PASS] External CSS and JavaScript: All CSS and JavaScript are externalized.
[PASS] Cookie Size: No cookies are being set.
[PASS] HTTP/2: The page is served over HTTP/2.
--------------------------------------

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

Fork le projet
Créer une branche pour votre fonctionnalité
Commiter vos changements
Pousser vers la branche
Ouvrir une Pull Request

📄 Licence

MIT License - voir le fichier LICENSE pour plus de détails.

🙏 Remerciements

Basé sur les bonnes pratiques GreenIT pour l'écoconception web.