Manual de usuario de calibre, Publicación 2.73.0
sync_booklists(booklists, end_session=True)
Actualizar metadatos del dispositivo.
Parámetros booklists – Una tupla que contiene el resultado de las llamadas
a
(books(oncard=None)(),
books(oncard='carda')(),
:meth‘books(oncard=’cardb’)‘).
get_file(path, outfile, end_session=True)
Lee el archivo en path en el dispositivo y lo escribe en outfile.
Parámetros outfile – objeto de archivo como sys.stdout o el resultado de ejecutar
open() (página 223).
classmethod config_widget()
Debe devolver un QWidget. El QWidget contiene las configuraciones de la interfaz de dispositivo.
classmethod save_settings(settings_widget)
Debe guardar las configuraciones en el disco. Toma el widget creado en config_widget() (página 226) y guarda todas las configuraciones en el disco.
classmethod settings()
Debe devolver un objeto opts. El objeto opts debería tener al menos un atributo format_map que es una
lista ordenada de formatos para el dispositivo.
set_plugboards(plugboards, pb_func)
Proporciona al controlador el conjunto actual de paneles de conexiones y una función para seleccionar un panel de conexión específico. Este método se ejecuta inmediatamente antes de add_books y
sync_booklists.
pb_func es un metodo ejecutable con la siguiente firma: def pb_func(device_name, format, plugboards)
Le da el nombre del dispositivo actual (ya sea el nombre de la clase o DEVICE_PLUGBOARD_NAME),
el formato en que está interesado (un formato «real» o ‘device_db‘), y los paneles de conexiones (suministrados por set_plugboards, en el mismo lugar de donde se obtuvo este método).
Devuelve None o un único panel de conexiones.
set_driveinfo_name(location_code, name)
Establece el nombre de dispositivo en el archivo driveinfo como name. Este ajuste persistirá hasta que el
archivo se vuelva a crear o se cambie el nombre de nuevo.
Los dispositivos que no son de disco deberían implementar este método según los códigos de ubicación
devueltos por el método get_device_information().
prepare_addable_books(paths)
Dada una lista de rutas de acceso, devuelve otra lista de rutas de acceso. Estas rutas apuntan a versiones de
los libros que pueden añadirse.
Si ocurre un error al preparar un libro, en lugar de una ruta de acceso, la posición en la lista devuelta para
ese libro debería de ser una tupla de tres elementos: (ruta_original, la excepción, rastro)
startup()
Se ejecuta cuando calibre inicia el dispositivo. Realiza cualquier inicialización necesaria. Tenga en cuenta
que pueden generarse varios especímenes de la clase, y por lo tanto __init__() puede ejecutarse varias
veces, pero sólo un espécimen ejecutará este método. Este método se ejecuta en el hilo del dispositivo, no
en el de la interfaz gráfica.
shutdown()
Llamado cuando Calibre se está cerrando, ya sea definitivamente o preparándose para reiniciarse. Cumple
cualquier limpieza requerida. Este método es llamado en el hilo del dispositivo, no en el de la GUI.
226
Capítulo 1. Secciones