feat: add an API for removing installed instances

Aperta Adatta ai principianti
#265 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
68/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
rust
Ambito
api

Direzione di ricerca

Inizia nel modulo launcher che espone inspect_instances / inspect_instance e riutilizza la stessa ricerca e validazione dell'instance-root per un nuovo remove_instance. Leggi Instance::instance_root per confermare cosa viene eliminato esattamente, poi aggiungi un enum RemoveInstanceOutcome con Removed e NotFound. Fatto significa che il metodo restituisce NotFound per nomi sconosciuti, rimuove il root per quelli noti, e un test copre entrambi i casi.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Problem

Launcher exposes inspect_instances / inspect_instance and Instance::instance_root, but there is no API to remove an installed instance. Launcher UIs that implement instance deletion have to inspect the instance, reach into instance_root, and delete the directory themselves. That duplicates filesystem/layout knowledge outside Elemental and makes cleanup behavior inconsistent between launchers.

Expected API

A removal method on Launcher, for example:

pub async fn remove_instance(&self, instance_name: impl Into<String>) -> Result<RemoveInstanceOutcome>

Possible outcome: Removed, NotFound. The method should own path validation and removal of the instance root. If future instance metadata lives outside the instance directory, this API can clean it up too.

Current workaround

Particle currently calls inspect_instance(name), then tokio::fs::remove_dir_all(instance.instance_root), then reloads the instance list. This works but bypasses the launcher abstraction.

Why this belongs upstream

Instance layout and detection are owned by Elemental. Deletion should follow the same layout rules and be reusable by any launcher built on the crate.

Lingua principale
Rust
Stelle
11
Fork
1
Merge medio
3h 32m
PR unite (30g)
52

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ElectronicWave/Elemental

Tutte le issue di ElectronicWave/Elemental

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.