Manual:Pywikibot/Instalação


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:
![]() |
Pywikibot |
---|
|
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 python --version
no console.
To discover if Python version 3 or above is installed, run python3 --version
in a console.
Ubuntu 19.04 and up comes with versions 2 & 3 installed. Python v2 runs by default using terminal command python
; to use v3, use terminal command python3
.
Caso você tenha Python 3.5.3 ou superior instalado, a sua versão é sufucientemente 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 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>=2.20.1"
In addition a MediaWiki markup parser is required.[1] Please install (at least) one of them:[1]
$ pip install "mwparserfromhell>=0.5.0"
or[1]
$ pip install "wikitextparser>=0.47.5"
or both.
Instalando Pywikibot
$ pip install pywikibot
Usuários do Python 2.7 devem baixar o branch estável do python2: .tar.gz, .zip em vez disso.
Desemcompacte o arquivo baixado, por exemplo em /home/username/pywikibot
ou C:\Users\username\pywikibot
.
Alternativamente, você pode obter a última versão usando clientes git ou svn do Gerrit, veja Manual:Pywikibot/Gerrit#For users . É 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.
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.
Descompacte a nova versão sobre a versão antiga, sobrescrevendo todos os arquivos.
Configure 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):
$ cd ~/core
- Windows:
$ c: $ cd "\Users\username\pywikibot"
É claro que deve-se substituir 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 é pré-configurado para um grande número de wikis, mas possivelmente não para aquela em que você quer trabalhar. Veja Manual:Pywikibot/Use on third-party wikis para saber como configurar o Pywikibot para a sua 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 config.py for a list of all parameters you can use.
Configuração de proxy
Pywikibot relies on requests
for communicating with the web.
You can use HTTP_PROXY
and HTTPS_PROXY
environment variables to make requests use a proxy server.
Refer to requests' documentation for more info.
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:
$ python pwb.py [name of the script]
Uma lista de todos os scripts estão disponíveis em Manual:Pywikibot/Scripts .
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:
$ pip install [name of the package]
Como alternativa, execute o seguinte comando para instalar todas as dependências de todos os scripts de uma só vez:
$ pip install -r requirements.txt
- Se você precisar de mais ajuda na configuração do seu Pywikibot, visite o canal #pywikibot IRC connect ou pywikibot@ lista de discussão.