From Fedora Project Wiki
(Created page with '{| style="float:right;" ! colspan="2" | Quick Links |- |[http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git gitweb] |} fedora-easy-karma allows you to easily ...')
 
(Portuguese (Brazilian flavor) translation of the latest documentation for Fedora Easy Karma (needs checking))
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{| style="float:right;"
{{autolang}}
! colspan="2" | Quick Links
 
|-
{{autolang|base=yes}}
|[http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git gitweb]
<span id="fedora-easy-karma"></span>
|}
= Fedora Easy Karma =
fedora-easy-karma allows you to easily portion out karma points for testing updates that you have currently installed. The typical workflow is as follows:
 
<span id="the-purpose-of-fedora-easy-karma"></span>
== O propósito do Fedora Easy Karma ==
 
'''fedora-easy-karma''' é uma aplicação de terminal que facilita o envio de feedback sobre as [https://bodhi.fedoraproject.org atualizações propostas] em um repositório de testes do Fedora ou EPEL, tudo diretamente da linha de comando.
 
Ele pode reconhecer automaticamente qualquer pacote de teste que você tenha instalado (substituindo a versão estável), fornece diversas informações sobre o pacote, incluindo comentários de outros usuários, e permite comentar e fornecer karma (avaliação) ao pacote. Para mais detalhes sobre o karma, consulte a seção ''Entendendo o karma dos pacotes''.
 
<span id="how-to-enable-testing-packages-on-your-system"></span>
== Como habilitar os pacotes de teste no seu sistema ==
 
Para usar o Fedora Easy Karma, é importante que você tenha habilitado os ''pacotes de teste'' (atualizações de teste) no seu sistema. Pacotes de teste são versões mais recentes de aplicativos, programas ou bibliotecas, que eventualmente se tornarão parte das atualizações estáveis do sistema.
 
Por padrão, os pacotes de teste não estão habilitados no sistema (exceto em versões Beta), então, se você deseja utilizá-los, deve habilitá-los explicitamente. Existem duas formas de adicionar pacotes de teste ao seu sistema:
 
<span id="temporarily-enabling-the-testing-repository"></span>
=== Habilitar temporariamente o repositório de teste ===
 
Você pode habilitar temporariamente o repositório de teste enquanto executa o comando <code>dnf update</code>. Com essa abordagem, você só baixará e instalará novas atualizações de teste quando decidir fazê-lo.
 
Para fazer com que o DNF instale atualizações de teste, use:
 
<pre class="[bash]">$ sudo dnf update --enablerepo=updates-testing --best</pre>
Note que, se você não usar o argumento <code>--enablerepo</code> no futuro, o DNF não atualizará os pacotes para suas últimas versões de teste, e o seu sistema poderá ficar numa situação em que não terá nem os pacotes mais recentes nem os estáveis instalados, o que pode gerar problemas, especialmente se as versões específicas dos pacotes instalados apresentarem problemas.
 
Para restaurar o sistema para a versão estável dos pacotes, use:
 
<pre class="[bash]">$ sudo dnf distro-sync</pre>
<span id="persistently-enabling-the-testing-repository"></span>
=== Habilitar permanentemente o repositório de teste ===
 
Você pode habilitar permanentemente o repositório de teste e sempre atualizar para os pacotes de teste mais recentes. Uma vez habilitados, você receberá essas novas atualizações toda vez que utilizar o comando <code>dnf update</code> até desabilitá-los novamente. Com essa abordagem, o seu Fedora estará um passo à frente da versão estável, então, você pode experimentar problemas com determinados aplicativos ou pacotes. Mas, afinal, isso faz parte do processo de testes, não é?
 
Para habilitar permanentemente o repositório de teste, use:
 
<pre class="[bash]">$ sudo dnf config-manager setopt "updates-testing.enabled=1"</pre>
Para desabilitar o repositório de teste, use o mesmo comando, mas substitua <code>enabled=1</code> por <code>enabled=0</code>. Também é recomendável sincronizar o sistema usando o comando <code>distro-sync</code> após desabilitar o repositório.
 
Alternativamente, você pode utilizar o seu gerenciador de pacotes, como o ''Gnome Software'', ''KDE Discover'' ou ''DNFdragora'' para habilitar ou desabilitar repositórios.
 
<span id="understanding-package-karma"></span>
== Entendendo o ''karma'' dos pacotes ==
 
Todo novo pacote atualizado chega a um repositório de teste onde precisa permanecer por um período de tempo (normalmente até 14 dias) antes de ser movido para o repositório ''estável''. Durante esse período, os usuários podem comentar sobre o pacote e fornecer uma avaliação, o chamado ''karma''.
 
O karma fornecido pode ser ''positivo'', ''neutro'' ou ''negativo'', com base na experiência do usuário e nos testes realizados sobre o pacote. Enquanto o karma neutro não afeta a permanência do pacote no repositório de teste, tanto o karma positivo quanto o negativo afetam.
 
Se um pacote receber um número predefinido de karma positivo (determinado pelo mantenedor do pacote), ele estará pronto para ser movido ao repositório estável sem precisar esperar o período de carência. Por outro lado, se um pacote receber karma negativo, o envio automático será bloqueado e o mantenedor poderá optar por enviá-lo manualmente ou corrigir os problemas, gerar uma nova versão do pacote e reiniciar o processo.
 
<span id="using-fedora-easy-karma"></span>
== Usando o 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
=== Instalando e executando o FEK ===
# Run fedora-easy-karma


== Installation ==
O ''Fedora Easy Karma'' não vem instalado por padrão, então você precisa instalá-lo primeiro. Para isso, execute:
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>
Depois de instalar o aplicativo, você pode executá-lo no terminal utilizando:
$ 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
O aplicativo mostrará informações sobre os pacotes, comentários de outros usuários relacionados e permitirá que você comente e forneça karma. Se não quiser comentar nem fornecer karma para um determinado pacote, você pode ''pular'' para outro pacote ou ''ignorar'' aquele pacote e seguir para o próximo, até que todos os pacotes tenham sido avaliados, pulados ou ignorados.
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 você pular um pacote, o ''Fedora Easy Karma'' perguntará sobre ele na próxima vez que for executado. Se você ignorar o pacote, o ''Fedora Easy Karma'' não perguntará mais sobre ele até que uma versão mais recente do pacote seja encontrada no 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
Note que, para usar o ''Fedora Easy Karma'', você precisa ter uma '''conta FAS'''. Caso não tenha, crie uma conta em [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
=== Argumentos opcionais ===
  --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
Utilizando argumentos opcionais, você pode alterar o comportamento padrão do ''Fedora Easy Karma''. Note que a lista a seguir mostra apenas os argumentos mais utilizados. Para uma lista completa, utilize o argumento <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"
|-
! Argumento
! Significado
|-
| <code>--help</code>
| Mostra a mensagem de ajuda.
|-
| <code>--datadir=DATADIR</code>
| Altera o local do diretório de configuração. Por padrão, está localizado em <code>~/.config/fedora-easy-karma</code>.
|-
| <code>--default-comment=COMMENT</code>
| Utiliza este valor como comentário padrão para cada pacote mostrado.
|-
| <code>--default-karma=KARMA</code>
| Utiliza este valor como karma padrão para cada pacote mostrado.
|-
| <code>--no-color</code>
| Não utiliza a saída colorida. Por padrão, alguns campos usam cores para melhorar a orientação, mas elas podem não ser legíveis com algumas paletas de terminais, então pode ser necessário desativá-las.
|-
| <code>--installed-max-days=DAYS</code>
| Inclui apenas pacotes instalados nos últimos DAYS dias.
|-
| <code>--installed-min-days=DAYS</code>
| Inclui apenas pacotes instalados há pelo menos DAYS dias.
|-
| <code>--pages</code>
| Limpa o terminal entre os pacotes para que apenas o pacote em questão seja mostrado na tela do terminal. Isso pode ajudar a melhorar a legibilidade.
|-
| <code>--retries=RETRIES</code>
| Define quantas vezes tentar enviar o comentário se ele falhar.
|-
| <code>--skip-bodhi-comments</code>
| Desativa os comentários fornecidos pelo sistema Bodhi. Isso aumenta significativamente a legibilidade da seção de comentários.
|-
| <code>--wrap-width=WIDTH</code>
| O comprimento da linha após o qual o texto será quebrado. O valor padrão é 80.
|}


Comment? -1/0/1 ->karma, other -> skip> 1
<span id="troubleshooting"></span>
Comment> It works perfectly.
=== Solução de problemas ===
FAS Password for till:
</pre>


== Example Workflows ==
Se você encontrar problemas com o ''Fedora Easy Karma'', considere reportar um problema na [https://pagure.io/fedora-easy-karma página do projeto].
=== 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:Brazilian translations]]
Currently the source is available at a [http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git Fedorapeople git repository]

Latest revision as of 15:08, 30 January 2025

Fedora Easy Karma

O propósito do Fedora Easy Karma

fedora-easy-karma é uma aplicação de terminal que facilita o envio de feedback sobre as atualizações propostas em um repositório de testes do Fedora ou EPEL, tudo diretamente da linha de comando.

Ele pode reconhecer automaticamente qualquer pacote de teste que você tenha instalado (substituindo a versão estável), fornece diversas informações sobre o pacote, incluindo comentários de outros usuários, e permite comentar e fornecer karma (avaliação) ao pacote. Para mais detalhes sobre o karma, consulte a seção Entendendo o karma dos pacotes.

Como habilitar os pacotes de teste no seu sistema

Para usar o Fedora Easy Karma, é importante que você tenha habilitado os pacotes de teste (atualizações de teste) no seu sistema. Pacotes de teste são versões mais recentes de aplicativos, programas ou bibliotecas, que eventualmente se tornarão parte das atualizações estáveis do sistema.

Por padrão, os pacotes de teste não estão habilitados no sistema (exceto em versões Beta), então, se você deseja utilizá-los, deve habilitá-los explicitamente. Existem duas formas de adicionar pacotes de teste ao seu sistema:

Habilitar temporariamente o repositório de teste

Você pode habilitar temporariamente o repositório de teste enquanto executa o comando dnf update. Com essa abordagem, você só baixará e instalará novas atualizações de teste quando decidir fazê-lo.

Para fazer com que o DNF instale atualizações de teste, use: 

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

Note que, se você não usar o argumento --enablerepo no futuro, o DNF não atualizará os pacotes para suas últimas versões de teste, e o seu sistema poderá ficar numa situação em que não terá nem os pacotes mais recentes nem os estáveis instalados, o que pode gerar problemas, especialmente se as versões específicas dos pacotes instalados apresentarem problemas.

Para restaurar o sistema para a versão estável dos pacotes, use: 

$ sudo dnf distro-sync

Habilitar permanentemente o repositório de teste

Você pode habilitar permanentemente o repositório de teste e sempre atualizar para os pacotes de teste mais recentes. Uma vez habilitados, você receberá essas novas atualizações toda vez que utilizar o comando dnf update até desabilitá-los novamente. Com essa abordagem, o seu Fedora estará um passo à frente da versão estável, então, você pode experimentar problemas com determinados aplicativos ou pacotes. Mas, afinal, isso faz parte do processo de testes, não é?

Para habilitar permanentemente o repositório de teste, use: 

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

Para desabilitar o repositório de teste, use o mesmo comando, mas substitua enabled=1 por enabled=0. Também é recomendável sincronizar o sistema usando o comando distro-sync após desabilitar o repositório.

Alternativamente, você pode utilizar o seu gerenciador de pacotes, como o Gnome Software, KDE Discover ou DNFdragora para habilitar ou desabilitar repositórios.

Entendendo o karma dos pacotes

Todo novo pacote atualizado chega a um repositório de teste onde precisa permanecer por um período de tempo (normalmente até 14 dias) antes de ser movido para o repositório estável. Durante esse período, os usuários podem comentar sobre o pacote e fornecer uma avaliação, o chamado karma.

O karma fornecido pode ser positivo, neutro ou negativo, com base na experiência do usuário e nos testes realizados sobre o pacote. Enquanto o karma neutro não afeta a permanência do pacote no repositório de teste, tanto o karma positivo quanto o negativo afetam.

Se um pacote receber um número predefinido de karma positivo (determinado pelo mantenedor do pacote), ele estará pronto para ser movido ao repositório estável sem precisar esperar o período de carência. Por outro lado, se um pacote receber karma negativo, o envio automático será bloqueado e o mantenedor poderá optar por enviá-lo manualmente ou corrigir os problemas, gerar uma nova versão do pacote e reiniciar o processo.

Usando o Fedora Easy Karma

Instalando e executando o FEK

O Fedora Easy Karma não vem instalado por padrão, então você precisa instalá-lo primeiro. Para isso, execute: 

$ sudo dnf install fedora-easy-karma

Depois de instalar o aplicativo, você pode executá-lo no terminal utilizando: 

$ fedora-easy-karma

O aplicativo mostrará informações sobre os pacotes, comentários de outros usuários relacionados e permitirá que você comente e forneça karma. Se não quiser comentar nem fornecer karma para um determinado pacote, você pode pular para outro pacote ou ignorar aquele pacote e seguir para o próximo, até que todos os pacotes tenham sido avaliados, pulados ou ignorados.

Se você pular um pacote, o Fedora Easy Karma perguntará sobre ele na próxima vez que for executado. Se você ignorar o pacote, o Fedora Easy Karma não perguntará mais sobre ele até que uma versão mais recente do pacote seja encontrada no sistema.

Note que, para usar o Fedora Easy Karma, você precisa ter uma conta FAS. Caso não tenha, crie uma conta em Fedora Accounts.

Argumentos opcionais

Utilizando argumentos opcionais, você pode alterar o comportamento padrão do Fedora Easy Karma. Note que a lista a seguir mostra apenas os argumentos mais utilizados. Para uma lista completa, utilize o argumento --help.

Argumento Significado
--help Mostra a mensagem de ajuda.
--datadir=DATADIR Altera o local do diretório de configuração. Por padrão, está localizado em ~/.config/fedora-easy-karma.
--default-comment=COMMENT Utiliza este valor como comentário padrão para cada pacote mostrado.
--default-karma=KARMA Utiliza este valor como karma padrão para cada pacote mostrado.
--no-color Não utiliza a saída colorida. Por padrão, alguns campos usam cores para melhorar a orientação, mas elas podem não ser legíveis com algumas paletas de terminais, então pode ser necessário desativá-las.
--installed-max-days=DAYS Inclui apenas pacotes instalados nos últimos DAYS dias.
--installed-min-days=DAYS Inclui apenas pacotes instalados há pelo menos DAYS dias.
--pages Limpa o terminal entre os pacotes para que apenas o pacote em questão seja mostrado na tela do terminal. Isso pode ajudar a melhorar a legibilidade.
--retries=RETRIES Define quantas vezes tentar enviar o comentário se ele falhar.
--skip-bodhi-comments Desativa os comentários fornecidos pelo sistema Bodhi. Isso aumenta significativamente a legibilidade da seção de comentários.
--wrap-width=WIDTH O comprimento da linha após o qual o texto será quebrado. O valor padrão é 80.

Solução de problemas

Se você encontrar problemas com o Fedora Easy Karma, considere reportar um problema na página do projeto.

Retrieved from "https://fedoraproject.org/w/index.php?title=Fedora_Easy_Karma/pt-br&oldid=729849"