Manual de usuario de calibre, Publicación 2.73.0
change _ index – Al cambiarel nombre de un campo del tipo serie cambiar también los valores de « series _ index ».
restrict _ to _ book _ ids – Un conjunto de id de libros opcional sobre los que se realiza el cambio de nombre, de manera predeterminada incluye todos los libros.
restore _ book( book _ id, mi, last _ modified, path, formats) Restaurar la entrada del libro en la base de datos de un libro que ya existe en el sistema de archivos.
restore _ original _ format( book _ id, original _ fmt) Restaurar el formato especificado a partir del ORIGINAL _ FORMAT previamente guardado, si lo hubiera. Devuelve True en caso de éxito. El ORIGINAL _ FORMAT se elimina después de una restauración correcta.
safe _ read _ lock Un bloqueo de lectura segura es un bloqueo que no hace nada si el hilo ya tiene un bloqueo de escritura, de lo contrario, agrega un bloqueo de lectura. Esto es necesario para evitar DowngradeLockErrors, lo que puede suceder cuando se actualiza la caché de búsqueda en presencia de columnas compuestas. Al actualizar la caché de búsqueda se crea un bloqueo exclusivo, pero al buscar en una columna compuesta tiene lugar la lectura de valores de campo vía ProxyMetadata, que trata de obtener un bloqueo compartido. Puede haber otras situaciones que desencadenen esto.
Esta propiedad devuelve un nuevo objeto de bloqueo en cada acceso. Este objeto de bloqueo no es recursivo( por rendimiento) y sólo debe ser utilizado en una sentencia with como with cache. safe _ read _ lock:, de lo contrario habrá problemas.
save _ original _ format( book _ id, fmt) Guardar una copia del formato especificado como ORIGINAL _ FORMAT, sustituyendo cualquier ORIGI- NAL _ FORMAT existente.
search( query, restriction = u’‘, virtual _ fields = None, book _ ids = None) Buscar en la base de datos con la consulta especificada, devolviendo un conjunto de identificadores de libros que coincidan.
Parámetros
restriction – Una restricción que se añade como Y a la consulta especificada. Tenga en cuenta que las restricciones se almacenan en caché, por lo tanto, la búsqueda de a Y b será más lenta que a con una restricción b.
virtual _ fields – Usado internamente( campos virtuales tales como « on _ device » para búsquedas).
book _ ids – Si no es None, un conjunto de identificadores de libros en los que buscar en vez de buscar en todos los libros.
set _ conversion _ options( options, fmt = u’ PIPE’) options debe ser un mapa de la forma { book _ id: opciones de conversión }
set _ cover( book _ id _ data _ map) Establecer la portada de este libro. data puede ser un objeto de tipo QImage, QPixmap, archivo o una serie de bytes. También puede ser None, en cuyo caso se elimina cualquier portada existente.
set _ field( name, book _ id _ to _ val _ map, allow _ case _ change = True, do _ path _ update = True) Establecer los valores del campo especificado por name. Devuelve el conjunto de todos los identificadores de libros afectados por el cambio.
Parámetros book _ id _ to _ val _ map – Mapa de book _ ids a los valores que se deben aplicar.
allow _ case _ change – Si es True, se cambiará el uso de mayúsculas y minúsculas de campos de tipo varios-uno o varios-varios. Por ejemplo, si un libro tiene la etiqueta « eti-
1.12. Configurar un entorno de desarrollo de calibre 293