Informazioni sul codice Python

[frferrer]

Buonasera,

Dopo aver esaminato alcuni esempi di codice, mi sono chiesto cosa significasse un'istruzione presente nella documentazione e in alcuni pacchetti.

Nello specifico nel seguente documento https://www.wapt.fr/fr/doc/wapt-create- ... g-software

Ecco il codice in questione:

Codice: Seleziona tutto

for soft in installed_softwares('winscp3'):
    if Version(soft['version']) < Version('5.0.2'):
        run(WAPT.uninstall_cmd(soft['key']))

L'istruzione disinstalla_cmd è una funzione del modulo aiutanti di configurazione.
Questo modulo viene caricato in tutti i file setup.py in cima al file con le istruzioni

Codice: Seleziona tutto

from setuphelpers import *

Quindi non capisco davvero il punto di usare WAPT.uninstall_cmd rispetto a un semplice disinstalla_cmd.
Il risultato è il seguente codice:

Codice: Seleziona tutto

for soft in installed_softwares('winscp3'):
    if Version(soft['version']) < Version('5.0.2'):
        run(uninstall_cmd(soft['key']))

Da quanto ho capito, WAPT è un oggetto contenente metodi del modulo setuphelpers.

Da qui le seguenti domande:

• Dove è istanziato questo oggetto WAPT? Qual è il suo scopo?

• Perché utilizzare il uninstall_cmd dell'oggetto WAPT anziché la uninstall_cmd del modulo setuphelpers?

• Qual è il vantaggio di utilizzare questo metodo?

GRAZIE.

[htouvet]

common.Wapt.uninstall_cmd è un alias per setuphelpers.uninstall_cmd, probabilmente per motivi di compatibilità con le versioni precedenti.

L'istanza WAPT (della classe common.Wapt) che può essere utilizzata nelle funzioni hook install(), uninstall(), session_setup() e audit() in setup.py è una variabile oggetto istanziata dal client WAPT e iniettata automaticamente nello spazio dei nomi del modulo setup prima della chiamata alla funzione, in modo simile a una variabile implicita integrata... vedi, ad esempio: https://github.com/tranquilit/WAPT/blob ... n.py#L3701.

Inizialmente, questo è stato fatto per evitare un elenco esplicito di parametri nelle definizioni della funzione install, ecc., in modo da non appesantire il file setup.py per i gestori di pacchetti meno esperti, poiché questa variabile viene usata raramente.

L'oggetto WAPT (classe common.Wapt) consente di accedere allo stato corrente del client Wapt e all'API associata, nonché di avviare comandi espliciti come WAPT.install('package'), WAPT.remove('package'), WAPT.forget('package'), ecc., un po' come facciamo da riga di comando con wapt-get install e wapt-get remove, ma nel codice Python.

[frferrer]

Buonasera,

Grazie per questa spiegazione del testo, è molto più chiaro.

Per i principianti non è facile orientarsi quando si utilizzano entrambi i sistemi di scrittura.

Posso suggerire di ripulire l'esempio di codice nella documentazione per mantenere solo la sintassi?

Codice: Seleziona tutto

run(uninstall_cmd())

; e mantenere l'uso di WAPT.<méthode> rispetto a quello che è, ovvero l'istanza client WAPT?
https://www.wapt.fr/fr/doc/wapt-create- ... g-software

GRAZIE.

[sfontenau]

Dobbiamo assolutamente sistemare le cose...

Non ne abbiamo parlato molto, ma potete modificare la documentazione voi stessi tramite pull request:

la documentazione si trova qui:

https://github.com/tranquilit/WAPT-Documentation.

Abbiamo sempre meno tempo per creare la documentazione.

L'aiuto della community sarebbe molto apprezzato!

Potete inviare le pull request direttamente!