# Pywikibot/imagetransfer.py

El script imagetransfer.py de Pywikibot es una herramienta que facilita la transferencia de archivos multimedia de un proyecto Wikimedia a otro. Esto es especialmente útil cuando se desea mover imágenes desde un proyecto local (por ejemplo, una Wikipedia en particular) a Wikimedia Commons, asegurando así que los archivos estén disponibles para todos los proyectos Wikimedia.
Este script es beneficioso para usuarios que deseen simplificar el proceso de copia de archivos entre proyectos, preservando la información relevante de las licencias y las descripciones. Además, automatiza la tarea, evitando la necesidad de realizar transferencias manuales que pueden ser tediosas y propensas a errores.

## Sección teórica

El script imagetransfer.py funciona conectándose a dos wikis: la wiki de origen, donde reside el archivo, y la wiki de destino, donde se transferirá el archivo. Utiliza la API de Wikimedia para acceder a los archivos, copiarlos y luego subirlos a la wiki de destino. Durante este proceso, se conservan los metadatos, incluyendo las descripciones y licencias.
Internamente, Pywikibot maneja las solicitudes HTTP necesarias y asegura que los archivos sean subidos con las licencias adecuadas, realizando verificaciones automáticas para evitar problemas comunes como duplicados.

## Requisitos previos

Antes de utilizar el script imagetransfer.py, es necesario cumplir con los siguientes requisitos:
* Configuración de Pywikibot: Pywikibot debe estar correctamente configurado con acceso a ambos proyectos (origen y destino). Esto incluye haber configurado los archivos user-config.py y user-password.py.
* Autenticación en Wikimedia: Necesitarás estar autenticado en ambos proyectos con permisos suficientes para cargar archivos (por ejemplo, una cuenta con permisos de autoconfirmado).
* Conexión estable a Internet: Como el script realiza operaciones de subida y descarga, es importante contar con una conexión fiable.
* Acceso a Wikimedia Commons: La wiki de destino suele ser Wikimedia Commons, por lo que es recomendable tener una cuenta en este proyecto y estar familiarizado con las políticas de licenciamiento de archivos.

## Guía paso a paso

A continuación, se describe cómo utilizar el script imagetransfer.py para transferir una imagen de un proyecto local a Wikimedia Commons.

### Ejecutando el script

* Abre la terminal o línea de comandos.
* Navega hasta el directorio donde se encuentra tu instalación de Pywikibot.
* Ejecuta el siguiente comando básico para transferir una imagen:
Este comando transfiere el archivo llamado «Nombre del archivo» desde la wiki configurada como origen a Wikimedia Commons.

### Ejemplo práctico

Supongamos que queremos transferir una imagen llamada mi_foto.jpg desde una Wikipedia local a Wikimedia Commons. El comando sería:
Este comando moverá el archivo y preservará la descripción y los metadatos de la página del archivo original.

## Ejercicio práctico
### Desafío

Transfiere una imagen de prueba desde un proyecto local de Wikipedia a Wikimedia Commons. Elige un archivo con una licencia libre y asegúrate de que cumpla con las políticas de Commons.

### Instrucciones

* Selecciona una imagen de una Wikipedia local (que tenga una licencia adecuada).
* Usa el script imagetransfer.py para transferir la imagen a Wikimedia Commons.
* Revisa la página del archivo en Commons para confirmar que se ha transferido correctamente con todos los metadatos preservados.

### Preguntas para reflexionar

* ¿Qué pasos adicionales fueron necesarios para cumplir con las políticas de Commons?
* ¿Se conservó toda la información de licencia y descripción adecuadamente?
* ¿Qué mejoras implementarías en el proceso de transferencia?

## Opciones avanzadas y parámetros

El script imagetransfer.py incluye varios parámetros avanzados que permiten personalizar el proceso de transferencia. A continuación se describen algunas opciones útiles:
* --target-lang: Especifica la wiki de destino, en caso de que no sea Wikimedia Commons. Ejemplo:
* --keep-name: Mantiene el nombre del archivo en el proyecto de destino. Si no se utiliza este parámetro, se puede pedir al usuario que especifique un nuevo nombre para evitar conflictos.
* --ignorewarnings: Ignora advertencias sobre conflictos de nombres o problemas de licencias, útil para automatizar procesos en los que las advertencias no son críticas.

## Resolución de problemas comunes

Al utilizar el script, los usuarios pueden encontrarse con algunos problemas frecuentes. Aquí algunos ejemplos y sus soluciones:
* Problema de permisos: Si recibes un error de permisos, asegúrate de estar autenticado en ambos proyectos y de tener los permisos necesarios para subir archivos en el proyecto de destino.
* Conflictos de nombre de archivo: Si el archivo ya existe en Commons con el mismo nombre, el script te pedirá que cambies el nombre o puedes usar el parámetro --keep-name.
* Problemas de licencia: Asegúrate de que el archivo tenga una licencia compatible con Wikimedia Commons. De lo contrario, la transferencia fallará.

## Discusión y reflexión

* ¿En qué casos crees que este script es más útil?
* ¿Cuáles son las dificultades más comunes que has enfrentado al transferir archivos entre wikis?
* ¿Cómo podrías mejorar el proceso de transferencia de archivos para hacerlo más eficiente o confiable?
Estas preguntas son útiles para iniciar una discusión en grupo o reflexionar sobre cómo mejorar el uso de este script.

## Conclusión

El script imagetransfer.py es una herramienta poderosa para automatizar la transferencia de archivos entre proyectos Wikimedia, particularmente hacia Commons. Con un entendimiento básico de sus parámetros y opciones, los usuarios pueden simplificar enormemente este proceso, evitando errores manuales y ahorrando tiempo.

### Recursos adicionales

* Documentación oficial de Pywikibot
* Política de licencias de Wikimedia Commons
* Cómo obtener ayuda para Pywikibot