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''' ...')
 
No edit summary
Line 1: Line 1:
{{autolang}}
{{autolang}}
{| style="float:right;"
! colspan="2" | Quick Links
|-
|[http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git gitweb]
|}


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


allows you to easily portion out karma points for testing updates that you have currently installed. The typical workflow is as follows:
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>


# install packages from [[QA/Updates_Testing|updates-testing]]: {{command|su -c 'yum --enablerepo<nowiki>=</nowiki>updates-testing update'}}
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
# Use these packages to identify breakage or directly run fedora-easy-karma and test packages according to the update notes
avviare direttamente <code>fedora-easy-karma</code> e procedere al testing seguendo le relative note di aggiornamento.
# Run fedora-easy-karma


== Installation ==
; Un estratto d'Output
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'}}
 
Per l'uso e le opzioni disponibili, digitare, come al solito, <code>fedora-easy-karma --help</code>


== Example Output ==
<pre>
<pre>
$ fedora-easy-karma --help
Usage: fedora-easy-karma [options] [pattern, ..]
You will be asked for every package installed from updates-testing to provide
feedback using karma points. If patterns are provided, you will be only prompted
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:
-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
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:
  -h, --help            show this help message and exit
  --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
$ fedora-easy-karma
Getting list of installed packages...
Getting list of installed packages...
Line 113: Line 43:
</pre>
</pre>


== Example Workflows ==
== Workflow tipico ==
=== Update Everything, then look at updates and perform some direct testing ===
# Aggiornare con i più recenti pacchetti disponibili, <code>yum update --enablerepo="*-testing"</code>
First update:
# Avviare <code>fedora-easy-karma</code>
{{command|yum update --enablerepo<nowiki>=</nowiki>"*-testing"}}
 
The run fedora-easy-karma:
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.
{{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".
Se si è soddisfatti di come l'applicazione funzioni, inserire '''1''' in <code>fedora-easy-karma</code>, descrivendo le operazioni svolte durante il test.  
 
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>


== Frequently Asked Questions ==
Se non si ha idea di come testare il pacchetto (si tratta magari di una libreria), saltare il feedback premendo '''Invio'''.
* 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 ==
{{Admon/note|Pacchetto privo di feedback
Currently the source is available at a [http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git Fedorapeople git repository]
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]]}}
 
== Il codice sorgente ==
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].

Revision as of 16:21, 23 August 2010

fedora-easy-karma (script) è lo strumento usato dai proven tester per inviare il proprio karma (positivo, neutro o negativo) ai pacchetti del repository updates-testing, dopo essere stati opportunamente sottoposti a test.

Per usare lo script occorre avere la versione 0.4.0 o superiore del pacchetto Package-x-generic-16.pngfedora-packager.
Lo script può essere installato usando il comando: su -c 'yum --enablerepo=updates-testing install fedora-easy-karma'

Poi, il workflow, prevede di installare i pacchetti da updates-testing: su -c 'yum --enablerepo=updates-testing update', e poi di usare i pacchetti e verificarne il funzionamento, come indicato nella sezione Cosa testare, oppure di avviare direttamente fedora-easy-karma e procedere al testing seguendo le relative note di aggiornamento.

Un estratto d'Output

Per l'uso e le opzioni disponibili, digitare, come al solito, fedora-easy-karma --help

$ 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

 inst. RPMS: fedora-easy-karma-0-0.7.20100709git561718c8.fc12.noarch - Fedora update feedback made easy (installed 0 days ago)

Comment? -1/0/1 ->karma, other -> skip> 1
Comment> It works perfectly.
FAS Password for till:

Workflow tipico

  1. Aggiornare con i più recenti pacchetti disponibili, yum update --enablerepo="*-testing"
  2. Avviare fedora-easy-karma

A questo punto, leggere le informazioni di aggiornamento disponibili.
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.

Se si è soddisfatti di come l'applicazione funzioni, inserire 1 in fedora-easy-karma, descrivendo le operazioni svolte durante il test.

Se si è verificato qualche problema, inaspettato, inserire -1 in fedora-easy-karma, menzionando il problema riscontrato e il link al bug-report generato in Bugzilla.

Se non si ha idea di come testare il pacchetto (si tratta magari di una libreria), saltare il feedback premendo Invio.

Note.png
Pacchetto privo di feedback Se il pacchetto pippo che è stato appena aggiornato dal repositori updates-testing, all'avvio di fedora-easy-karma non richiede alcun feedback, vuol dire con buona probabilità il pacchetto pippo è 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

Il codice sorgente

Il sorgente dello script, fedora-easy-karma, attualmente si trova su Fedorapeople git repository.