Premiers pas avec Lino

Prérequis

Avant d'installer Lino, assurez-vous que votre environnement est correctement préparé :

• ✅ .NET 9.0 SDK ou version supérieure installée. Télécharger .NET
• ✅ CLI .NET disponible dans le terminal. Vérifiez avec : dotnet --version
• ✅ Git installé pour le contrôle de version. Télécharger Git
• ✅ Entity Framework Core CLI installé pour le support des migrations : dotnet tool install --global dotnet-ef
• ✅ Environnement de conteneur compatible OCI, tel que Docker Desktop ou Podman.

Compatibilité de la plateforme

Lino est multiplateforme et peut être utilisé sur les principaux systèmes d'exploitation :

• ✅ Windows
• ✅ macOS
• ✅ Linux

Installation

Lino est distribué comme un outil global .NET. Avant de continuer, assurez-vous d'avoir installé le SDK .NET 9 ou une version supérieure.

Pour installer la dernière version, exécutez :

dotnet tool install --global Tolitech.Lino --version 1.0.0-alpha.10

Après l'installation, validez le fonctionnement de Lino en exécutant :

lino --version

Si l'installation est réussie, la version installée sera affichée dans le terminal.

Authentification

Après avoir installé Lino, il est nécessaire de s'authentifier pour accéder à toutes les fonctionnalités.

Si vous avez déjà un compte, connectez-vous avec la commande :

lino auth login

Il vous sera demandé de fournir :

• Utilisateur : Adresse e-mail déjà enregistrée.
• Mot de passe : Mot de passe associé au compte.

Si vous n'avez pas encore de compte, inscrivez-vous directement via le CLI en utilisant :

lino user register

Lors de l'inscription, indiquez :

• Prénom : Prénom de l'utilisateur.
• Nom : Nom de famille de l'utilisateur.
• E-mail : Adresse e-mail qui servira également de login.
• Mot de passe : Mot de passe sécurisé d'au moins 6 caractères.
• Confirmation du mot de passe : Saisissez à nouveau le mot de passe pour validation.

Après l'inscription, l'utilisateur sera automatiquement authentifié.

Préférences de langue

Par défaut, la CLI de Lino est affichée en anglais en, mais vous pouvez changer la langue selon vos préférences parmi les options disponibles :

en | pt | es | de | fr | it | ja | ko | ru | zh

Pour définir une nouvelle langue, exécutez la commande suivante :

lino preferences culture set --name culture

Alternativement, vous pouvez sélectionner la langue via une liste interactive avec :

lino preferences culture set

Ajustement de la codification UTF-8 (facultatif)

Pour un affichage correct des langues avec des caractères spéciaux (comme le japonais, le coréen, le russe ou le chinois), assurez-vous que votre terminal est configuré pour utiliser l'encodage UTF-8.

Dans PowerShell de Windows, ajustez l'encodage en exécutant les commandes suivantes :

[console]::InputEncoding = [System.Text.Encoding]::UTF8

[console]::OutputEncoding = [System.Text.Encoding]::UTF8

Remarque : Sur les systèmes Linux, macOS et Windows Terminal, la prise en charge de UTF-8 est généralement native. Cependant, il est recommandé de vérifier la configuration si des problèmes d'affichage des caractères surviennent.

Commandes Disponibles

Lino est en constante évolution, recevant continuellement de nouvelles commandes et fonctionnalités pour répondre aux exigences des projets .NET de haute qualité.

Pour afficher la liste complète des commandes disponibles, exécutez dans le terminal :

lino

Ou, alternativement :

lino --help

Le terminal affichera une liste des principales commandes avec une brève description pour chacune, comme dans l'exemple ci-dessous :

COMMANDS:
    project         Commande responsable de la gestion des projets.
    service         Commande responsable de la gestion des services.
    module          Commande responsable de la gestion des modules.
    entity          Commande responsable de la gestion des entités.
    enumeration     Commande responsable de la gestion des énumérations.
    value-object    Commande responsable de la gestion des objets de valeur.
    query           Commande responsable de la gestion des requêtes.
    command         Commande responsable de la gestion des commandes.
    api             Commande responsable de la gestion des APIs.
    page            Commande responsable de la gestion des pages.
    database        Commande responsable de la gestion des migrations de base de données.
    feature         Commande responsable de la gestion des fonctionnalités du projet.
    user            Commande responsable de la gestion des utilisateurs.
    auth            Commande responsable de la gestion de l'authentification des utilisateurs.
    preferences     Commande pour gérer les préférences utilisateur.

Pour voir les sous-commandes et les options spécifiques à toute commande, utilisez :

lino command

Ou :

lino command --help

Par exemple, pour consulter la commande project :

lino project --help

Vous verrez :

DESCRIPTION:
    Commande responsable de la gestion des projets.

EXAMPLES:
    lino project new --name MyProject
    lino project list

COMMANDS:
    new     Commande utilisée pour créer un nouveau projet.
    list    Commande utilisée pour lister les projets créés.

Dans la prochaine section, nous verrons comment créer rapidement un nouveau projet avec Lino.

Démarrage rapide

Créez rapidement une application .NET moderne, scalable et prête pour des projets de haut niveau avec la commande suivante :

lino project new --name MyApp

Cette commande génère une solution .NET structurée avec une séparation claire des responsabilités entre les couches, servant de base idéale pour des applications d'entreprise robustes et évolutives.

MyApp/
├── MyApp.sln
├── src/
│   ├── Aspire/
│   │   ├── AppHost/
│   │   │   └── MyApp.AppHost.csproj
│   │   └── ServiceDefaults/
│   │       └── MyApp.ServiceDefaults.csproj
│   └── Services/
│       └── Shared/
│           ├── API/
│           │   └── MyApp.Shared.API.csproj
│           ├── Application/
│           │   └── MyApp.Shared.Application.csproj
│           ├── Domain/
│           │   └── MyApp.Shared.Domain.csproj
│           ├── Infrastructure/
│           │   └── MyApp.Shared.Infrastructure.csproj
│           └── Infrastructure.Persistence/
│               └── MyApp.Shared.Infrastructure.Persistence.csproj
└── tests/
    

Principaux avantages :

• ✅ Structure en couches alignée avec les meilleures pratiques d'architecture moderne.
• 🔧 Flexibilité pour évoluer en tant que microservice, monolithe modulaire ou traditionnel.
• 🚀 Fonctionnalités prêtes à l'emploi telles que le cache, la messagerie et la planification des tâches.
• 🧱 Base solide pour appliquer des modèles tels que Domain-Driven Design (DDD), Event-Driven Architecture (EDA) et les principes SOLID.
• ✨ Code propre, opinionné et hautement productif, idéal pour accélérer un développement durable.

Avec Lino, vous stimulez la création de projets .NET de haute qualité, combinant productivité, excellence architecturale et flexibilité pour accompagner la croissance de votre application.