Manual:Pywikibot/PAWS/pt-br


 * Veja PAWS para mais detalhes.

Este documento fornece uma rápida visão geral interativa de  usando um  notebook  hospedado no ambiente do Wikimedia labs usando PAWS (PAWS: Um Web Shell).

Crie uma conta Wikimedia
Para seguir este guia, você só precisa de uma conta na Wikipedia / Wikimedia. Use Special:CreateAccount para criar uma.

Depois de criar uma conta, visite https://test.wikipedia.org/ e verifique se seu nome de usuário aparece no canto superior direito (isso funciona em torno de T120327).

Se você é um novo usuário da Wikimedia, faça login com sua conta na meta.Wikimedia, Wikipédia, Wikidata e Commons. E em cada um deles leia e exclua todas as mensagens pendentes que você tem (na parte superior).

Entre em um notebook
Para iniciar um notebook hospedado, vá para https://hub.paws.wmcloud.org/hub

Clique em "Entrar com o MediaWiki" e, em seguida, clique em "Permitir" quando for solicitado a aprovar "Usar o OAuth para autenticação". Na primeira vez que você acessa o PAWS, você precisa criar um servidor. Clique no botão verde "Start my Server". É normal aguardar alguns minutos para a inicialização do novo servidor.

Uma vez concluído, você será redirecionado para um URL como https://hub.paws.wmcloud.org/user/ /tree

Iniciar um terminal
Para iniciar um novo terminal interativo,
 * 1) Vá para a sua [$paws PAWS home]
 * 2) clique em 'New' no lado direito e
 * 3) selecione 'Terminal'.

Isso abrirá uma nova janela com a URL https://hub.paws.wmcloud.org/user/ /terminals/1, com um prompt '$' do Linux.

Você pode marcar este URL como favorito e retornar ao terminal a qualquer momento, mesmo depois de fechar o navegador ou desligar o computador.

Este terminal não é um emulador. É um verdadeiro bash shell, como parte de uma instalação real do Linux em um container docker, para que você possa usar qualquer comando bash e use todos os comandos disponíveis no Linux que foram instalados.

Para ver alguns dos comandos disponíveis, use.

Faça login na wiki
Isso estabelecerá sua conta no servidor e permitirá que você efetue login na linha de comando. O comando a seguir deve confirmar que você pode efetuar login no testwiki. Ele usa o OAuth, portanto, não é necessário digitar uma senha.

Você pode conectar o pywikibot a um wiki diferente criando um arquivo chamado user-config.py em seu  directory  e adicionando variáveis de mylang e family:

Crie uma página
Para criar uma página, digite o seguinte comando no terminal, substituindo '&lt;username>' pelo seu nome de usuário e pressionando 'Y' quando solicitado a aceitar suas alterações:

Você editou o wiki. Veja suas alterações abrindo https://test.wikipedia.org/wiki/User_talk: no seu navegador.

Você pode ler mais sobre cada um desses scripts de linha de comando com a opção de linha de comando '-help'.

Buscar uma página
A busca de muitas páginas é obtida com o comando "listpages".

Para obter o conteúdo da página que você criou na seção anterior, digite o seguinte comando:

Agora, se você for para a sua [$pawshome PAWS files list], a página salva deverá estar presente.

Um exemplo de script real
Quando um site usado na Wikipedia altera seu URL, os links na Wikipedia ficam desatualizados e também são possíveis links mortos se o site não redirecionar dos URLs antigos para os novos URLs. Por exemplo, a Encyclopedia Britannica (EB) mudou seus links, como mover páginas de http://www.britannica.com/EBchecked/media/ para http://www.britannica.com/topic/[topic name]/images-videos/*. Você pode encontrar a lista de usos do URL antigo na Wikipedia em inglês por w:Special:LinkSearch/http://www.britannica.com/EBchecked/media. A atualização manual de todos esses links consumirá muito tempo. Felizmente, a EB manteve redirecionamentos de seus URLs antigos para os novos URLs, portanto, isso não precisa ser corrigido imediatamente.

Para um exemplo mais simples, atualmente a Wikipedia em inglês contém links para http://britannica.com/EBchecked/ em vez de http://www.britannica.com/EBchecked/ ; ou seja, um "www". O subdomínio está ausente no URL.

Atualmente, existem 14 casos na Wikipedia em inglês: w:Special:LinkSearch/http://britannica.com/EBchecked/

A Wikipedia em outro idioma também tem esse problema. por exemplo. há um caso na Wikipedia em alemão: w:de:Spezial:Weblinksuche/http://britannica.com/EBchecked/

Para corrigir esses links, podemos usar o script Pywikibot replace.py. Nesta demonstração, usaremos o argumento '-simulate' para evitar a escrita no wiki, pois existem regras estritas sobre a Wikipedia em inglês edição automática.

Primeiro vamos listar todas as páginas que apontam para http://britannica.com/EBchecked/.

Agora, verificamos se essas páginas realmente possuem o URL literal na página; ou seja, eles não estão usando um modelo.

Agora use substituir para adicionar o "www" ausente.

No PAWS e em qualquer terminal que suporte cores, a diferença de alterações mostrará o "www." adicionado na cor verde do texto, facilitando a localização das alterações propostas.

Dentro do Pywikibot
Em seguida, usaremos a sessão do PAWS Python.


 * 1) Vá para a sua [$paws PAWS home],
 * 2) clique em 'Novo' no lado direito e
 * 3) selecione 'Python 3'.

Isso abrirá uma nova janela.

Na caixa de texto, digite o seguinte e, no menu Cell, selecione 'Run' (ou pressione Shift+Enter para executar).

Uma nova caixa de texto será exibida abaixo. Execute o seguinte para criar um objeto APISite conectado a https://test.wikipedia.org/:

Descreva o "site" inserindo-o na nova caixa de texto e selecionando "Run".

Deve mostrar

Out[3]: APISite("test", "wikipedia")

Crie um objeto de página:

Verifique se existe executando:

Deve gerar

VERBOSE:pywiki:Found 1 wikipedia:test processes running, including this one. Out[5]: True

Mostre o texto na página:

Altere o texto da página no objeto:

Salve a página no wiki:

A resposta deve ser:

O notebook interativo Python 3 permite que muitas linhas sejam executadas juntas. O acima pode ser colocado em uma caixa de texto e Executar

O log da sua sessão interativa do Python pode ser salvo ou baixado para referência futura.

Acessando a documentação online no PAWS
A documentação do Pywikibot pode ser encontrada em https://doc.wikimedia.org/pywikibot/. Ele é originário principalmente de docstrings, que pode ser carregado no notebook interativo do Python 3 usando a função interna do Python help.

Por exemplo, para examinar os argumentos do método save acima, execute:

ou

Editando scripts Pywikibot
A biblioteca e os scripts do Pywikibot estão localizados em /srv/paws e são somente leitura. A biblioteca Pywikibot instalada não pode ser modificada no PAWS.

Os scripts podem ser modificados após copiá-los para a sua casa no PAWS.

Por exemplo, para executar um "checkimages.py" modificado:


 * 1) No terminal, digite
 * 1) Em um navegador, vá para a sua [$paws PAWS home] e clique no arquivo.
 * 1) No navegador, você pode editar o arquivo. Edite o código -- por exemplo, logo após o código   na linha 1775, adicione uma nova linha 1776 que imprimirá seu nome:
 * 2) Na interface de edição, use o menu Arquivo e clique em Salvar para salvar suas modificações.
 * 3) No terminal, digite

Veja também

 * [$1 PAWS cheatsheet] por um usuário (por exemplo, sobre acesso à API e ao banco de dados)
 * Source code on GitHub