Manual de usuario de calibre, Publicación 2.73.0
set_option(opt_string, opt_value)
Fija el valor de la opción indicada en opt_string. Este método puede ser llamado cuando el plugin no se ha
llamado.
Este método puede ser llamado en el hilo de la GUI. Un conductor que implemente este método debe estar
de hilo seguro.
is_running()
Devuelve True si el complemento está iniciado, de lo contrario False.
Este método puede ser llamado en el hilo de la GUI. Un conductor que implemente este método debe estar
de hilo seguro.
synchronize_with_db(db, book_id, book_metadata, first_call)
Se ejecuta durante el emparejamiento de libros, cuando cada libro del dispositivo se empareja con un libro
en la base de datos de calibre. El método tiene por cometido sincronizar los datos del dispositivo con la
base de datos de calibre (si es necesario).
Este método debe devolver una tupla de dos valores. El primer valor es un conjunto de identificadores de
libro de calibre modificados si se modificó la base de datos de calibre, o None si la base de datos no se
modificó. Si el primer valor es un conjunto vacío, los metadatos del libro en el dispositivo se actualizan con
los metadatos de calibre y se vuelven a mandar al dispositivo, pero no se actualiza la interfaz gráfica para
ese libro. Esto es útil cuando los metadatos de calibre son correctos, pero deben enviarse al dispositivo.
El segundo valor es un valor tuple 2. El primer valor del tuple especifica si un formato de libro debería de
ser enviado al dispositivo. El propósito es permitir verificar que el libro del dispositivo es el mismo que el
de Calibre. Este valor debe ser None si no se ha enviado ningún libro, de otro modo devuelve el nombre del
archivo base del dispositivo (un hilo como foobar.epub). Asegúrese de incluir la extensión en el nombre. El
subsistema del dispositivo creará un trabajo send_books para todos los libros sin valores None devueltos.
Nota: otro que recupere los datos de la extensión más tarde, el nombre es pasado por alto en los casos en
los que el dispositivo utilice una plantilla para generar el nombre de archivo, el que hace más. el segundo
valor del tuple devuelto indica si el formato está fechado en el futuro. Devuelve True si lo está, de otro
modo devuelve False. Calibre mostrará un diálogo al usuario enumerando todos los libros datados en el
futuro.
Extremadamente importante: este método es llamado en el hilo de la GUI. Debe de estar seguro con
respecto al hilo del gerente del dispositivo.
book_id: la ID de Calibre para el libro en la base de datos. book_metadata: El objeto de metadata para el libro que viene desde el dispositivo. first_call: True si esta es es la primera llamada durante la sincronización,
False si es de otro modo
class calibre.devices.interface.BookList(oncard, prefix, settings)
Clases base: list
Una lista de libros. Cada objeto Book debe tener los campos
1.título
2.autores
3.tamaño (tamaño del archivo del libro)
4.tiempo (tupla de tiempo UTC)
5.path (ruta de acceso del libro en el dispositivo)
6.miniatura (puede ser None) la miniatura es cualquier objeto str/bytes con los datos de imagen o debería
tener un atributo image_path que almacena un completo camino (plataforma nativa) a la imagen
7.tags (una lista de textos, puede estar vacía).
228
Capítulo 1. Secciones