nico-tools 1.0.0 → 1.1.0

package/bin/cli.js

@@ -1,22 +1,21 @@
 #!/usr/bin/env node
+/**
+ * Point d'entrée principal du CLI
+ * Configure et lance les commandes disponibles
+ */
 import yargs from "yargs/yargs";
 import { hideBin } from "yargs/helpers";
+import { createProjectHandler } from "./commands/create-project.js";
+import { translateHandler } from "./commands/translate.js";
 
 yargs(hideBin(process.argv))
   .command(
     "create-project",
     "Crée un nouveau projet",
     (yargs) => {
-      return yargs.option("name", {
-        describe: "Nom du projet",
-        type: "string",
-        demandOption: true,
-      });
+      return yargs;
     },
-    (argv) => {
-      console.log(`Création du projet : ${argv.name}`);
-      // Logique de création de projet ici
-    }
+    createProjectHandler
   )
   .command(
     "translate",
@@ -28,10 +27,7 @@ yargs(hideBin(process.argv))
         demandOption: true,
       });
     },
-    (argv) => {
-      console.log(`Gestion des traductions pour : ${argv.lang}`);
-      // Logique de gestion des traductions ici
-    }
+    translateHandler
   )
   .demandCommand(1, "Vous devez spécifier une commande")
   .help().argv;

package/bin/commands/create-project.js

@@ -0,0 +1,106 @@
+/**
+ * Commande pour créer un nouveau projet à partir d'un template
+ */
+import inquirer from "inquirer";
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+import { TEMPLATES } from "../config/templates.js";
+import { generateSlug, generateReplacements } from "../utils/project-utils.js";
+import { processDirectory, replacePlaceholdersInFile } from "../utils/file-utils.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * Copie un template et remplace les placeholders
+ * @param {string} templatePath - Le chemin relatif du template
+ * @param {string} projectName - Le nom du projet
+ * @param {string} targetPath - Le chemin de destination
+ */
+async function copyTemplate(templatePath, projectName, targetPath) {
+  const sourcePath = path.join(__dirname, "..", "..", "templates", templatePath);
+
+  // Vérifier que le template existe
+  if (!(await fs.pathExists(sourcePath))) {
+    throw new Error(`Le template ${templatePath} n'existe pas`);
+  }
+
+  // Vérifier que le répertoire cible n'existe pas déjà
+  if (await fs.pathExists(targetPath)) {
+    throw new Error(`Le répertoire ${targetPath} existe déjà`);
+  }
+
+  // Copier le template
+  await fs.copy(sourcePath, targetPath);
+
+  // Préparer les replacements
+  const replacements = generateReplacements(projectName);
+
+  // Remplacer les placeholders dans tous les fichiers
+  const files = await fs.readdir(targetPath, { withFileTypes: true });
+  for (const file of files) {
+    const filePath = path.join(targetPath, file.name);
+    if (file.isDirectory()) {
+      await processDirectory(filePath, replacements);
+    } else {
+      await replacePlaceholdersInFile(filePath, replacements);
+    }
+  }
+}
+
+/**
+ * Handler de la commande create-project
+ */
+export async function createProjectHandler() {
+  try {
+    // Prompt pour le type de projet
+    const { projectType } = await inquirer.prompt([
+      {
+        type: "list",
+        name: "projectType",
+        message: "Quel type de projet voulez-vous créer ?",
+        choices: Object.entries(TEMPLATES).map(([key, template]) => ({
+          name: template.name,
+          value: key,
+        })),
+      },
+    ]);
+
+    // Prompt pour le nom du projet
+    const { projectName } = await inquirer.prompt([
+      {
+        type: "input",
+        name: "projectName",
+        message: "Quel est le nom de votre projet ?",
+        validate: (input) => {
+          if (!input || input.trim().length === 0) {
+            return "Le nom du projet ne peut pas être vide";
+          }
+          if (!/^[a-zA-Z0-9\s-_]+$/.test(input)) {
+            return "Le nom du projet ne peut contenir que des lettres, chiffres, espaces, tirets et underscores";
+          }
+          return true;
+        },
+      },
+    ]);
+
+    const template = TEMPLATES[projectType];
+    const targetPath = path.join(process.cwd(), generateSlug(projectName));
+
+    console.log(`\nCréation du projet "${projectName}" avec le template ${template.name}...`);
+    console.log(`Répertoire cible : ${targetPath}\n`);
+
+    await copyTemplate(template.path, projectName, targetPath);
+
+    console.log(`✅ Projet créé avec succès dans ${targetPath}`);
+    console.log(`\nPour démarrer :`);
+    console.log(`  cd ${path.basename(targetPath)}`);
+    console.log(`  npm install`);
+    console.log(`  npm start\n`);
+  } catch (error) {
+    console.error(`❌ Erreur lors de la création du projet : ${error.message}`);
+    process.exit(1);
+  }
+}

package/bin/commands/translate.js

@@ -0,0 +1,12 @@
+/**
+ * Commande pour gérer les traductions
+ */
+
+/**
+ * Handler de la commande translate
+ * @param {Object} argv - Arguments de la commande
+ */
+export function translateHandler(argv) {
+  console.log(`Gestion des traductions pour : ${argv.lang}`);
+  // Logique de gestion des traductions ici
+}

package/bin/config/templates.js

@@ -0,0 +1,9 @@
+/**
+ * Configuration des templates disponibles pour la création de projets
+ */
+export const TEMPLATES = {
+  expo: {
+    name: "Expo (React Native)",
+    path: "react-native/expo-clean-architecture",
+  },
+};

package/bin/utils/file-utils.js

@@ -0,0 +1,84 @@
+/**
+ * Utilitaires pour la gestion des fichiers et le remplacement de placeholders
+ */
+import fs from "fs-extra";
+import path from "path";
+
+// Extensions de fichiers binaires à ignorer lors du remplacement de placeholders
+const BINARY_EXTENSIONS = [
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".ico",
+  ".svg",
+  ".ttf",
+  ".woff",
+  ".woff2",
+  ".eot",
+  ".otf",
+  ".pdf",
+  ".zip",
+  ".tar",
+  ".gz",
+];
+
+/**
+ * Vérifie si un fichier est binaire selon son extension
+ * @param {string} filePath - Le chemin du fichier
+ * @returns {boolean} True si le fichier est binaire
+ */
+export function isBinaryFile(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+  return BINARY_EXTENSIONS.includes(ext);
+}
+
+/**
+ * Remplace les placeholders dans un fichier texte
+ * @param {string} filePath - Le chemin du fichier
+ * @param {Object} replacements - Objet contenant les replacements (clé: valeur)
+ */
+export async function replacePlaceholdersInFile(filePath, replacements) {
+  // Ignorer les fichiers binaires
+  if (isBinaryFile(filePath)) {
+    return;
+  }
+
+  try {
+    const content = await fs.readFile(filePath, "utf-8");
+    let newContent = content;
+    
+    for (const [key, value] of Object.entries(replacements)) {
+      const regex = new RegExp(`{{${key}}}`, "g");
+      newContent = newContent.replace(regex, value);
+    }
+    
+    if (newContent !== content) {
+      await fs.writeFile(filePath, newContent, "utf-8");
+    }
+  } catch (error) {
+    // Ignorer les erreurs silencieusement pour les fichiers non textuels
+    if (error.code !== "EISDIR") {
+      // Ne rien faire pour les fichiers qui ne peuvent pas être lus comme texte
+    }
+  }
+}
+
+/**
+ * Traite récursivement un répertoire pour remplacer les placeholders
+ * @param {string} dirPath - Le chemin du répertoire
+ * @param {Object} replacements - Objet contenant les replacements
+ */
+export async function processDirectory(dirPath, replacements) {
+  const files = await fs.readdir(dirPath, { withFileTypes: true });
+  
+  for (const file of files) {
+    const filePath = path.join(dirPath, file.name);
+    
+    if (file.isDirectory()) {
+      await processDirectory(filePath, replacements);
+    } else {
+      await replacePlaceholdersInFile(filePath, replacements);
+    }
+  }
+}

package/bin/utils/project-utils.js

@@ -0,0 +1,49 @@
+/**
+ * Utilitaires pour la génération de noms et identifiants de projet
+ */
+
+/**
+ * Génère un slug à partir d'un nom de projet
+ * @param {string} name - Le nom du projet
+ * @returns {string} Le slug généré
+ */
+export function generateSlug(name) {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+/**
+ * Génère un bundle identifier iOS à partir d'un slug
+ * @param {string} slug - Le slug du projet
+ * @returns {string} Le bundle identifier iOS (ex: com.monapp)
+ */
+export function generateIOSBundleId(slug) {
+  return `com.${slug.replace(/-/g, "")}`;
+}
+
+/**
+ * Génère un package Android à partir d'un slug
+ * @param {string} slug - Le slug du projet
+ * @returns {string} Le package Android (ex: com.mon.app)
+ */
+export function generateAndroidPackage(slug) {
+  return `com.${slug.replace(/-/g, ".")}`;
+}
+
+/**
+ * Génère tous les replacements pour un projet
+ * @param {string} projectName - Le nom du projet
+ * @returns {Object} Objet contenant tous les replacements
+ */
+export function generateReplacements(projectName) {
+  const slug = generateSlug(projectName);
+  return {
+    APP_NAME: projectName,
+    APP_SLUG: slug,
+    APP_SCHEME: slug,
+    IOS_BUNDLE_ID: generateIOSBundleId(slug),
+    ANDROID_PACKAGE: generateAndroidPackage(slug),
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nico-tools",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Une suite d'outils dédiés à mes projets",
   "main": "lib/index.js",
   "bin": {
@@ -22,7 +22,9 @@
     "templates"
   ],
   "dependencies": {
-    "yargs": "^18.0.0"
+    "yargs": "^18.0.0",
+    "inquirer": "^9.2.15",
+    "fs-extra": "^11.2.0"
   },
   "type": "module"
 }

package/templates/react-native/expo-clean-architecture/README.md

@@ -0,0 +1,154 @@
+# Template Socle React Native + Expo
+
+Ce template fournit une base pour créer des applications React Native avec Expo en suivant les principes de **Clean Architecture**.
+
+## 🚀 Utilisation
+
+### Créer un nouveau projet avec ce template
+
+**Option 1 : Depuis un chemin local (pointant vers le dossier template)**
+
+```bash
+npx create-expo-app MonApp --template /chemin/vers/socle-react-native-expo/template
+```
+
+**Option 2 : Depuis le projet racine (si publié sur NPM)**
+
+```bash
+npx create-expo-app MonApp --template expo-template-socle-react-native
+```
+
+**Option 3 : Depuis un dépôt Git**
+
+```bash
+npx create-expo-app MonApp --template https://github.com/votre-org/expo-template-socle
+```
+
+> **Note importante** : Si vous utilisez un chemin local, vous devez pointer vers le dossier `template/` et non vers le projet racine, sinon le dossier `template/` sera copié tel quel dans le nouveau projet.
+
+## 📋 Configuration requise
+
+Après la création du projet, vous devrez effectuer les étapes suivantes :
+
+### 1. Installer les dépendances
+
+```bash
+npm install
+```
+
+### 2. Configurer les identifiants de l'application
+
+Modifiez le fichier `app.config.ts` pour personnaliser :
+
+- `name` : Nom d'affichage de l'application
+- `slug` : Identifiant unique de l'application
+- `scheme` : Schéma de deep linking
+- `ios.bundleIdentifier` : Identifiant du bundle iOS (ex: `com.votre-org.monapp`)
+- `android.package` : Package Android (ex: `com.votre-org.monapp`)
+
+### 3. Configurer Firebase (optionnel)
+
+Si vous souhaitez utiliser Firebase :
+
+1. Créez un projet Firebase dans la [console Firebase](https://console.firebase.google.com/)
+2. Téléchargez les fichiers de configuration :
+   - `GoogleService-Info.plist` pour iOS → placez-le dans `assets/config/`
+   - `google-services.json` pour Android → placez-le dans `assets/config/`
+3. Décommentez les lignes suivantes dans `app.config.ts` :
+   ```typescript
+   // Dans la section ios:
+   googleServicesFile: "./assets/config/GoogleService-Info.plist",
+   
+   // Dans la section android:
+   googleServicesFile: "./assets/config/google-services.json",
+   
+   // Dans la section plugins:
+   "@react-native-firebase/app",
+   "@react-native-firebase/crashlytics",
+   ```
+4. Pour iOS, installez les pods :
+   ```bash
+   cd ios && pod install && cd ..
+   ```
+
+### 4. Configurer les variables d'environnement
+
+Créez un fichier `.env` à la racine du projet pour vos variables d'environnement :
+
+```env
+EXPO_PUBLIC_TMDB_TOKEN=votre_token_ici
+```
+
+### 5. Personnaliser les assets
+
+Remplacez les images dans `assets/images/` :
+- `icon.png` : Icône de l'application
+- `adaptive-icon.png` : Icône adaptative Android
+- `splash-icon.png` : Icône du splash screen
+- `favicon.png` : Favicon web
+
+## 🏗 Architecture
+
+Ce template suit les principes de **Clean Architecture** avec une approche **feature-based**.
+
+### Structure des features
+
+Chaque feature est divisée en 3 couches :
+
+- **`data`** : Récupération des données (API, stockage local)
+- **`domain`** : Logique métier (entités, use cases, repositories)
+- **`presentation`** : Interface utilisateur (composants, hooks)
+
+Pour plus de détails, consultez la [documentation technique](docs/01-architecture.md).
+
+## 📚 Documentation
+
+- [Documentation technique](docs/00-introduction.md)
+- [Architecture](docs/01-architecture.md)
+
+## 🛠 Scripts disponibles
+
+```bash
+# Démarrer l'application en mode développement
+npm start
+
+# Lancer sur iOS
+npm run ios
+
+# Lancer sur Android
+npm run android
+
+# Lancer sur le web
+npm run web
+
+# Lancer les tests
+npm test
+
+# Lancer le linter
+npm run lint
+
+# Nettoyer les dossiers iOS/Android
+npm run clean
+```
+
+## 📦 Stack technique
+
+- **React Native** + **Expo** : Framework mobile
+- **Expo Router** : Navigation file-based
+- **TypeScript** : Typage statique
+- **@tanstack/react-query** : Gestion d'état serveur
+- **zustand** : Gestion d'état applicatif
+- **Inversify** : Injection de dépendances
+- **react-i18next** : Internationalisation
+
+## 🔗 Liens utiles
+
+- [Documentation Expo](https://docs.expo.dev/)
+- [Documentation React Native](https://reactnative.dev/)
+- [Expo Router](https://docs.expo.dev/router/introduction/)
+
+## 📝 Notes
+
+- Les dossiers `ios/` et `android/` sont générés automatiquement et ne doivent pas être versionnés
+- Le template inclut une configuration de base pour les tests avec Jest
+- L'internationalisation est configurée avec `react-i18next` (français par défaut)

package/templates/react-native/expo-clean-architecture/app.config.ts

@@ -0,0 +1,61 @@
+import "ts-node/register";
+import { ExpoConfig } from "expo/config";
+
+const config: ExpoConfig = {
+  name: "{{APP_NAME}}",
+  slug: "{{APP_SLUG}}",
+  version: "1.0.0",
+  orientation: "portrait",
+  icon: "./assets/images/icon.png",
+  scheme: "{{APP_SCHEME}}",
+  userInterfaceStyle: "automatic",
+  newArchEnabled: true,
+  ios: {
+    supportsTablet: true,
+    // Décommenter et configurer si vous utilisez Firebase
+    // googleServicesFile: "./assets/config/GoogleService-Info.plist",
+    bundleIdentifier: "{{IOS_BUNDLE_ID}}",
+  },
+  android: {
+    adaptiveIcon: {
+      foregroundImage: "./assets/images/adaptive-icon.png",
+      backgroundColor: "#ffffff",
+    },
+    // Décommenter et configurer si vous utilisez Firebase
+    // googleServicesFile: "./assets/config/google-services.json",
+    package: "{{ANDROID_PACKAGE}}",
+  },
+  web: {
+    bundler: "metro",
+    output: "static",
+    favicon: "./assets/images/favicon.png",
+  },
+  plugins: [
+    "expo-router",
+    [
+      "expo-splash-screen",
+      {
+        image: "./assets/images/splash-icon.png",
+        imageWidth: 200,
+        resizeMode: "contain",
+        backgroundColor: "#ffffff",
+      },
+    ],
+    // Décommenter si vous utilisez Firebase
+    // "@react-native-firebase/app",
+    // "@react-native-firebase/crashlytics",
+    [
+      "expo-build-properties",
+      {
+        ios: {
+          useFrameworks: "static",
+        },
+      },
+    ],
+  ],
+  experiments: {
+    typedRoutes: true,
+  },
+};
+
+export default config;

package/templates/react-native/expo-clean-architecture/assets/config/.gitkeep

@@ -0,0 +1,3 @@
+# Placez ici vos fichiers de configuration Firebase
+# google-services.json pour Android
+# GoogleService-Info.plist pour iOS

package/templates/react-native/expo-clean-architecture/babel.config.js

@@ -0,0 +1,11 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    plugins: [
+      "babel-plugin-transform-typescript-metadata",
+      ["@babel/plugin-proposal-decorators", { legacy: true }],
+      ["@babel/plugin-proposal-class-properties", { loose: true }],
+    ],
+    presets: ["babel-preset-expo"],
+  };
+};

package/templates/react-native/expo-clean-architecture/docs/00-introduction.md

@@ -0,0 +1,3 @@
+# Documentation technique
+
+🚧 Work in progress 🚧