# Pywikibot/patrol.py

El script patrol.py es una herramienta incluida en Pywikibot diseñada para marcar ediciones como patrulladas en proyectos Wikimedia que permiten el patrullaje de ediciones o marcas de patrullaje. Este proceso es fundamental para mantener la calidad de los contenidos, permitiendo que los editores verifiquen ediciones recientes y las marquen como revisadas si cumplen con los estándares del proyecto. El script es útil para usuarios con permisos de patrullaje, agilizando el proceso en comparación con hacerlo manualmente.

## Contextos útiles

* Proyectos Wikimedia con un volumen elevado de ediciones recientes.
* Usuarios que deseen automatizar el proceso de revisión de nuevas ediciones.
Beneficio: Facilita la gestión de la revisión de cambios, reduciendo el tiempo y esfuerzo requerido para patrullar manualmente.

## Sección teórica

El script patrol.py utiliza la API de MediaWiki para buscar ediciones pendientes de patrullaje y marcarlas como revisadas. Esto se realiza mediante solicitudes a la API, utilizando tokens de patrullaje, que son necesarios para realizar la acción. Pywikibot simplifica el proceso de autentificación y envío de estas solicitudes, permitiendo que los usuarios se enfoquen en configurar parámetros básicos para ejecutar el script.

### Conceptos clave

* Ediciones pendientes de patrullaje: Ediciones que aún no han sido revisadas por un editor con permisos de patrullaje.
* Token de patrullaje: Un identificador necesario para realizar la acción de patrullaje a través de la API de MediaWiki.

## Requisitos previos

Antes de usar el script, debes cumplir con los siguientes requisitos:
* Instalación de Pywikibot: Asegúrate de tener Pywikibot correctamente configurado en tu sistema. Puedes seguir esta guía para instalar Pywikibot.
* Autenticación en Wikimedia: Debes autenticarte en un proyecto Wikimedia con permisos de patrullaje habilitados. La autenticación en Pywikibot requiere configurar tu cuenta en el archivo user-config.py.
* Permisos de patrullaje: Solo los usuarios con permisos de patrullaje en el proyecto Wikimedia pueden usar este script de manera efectiva.

## Guía paso a paso

A continuación se detalla el proceso para ejecutar el script patrol.py:
* Autenticarte en Pywikibot:
** Ejecuta el siguiente comando para autenticarte:
   * Sigue las indicaciones para iniciar sesión.
* Ejecutar el script patrol.py:
** Una vez autenticado, puedes ejecutar el script con el siguiente comando:
   * El script buscará automáticamente ediciones pendientes de patrullaje en el proyecto al que estás conectado.

### Ejemplo

Supongamos que deseas patrullar todas las ediciones recientes. El comando anterior buscará y marcará las ediciones pendientes como revisadas. Si deseas limitar el número de ediciones patrulladas, puedes agregar un parámetro opcional:
Este comando solo patrullará las 50 ediciones más recientes.

## Tarea: Patrullaje dirigido

Imagina que deseas patrullar solo las ediciones hechas por un usuario en particular, digamos UsuarioX. Para ello, deberás personalizar el uso del script utilizando los parámetros adecuados.
* Ejecuta el script filtrando por el usuario en cuestión:
* Reflexión: Después de ejecutar el script, responde las siguientes preguntas:
** ¿Qué diferencias encontraste entre patrullar todas las ediciones y patrullar solo las de un usuario específico?
** ¿Qué ventajas y desventajas encuentras en el patrullaje automatizado frente al manual?
Este ejercicio te permitirá experimentar con las funciones de filtrado y reflexionar sobre su utilidad en diferentes escenarios.

## Opciones avanzadas y parámetros

El script patrol.py ofrece una serie de parámetros que permiten modificar su comportamiento para adaptarse a tareas más complejas:
* -limit:X: Patrullar solo un número determinado de ediciones. Ejemplo:
* -user:NombreUsuario: Patrullar únicamente las ediciones de un usuario específico. Ejemplo:
* -start:YYYYMMDD: Patrullar ediciones a partir de una fecha específica. Ejemplo:
* -namespace:X: Limitar el patrullaje a un espacio de nombres específico. Ejemplo:
Cada uno de estos parámetros permite una personalización más fina del script, ajustándose a las necesidades de los usuarios avanzados.

## Resolución de problemas comunes

A continuación, se presentan algunos problemas que podrías enfrentar al usar el script y sus posibles soluciones:
* Error de autenticación: Asegúrate de haber ejecutado python pwb.py login antes de usar el script.
* Permisos insuficientes: Verifica que tu cuenta tiene permisos de patrullaje en el proyecto Wikimedia.
* El script no patrulla ninguna edición: Esto puede suceder si no hay ediciones pendientes de patrullaje. Intenta ejecutar el script en un momento posterior.

## Discusión y reflexión

En un entorno colaborativo, discute las siguientes preguntas con otros usuarios:
* ¿En qué contextos resulta más eficiente el patrullaje automatizado frente al manual?
* ¿Qué desafíos encontraste al personalizar el script con parámetros avanzados?
* ¿Consideras que este tipo de automatización puede tener implicaciones en la calidad del contenido revisado? ¿Por qué?
Estas preguntas fomentan la reflexión sobre el uso responsable de las herramientas automatizadas en la edición colaborativa.

## Conclusión

El script patrol.py de Pywikibot es una herramienta potente para facilitar el patrullaje de ediciones en proyectos Wikimedia. Su capacidad de automatizar este proceso reduce significativamente el tiempo dedicado a la revisión manual, sin comprometer la calidad. En este artículo, has aprendido a usar el script, desde su configuración básica hasta el uso de parámetros avanzados, y cómo resolver problemas comunes.

### Recursos adicionales

* Documentación oficial de Pywikibot
* Guía de uso de la API de MediaWiki