Structure des répertoires du projet

Après avoir cloné ou téléchargé le projet aliyunpan, sa structure de répertoire standard se présente généralement comme suit :

aliyunpan/
├── LICENCE
├── LIREMOI.md
├── scripts/
│   └── installation.sh
└── src/
    ├── commandes/
    │   ├── telechargement.js
    │   ├── listage.js
    │   ├── creation_repertoire.js
    │   └── ...
    ├── extensions/
    │   └── filtrage.js
    └── utilitaires/
        └── authentification.js

Description des répertoires

• LICENCE : Contient l'accord de licence sous lequel le projet est distribué.
• LIREMOI.md : Fournit une introduction au projet, ses fonctionnalités et des étapes de base pour commencer.
• scripts/ : Regroupe les scripts pour le déploiement automatisé, la construction et les tests, comme le script d'installation installation.sh.
• src/ : Le répertoire principal du code source.
  • commendes/ : Fichiers JavaScript implémentant les diverses commandes fonctionnelles, comme le téléchargement (telechargement.js) et le listage des fichiers (listage.js).
  • extensions/ : Répertoire pour les extensions qui étendent les fonctionnalités, par exemple filtrage.js pour le filtrage des fichiers.
  • utilitaires/ : Bibliothèque d'outils partagés, comme le module d'authentification (authentification.js).

Point d'entrée de l'application

Le point d'entrée principal de aliyunpan est l'exécutable binaire ou le script portant le même nom (aliyunpan) situé dans le répertoire racine.

Il accepte une série de paramètres et de sous-commandes pour exécuter différentes fonctions, telles que :

• connexion : Authentification de l'utilisateur.
• envoi, telechargement, ls, etc. : Opérations diverses sur les ressources cloud.

Dans le terminal, saisissez aliyunpan ou plus précisément aliyunpan commande arg1 arg2... pour invoquer une fonctionnalité spécifique.

Par exemple :

aliyunpan connexion               # Exécute l'opération de connexion
aliyunpan telechargement chemin   # Télécharge un fichier depuis le cloud

Fichier de configuration

Pour garantir la sécurité des données et répondre aux besoins de personnalisation, aliyunpan permet aux utilisateurs de stocker les informations sansibles et de définir les préférences via un fichier de configuration externe.

Le fichier de configuration n'est pas inclus par défaut dans le dépôt du projet ; son emplacement doit être explicitement spécifié lors de l'exécution.

Par défaut, le fichier de configuration est stocké à l'emplacement $HOME/.config/aliyunpan/config.json sur le système. Cependant, dans la pratique, il est souvent recommandé de définir la variable d'environnement ALIYUNPAN_CONFIG_DIR pour pointer vers un répertoire de configuration personnalisé.

Par exemple, sous Linux, vous pouvez procéder ainsi :

export ALIYUNPAN_CONFIG_DIR="/chemin/vers/votre/repertoire/config/personnalise"

Cela écrasera l'emplacement par défaut, et aliyunpan lira le fichier config.json de ce répertoire à chaque exécution. Ce fichier contient les identifiants de l'utilisateur ainsi que d'autres options de configuration possibles.

En termes de champs de configuration spécifiques, config.json peut inclure, sans s'y limiter, les éléments suivants :

• identifiant : Nom d'utilisateur ou adresse e-mail.
• mot_de_passe : Mot de passe de l'utilisateur.
• jeton : Jeton OAuth pour l'authentification.
• ... D'autres options personnnalisées comme le répertoire de travail par défaut sur le cloud, etc.

En résumé, il est essentiel de maintenir ces informations sensibles en sécurité, et les stocker indépendamment du corps principal du code de la manière décrite ci-dessus est une approche judicieuse.