> For the complete documentation index, see [llms.txt](https://cristiandis.gitbook.io/ntix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cristiandis.gitbook.io/ntix/ntix-documentation/docs-it/api/models.md). # Modelli ## Modelli Tipi di dati in `ntix_rs::models`. ### PackageEntry Una dichiarazione di pacchetto dal file di configurazione. ```rust pub struct PackageEntry { pub id: String, pub version: Option, } impl PackageEntry { pub fn new(id: impl Into) -> Self; } ``` | Campo | Tipo | Predefinito | Descrizione | | --------- | ---------------- | ------------ | ---------------------------------- | | `id` | `String` | obbligatorio | Identificatore del pacchetto | | `version` | `Option` | `None` | Versione bloccata; `None` = latest | ### PackageSpec Un pacchetto risolto con il relativo gestore di origine. ```rust pub struct PackageSpec { pub id: String, pub version: Option, pub source: PackageManager, } ``` | Campo | Tipo | Descrizione | | --------- | ---------------- | --------------------------------------- | | `id` | `String` | Identificatore del pacchetto | | `version` | `Option` | Versione risolta (None se non bloccata) | | `source` | `PackageManager` | `Winget`, `Chocolatey`, oppure `Scoop` | ### UpgradeInfo Informazioni sulla versione per un aggiornamento disponibile. Definito in `models::installed_packages`. ```rust pub struct UpgradeInfo { pub current_version: String, pub available_version: String, } impl UpgradeInfo { pub fn new(current_version: impl Into, available_version: impl Into) -> Self; } ``` ### InstalledPackages Pacchetti attualmente installati sul sistema. Definito in `models::installed_packages`. ```rust pub struct InstalledPackages { pub winget: HashMap, pub chocolatey: HashMap, pub scoop: HashMap, } ``` Ogni mappa associa l'ID del pacchetto alla stringa della versione installata. ### State Lo stato dei pacchetti tracciati da NTIX. ```rust #[derive(Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct State { pub version: i32, pub winget: HashMap, pub chocolatey: HashMap, pub scoop: HashMap, pub scoop_buckets: HashMap>, pub config_files: HashMap, } ``` | Campo | Tipo | Predefinito | Descrizione | | --------------- | --------------------------------- | ----------- | ----------------------------------------------------------------------------------------- | | `version` | `i32` | `2` | Versione del formato del file di stato | | `winget` | `HashMap` | vuoto | Pacchetti winget tracciati | | `chocolatey` | `HashMap` | vuoto | Pacchetti chocolatey tracciati | | `scoop` | `HashMap` | vuoto | Pacchetti scoop tracciati | | `scoop_buckets` | `HashMap>` | vuoto | Bucket Scoop aggiunti da NTIX (nome a URL) | | `config_files` | `HashMap` | vuoto | File di configurazione gestiti (percorso assoluto di destinazione all'hash del contenuto) | ### DiffResult L'insieme di azioni calcolato da applicare. ```rust pub struct DiffResult { pub to_install: Vec, pub to_upgrade: Vec, pub to_skip: Vec, pub to_remove: Vec, pub to_adopt: Vec, pub to_untracked: Vec, pub buckets_to_add: Vec, pub buckets_to_remove: Vec, pub config_files_to_create: Vec, pub config_files_to_update: Vec, pub config_files_no_longer_managed: Vec, pub warnings: Vec, pub manager_validation: ValidationResult, } impl DiffResult { pub fn is_empty(&self) -> bool; } ``` | Campo | Tipo | Descrizione | | -------------------------------- | ---------------------- | ------------------------------------------------------------------------------ | | `to_install` | `Vec` | Pacchetti da installare | | `to_upgrade` | `Vec` | Pacchetti da aggiornare (solo con `--upgrade`) | | `to_skip` | `Vec` | Pacchetti già nello stato desiderato | | `to_remove` | `Vec` | Pacchetti orfani da rimuovere | | `to_adopt` | `Vec` | Pacchetti installati esternamente da adottare nello stato | | `to_untracked` | `Vec` | Pacchetti installati non tracciati nello stato (solo informativo) | | `buckets_to_add` | `Vec` | Bucket Scoop da aggiungere | | `buckets_to_remove` | `Vec` | Bucket Scoop tracciati da NTIX ma non più configurati | | `config_files_to_create` | `Vec` | File da creare su disco | | `config_files_to_update` | `Vec` | File il cui contenuto sorgente è cambiato | | `config_files_no_longer_managed` | `Vec` | Percorsi di destinazione tracciati nello stato ma non più nella configurazione | | `warnings` | `Vec` | Avvisi non fatali | | `manager_validation` | `ValidationResult` | Risultato della fase di rilevamento delle capacità | | `is_empty()` | `bool` | Vero se tutte le liste di azioni sono vuote (avvisi esclusi) | ### ConfigFileEntry Un file arbitrario gestito da NTIX, copiato da `src` a `dest`. Entrambi i percorsi vengono risolti in percorsi assoluti al momento del caricamento della configurazione. ```rust pub struct ConfigFileEntry { pub dest: PathBuf, pub src: PathBuf, } ``` | Campo | Tipo | Descrizione | | ------ | --------- | ------------------------------------------------------------------------------------------- | | `dest` | `PathBuf` | Percorso assoluto di destinazione | | `src` | `PathBuf` | Percorso assoluto di origine (risolto a partire dalla directory del file di configurazione) | ### ValidationResult Risultato del singolo controllo di compatibilità del gestore di pacchetti condiviso da `diff` e `apply`. ```rust pub struct ValidationResult { pub warnings: Vec, pub winget_installed: bool, pub choco_installed: bool, pub scoop_installed: bool, } ``` ### ImportNode Tiene traccia dell'albero di importazione prodotto durante l'analisi della configurazione. ```rust pub struct ImportNode { pub path: PathBuf, pub children: Vec, } ``` ### NTIXConfig La configurazione completamente analizzata. ```rust pub struct NTIXConfig { pub options: NTIXOptions, pub winget_packages: Vec, pub choco_packages: Vec, pub scoop_packages: Vec, pub config_files: Vec, pub imports: Vec, } ```