From Fedora Project Wiki
mNo edit summary
(Portuguese (Brazilian flavor) translation of the latest documentation for Fedora Easy Karma (needs checking))
 
Line 1: Line 1:
{{autolang}}
{{autolang}}


{| style="float:right;"
{{autolang|base=yes}}
! colspan="2" | Links rápidos
<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>
fedora-easy-karma permite que você atribua pontos de karma facilmente para as atualizações de testes que você tem instaladas no momento. O fluxo de trabalho típico é o seguinte:
== 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 ==


# Instalar pacotes apartir do repositório [[QA:Updates_Testing|updates-testing]]: {{command|su -c 'dnf --enablerepo<nowiki>=</nowiki>updates-testing update'}}
<span id="installing-and-running-fek"></span>
# Utilize esses pacotes para identificar problemas ou execute diretamente o fedora-easy-karma e teste os pacotes de acordo com as notas de atualizações.
=== Instalando e executando o FEK ===
# Execute o fedora-easy-karma


== Instalação ==
O ''Fedora Easy Karma'' não vem instalado por padrão, então você precisa instalá-lo primeiro. Para isso, execute:
Você precisará da versão 0.4.0 ou superior do {{package|fedora-packager}} para usar esse script. Você pode instalar o {{package|fedora-easy-karma}} para qualquer versão suportada do Fedora utilizando o comando: {{command|su -c 'dnf --enablerepo<nowiki>=</nowiki>updates-testing install fedora-easy-karma'}}


== Exemplo de saída ==
<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>


== Exemplo de fluxos de trabalho ==
Se você encontrar problemas com o ''Fedora Easy Karma'', considere reportar um problema na [https://pagure.io/fedora-easy-karma página do projeto].
=== Atualizar tudo, então olhar as atualizações e fazer alguns testes diretos ===
Primeiro comando:
{{command|dnf update --enablerepo<nowiki>=</nowiki>"*-testing"}}
Executar o fedora-easy-karma:
{{command|fedora-easy-karma}}
Agora leia as informações de atualização apresentadas. Se houver uma atualização que você gostaria de testar, faça isso agora, em paralelo, por exemplo, se é um editor de texto, você deve executá-lo, abrir alguns arquivos, modificar algo, etc. Se você estiver satisfeito com o resultado, digite "1" no fedora-easy-karma e descreva o que você fez. Se alguma coisa quebrou, por favor relate o problema, digite "-1" no fedora-easy-karma e mencione o erro no comentário. Se você não sabe como testar o pacote, apenas ignore-o e tecle "Enter".


== FAQ ==
[[Category:QA]]
* P: Eu atualizei somente o pacote FOO apartir do repositório updates-testing, mas quando eu executei o fedora-easy-karma, porque eu não fui perguntado para fazer uma avaliação?
: R: A atualização para o pacote provavelmente já foi submetida para tornar-se estável ou talvez para ser removido dos testes. Você não será solicitado a fazer uma avaliação sobre essas atualizações. Se você encontrou um novo problema, por favor, abra um bug no Bugzilla.


== Código-Fonte ==
Atualmente o código-fonte está disponível em [http://fedorapeople.org/gitweb?p=till/public_git/fedora-easy-karma.git Fedorapeople git repository]
[[Category:Brazilian translations]]
[[Category:Brazilian translations]]

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"