Manual de usuario de calibre, Publicación 2.73.0
Devuelve Una lista de tres elementos con el espacio libre en bytes de( 1, 2, 3). Si un dispositivo concreto no tiene alguna de estas ubicaciones, debe devolver-1.
books( oncard = None, end _ session = True) Devuelve una lista de los libros electrónicos en el dispositivo.
Parámetros oncard – Si es‘ carda’ o‘ cardb’, devuelve una lista de los libros en la tarjeta de almacenamiento especificada, en caso contrario devuelve una lista de los libros en la memoria principal del dispositivo. Si se especifica una tarjeta y no hay libros en ella, devuelva una lista vacía.
Devuelve Un objeto BookList.
upload _ books( files, names, on _ card = None, end _ session = True, metadata = None) Copia una lista de libros al dispositivo. Si un archivo ya existe en el dispositivio, deberá ser sustituido. Este método debería generar un error FreeSpaceError si no hay suficiente espacio libre en el dispositivo. El texto del error FreeSpaceError debe contener la palabra « card » si‘‘ on _ card‘ no es None, si no, debe contener la palabra « memory ».
Parámetros files – Una lista de rutas
names – Una lista de nombres de archivo que los libros deberán tener una vez copiados al dispositivo. len( names) == len( files)
metadata – Si no es None, es una lista de objetos Metadata. La idea es utilizar los metadatos para determinar dónde poner el libro en el dispositivo. len( metadata) == len( files). Aparte de la portada normal( ruta a la portada), también puede haber un atributo de miniatura( thumbnail), que debería tener prioridad. El atributo thumbnail es de la forma( anchura, altura, datos _ de _ portada como jpeg).
Devuelve Una lista de tuplas de 3 elementos. La lista se envía a add _ books _ to _ metadata()( página 225).
classmethod add _ books _ to _ metadata( locations, metadata, booklists) Añade ubicaciones a las listas de libros. Esta función no debe comunicarse con el dispositivo.
Parámetros locations – Resultado de una llamada a L { upload _ books }
metadata – Lista de objetos Metadata, igual que para upload _ books()( página 225).
booklists – Una tupla que contiene el resultado de las llamadas a( books( oncard = None)(), books( oncard =' carda ')(),: meth‘ books( oncard =’ cardb’)‘).
delete _ books( paths, end _ session = True) Borrar libros en ubicaciones del dispositivo.
classmethod remove _ books _ from _ metadata( paths, booklists) Elimina libros de la lista de metadatos. Esta función no debe comunicarse con el dispositivo.
Parámetros paths – rutas a los libros en el dispositivo.
booklists – Una tupla que contiene el resultado de las llamadas a( books( oncard = None)(), books( oncard =' carda ')(),: meth‘ books( oncard =’ cardb’)‘).
1.10. Personalizar calibre 225