Manual:Pywikibot/Instalação

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 submeter comandos.

Rodando Pywikibot em PAWS

No seu próprio computador

Esta página irá começar a instalar e executar o Pywikibot em seus próprios computadores. Existem quatro etapas principais para este processo:

• Instalando o Python
• Instalando Pywikibot
• Configurando Pywikibot

Executando os scripts

No Toolforge

Se você quiser executar um bot em um wiki da Wikimedia, considere o uso de Toolforge. O Toolforge fornece uma infraestrutura de hospedagem estável que permite executar bots continuamente ou em uma programação.

Executando Pywikibot na Toolforge

Pywikibot
Visão geral rápida Instalação (Windows ) Correndo na Toolforge user-config.py Wikidata Wikis não Wikimedia Opções globais i18n Scripts Desenvolvimento Ajuda adicional Mais... »

Instalar Python

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

If you already have Python installed, check if your version is recent enough by running python --version in a console. If you have Python 2.7.4 or higher, or Python 3.4 or higher installed, your version of Python is recent enough.

Instalar dependeências

Um pacote adicional chamado "requestes" é necessário para rodar Pywikibot. Use pip, que já está instalado se você tem 2.7.9 ou superior, ou Python 3.4 ou superior. Rode o comando seguinte para instalar o pacote:

pip install requests

On Ubuntu, additionaly,

sudo apt install python3-distutils

Instando Pywikibot

Baixe o Pywikibot atual master branch: .tar.gz, .zip.

Desempacote o arquivo baixado, por exemplo /home/username/pywikibot ou C:\Users\username\pywikibot.

Alternatively, you may retrieve the latest version using git from Gerrit, see Manual:Pywikibot/Gerrit#For users . This is the recommended way for active bot operators and developers to use Pywikibot.

Versões antigas estão disponíveis em http://tools.wmflabs.org/pywikibot/.

Atualizando Pywikibot

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

If you are using git or svn release, you may skip this note. Otherwise please be aware of a necessity to backup your configuration files and scripts (user-config.py, any family file, or custom script that you might have created or changed, and any current XML dump file you're using for a wiki) before installing a new release.

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

Configure Pywikibot

Open Terminal on Unix-like (Linux/BSD/Solaris) or Command Prompt on Windows (typically under Windows System or Accessories folders in All apps or All programs menu inside the Start menu), and change directory to where you unpacked Pywikibot:

Unix-like (Linux/BSD/Solaris):

cd /home/username/pywikibot

Windows:

c:
cd "\Users\username\pywikibot"

É claro que substitua o local por onde você desempacotou o Pywikibot.

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

python pwb.py generate_user_files

Siga as instruções para configurar o Pywikibot.

Finalmente, execute o seguinte comando para efetuar login no seu wiki:

python pwb.py login

Use em wikis de terceiros

Pywikibot is pre-configured for a large number of wikis, but possibly not for the one you want to work on. See Manual:Pywikibot/Use on third-party wikis for how to configure Pywikibot for your wiki.

Mais opções de configuração

Pywikibot provides a wide range of configuration options to change the behavior of your bot. Você pode alterar essas opções no arquivo "user-config.py". See config2.py for a list of all parameters you can use.

Execução do script

Pywikibot comes packaged with a large number of scripts in the scripts directory. Você pode rodar todos esses usando:

python pwb.py [name of the script]

Uma lista de todos os scripts estão disponíveis em Manual:Pywikibot/Scripts .

Outras dependências

Most scripts do not require additional packages, but a few of them will not work without. These are listed in requirements.txt together with their dependencies.

To install dependencies for some script, use pip, and run the following command:

pip install [name of the package]

Alternatively, run the following command to install all dependencies for all scripts at once:

pip install -r requirements.txt

Se você precisar de mais ajuda para configurar seu Pywikibot, visite o canal de IRC #pywikibot^conectar @ no servidor freenode ou lista de correio do Pywikibot.