Primi passi con Lino

Requisiti

Prima di installare Lino, assicurati che il tuo ambiente sia correttamente configurato:

• ✅ .NET 9.0 SDK o versione superiore installata. Scarica .NET
• ✅ CLI .NET disponibile nel terminale. Verifica con: dotnet --version
• ✅ Git installato per il controllo delle versioni. Scarica Git
• ✅ Entity Framework Core CLI installato per il supporto delle migrazioni: dotnet tool install --global dotnet-ef
• ✅ Ambiente di contenitore compatibile con OCI, come Docker Desktop o Podman.

Compatibilità della piattaforma

Lino è multipiattaforma e può essere utilizzato sui principali sistemi operativi:

• ✅ Windows
• ✅ macOS
• ✅ Linux

Installazione

Lino è distribuito come uno strumento globale di .NET. Prima di procedere, assicurati di avere installato il SDK di .NET 9 o superiore.

Per installare l'ultima versione, esegui:

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

Dopo l'installazione, verifica il funzionamento di Lino eseguendo:

lino --version

Se l'installazione è andata a buon fine, la versione installata verrà mostrata nel terminale.

Autenticazione

Dopo aver installato Lino, è necessario autenticarsi per accedere a tutte le funzionalità.

Se hai già un account, effettua l'accesso con il comando:

lino auth login

Ti verrà chiesto di fornire:

• Utente: Indirizzo e-mail già registrato.
• Password: Password associata all'account.

Se non hai ancora un account, registrati direttamente tramite CLI utilizzando:

lino user register

Durante la registrazione, indica:

• Nome: Nome dell'utente.
• Cognome: Cognome dell'utente.
• Email: Indirizzo email che sarà anche il login.
• Password: Password sicura di almeno 6 caratteri.
• Conferma Password: Inserisci nuovamente la password per conferma.

Al termine della registrazione, l'utente sarà autenticato automaticamente.

Preferenze della lingua

Per impostazione predefinita, la CLI di Lino viene visualizzata in inglese en, ma puoi cambiare la lingua in base alle tue preferenze tra le opzioni disponibili:

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

Per impostare una nuova lingua, esegui il seguente comando:

lino preferences culture set --name culture

In alternativa, puoi selezionare la lingua tramite un elenco interattivo con:

lino preferences culture set

Impostazione della codifica UTF-8 (opzionale)

Per una corretta visualizzazione delle lingue con caratteri speciali (come giapponese, coreano, russo o cinese), assicurati che il tuo terminale sia configurato per utilizzare la codifica UTF-8.

In PowerShell di Windows, regola la codifica eseguendo i seguenti comandi:

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

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

Nota: Su sistemi Linux, macOS e Windows Terminal, il supporto UTF-8 è generalmente nativo. Tuttavia, si consiglia di verificare la configurazione se si verificano problemi nella visualizzazione dei caratteri.

Comandi Disponibili

Lino è in continua evoluzione, ricevendo continuamente nuovi comandi e funzionalità per soddisfare le esigenze di progetti .NET di alta qualità.

Per visualizzare l'elenco completo dei comandi disponibili, esegui nel terminale:

lino

Oppure, in alternativa:

lino --help

Il terminale mostrerà un elenco dei comandi principali con una breve descrizione per ciascuno, come nell'esempio seguente:

COMMANDS:
    project         Comando responsabile della gestione dei progetti.
    service         Comando responsabile della gestione dei servizi.
    module          Comando responsabile della gestione dei moduli.
    entity          Comando responsabile della gestione delle entità.
    enumeration     Comando responsabile della gestione delle enumerazioni.
    value-object    Comando responsabile della gestione degli oggetti valore.
    query           Comando responsabile della gestione delle query.
    command         Comando responsabile della gestione dei comandi.
    api             Comando responsabile della gestione delle API.
    page            Comando responsabile della gestione delle pagine.
    database        Comando responsabile della gestione delle migrazioni del database.
    feature         Comando responsabile della gestione delle funzionalità del progetto.
    user            Comando responsabile della gestione degli utenti.
    auth            Comando responsabile della gestione dell'autenticazione utente.
    preferences     Comando per gestire le preferenze utente.

Per visualizzare i sottocomandi e le opzioni specifiche di qualsiasi comando, utilizza:

lino command

Oppure:

lino command --help

Ad esempio, per consultare il comando project:

lino project --help

Verrà mostrato:

DESCRIPTION:
    Comando responsabile della gestione dei progetti.

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

COMMANDS:
    new     Comando usato per creare un nuovo progetto.
    list    Comando usato per elencare i progetti creati.

Nella prossima sezione vedremo come creare rapidamente un nuovo progetto con Lino.

Avvio rapido

Crea rapidamente un'applicazione .NET moderna, scalabile e pronta per progetti di alto livello con il seguente comando:

lino project new --name MyApp

Questo comando genera una soluzione .NET strutturata con una separazione chiara delle responsabilità tra i livelli, fungendo da base ideale per applicazioni aziendali robuste e scalabili.

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/
    

Principali vantaggi:

• ✅ Struttura a livelli allineata alle migliori pratiche di architettura moderna.
• 🔧 Flessibilità per scalare come microservizio, monolito modulare o tradizionale.
• 🚀 Funzionalità pronte all'uso come caching, messaggistica e pianificazione di attività.
• 🧱 Base solida per applicare modelli come Domain-Driven Design (DDD), Event-Driven Architecture (EDA) e principi SOLID.
• ✨ Codice pulito, opinato e altamente produttivo, ideale per accelerare lo sviluppo sostenibile.

Con Lino, puoi accelerare la creazione di progetti .NET di alta qualità, combinando produttività, eccellenza architetturale e flessibilità per supportare la crescita della tua applicazione.