Manual:Pywikibot/Installation/pt-br

  Esta página ajudará você a começar a usar o Pywikibot, seja no seu próprio computador, no Toolforge ou usando o PAWS: A Web Shell.

  No PAWS PAWS: A Web Shell é a maneira mais fácil de começar a usar o Pywikibot. Nenhuma instalação é necessária, e você usa a interface web para enviar comandos.

 No seu próprio computador Abaixo está o manual para ajudá-lo a configurar e executar o Pywikibot em seu próprio computador. São quatro etapas principais para este processo:  No Toolforge O Toolforge fornece uma infraestrutura de hospedagem estável na Wikimedia, que permite executar bots continuamente ou em uma programação.
 * Instalando Python
 * Instalando Pywikibot
 * Configurando Pywikibot
 * Executando um script



Instalando Python
Baixe e instale o Python no https://www.python.org/downloads/.

Caso você já tenha Python instalado, verifique se a versão é recente o suficiente, executando  no console. Para descobrir se a versão 3 ou acima do Python está instalada, execute  em um console.

Ubuntu 19.04 e acima vem com as versões 2 & 3 instaladas. Python v2 funciona por padrão usando o comando terminal  ; para usar v3, use o comando terminal.

Caso você tenha instalado, a sua versão é suficientemente recente.

No Windows, não esqueça de modificar a variável do caminho PATH para fazer com que o Python e o pip funcionem corretamente.



Instalar dependências
Um pacote adicional chamado requests é necessário para usar o Pywikibot. Use pip, que está incluído por padrão em todas as versões suportadas do Python. Execute o seguinte comando para instalar esse pacote:

Além disso, é necessário um analisador de marcação MediaWiki. Instale (pelo menos) um dos abaixo (ou ambos):



Instalando Pywikibot
Ao usar pip, use  ao invés de   nos exemplos abaixo.

Baixe a versão mais atual do Pywikibot de número stable: .tar.gz, .zip.

Descompacte o arquivo baixado, por exemplo em  ou.

Alternativamente, você pode obter a última versão usando clientes git ou svn do Gerrit, veja. É o recomendado para operadores e desenvolvedores ativos de bots para Pywikibot.

Outras versões estão disponíveis em https://pywikibot.toolforge.org/.



Atualizando Pywikibot
Mantenha o framework do seu bot atualizado. Novas versões são lançadas continuamente, e estão disponibilizadas no mesmo local.

Se você estiver usando git ou svn, você pode pular essa parte. Senão, tenha em mente a necessidade de fazer um backup de seus arquivos de configuração e scripts (user-config.py, qualquer arquivo de família, ou script customizado que você criou ou modificou, e qualquer arquivo de dump XML que você está usando atualmente para uma wiki) antes de instalar uma nova versão.

Descompacte a nova versão sobre a versão antiga, sobrescrevendo todos os arquivos.



Configurando Pywikibot
Abra o Terminal no Unix (Linux/BSD/Solaris) ou Prompt de Comando no Windows (normalmente nas pastas Sistema ou Acessórios no menu Todos os Programas dentro do menu Inciar), e mude o diretório para onde você descompactou o Pywikibot:


 * Unix (Linux/BSD/Solaris):




 * Windows:



Substitua o local por onde você desempacotou o Pywikibot.

Continue com o seguinte comando para gerar o arquivo de configuração do usuário:

Siga as instruções para configurar o Pywikibot.

Finalmente, execute o seguinte comando para efetuar login na sua wiki:



Uso em wikis de terceiros
Pywikibot é pré-configurado para um grande número de wikis, mas possivelmente não para aquela em que você quer trabalhar. Veja para saber como configurar o Pywikibot para a sua wiki.



Mais opções de configuração
Pywikibot disponibiliza um gama extensa de opções de configuração para mudar o comportamento de seu robô. Você pode alterar essas opções no arquivo user-config.py. Veja config.py para uma lista com todos os parâmetros que você pode usar.



Configuração de proxy
Pywikibot depende de  para comunicar com a web. Você pode usar as variáveis dos caminhos  e   para fazer requests usando um servidor proxy. Veja documentação de requests para mais informações.



Execução do script
O Pywikibot vem empacotado com um grande número de scripts no diretório scripts. Você pode rodar todos esses usando:

To learn more about running basic Pywikibot scripts, see:
 * Small wiki toolkits workshop about running basic Pywikibot scripts

Uma lista de todos os scripts estão disponíveis em doc.wikimedia.org/pywikibot.



Outras dependências
A maioria dos scripts não requer pacotes adicionais, mas alguns deles não funcionarão sem. Eles estão listados em requirements.txt juntamente com suas dependências.

Para instalar dependências para algum script, use pip e execute o seguinte comando:

Como alternativa, execute o seguinte comando para instalar todas as dependências de todos os scripts de uma só vez: