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

Esta página 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 que te permite ejecutar tus bots continuamente o en un horario determinado.

Ejecutar Pywikibot en Toolforge.

Pywikibot
Un vistazo rápido Instalación Running on PAWS Running on Windows Running on Toolforge Configuration and scripts user-config.py Opciones globales i18n Scripts Uses 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. Si tienes Python 2.7.4 o superior, o Python 3.4 o superior instalado, tu versión es suficientemente reciente. Sin embargo, las versiones de Python inferiores a 3.5 se pueden eliminar en un futuro. Se recomienda estrictamente usar Python 3.5 o superior.

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

Instalar Pywikibot

Descargar Pywikibot stable branch: .tar.gz, .zip.

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://tools.wmflabs.org/pywikibot/.

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 ~/pywikibot

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 config2.py para una lista de todos los parámetros que puedes usar.

Proxy configuration

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.

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 ^conectar or pywikibot@ mailing list.