@y4wee/nupo 0.1.0 → 0.2.1

package/README.md

@@ -0,0 +1,147 @@
+# nupo
+
+**nupo** est un gestionnaire d'environnements de développement Odoo en ligne de commande. Il simplifie l'installation, la configuration et le lancement de plusieurs versions d'Odoo en parallèle, directement depuis le terminal.
+
+---
+
+## Fonctionnalités
+
+- **Installation de versions Odoo** — clone community + enterprise, création du virtualenv Python, installation des dépendances
+- **Mise à jour des versions** — vérification et mise à jour vers le dernier commit distant
+- **Gestion de services** — créer, modifier, supprimer des configurations de service Odoo (port HTTP, modules custom, conf Odoo)
+- **Lancement de services** — démarrage avec options (-d, -u, -i, --shell, --stop-after-init) et visualiseur de logs en temps réel avec filtrage
+- **Configuration VS Code** — génération automatique de `settings.json` / `launch.json` pour le debug Odoo
+- **Interface themeable** — couleurs entièrement personnalisables (primary, secondary, text, cursor)
+- **Reprise d'installation** — une installation interrompue peut être reprise à l'étape où elle s'est arrêtée
+
+---
+
+## Prérequis
+
+- **Node.js** ≥ 18
+- **Python** ≥ 3.8 avec `pip` et `venv`
+- **Git**
+- Un dépôt **Odoo Community** accessible en local ou clonable
+
+> Pour Odoo Enterprise : une clé SSH avec accès au dépôt `git@github.com:odoo/enterprise.git` est requise.
+
+---
+
+## Installation
+
+### Via le script d'installation (Linux & macOS)
+
+```bash
+curl -fsSL https://y4wee.github.io/nupo/install.sh | bash
+```
+
+Le script vérifie automatiquement la présence de Node.js ≥ 18 et l'installe via `nvm` si nécessaire.
+
+### Via npm
+
+```bash
+npm install -g @y4wee/nupo
+```
+
+---
+
+## Utilisation
+
+### Interface interactive
+
+```bash
+nupo
+```
+
+Lance le menu principal avec navigation au clavier (↑↓ pour naviguer, ↵ pour sélectionner, Échap pour revenir).
+
+### Commandes CLI
+
+#### Démarrer un service directement
+
+```bash
+nupo start <nom_du_service> [options]
+```
+
+| Option | Description |
+|---|---|
+| `-d <base>` | Nom de la base de données |
+| `-u <module>` | Module à mettre à jour |
+| `-i <module>` | Module à installer |
+| `--stop-after-init` | Arrêter après l'initialisation |
+| `--shell` | Lancer en mode shell interactif |
+
+**Exemples :**
+```bash
+nupo start mon_service
+nupo start mon_service -d ma_base -u mon_module
+nupo start mon_service --shell
+```
+
+#### Configurer VS Code pour une version
+
+```bash
+nupo code <branche>
+```
+
+**Exemples :**
+```bash
+nupo code 17.0
+nupo code 18.0
+```
+
+Configure automatiquement `.vscode/settings.json` et `launch.json` pour le debug Odoo, puis ouvre VS Code.
+
+---
+
+## Première utilisation
+
+Au premier lancement, nupo guide à travers une étape d'initialisation :
+
+1. Vérification de Python, pip et venv
+2. Saisie du chemin vers le dépôt Odoo (source des clones)
+
+Une fois initialisé, le menu principal donne accès à toutes les fonctionnalités.
+
+---
+
+## Configuration
+
+La configuration est stockée dans `~/.nupo/config.json`.
+
+Elle est modifiable directement via **nupo → Paramètres** :
+
+| Paramètre | Description | Défaut |
+|---|---|---|
+| `odoo_path_repo` | Chemin du dépôt Odoo source | — |
+| `log_buffer_size` | Nombre de lignes de logs conservées | `500` |
+| `primary_color` | Couleur principale de l'interface | `#9F0C58` |
+| `secondary_color` | Couleur des titres d'écran | `#E79439` |
+| `text_color` | Couleur des textes secondaires | `#848484` |
+| `cursor_color` | Couleur de surlignage des sélections | `cyan` |
+
+La variable d'environnement `NUPO_CONFIG_DIR` permet de surcharger le répertoire de configuration.
+
+---
+
+## Mise à jour
+
+```bash
+npm update -g @y4wee/nupo
+```
+
+---
+
+## Publier une nouvelle version (développeurs)
+
+```bash
+npm version patch   # ou minor / major
+git push origin master --tags
+npm publish --access=public
+```
+
+---
+
+## Licence
+
+MIT

package/dist/App.d.ts

@@ -2,7 +2,8 @@ import React from 'react';
 import { CliStartArgs } from './types/index.js';
 interface AppProps {
     onExit: () => void;
+    onUpdate: () => void;
     startupArgs?: CliStartArgs;
 }
-export declare function App({ onExit, startupArgs }: AppProps): React.JSX.Element;
+export declare function App({ onExit, onUpdate, startupArgs }: AppProps): React.JSX.Element;
 export {};

package/dist/App.js

@@ -10,7 +10,10 @@ import { InitScreen } from './screens/InitScreen.js';
 import { OdooScreen } from './screens/OdooScreen.js';
 import { ConfigScreen } from './screens/ConfigScreen.js';
 import { IdeScreen } from './screens/IdeScreen.js';
-export function App({ onExit, startupArgs }) {
+import { UpdateScreen } from './screens/UpdateScreen.js';
+import { checkForUpdate } from './services/updater.js';
+import { patchConfig } from './services/config.js';
+export function App({ onExit, onUpdate, startupArgs }) {
     const { columns, rows } = useTerminalSize();
     const { config, loading, refresh } = useConfig();
     const [currentScreen, setCurrentScreen] = useState('home');
@@ -18,6 +21,10 @@ export function App({ onExit, startupArgs }) {
     const [confirmSelected, setConfirmSelected] = useState(1);
     const [serviceRunning, setServiceRunning] = useState(false);
     const [activeService, setActiveService] = useState(null);
+    const [updateBanner, setUpdateBanner] = useState(false);
+    const [updateConfirm, setUpdateConfirm] = useState(false);
+    const [updateSel, setUpdateSel] = useState(1);
+    const [showUpdate, setShowUpdate] = useState(false);
     // Reposition to top-left whenever the box height changes (service start/stop)
     useEffect(() => {
         process.stdout.write('\x1B[2J\x1B[H');
@@ -28,6 +35,21 @@ export function App({ onExit, startupArgs }) {
             setCurrentScreen('odoo');
         }
     }, [loading, config?.initiated, startupArgs]);
+    // Update check: show banner immediately if flagged, otherwise check in background
+    useEffect(() => {
+        if (loading)
+            return;
+        if (config?.to_update) {
+            setUpdateBanner(true);
+            return;
+        }
+        void checkForUpdate().then(hasUpdate => {
+            if (!hasUpdate)
+                return;
+            void patchConfig({ to_update: true });
+            setUpdateBanner(true);
+        });
+    }, [loading]); // eslint-disable-line react-hooks/exhaustive-deps
     const primaryColor = getPrimaryColor(config);
     const secondaryColor = getSecondaryColor(config);
     const textColor = getTextColor(config);
@@ -62,8 +84,33 @@ export function App({ onExit, startupArgs }) {
             visible: config?.initiated === true,
         },
     ].filter(o => o.visible), [config]);
-    // Global input: handles Ctrl+C and confirm-exit dialog on all screens
+    // Global input: handles Ctrl+C, Ctrl+U and confirm dialogs on all screens
     useInput((char, key) => {
+        if (updateConfirm) {
+            if (key.leftArrow)
+                setUpdateSel(0);
+            if (key.rightArrow)
+                setUpdateSel(1);
+            if (key.return) {
+                if (updateSel === 0) {
+                    setUpdateConfirm(false);
+                    setShowUpdate(true);
+                }
+                else {
+                    setUpdateConfirm(false);
+                    setUpdateSel(1);
+                }
+            }
+            if (key.escape || char === 'n') {
+                setUpdateConfirm(false);
+                setUpdateSel(1);
+            }
+            if (char === 'o' || char === 'y') {
+                setUpdateConfirm(false);
+                setShowUpdate(true);
+            }
+            return;
+        }
         if (confirmExit) {
             if (key.leftArrow)
                 setConfirmSelected(0);
@@ -81,6 +128,11 @@ export function App({ onExit, startupArgs }) {
                 onExit();
             return;
         }
+        if (key.ctrl && char === 'u' && updateBanner) {
+            setUpdateConfirm(true);
+            setUpdateSel(1);
+            return;
+        }
         if (key.ctrl && char === 'c' && !serviceRunning) {
             setConfirmExit(true);
             setConfirmSelected(1);
@@ -98,12 +150,25 @@ export function App({ onExit, startupArgs }) {
             React.createElement(Box, { paddingX: 3, paddingY: 2 },
                 React.createElement(Text, { color: textColor, dimColor: true }, "Chargement\u2026"))));
     }
+    if (showUpdate) {
+        return (React.createElement(UpdateScreen, { termWidth: termWidth, primaryColor: primaryColor, secondaryColor: secondaryColor, textColor: textColor, onComplete: onUpdate, onError: () => setShowUpdate(false) }));
+    }
     return (React.createElement(Box, { borderStyle: "round", borderColor: primaryColor, flexDirection: "column", width: termWidth, height: serviceRunning ? rows : undefined },
         React.createElement(Header, { activeService: activeService, serviceRunning: serviceRunning, primaryColor: primaryColor, secondaryColor: secondaryColor }),
+        updateBanner && (React.createElement(Box, { paddingX: 3, paddingY: 0, borderStyle: "single", borderTop: false, borderLeft: false, borderRight: false, borderColor: secondaryColor },
+            React.createElement(Text, { color: secondaryColor }, '⬆ '),
+            React.createElement(Text, { color: textColor }, "Mise \u00E0 jour disponible \u2014 "),
+            React.createElement(Text, { color: secondaryColor, bold: true }, "Ctrl+U"),
+            React.createElement(Text, { color: textColor }, " pour mettre \u00E0 jour"))),
         currentScreen === 'home' && (React.createElement(HomeScreen, { leftWidth: leftWidth, options: options, isActive: !confirmExit, primaryColor: primaryColor, secondaryColor: secondaryColor, textColor: textColor, cursorColor: cursorColor, onNavigate: screen => setCurrentScreen(screen) })),
         currentScreen === 'init' && (React.createElement(InitScreen, { config: config, leftWidth: leftWidth, onComplete: handleInitComplete })),
         currentScreen === 'odoo' && config && (React.createElement(OdooScreen, { leftWidth: leftWidth, config: config, onBack: () => setCurrentScreen('home'), onConfigChange: () => void refresh(), onServiceRunning: svc => { setServiceRunning(true); setActiveService(svc); }, onServiceStopped: () => { setServiceRunning(false); setActiveService(null); }, autoStart: startupArgs })),
         currentScreen === 'ide' && config && (React.createElement(IdeScreen, { config: config, leftWidth: leftWidth, onBack: () => setCurrentScreen('home') })),
         currentScreen === 'config' && config && (React.createElement(ConfigScreen, { config: config, leftWidth: leftWidth, onBack: () => setCurrentScreen('home'), onSaved: () => { void refresh(); setCurrentScreen('home'); } })),
-        React.createElement(ConfirmExit, { visible: confirmExit, selected: confirmSelected, textColor: textColor, cursorColor: cursorColor })));
+        React.createElement(ConfirmExit, { visible: confirmExit, selected: confirmSelected, textColor: textColor, cursorColor: cursorColor }),
+        updateConfirm && (React.createElement(Box, { paddingX: 3, paddingY: 0, borderStyle: "single", borderTop: true, borderBottom: false, borderLeft: false, borderRight: false, borderColor: secondaryColor },
+            React.createElement(Text, { color: secondaryColor }, "Mettre \u00E0 jour et red\u00E9marrer nupo ? "),
+            React.createElement(Text, { color: updateSel === 0 ? 'black' : textColor, backgroundColor: updateSel === 0 ? secondaryColor : undefined, bold: updateSel === 0 }, ' Oui '),
+            React.createElement(Text, null, "  "),
+            React.createElement(Text, { color: updateSel === 1 ? 'black' : textColor, backgroundColor: updateSel === 1 ? cursorColor : undefined, bold: updateSel === 1 }, ' Non ')))));
 }

package/dist/index.js

@@ -2,8 +2,9 @@
 import React from 'react';
 import { render } from 'ink';
 import { App } from './App.js';
-import { configExists, readConfig } from './services/config.js';
+import { configExists, readConfig, patchConfig } from './services/config.js';
 import { setupVsCode } from './services/ide.js';
+import { spawn } from 'node:child_process';
 // ── Help ─────────────────────────────────────────────────────────────────────
 const rawArgs = process.argv.slice(2);
 if (rawArgs[0] === '--help' || rawArgs[0] === '-h') {
@@ -140,6 +141,18 @@ function cleanup() {
     // Restore main screen buffer + show cursor
     process.stdout.write('\x1B[?1049l\x1B[?25h');
 }
+async function handleUpdate() {
+    instance.clear();
+    instance.unmount();
+    cleanup();
+    await patchConfig({ to_update: false });
+    // npm install already done by UpdateScreen — just restart
+    const child = spawn(process.argv[0], process.argv.slice(1), {
+        stdio: 'inherit',
+        env: process.env,
+    });
+    child.on('exit', code => process.exit(code ?? 0));
+}
 // Guarantee cleanup on every possible exit path
 process.on('exit', cleanup);
 process.on('SIGTERM', () => { cleanup(); process.exit(0); });
@@ -161,7 +174,7 @@ function handleExit() {
     instance.unmount();
     cleanup();
 }
-instance = render(React.createElement(App, { onExit: handleExit, startupArgs: startupArgs ?? undefined }), {
+instance = render(React.createElement(App, { onExit: handleExit, onUpdate: () => { void handleUpdate(); }, startupArgs: startupArgs ?? undefined }), {
     exitOnCtrlC: false,
 });
 process.stdout.on('resize', () => {

package/dist/screens/InitScreen.js

@@ -174,7 +174,10 @@ export function InitScreen({ config, leftWidth, onComplete }) {
                     React.createElement(Text, { color: "red" },
                         "\u00C9tape \u00E9chou\u00E9e : ",
                         errorStep.label),
-                    React.createElement(Text, { color: textColor }, "Corrigez l'erreur et relancez nupo."))),
+                    errorStep.errorMessage && (React.createElement(Box, { flexDirection: "column", gap: 0 },
+                        React.createElement(Text, { color: textColor }, "Pour installer :"),
+                        errorStep.errorMessage.split('\n').map((line, i) => (React.createElement(Text, { key: i, color: "cyan" }, `  ${line}`))))),
+                    React.createElement(Text, { color: textColor, dimColor: true }, "Relancez nupo une fois corrig\u00E9."))),
                 !waitingInput && !errorStep && !done && (React.createElement(Box, { marginTop: 1 },
                     React.createElement(Text, { color: textColor, dimColor: true }, "\u27F3 V\u00E9rification en cours\u2026"))))),
         React.createElement(StepsPanel, { steps: steps, textColor: textColor }),

package/dist/screens/UpdateScreen.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface UpdateScreenProps {
+    termWidth: number;
+    primaryColor: string;
+    secondaryColor: string;
+    textColor: string;
+    onComplete: () => void;
+    onError: (msg: string) => void;
+}
+export declare function UpdateScreen({ termWidth, primaryColor, secondaryColor, textColor, onComplete, onError }: UpdateScreenProps): React.JSX.Element;
+export {};

package/dist/screens/UpdateScreen.js

@@ -0,0 +1,62 @@
+import React, { useEffect, useRef, useState } from 'react';
+import { Box, Text } from 'ink';
+import { spawn } from 'node:child_process';
+import { createRequire } from 'module';
+const _require = createRequire(import.meta.url);
+const { name: packageName } = _require('../../package.json');
+const BAR_PADDING = 6; // paddingX * 2 + some margin
+export function UpdateScreen({ termWidth, primaryColor, secondaryColor, textColor, onComplete, onError }) {
+    const [progress, setProgress] = useState(0);
+    const [done, setDone] = useState(false);
+    const doneRef = useRef(false);
+    const onCompleteRef = useRef(onComplete);
+    const onErrorRef = useRef(onError);
+    onCompleteRef.current = onComplete;
+    onErrorRef.current = onError;
+    const barWidth = Math.max(10, termWidth - BAR_PADDING - 8); // 8 = "  XXX%  "
+    useEffect(() => {
+        // Animate progress up to 90% while npm runs
+        const timer = setInterval(() => {
+            setProgress(prev => {
+                if (doneRef.current || prev >= 90)
+                    return prev;
+                // Accelerate early, slow down near 90
+                const step = prev < 50 ? 2 : 1;
+                return Math.min(prev + step, 90);
+            });
+        }, 400);
+        // Run npm install -g
+        const child = spawn('npm', ['install', '-g', packageName], {
+            stdio: 'pipe',
+            env: process.env,
+        });
+        child.on('exit', code => {
+            clearInterval(timer);
+            if (code === 0) {
+                doneRef.current = true;
+                setProgress(100);
+                setDone(true);
+                setTimeout(() => onCompleteRef.current(), 800);
+            }
+            else {
+                onErrorRef.current(`npm exited with code ${String(code)}`);
+            }
+        });
+        child.on('error', err => {
+            clearInterval(timer);
+            onErrorRef.current(err.message);
+        });
+        return () => clearInterval(timer);
+    }, []); // eslint-disable-line react-hooks/exhaustive-deps
+    const filled = Math.round((progress / 100) * barWidth);
+    const empty = barWidth - filled;
+    return (React.createElement(Box, { flexDirection: "column", flexGrow: 1, borderStyle: "round", borderColor: primaryColor, width: termWidth },
+        React.createElement(Box, { flexDirection: "column", paddingX: 3, paddingY: 2, gap: 1 },
+            React.createElement(Text, { color: secondaryColor, bold: true }, "Mise \u00E0 jour en cours"),
+            React.createElement(Box, { flexDirection: "column", gap: 1, marginTop: 1 },
+                React.createElement(Box, null,
+                    React.createElement(Text, { color: secondaryColor }, '█'.repeat(filled)),
+                    React.createElement(Text, { color: textColor, dimColor: true }, '░'.repeat(empty)),
+                    React.createElement(Text, { color: textColor }, `  ${String(progress).padStart(3)}%`)),
+                React.createElement(Text, { color: textColor, dimColor: true }, done ? '✓ Installation terminée — redémarrage…' : `Installation de ${packageName}…`)))));
+}

package/dist/services/checks.js

@@ -22,17 +22,35 @@ async function tryCommand(cmd, args) {
         return { ok: false, error: error.message ?? String(err) };
     }
 }
+const isMac = process.platform === 'darwin';
+const HINTS = {
+    python: isMac
+        ? 'brew install python3  (ou téléchargez depuis https://python.org)'
+        : 'sudo apt install python3   # Debian/Ubuntu\nsudo dnf install python3   # Fedora/RHEL',
+    pip: isMac
+        ? 'brew install python3  (pip3 inclus)\nou : python3 -m ensurepip --upgrade'
+        : 'sudo apt install python3-pip   # Debian/Ubuntu\nsudo dnf install python3-pip   # Fedora/RHEL',
+    venv: isMac
+        ? 'brew install python3  (venv inclus)'
+        : 'sudo apt install python3-venv   # Debian/Ubuntu\nsudo dnf install python3-venv   # Fedora/RHEL',
+};
 export async function checkPython() {
     const result = await tryCommand('python3', ['--version']);
     if (result.ok)
         return result;
-    return tryCommand('python', ['--version']);
+    const result2 = await tryCommand('python', ['--version']);
+    if (result2.ok)
+        return result2;
+    return { ok: false, error: HINTS.python };
 }
 export async function checkPip() {
     const result = await tryCommand('pip3', ['--version']);
     if (result.ok)
         return result;
-    return tryCommand('pip', ['--version']);
+    const result2 = await tryCommand('pip', ['--version']);
+    if (result2.ok)
+        return result2;
+    return { ok: false, error: HINTS.pip };
 }
 export async function checkVenv() {
     const result = await tryCommand('python3', ['-m', 'venv', '--help']);
@@ -41,8 +59,5 @@ export async function checkVenv() {
     const result2 = await tryCommand('python', ['-m', 'venv', '--help']);
     if (result2.ok)
         return { ok: true };
-    const hint = process.platform === 'darwin'
-        ? 'réinstallez Python via python.org ou brew install python3'
-        : 'sudo apt install python3-venv';
-    return { ok: false, error: `python venv non disponible (${hint})` };
+    return { ok: false, error: HINTS.venv };
 }

package/dist/services/updater.d.ts

@@ -0,0 +1,4 @@
+/** Vérifie si une version plus récente est disponible sur npm. */
+export declare function checkForUpdate(): Promise<boolean>;
+/** Lance npm install -g puis respawn le process courant. À appeler après cleanup Ink. */
+export declare function performUpdateAndRestart(): void;

package/dist/services/updater.js

@@ -0,0 +1,58 @@
+import { createRequire } from 'module';
+import { get } from 'node:https';
+import { execFileSync, spawn } from 'node:child_process';
+const _require = createRequire(import.meta.url);
+const { version: currentVersion, name: packageName } = _require('../../package.json');
+function fetchLatestVersion() {
+    return new Promise(resolve => {
+        const req = get(`https://registry.npmjs.org/${packageName}/latest`, { headers: { Accept: 'application/json' } }, res => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(data);
+                    resolve(json.version ?? null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        });
+        req.on('error', () => resolve(null));
+        req.setTimeout(3000, () => { req.destroy(); resolve(null); });
+    });
+}
+function isNewer(latest, current) {
+    const parse = (v) => v.split('.').map(Number);
+    const [lMaj, lMin, lPatch] = parse(latest);
+    const [cMaj, cMin, cPatch] = parse(current);
+    if (lMaj !== cMaj)
+        return lMaj > cMaj;
+    if (lMin !== cMin)
+        return lMin > cMin;
+    return lPatch > cPatch;
+}
+/** Vérifie si une version plus récente est disponible sur npm. */
+export async function checkForUpdate() {
+    const latest = await fetchLatestVersion();
+    if (!latest)
+        return false;
+    return isNewer(latest, currentVersion);
+}
+/** Lance npm install -g puis respawn le process courant. À appeler après cleanup Ink. */
+export function performUpdateAndRestart() {
+    process.stdout.write('\n  Mise à jour en cours…\n\n');
+    try {
+        execFileSync('npm', ['install', '-g', packageName], { stdio: 'inherit' });
+    }
+    catch {
+        process.stdout.write('\n  Échec de la mise à jour.\n');
+        process.exit(1);
+    }
+    process.stdout.write('\n  Redémarrage…\n\n');
+    const child = spawn(process.argv[0], process.argv.slice(1), {
+        stdio: 'inherit',
+        env: process.env,
+    });
+    child.on('exit', code => process.exit(code ?? 0));
+}

package/dist/types/index.d.ts

@@ -29,6 +29,7 @@ export interface NupoConfig {
     text_color?: string;
     cursor_color?: string;
     venv_installed?: boolean;
+    to_update?: boolean;
 }
 export declare const DEFAULT_CONFIG: NupoConfig;
 export declare function getPrimaryColor(config?: NupoConfig | null): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@y4wee/nupo",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "nupo CLI - Odoo development environment manager",
   "type": "module",
   "bin": {