Manual de usuario de calibre, Publicación 2.73.0
delete_custom_book_data(name, book_ids=())
Borra los datos para name. De manera predeterminada se borran todos los datos, si sólo desea borrar datos
de ciertos identificadores de libros, señálelos como una lista de identificadores de libros.
embed_metadata(book_ids, only_fmts=None, report_error=None, report_progress=None)
Actualizar metadatos en todos los formatos de los book_ids especificados a los metadatos actuales de
la base de datos.
fast_field_for(field_obj, book_id, default_value=None)
Igual que field_for, salvo que se evita la búsqueda adicional para obtener el objeto de campo
field_for(name, book_id, default_value=None)
Devuelve el valor del campo name para el libro identificado por book_id. Si no existe tal libro o no tiene
un valor definido para el campo name o no existe dicho campo, entonces devuelve default_value.
default_value no se utiliza para title, title_sort, authors, author_sort y series_index. Esto se debe a
que éstos siempre tienen valores en la base de datos. default_value se utiliza para todas las columnas
personalizadas.
El valor devuelto para los campos is_multiple es siempre una tupla, incluso cuando no se encuentran
valores (en otras palabras, default_value no tiene efecto). La excepción son los identificadores para
los que el valor devuelto es siempre un diccionario. Las tuplas devueltas son siempre en orden de enlace,
es decir, el orden en el que fueron creadas.
field_ids_for(name, book_id)
Devuelve los identificadores (como una tupla) de los valores que el campo name tiene en el libro identificado por book_id. Si no hay valores, o tal libro o tal campo, se devuelve una tupla vacía.
find_identical_books(mi, search_restriction=u’‘, book_ids=None)
Encuentra libros que contienen los autores en «mi» y tienen el mismo título (la búsqueda de título es
difusa). Véase también
format(book_id, fmt, as_file=False, as_path=False, preserve_filename=False)
Devuelve el formato de libro electrónico como una serie de bytes o None si el formato no existe, o no hay
permiso para escribir en el archivo de libro electrónico.
Parámetros
as_file – Si es True el formato de libro electrónico se devuelve como un objeto de
archivo. Tenga en cuenta que el objeto es un archivo SpooledTemporaryFile, por lo que
si lo que quiere hacer es copiar el formato a otro archivo, utilice copy_format_to()
(página 289) en su lugar para mejorar el rendimiento.
as_path – Copia el archivo de formato a un archivo temporal y devuelve la ruta de
acceso al archivo temporal.
preserve_filename – Si es True y devuelve una ruta de acceso, el nombre de archivo
es el mismo que el utilizado en la biblioteca. Tenga en cuenta que, al utilizar este método,
llamadas repetidas producen el mismo archivo temporal (que se vuelve a crear cada vez)
format_abspath(book_id, fmt)
Devuelve la ruta de acceso absoluta al archivo de libro electrónico de formato format. Casi nunca debe
usarlo, ya que rompe la filosofía multihilo de esta API. Use copy_format_to() (página 289).
Actualmente sólo se usa en calibredb list, el visor, modificar libro, compare_format con formato original,
abrir con y los catálogos (vía get_data_as_dict()).
Aparte del visor, abrir con y el editor de libros, no creo que ningún otro realice ninguna operación de
entrada o salida con el resultado de esta función.
290
Capítulo 1. Secciones