Quick start

Commence en quelques commandes.

Cette mini documentation présente l’expérience CLI envisagée pour PointClass : créer, exécuter, enrichir, tester, diagnostiquer et distribuer un projet Java sans configurer manuellement la toolchain.

$ pointclass new hello $ cd hello $ pointclass run

01 / Installation

Une installation, rien de plus.

Après installation de PointClass, la commande suivante doit confirmer que le CLI et sa toolchain sont disponibles.

pointclass --version
pointclass doctor

Les noms de packages, numéros de version et URL de téléchargement seront à connecter lorsque les premiers binaires seront publiés.

02 / Premier projet

De zéro à une application lancée.

pointclass new hatchling
cd hatchling
pointclass run

new crée le projet et sa configuration. run prépare automatiquement l’environnement nécessaire, compile le code et démarre l’application.

03 / Projet

Créer et faire vivre le projet.

pointclass new <nom>Création

Crée un nouveau projet PointClass avec le template par défaut.

pointclass new <nom> --template cli|rest|desktopCréation

Crée un projet à partir d’un template ciblé : outil en ligne de commande, API REST ou application desktop.

pointclass runExécution

Compile puis lance le projet courant avec la toolchain définie dans sa configuration.

pointclass run <fichier.java>Script

Exécute directement un fichier Java autonome, sans créer préalablement un projet complet.

pointclass watchDéveloppement

Observe les fichiers, recompile et relance automatiquement l’application après une modification.

pointclass cleanMaintenance

Supprime les artefacts de compilation et recrée un espace de build propre.

04 / Dépendances

Ajouter une bibliothèque sans éditer du XML.

pointclass add <package>Dépendance

Ajoute une dépendance à partir du catalogue PointClass, par exemple pointclass add gson.

pointclass add <group:artifact:version>Avancé

Ajoute directement une coordonnée Maven lorsque la bibliothèque n’est pas référencée dans le catalogue simplifié.

pointclass remove <package>Dépendance

Retire une dépendance du projet et met à jour sa configuration.

pointclass depsInspection

Affiche les dépendances directes, transitives et leurs versions résolues.

pointclass updateMise à jour

Recherche et applique les mises à jour compatibles de la toolchain et des dépendances.

05 / Tests et qualité

Vérifier avant de livrer.

pointclass testTest

Compile et exécute tous les tests du projet.

pointclass test --watchTest continu

Relance les tests concernés à chaque modification du code.

pointclass checkQualité

Exécute les contrôles configurés : compilation, tests, format et vérifications statiques.

pointclass formatCode

Formate automatiquement les sources Java selon le profil du projet.

06 / Build et distribution

Produire le bon livrable.

pointclass buildJVM

Compile le projet et produit son artefact JVM standard.

pointclass build --nativeGraalVM

Produit un exécutable natif autonome avec la toolchain GraalVM compatible.

pointclass packageDistribution

Crée un package distribuable adapté à la plateforme courante.

pointclass package --target windows|macos|linuxCible

Prépare un package pour une plateforme choisie lorsque la compilation croisée est disponible.

pointclass export --mavenInteropérabilité

Génère ou expose un projet Maven standard pour reprendre la main avec l’outillage Java traditionnel.

07 / Environnement

Une toolchain gérée par PointClass.

pointclass doctorDiagnostic

Vérifie le JDK, Maven, GraalVM, les compilateurs natifs, le cache et la configuration du projet.

pointclass doctor --fixRéparation

Corrige automatiquement les problèmes connus et retélécharge les composants défectueux ou manquants.

pointclass use java21|java25|graalvmToolchain

Sélectionne la toolchain du projet sans modifier globalement JAVA_HOME ou le PATH.

pointclass envInspection

Affiche les versions, chemins et composants effectivement utilisés pour le projet courant.

pointclass cache cleanCache

Nettoie les téléchargements et artefacts temporaires gérés par PointClass.

08 / Référence

Commandes globales.

pointclass --helpAide

Affiche l’aide générale et la liste des commandes disponibles.

pointclass <commande> --helpAide

Affiche la syntaxe, les options et des exemples pour une commande précise.

pointclass --versionVersion

Affiche la version du CLI et l’identifiant de la toolchain active.

pointclass self-updateCLI

Met à jour PointClass lui-même vers la dernière version compatible.

Cette référence formalise une proposition cohérente de CLI. Elle peut devenir la spécification fonctionnelle de la première version, puis être ajustée selon les commandes réellement implémentées.