Manual:Pywikibot/Instalación

Esta página te ayudará a comenzar con Pywikibot, ya sea en su propia computadora, en Toolforge o utilizando Pywikibot: A Web Shell (PAWS).

En PAWS

PAWS: A Web Shell es la manera más sencilla de empezar con Pywikibot. No es necesaria ninguna instalación y utilizas una interfaz web para enviar comandos.

Ejecutando Pywikibot en PAWS

En tu propio ordenador

A continuación encontrarás un manual que te ayudará a comenzar con la instalación y a ejecutar Pywikibot en tu ordenador. Este proceso tiene cuatro pasos principales:

• Instalación de Python.
• Instalación de Pywikibot.
• Configuración de Pywikibot.
• Ejecución de un script.

En Toolforge

Toolforge te proporciona una infraestructura de alojamiento estable en la nube que te permite ejecutar tus bots continuamente o en un horario determinado.

Ejecutar Pywikibot en Toolforge.

Pywikibot
Un vistazo rápido Instalación Correr en PAWS Funcionamiento en Windows Ejecutar Pywikibot en Toolforge. Configuraciones y scripts user-config.py Opciones globales Opciones de generadores y filtros i18n Scripts Usos Wikidata Wikis que no son de Wikimedia Desarrollo Más ayuda Más... »

Instalar Python

Descarga e instalar Python desde https://www.python.org/downloads/.

Si ya has instalado Python, comprueba si tu versión es lo suficientemente reciente ejecutando python --version en una consola. 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.

Si tienes Python 3.5.3 or higher instalado, tu versión es suficientemente reciente.

En Windows, no olvide modificar la variable de entorno PATH para que Python y pip funcionen correctamente.

Instalar dependencias

Un paquete adicional llamado "requests" se requiere para ejecutar Pywikibot. Usa pip, que ya está instalado si tienes Python 2.7.9 o superior, o Python 3.4 o superior. Ejecuta el siguiente comando para instalar este paquete:

$ pip install "requests>=2.20.1"

In addition a MediaWiki markup parser is required. Please install (at least) one of them:

$ pip install "mwparserfromhell>=0.5.0"

or

$ pip install "wikitextparser>=0.47.5"

or both.

Instalar Pywikibot

$ pip install pywikibot

Advertencia:

The last version of the zip-file is currently (14 de julio de 2022(2022-07-14)) broken, it contains __metadata__.py instead of version string.

Descargar versión actual de Pywikibot stable: .zip.

Los usuarios de Python 2.7 deben descargar la rama estable de python2: .tar.gz, .zip en su lugar.

Desempaqueta el archivo descargado, por ejemplo en ~/pywikibot o C:\Users\username\pywikibot.

Alternativamente, puedes recuperar la última versión usando git o un cliente svn desde Gerrit, véase Manual:Pywikibot/Gerrit#For users . Esta es la manera recomendada para que los operadores de bot activos y desarrolladores usen Pywikibot.

Otras versiones están disponibles en https://pywikibot.toolforge.org/.

Actualizando Pywikibot

Mantén el framework de tu bot actualizado. Salen nuevas versiones continuamente, y están disponibles en la misma ubicación.

Si estás usando git o svn, puedes saltarte está nota. De la contrario, sé consciente de que necesitas hacer un backup de tus archivos de configuración y scripts ("user-config.py", cualquier archivo familiar, o script personalizado que hayas creado o modificado, y cualquier archvo de volcado XML que estés usando en una wiki) antes de instalar una nueva actualización.

Desempaqueta la nueva versión sobre la versión antigua, sobrescribiendo todos los archivos.

Configuración de Pywikibot

Abre Terminal en un sistema operativo tipo-Unix (Linux/BSD/Solaris) o Símbolo del sistema en Windows (generalmente debajo de Sistema Windows o la carpeta Accesorios en el menú Todas las aplicaciones o Todos los programas dentro del menú de inicio), y cambia el directorio a donde extrajiste Pywikibot:

Tipo-Unix (Linux/BSD/Solaris):

$ cd ~/core

Windows:

$ c:
$ cd "\Users\username\pywikibot"

Por supuesto, sustituye la ubicación donde desempaquetaste Pywikibot.

Continua con el siguiente comando para generar el archivo de configuración de usuario:

$ python pwb.py generate_user_files

Sigue las indicaciones para configurar Pywikibot.

Finalmente ejecuta el siguiente comando para identificarte en tu wiki:

$ python pwb.py login

Utilizar en wikis de terceros

Pywikibot está pee-configurado para una gran cantidad de wikis, sin embargo, posiblemente no para la que quieres utilizar. Véase Manual:Pywikibot/Use on third-party wikis para cómo configurar Pywikibot para tu wiki.

Más opciones de configuración

Pywikibot proporciona una amplia gama de opciones de configuración para cambiar el comportamiento de tu bot. Puedes cambiar estas opciones en tu archivo 'user-config.py'. Véase config.py para una lista de todos los parámetros que puedes usar.

Configuración del proxy

Pywikibot se basa en requests para comunicarse con la web. Puede utilizar las variables de entorno HTTP_PROXY y HTTPS_PROXY para que las peticiones utilicen un servidor proxy. Consulte la documentación de las solicitudes para obtener más información.

Ejecutando un script

Pywikibot trae consigo un gran número de scripts en la carpeta scripts. Puedes ejecutar todos estos usando

$ python pwb.py [name of the script]

Hay una lista con todos los scripts disponibles en Manual:Pywikibot/Scripts .

Otras dependencias

La mayoría de los scripts no requieren paquetes adicionales, sin embargo, algunos no funcionarán sin ellos. Estos paquetes están listados en requirements.txt junto con sus dependencias.

Para instalar dependencias, usa "pip", y ejecuta el siguiente comando:

$ pip install [name of the package]

Alternativamente, ejecuta el siguiente comando para instalar todas las dependencias de todos los scripts en una vez:

$ pip install -r requirements.txt

If you need more help on setting up your Pywikibot visit the #pywikibot IRC channel ^connect or pywikibot@ mailing list.