From Fedora Project Wiki
(Created page with '{{autolang}} {| style="float:right;" ! colspan="2" | Quick Links |- |[http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git gitweb] |} '''fedora-easy-karma''' ...')
 
(Italian translation of the latest documentation for Fedora Easy Karma (needs checking))
 
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{autolang}}
{{autolang}}
{| style="float:right;"
{{autolang|base=yes}}
! colspan="2" | Quick Links
<span id="fedora-easy-karma"></span>
|-
= Fedora Easy Karma =
|[http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git gitweb]
 
|}
<span id="the-purpose-of-fedora-easy-karma"></span>
== Lo scopo di Fedora Easy Karma ==
 
'''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.
 
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''.
 
<span id="how-to-enable-testing-packages-on-your-system"></span>
== 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:
 
<span id="temporarily-enabling-the-testing-repository"></span>
=== Abilitare temporaneamente il repository di testing ===
 
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.
 
Per fare in modo che DNF installi gli aggiornamenti di testing, utilizza:
 
<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.
 
Per ripristinare il sistema alla versione stabile dei pacchetti, utilizza:
 
<pre class="[bash]">$ sudo dnf distro-sync</pre>
<span id="persistently-enabling-the-testing-repository"></span>
=== 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 <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?
 
Per abilitare permanentemente il repository di testing, utilizza:
 
<pre class="[bash]">$ sudo dnf config-manager setopt "updates-testing.enabled=1"</pre>
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.
 
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ì.


'''fedora-easy-karma''' è uno strumento che (...)
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.


allows you to easily portion out karma points for testing updates that you have currently installed. The typical workflow is as follows:
<span id="using-fedora-easy-karma"></span>
== Utilizzare Fedora Easy Karma ==


# install packages from [[QA/Updates_Testing|updates-testing]]: {{command|su -c 'yum --enablerepo<nowiki>=</nowiki>updates-testing update'}}
<span id="installing-and-running-fek"></span>
# Use these packages to identify breakage or directly run fedora-easy-karma and test packages according to the update notes
=== Installare ed eseguire FEK ===
# Run fedora-easy-karma


== Installation ==
''Fedora Easy Karma'' non è installato di default, quindi devi prima installarlo. Per farlo, esegui:
You need version 0.4.0 or greater of {{package|fedora-packager}} to use this script. You can install {{package|fedora-easy-karma}} for any supported Fedora release by using the command: {{command|su -c 'yum --enablerepo<nowiki>=</nowiki>updates-testing install fedora-easy-karma'}}


== Example Output ==
<pre class="[bash]">$ sudo dnf install fedora-easy-karma</pre>
<pre>
Una volta installata l'applicazione, puoi eseguirla dal terminale utilizzando:
$ fedora-easy-karma --help
Usage: fedora-easy-karma [options] [pattern, ..]


You will be asked for every package installed from updates-testing to provide
<pre class="[bash]">$ fedora-easy-karma</pre>
feedback using karma points. If patterns are provided, you will be only prompted
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.
for updates related to packages or builds that match any of the patterns.
Possible wildcards are *, ?, [seq] and [!seq] as explained at
http://docs.python.org/library/fnmatch.html
After selecting the karma points, you will be asked for a comment. An empty
comment skips the update.


Possible karma points are:
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.
-1 : Update breaks something or does not fix a bug it is supposed to
0 : The update has not been tested much or at all
1 : The update seems not to break anything new
All other inputs will skip the update.
You can use <CTRL>-<D> on an empty prompt to exit
If you use a default comment, '<CTRL>-<X> <backspace>' can be used to delete the
default comment to easily enter a custom one.


The source can be found at
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].
http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git;a=summary
Please send bug reports and feature requests to
'Till Maas <opensource@till.name>'
For patches please use 'git send-email'.


Options:
<span id="optional-arguments"></span>
  -h, --help            show this help message and exit
=== Argomenti opzionali ===
  --bodhi-cached        Use cached bodhi query
  --bodhi-cachedir=BODHI_CACHEDIR
                        Directory to store bodhi cache, default: ~/.fedora-
                        easy-karma
  --bodhi-update-cache  Update bodhi query cache
  --critpath-only      Only consider unapproved critpath updates
  --debug              Enable debug output
  --default-comment=COMMENT
                        Default comment to use, default:
  --default-karma=KARMA
                        Default karma to use, default:
  --fas-username=FAS_USERNAME
                        FAS username
  --include-commented  Also ask for more comments on updates that already got
                        a comment from you, this is enabled if patterns are
                        provided
  --installed-max-days=DAYS
                        Only check packages installed within the last XX days,
                        default: 28
  --installed-min-days=DAYS
                        Only check packages installed for at least XX days,
                        default: 0
  --list-rpms-only      Only list affected rpms
  --no-skip-empty-comment
                        Do not skip update if comment is empty
  --product=PRODUCT    product to query Bodhi for, 'F' for Fedora, 'EL-' for
                        EPEL, default: F
  --releasever=RELEASEVER
                        releasever to query Bodhi for, default: releasever
                        from yum
  --retries=RETRIES    Number if retries when submitting a comment in case of
                        an error, default: 3
  --wrap-bugs          Apply line-wrapping to bugs
  --wrap-rpms          Apply line-wrapping to list of installed rpms
  --wrap-width=WRAP_WIDTH
                        Width to use for line wrapping of updates, default: 80
$ 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
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>.


inst. RPMS: fedora-easy-karma-0-0.7.20100709git561718c8.fc12.noarch - Fedora update feedback made easy (installed 0 days ago)
{| 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.
|}


Comment? -1/0/1 ->karma, other -> skip> 1
<span id="troubleshooting"></span>
Comment> It works perfectly.
=== Risoluzione dei problemi ===
FAS Password for till:
</pre>


== Example Workflows ==
Se riscontri problemi con ''Fedora Easy Karma'', considera di segnalare un problema sulla [https://pagure.io/fedora-easy-karma pagina del progetto].
=== Update Everything, then look at updates and perform some direct testing ===
First update:
{{command|yum update --enablerepo<nowiki>=</nowiki>"*-testing"}}
The run fedora-easy-karma:
{{command|fedora-easy-karma}}
Now read the presented update information. If there is an update to would like to test, do it now in parallel, e.g. if it is a text editor, run it, open some files, edit something etc. If you are content with the application, enter "1" in fedora-easy-karma and describe what you did. If something broke, please file a bug report, enter "-1" in fedora-easy-karma and mention the bug in the comment. If you do not know how to test the package, just skip it hitting "Enter".


== Frequently Asked Questions ==
[[Category:QA]]
* Q: I just updated package foo from updates-testing, but when I run fedora-easy-karma, why I am not asked for feedback?
: A: The update for the package is probably already requested to become stable or maybe to be unpushed from testing. You will not be asked for feedback on such updates. If you found a new bug, please open a bug report instead.


== Source ==
[[Category:Italiano]]
Currently the source is available at a [http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git Fedorapeople git repository]
[[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.