From Fedora Project Wiki
No edit summary
(Italian translation of the latest documentation for Fedora Easy Karma (needs checking))
 
(8 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{autolang}}
{{autolang}}
{{autolang|base=yes}}
<span id="fedora-easy-karma"></span>
= Fedora Easy Karma =


'''fedora-easy-karma''' (script) è lo strumento usato dai [[proven tester/it|proven tester]] per inviare il proprio ''karma'' (positivo, neutro o negativo)  ai pacchetti del repository [[updates-testing]], dopo essere stati opportunamente sottoposti a test.
<span id="the-purpose-of-fedora-easy-karma"></span>
== Lo scopo di Fedora Easy Karma ==


Per usare lo script occorre avere la versione 0.4.0 o superiore del pacchetto {{package|fedora-packager}}.<BR> Lo script può essere installato usando il comando: <code>su -c 'yum --enablerepo=updates-testing install fedora-easy-karma'</code>
'''fedora-easy-karma''' è un'applicazione da riga di comando che facilita l'invio di feedback sugli [https://bodhi.fedoraproject.org aggiornamenti proposti] in un repository di testing di Fedora o EPEL, tutto direttamente dal terminale.


Poi, il workflow, prevede di installare i pacchetti da ''updates-testing'': <code>su -c 'yum --enablerepo=updates-testing update'</code>, e poi di usare i pacchetti e verificarne il funzionamento, come indicato nella sezione [[proven tester/it#Cosa testare | Cosa testare]], oppure di
Riconosce automaticamente qualsiasi pacchetto di testing installato (sostituendo la versione stabile), fornisce varie informazioni sul pacchetto, inclusi i commenti di altri utenti, e consente di commentare e fornire karma (valutazione) a tale pacchetto. Per ulteriori dettagli sul karma, consulta la sezione ''Comprendere il karma dei pacchetti''.
avviare direttamente <code>fedora-easy-karma</code> e procedere al testing seguendo le relative note di aggiornamento.


; Un estratto d'Output
<span id="how-to-enable-testing-packages-on-your-system"></span>
== Come abilitare i pacchetti di testing sul tuo sistema ==


Per l'uso e le opzioni disponibili, digitare, come al solito, <code>fedora-easy-karma --help</code><BR>
Per utilizzare Fedora Easy Karma, è importante aver abilitato i ''pacchetti di testing'' (aggiornamenti di testing) sul sistema. I pacchetti di testing sono versioni più recenti di applicazioni, programmi o librerie che, alla fine, diventeranno parte degli aggiornamenti stabili del sistema.
oppure vedere la [[Fedora_Easy_Karma#Example_Output|USA version]] di questa pagina.
<pre>
$ fedora-easy-karma
Getting list of installed packages...
Getting list of packages in updates-testing...
================================================================================
    fedora-easy-karma-0-0.7.20100709git561718c8.fc12
================================================================================
  Update ID: FEDORA-2010-11029
    Release: Fedora 12
    Status: testing
      Type: enhancement
      Karma: 1
      Notes: Introduce the --critpath-only parameter.
  Submitter: till
  Submitted: 2010-07-09 15:30:58
  Comments: bodhi - 2010-07-09 15:30:58 (karma 0)
            This update has been submitted for testing by till.
            bodhi - 2010-07-13 07:45:42 (karma 0)
            This update has been pushed to testing
            robatino (proventesters) - 2010-07-13 08:49:36 (karma 1)
            Seems to work properly.


  https://admin.fedoraproject.org/updates/F12/FEDORA-2010-11029
Per impostazione predefinita, i pacchetti di testing non sono abilitati sul sistema (tranne che nelle versioni Beta), quindi, se desideri utilizzarli, devi abilitarli esplicitamente. Ci sono due modi per aggiungere pacchetti di testing al tuo sistema:


inst. RPMS: fedora-easy-karma-0-0.7.20100709git561718c8.fc12.noarch - Fedora update feedback made easy (installed 0 days ago)
<span id="temporarily-enabling-the-testing-repository"></span>
=== Abilitare temporaneamente il repository di testing ===


Comment? -1/0/1 ->karma, other -> skip> 1
Puoi abilitare temporaneamente il repository di testing durante l'esecuzione del comando <code>dnf update</code>. Con questo approccio, scaricherai e installerai nuovi aggiornamenti di testing solo quando lo decidi.
Comment> It works perfectly.
FAS Password for till:
</pre>


== Workflow tipico ==
Per fare in modo che DNF installi gli aggiornamenti di testing, utilizza:
# Aggiornare con i più recenti pacchetti disponibili, <code>yum update --enablerepo="*-testing"</code>
# Avviare <code>fedora-easy-karma</code>


A questo punto, leggere le informazioni di aggiornamento disponibili.<BR> Se si trova un pacchetto che si vuole testare, lo si provi in contemporanea: se si tratta di un editor di testo, lo si avvii, si aprano alcuni file di testo, si scriva qualcosa, si salvi, si chiuda e riapra il documento, si provino i pulsanti, e così via, il testing è avviato.
<pre class="[bash]">$ sudo dnf update --enablerepo=updates-testing --best</pre>
Tieni presente che, se in futuro non utilizzi l'argomento <code>--enablerepo</code>, DNF non aggiornerà i pacchetti alle loro ultime versioni di testing e il tuo sistema potrebbe trovarsi in una situazione in cui non avrai installato né i pacchetti di testing più recenti né quelli stabili, con il rischio di riscontrare problemi, specialmente se le versioni dei pacchetti installati risultano problematiche.


Se si è soddisfatti di come l'applicazione funzioni, inserire '''1''' in <code>fedora-easy-karma</code>, descrivendo le operazioni svolte durante il test.
Per ripristinare il sistema alla versione stabile dei pacchetti, utilizza:


Se si è verificato qualche problema, inaspettato, inserire '''-1''' in <code>fedora-easy-karma</code>, menzionando il problema riscontrato e il link al bug-report generato in [[Bugzilla]].<BR>
<pre class="[bash]">$ sudo dnf distro-sync</pre>
<span id="persistently-enabling-the-testing-repository"></span>
=== Abilitare permanentemente il repository di testing ===


Se non si ha idea di come testare il pacchetto (si tratta magari di una libreria), saltare il feedback premendo '''Invio'''.
Puoi abilitare permanentemente il repository di testing e aggiornare sempre ai pacchetti di testing più recenti. Una volta abilitati, riceverai questi nuovi aggiornamenti ogni volta che utilizzi il comando <code>dnf update</code> fino a quando non li disabiliti di nuovo. Con questo approccio, il tuo sistema Fedora sarà un passo avanti rispetto alla versione stabile, quindi potresti riscontrare problemi con alcune applicazioni o pacchetti. Tuttavia, questo fa parte del processo di testing, giusto?


{{Admon/note|Pacchetto privo di feedback
Per abilitare permanentemente il repository di testing, utilizza:
Se il pacchetto <code>pippo</code> che è stato appena aggiornato dal repositori updates-testing, all'avvio di <code>fedora-easy-karma</code> non richiede alcun feedback, vuol dire con buona probabilità il pacchetto <code>pippo</code> è stato richiesto di passare allo status ''stable'', o che sia stato respinto dal testing. Su tali pacchetti non viene richiesto alcun feddback, tuttavia se si trova un bug, è una buona idea inviare un bug-report in [[Bugzilla]]}}
 
 
<pre class="[bash]">$ sudo dnf config-manager setopt "updates-testing.enabled=1"</pre>
== Il codice sorgente ==
Per disabilitare il repository di testing, utilizza lo stesso comando ma sostituisci <code>enabled=1</code> con <code>enabled=0</code>. Inoltre, potrebbe essere opportuno sincronizzare il sistema con <code>distro-sync</code> successivamente.
Il sorgente dello script, <code>fedora-easy-karma</code>, attualmente si trova su [http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git Fedorapeople git repository].
 
In alternativa, puoi utilizzare il tuo gestore di pacchetti, come ''Gnome Software'', ''KDE Discover'' o ''DNFdragora'' per abilitare o disabilitare i repository.
 
<span id="understanding-package-karma"></span>
== Comprendere il ''karma'' dei pacchetti ==
 
Ogni nuovo pacchetto aggiornato arriva in un repository di testing dove deve rimanere per un determinato periodo di tempo (di solito fino a 14 giorni) prima di poter essere spostato nel repository ''stabile''. Durante questo periodo, gli utenti possono commentare il pacchetto e fornire una valutazione, il cosiddetto ''karma''.
 
Il karma fornito può essere ''positivo'', ''neutrale'' o ''negativo'' in base all'esperienza dell'utente e ai test del pacchetto in questione. Mentre il karma neutrale non influisce sulla permanenza del pacchetto nel repository di testing, il karma positivo e negativo sì.
 
Se un pacchetto riceve un numero predefinito di karma positivo (determinato dal manutentore del pacchetto), sarà pronto per essere trasferito al repository stabile senza dover attendere il periodo di grazia. D'altra parte, se un pacchetto riceve karma negativo, il trasferimento automatico viene bloccato e il manutentore può decidere di trasferirlo manualmente o di risolvere i problemi, costruire una nuova versione del pacchetto e riavviare il processo.
 
<span id="using-fedora-easy-karma"></span>
== Utilizzare Fedora Easy Karma ==
 
<span id="installing-and-running-fek"></span>
=== Installare ed eseguire FEK ===
 
''Fedora Easy Karma'' non è installato di default, quindi devi prima installarlo. Per farlo, esegui:
 
<pre class="[bash]">$ sudo dnf install fedora-easy-karma</pre>
Una volta installata l'applicazione, puoi eseguirla dal terminale utilizzando:
 
<pre class="[bash]">$ fedora-easy-karma</pre>
L'applicazione ti mostrerà informazioni sui pacchetti, i commenti degli utenti correlati e ti consentirà di commentare e fornire karma. Se non desideri commentare né fornire karma per un determinato pacchetto, puoi ''saltare'' a un altro pacchetto o ''ignorare'' quel pacchetto e passare al successivo, fino a quando tutti i pacchetti non saranno stati valutati, saltati o ignorati.
 
Se salti un pacchetto, ''Fedora Easy Karma'' ti chiederà informazioni su di esso la prossima volta che lo eseguirai. Se ignori il pacchetto, ''Fedora Easy Karma'' non te lo mostrerà più fino a quando non verrà trovata una versione più recente del pacchetto sul tuo sistema.
 
Tieni presente che per utilizzare ''Fedora Easy Karma'', devi avere un '''account FAS'''. Se non ne hai uno, crealo su [https://accounts.fedoraproject.org Fedora Accounts].
 
<span id="optional-arguments"></span>
=== Argomenti opzionali ===
 
Utilizzando argomenti opzionali, puoi modificare il comportamento predefinito di ''Fedora Easy Karma''. Nota che l'elenco seguente mostra solo gli argomenti più utilizzati. Per un elenco completo, utilizza l'argomento <code>--help</code>.
 
{| class="wikitable"
|-
! Argomento
! Significato
|-
| <code>--help</code>
| Mostra il messaggio di aiuto.
|-
| <code>--datadir=DATADIR</code>
| Modifica la posizione della directory di configurazione. Per impostazione predefinita, si trova in <code>~/.config/fedora-easy-karma</code>.
|-
| <code>--default-comment=COMMENT</code>
| Utilizza questo valore come commento predefinito per ogni pacchetto mostrato.
|-
| <code>--default-karma=KARMA</code>
| Utilizza questo valore come karma predefinito per ogni pacchetto mostrato.
|-
| <code>--no-color</code>
| Non utilizzare l'output a colori. Per impostazione predefinita, alcuni campi utilizzano i colori per migliorare l'orientamento, ma potrebbero non essere leggibili con alcune palette di terminali, quindi potrebbe essere necessario disattivarli.
|-
| <code>--installed-max-days=DAYS</code>
| Includi solo i pacchetti installati negli ultimi DAYS giorni.
|-
| <code>--installed-min-days=DAYS</code>
| Includi solo i pacchetti installati da almeno DAYS giorni.
|-
| <code>--pages</code>
| Pulisci il terminale tra i pacchetti in modo che venga mostrato solo il pacchetto in questione sullo schermo del terminale. Questo può aiutare ad aumentare la leggibilità.
|-
| <code>--retries=RETRIES</code>
| Quante volte tentare di inviare il commento in caso di errore.
|-
| <code>--skip-bodhi-comments</code>
| Disabilita i commenti forniti dal sistema Bodhi. Questo aumenta significativamente la leggibilità della sezione dei commenti.
|-
| <code>--wrap-width=WIDTH</code>
| La lunghezza della riga dopo la quale il testo verrà avvolto. Il valore predefinito è 80.
|}
 
<span id="troubleshooting"></span>
=== Risoluzione dei problemi ===
 
Se riscontri problemi con ''Fedora Easy Karma'', considera di segnalare un problema sulla [https://pagure.io/fedora-easy-karma pagina del progetto].
 
[[Category:QA]]
 
[[Category:Italiano]]
[[Category:Da revisionare]]

Latest revision as of 15:04, 30 January 2025

Fedora Easy Karma

Lo scopo di Fedora Easy Karma

fedora-easy-karma è un'applicazione da riga di comando che facilita l'invio di feedback sugli aggiornamenti proposti in un repository di testing di Fedora o EPEL, tutto direttamente dal terminale.

Riconosce automaticamente qualsiasi pacchetto di testing installato (sostituendo la versione stabile), fornisce varie informazioni sul pacchetto, inclusi i commenti di altri utenti, e consente di commentare e fornire karma (valutazione) a tale pacchetto. Per ulteriori dettagli sul karma, consulta la sezione Comprendere il karma dei pacchetti.

Come abilitare i pacchetti di testing sul tuo sistema

Per utilizzare Fedora Easy Karma, è importante aver abilitato i pacchetti di testing (aggiornamenti di testing) sul sistema. I pacchetti di testing sono versioni più recenti di applicazioni, programmi o librerie che, alla fine, diventeranno parte degli aggiornamenti stabili del sistema.

Per impostazione predefinita, i pacchetti di testing non sono abilitati sul sistema (tranne che nelle versioni Beta), quindi, se desideri utilizzarli, devi abilitarli esplicitamente. Ci sono due modi per aggiungere pacchetti di testing al tuo sistema:

Abilitare temporaneamente il repository di testing

Puoi abilitare temporaneamente il repository di testing durante l'esecuzione del comando dnf update. Con questo approccio, scaricherai e installerai nuovi aggiornamenti di testing solo quando lo decidi.

Per fare in modo che DNF installi gli aggiornamenti di testing, utilizza:

$ sudo dnf update --enablerepo=updates-testing --best

Tieni presente che, se in futuro non utilizzi l'argomento --enablerepo, DNF non aggiornerà i pacchetti alle loro ultime versioni di testing e il tuo sistema potrebbe trovarsi in una situazione in cui non avrai installato né i pacchetti di testing più recenti né quelli stabili, con il rischio di riscontrare problemi, specialmente se le versioni dei pacchetti installati risultano problematiche.

Per ripristinare il sistema alla versione stabile dei pacchetti, utilizza:

$ sudo dnf distro-sync

Abilitare permanentemente il repository di testing

Puoi abilitare permanentemente il repository di testing e aggiornare sempre ai pacchetti di testing più recenti. Una volta abilitati, riceverai questi nuovi aggiornamenti ogni volta che utilizzi il comando dnf update fino a quando non li disabiliti di nuovo. Con questo approccio, il tuo sistema Fedora sarà un passo avanti rispetto alla versione stabile, quindi potresti riscontrare problemi con alcune applicazioni o pacchetti. Tuttavia, questo fa parte del processo di testing, giusto?

Per abilitare permanentemente il repository di testing, utilizza:

$ sudo dnf config-manager setopt "updates-testing.enabled=1"

Per disabilitare il repository di testing, utilizza lo stesso comando ma sostituisci enabled=1 con enabled=0. Inoltre, potrebbe essere opportuno sincronizzare il sistema con distro-sync successivamente.

In alternativa, puoi utilizzare il tuo gestore di pacchetti, come Gnome Software, KDE Discover o DNFdragora per abilitare o disabilitare i repository.

Comprendere il karma dei pacchetti

Ogni nuovo pacchetto aggiornato arriva in un repository di testing dove deve rimanere per un determinato periodo di tempo (di solito fino a 14 giorni) prima di poter essere spostato nel repository stabile. Durante questo periodo, gli utenti possono commentare il pacchetto e fornire una valutazione, il cosiddetto karma.

Il karma fornito può essere positivo, neutrale o negativo in base all'esperienza dell'utente e ai test del pacchetto in questione. Mentre il karma neutrale non influisce sulla permanenza del pacchetto nel repository di testing, il karma positivo e negativo sì.

Se un pacchetto riceve un numero predefinito di karma positivo (determinato dal manutentore del pacchetto), sarà pronto per essere trasferito al repository stabile senza dover attendere il periodo di grazia. D'altra parte, se un pacchetto riceve karma negativo, il trasferimento automatico viene bloccato e il manutentore può decidere di trasferirlo manualmente o di risolvere i problemi, costruire una nuova versione del pacchetto e riavviare il processo.

Utilizzare Fedora Easy Karma

Installare ed eseguire FEK

Fedora Easy Karma non è installato di default, quindi devi prima installarlo. Per farlo, esegui:

$ sudo dnf install fedora-easy-karma

Una volta installata l'applicazione, puoi eseguirla dal terminale utilizzando:

$ fedora-easy-karma

L'applicazione ti mostrerà informazioni sui pacchetti, i commenti degli utenti correlati e ti consentirà di commentare e fornire karma. Se non desideri commentare né fornire karma per un determinato pacchetto, puoi saltare a un altro pacchetto o ignorare quel pacchetto e passare al successivo, fino a quando tutti i pacchetti non saranno stati valutati, saltati o ignorati.

Se salti un pacchetto, Fedora Easy Karma ti chiederà informazioni su di esso la prossima volta che lo eseguirai. Se ignori il pacchetto, Fedora Easy Karma non te lo mostrerà più fino a quando non verrà trovata una versione più recente del pacchetto sul tuo sistema.

Tieni presente che per utilizzare Fedora Easy Karma, devi avere un account FAS. Se non ne hai uno, crealo su Fedora Accounts.

Argomenti opzionali

Utilizzando argomenti opzionali, puoi modificare il comportamento predefinito di Fedora Easy Karma. Nota che l'elenco seguente mostra solo gli argomenti più utilizzati. Per un elenco completo, utilizza l'argomento --help.

Argomento Significato
--help Mostra il messaggio di aiuto.
--datadir=DATADIR Modifica la posizione della directory di configurazione. Per impostazione predefinita, si trova in ~/.config/fedora-easy-karma.
--default-comment=COMMENT Utilizza questo valore come commento predefinito per ogni pacchetto mostrato.
--default-karma=KARMA Utilizza questo valore come karma predefinito per ogni pacchetto mostrato.
--no-color Non utilizzare l'output a colori. Per impostazione predefinita, alcuni campi utilizzano i colori per migliorare l'orientamento, ma potrebbero non essere leggibili con alcune palette di terminali, quindi potrebbe essere necessario disattivarli.
--installed-max-days=DAYS Includi solo i pacchetti installati negli ultimi DAYS giorni.
--installed-min-days=DAYS Includi solo i pacchetti installati da almeno DAYS giorni.
--pages Pulisci il terminale tra i pacchetti in modo che venga mostrato solo il pacchetto in questione sullo schermo del terminale. Questo può aiutare ad aumentare la leggibilità.
--retries=RETRIES Quante volte tentare di inviare il commento in caso di errore.
--skip-bodhi-comments Disabilita i commenti forniti dal sistema Bodhi. Questo aumenta significativamente la leggibilità della sezione dei commenti.
--wrap-width=WIDTH La lunghezza della riga dopo la quale il testo verrà avvolto. Il valore predefinito è 80.

Risoluzione dei problemi

Se riscontri problemi con Fedora Easy Karma, considera di segnalare un problema sulla pagina del progetto.