Manual de usuario de calibre, Publicación 2.73.0
OPEN_FEEDBACK_MESSAGE = None
La interfaz gráfica muestra esto como un mensaje si no es None. Útil si la apertura puede llevar mucho
tiempo
VIRTUAL_BOOK_EXTENSIONS = frozenset([])
Conjunto de extensiones que son «libros virtuales» en el dispositivo y por lo tanto no pueden visualizarse,
guardarse o añadirse a la biblioteca. Por ejemplo: frozenset(['kobo'])
VIRTUAL_BOOK_EXTENSION_MESSAGE = None
Mensaje que se mostrará al usuario para las extensiones de libro virtuales.
NUKE_COMMENTS = None
Indica si se eliminan los comentarios de la copia del libro que se envía al dispositivo. Si no es None,
debería ser un texto corto por el que se sustituirán los comentarios.
MANAGES_DEVICE_PRESENCE = False
Si es True, indica que este controlador gestiona completamente la detección de dispositivos, la desconexión, etc. Si la establece a True, debe implementar los métodos detect_managed_devices y debug_managed_device_detection. Un controlador con esta variable como True tiene la responsabilidad de
detectar dispositivos, gestionar una lista negra de dispositivos, una lista de dispositivos desconectados, etc.
calibre ejecutará periódicamente el método detect_managed_devices() y si devuleve un dispositivo detectado, calibre ejecutará call open(). open() se ejecutará cada vez que se devuelva un dispositivo, incluso si
previamente open() falló, por lo tanto el controlador debe mantener su propia lista negra de dispositivos fallidos. Análogamente, al desconectar, calibre ejecutará eject() y, suponiendo que que la siguiente ejecución
de detect_managed_devices() devuelva None, ejecutará post_yank_cleanup().
SLOW_DRIVEINFO = False
Si se establece en True, calibre ejecutará el método get_driveinfo() (página 224) una vezs cargadas
las listas de libros para obtener la información de la unidad.
ASK_TO_ALLOW_CONNECT = False
Si se establece en True, calibre preguntará al usuario si quiere administrar el dispositivo con calibre la
primera vez que se detecta. Si lo establece en True debe implementar get_device_uid() (página 226), ignore_connected_device() (página 227), get_user_blacklisted_devices()
(página 227) y set_user_blacklisted_devices() (página 227)
user_feedback_after_callback = None
Establezca esto a un diccionario de la forma {‘title’:título, ‘msg’:mensaje, ‘det_msg’:mensaje_detallado}
para que calibre muestre una ventana con un mensaje para el usuario tras ejecutar varias acciones (actualmente sólo upload_books()). Procure no mostrar demasiados mensajes al usuario. Esta variable se
comprueba después de cada acción, así que establézcala sólo cuando sea realmente necesaria.
is_usb_connected(devices_on_system, debug=False, only_presence=False)
Devuelve True, device_info si algún dispositivo gestionado por este complemento está actualmente conectado.
Parámetros devices_on_system – Lista de dispositivos conectados actualmente
detect_managed_devices(devices_on_system, force_refresh=False)
Sólo se llama si MANAGES_DEVICE_PRESENCE es True.
Buscar dispositivos que pueda gestionar este controlador. Debe devolver un objeto de dispositivo si se
encuentra algún dispositivo. Este objeto se pasará al método open() como connected_device. Si no se
encuentra ningún dispositivo, devuelve None. El objeto devuelto puede ser cualquier cosa, calibre no lo
usa, sólo lo pasa a open().
Este método se ejecuta periódicamente por la interfaz gráfica, así que asegúrese de que no requiere demasiados recursos. Use un caché para evitar buscar en el sistema una y otra vez.
Parámetros
222
Capítulo 1. Secciones