Debian Codegraph @

translations/manual/tt/db_api.po

raw
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) Kovid Goyal
3 # This file is distributed under the same license as the calibre package.
4 #
5 # Translators:
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: calibre\n"
9 "Report-Msgid-Bugs-To: \n"
10 "POT-Creation-Date: 2021-12-01 12:56+0000\n"
11 "PO-Revision-Date: 2021-11-23 15:49+0000\n"
12 "Last-Translator: Kovid Goyal <[email protected]>\n"
13 "Language-Team: Tatar (http://www.transifex.com/calibre/calibre/language/tt/)\n"
14 "MIME-Version: 1.0\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
17 "Language: tt\n"
18 "Plural-Forms: nplurals=1; plural=0;\n"
19
20 #: ../../__w/calibre/calibre/manual/db_api.rst:4
21 msgid "API documentation for the database interface"
22 msgstr ""
23
24 #: ../../__w/calibre/calibre/manual/db_api.rst:9
25 msgid ""
26 "This API is thread safe (it uses a multiple reader, single writer locking "
27 "scheme). You can access this API like this::"
28 msgstr ""
29
30 #: ../../__w/calibre/calibre/manual/db_api.rst:14
31 msgid ""
32 "If you are in a calibre plugin that is part of the main calibre GUI, you get"
33 " access to it like this instead::"
34 msgstr ""
35
36 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
37 #: calibre.db.cache.Cache:1
38 msgid ""
39 "An in-memory cache of the metadata.db file from a calibre library. This "
40 "class also serves as a threadsafe API for accessing the database. The in-"
41 "memory cache is maintained in normal form for maximum performance."
42 msgstr ""
43
44 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
45 #: calibre.db.cache.Cache:5
46 msgid ""
47 "SQLITE is simply used as a way to read and write from metadata.db robustly. "
48 "All table reading/sorting/searching/caching logic is re-implemented. This "
49 "was necessary for maximum performance and flexibility."
50 msgstr ""
51
52 #: ../../__w/calibre/calibre/src/calibre/db/listeners.pydocstring of
53 #: calibre.db.listeners.EventType:1
54 msgid "An enumeration."
55 msgstr ""
56
57 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
58 #: calibre.db.cache.Cache.add_books:1
59 msgid ""
60 "Add the specified books to the library. Books should be an iterable of "
61 "2-tuples, each 2-tuple of the form :code:`(mi, format_map)` where mi is a "
62 "Metadata object and format_map is a dictionary of the form :code:`{fmt: "
63 "path_or_stream}`, for example: :code:`{'EPUB': '/path/to/file.epub'}`."
64 msgstr ""
65
66 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
67 #: calibre.db.cache.Cache.add_books:6
68 msgid ""
69 "Returns a pair of lists: :code:`ids, duplicates`. ``ids`` contains the book "
70 "ids for all newly created books in the database. ``duplicates`` contains the"
71 " :code:`(mi, format_map)` for all books that already exist in the database "
72 "as per the simple duplicate detection heuristic used by :meth:`has_book`."
73 msgstr ""
74
75 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
76 #: calibre.db.cache.Cache.add_custom_book_data:1
77 msgid ""
78 "Add data for name where val_map is a map of book_ids to values. If "
79 "delete_first is True, all previously stored data for name will be removed."
80 msgstr ""
81
82 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
83 #: calibre.db.cache.Cache.add_format:1
84 msgid ""
85 "Add a format to the specified book. Return True if the format was added "
86 "successfully."
87 msgstr ""
88
89 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
90 #: calibre.db.cache.Cache.add_format:0
91 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
92 #: calibre.db.cache.Cache.cover:0
93 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
94 #: calibre.db.cache.Cache.format:0
95 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
96 #: calibre.db.cache.Cache.format_metadata:0
97 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
98 #: calibre.db.cache.Cache.get_next_series_num_for:0
99 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
100 #: calibre.db.cache.Cache.remove_formats:0
101 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
102 #: calibre.db.cache.Cache.rename_items:0
103 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
104 #: calibre.db.cache.Cache.search:0
105 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
106 #: calibre.db.cache.Cache.set_field:0
107 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
108 #: calibre.db.cache.Cache.tags_older_than:0
109 msgid "Parameters"
110 msgstr ""
111
112 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
113 #: calibre.db.cache.Cache.add_format:3
114 msgid ""
115 "If True replace existing format, otherwise if the format already exists, "
116 "return False."
117 msgstr ""
118
119 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
120 #: calibre.db.cache.Cache.add_format:4
121 msgid ""
122 "If True, file type plugins are run on the format before and after being "
123 "added."
124 msgstr ""
125
126 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
127 #: calibre.db.cache.Cache.add_format:5
128 msgid "Internal use only."
129 msgstr ""
130
131 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
132 #: calibre.db.cache.Cache.add_listener:1
133 msgid ""
134 "Register a callback function that will be called after certain actions are "
135 "taken on this database. The function must take three arguments: "
136 "(:class:`EventType`, library_id, event_type_specific_data)"
137 msgstr ""
138
139 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
140 #: calibre.db.cache.Cache.all_book_ids:1
141 msgid "Frozen set of all known book ids."
142 msgstr ""
143
144 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
145 #: calibre.db.cache.Cache.all_field_for:1
146 msgid "Same as field_for, except that it operates on multiple books at once"
147 msgstr ""
148
149 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
150 #: calibre.db.cache.Cache.all_field_ids:1
151 msgid "Frozen set of ids for all values in the field ``name``."
152 msgstr ""
153
154 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
155 #: calibre.db.cache.Cache.all_field_names:1
156 msgid ""
157 "Frozen set of all fields names (should only be used for many-one and many-"
158 "many fields)"
159 msgstr ""
160
161 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
162 #: calibre.db.cache.Cache.author_data:1
163 msgid "Return author data as a dictionary with keys: name, sort, link"
164 msgstr ""
165
166 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
167 #: calibre.db.cache.Cache.author_data:3
168 msgid ""
169 "If no authors with the specified ids are found an empty dictionary is "
170 "returned. If author_ids is None, data for all authors is returned."
171 msgstr ""
172
173 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
174 #: calibre.db.cache.Cache.author_sort_from_authors:1
175 msgid ""
176 "Given a list of authors, return the author_sort string for the authors, "
177 "preferring the author sort associated with the author over the computed "
178 "string."
179 msgstr ""
180
181 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
182 #: calibre.db.cache.Cache.books_for_field:1
183 msgid ""
184 "Return all the books associated with the item identified by ``item_id``, "
185 "where the item belongs to the field ``name``."
186 msgstr ""
187
188 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
189 #: calibre.db.cache.Cache.books_for_field:4
190 msgid ""
191 "Returned value is a set of book ids, or the empty set if the item or the "
192 "field does not exist."
193 msgstr ""
194
195 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
196 #: calibre.db.cache.Cache.books_in_virtual_library:1
197 msgid "Return the set of books in the specified virtual library"
198 msgstr ""
199
200 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
201 #: calibre.db.cache.Cache.compress_covers:1
202 msgid ""
203 "Compress the cover images for the specified books. A compression quality of "
204 "100 will perform lossless compression, otherwise lossy compression."
205 msgstr ""
206
207 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
208 #: calibre.db.cache.Cache.compress_covers:4
209 msgid ""
210 "The progress callback will be called with the book_id and the old and new "
211 "sizes for each book that has been processed. If an error occurs, the new "
212 "size will be a string with the error details."
213 msgstr ""
214
215 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
216 #: calibre.db.cache.Cache.copy_cover_to:1
217 msgid ""
218 "Copy the cover to the file like object ``dest``. Returns False if no cover "
219 "exists or dest is the same file as the current cover. dest can also be a "
220 "path in which case the cover is copied to it if and only if the path is "
221 "different from the current path (taking case sensitivity into account)."
222 msgstr ""
223
224 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
225 #: calibre.db.cache.Cache.copy_format_to:1
226 msgid ""
227 "Copy the format ``fmt`` to the file like object ``dest``. If the specified "
228 "format does not exist, raises :class:`NoSuchFormat` error. dest can also be "
229 "a path (to a file), in which case the format is copied to it, iff the path "
230 "is different from the current path (taking case sensitivity into account)."
231 msgstr ""
232
233 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
234 #: calibre.db.cache.Cache.cover:1
235 msgid ""
236 "Return the cover image or None. By default, returns the cover as a "
237 "bytestring."
238 msgstr ""
239
240 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
241 #: calibre.db.cache.Cache.cover:4
242 msgid ""
243 "WARNING: Using as_path will copy the cover to a temp file and return the "
244 "path to the temp file. You should delete the temp file when you are done "
245 "with it."
246 msgstr ""
247
248 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
249 #: calibre.db.cache.Cache.cover:8
250 msgid ""
251 "If True return the image as an open file object (a SpooledTemporaryFile)"
252 msgstr ""
253
254 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
255 #: calibre.db.cache.Cache.cover:9
256 msgid "If True return the image as a QImage object"
257 msgstr ""
258
259 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
260 #: calibre.db.cache.Cache.cover:10
261 msgid "If True return the image as a path pointing to a temporary file"
262 msgstr ""
263
264 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
265 #: calibre.db.cache.Cache.data_for_find_identical_books:1
266 msgid ""
267 "Return data that can be used to implement :meth:`find_identical_books` in a "
268 "worker process without access to the db. See db.utils for an implementation."
269 msgstr ""
270
271 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
272 #: calibre.db.cache.Cache.data_for_has_book:1
273 msgid ""
274 "Return data suitable for use in :meth:`has_book`. This can be used for an "
275 "implementation of :meth:`has_book` in a worker process without access to the"
276 " db."
277 msgstr ""
278
279 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
280 #: calibre.db.cache.Cache.delete_custom_book_data:1
281 msgid ""
282 "Delete data for name. By default deletes all data, if you only want to "
283 "delete data for some book ids, pass in a list of book ids."
284 msgstr ""
285
286 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
287 #: calibre.db.cache.Cache.embed_metadata:1
288 msgid ""
289 "Update metadata in all formats of the specified book_ids to current metadata"
290 " in the database."
291 msgstr ""
292
293 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
294 #: calibre.db.cache.Cache.fast_field_for:1
295 msgid ""
296 "Same as field_for, except that it avoids the extra lookup to get the field "
297 "object"
298 msgstr ""
299
300 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
301 #: calibre.db.cache.Cache.field_for:1
302 msgid ""
303 "Return the value of the field ``name`` for the book identified by "
304 "``book_id``. If no such book exists or it has no defined value for the field"
305 " ``name`` or no such field exists, then ``default_value`` is returned."
306 msgstr ""
307
308 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
309 #: calibre.db.cache.Cache.field_for:6
310 msgid ""
311 "``default_value`` is not used for title, title_sort, authors, author_sort "
312 "and series_index. This is because these always have values in the db. "
313 "``default_value`` is used for all custom columns."
314 msgstr ""
315
316 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
317 #: calibre.db.cache.Cache.field_for:10
318 msgid ""
319 "The returned value for is_multiple fields are always tuples, even when no "
320 "values are found (in other words, default_value is ignored). The exception "
321 "is identifiers for which the returned value is always a dict. The returned "
322 "tuples are always in link order, that is, the order in which they were "
323 "created."
324 msgstr ""
325
326 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
327 #: calibre.db.cache.Cache.field_ids_for:1
328 msgid ""
329 "Return the ids (as a tuple) for the values that the field ``name`` has on "
330 "the book identified by ``book_id``. If there are no values, or no such book,"
331 " or no such field, an empty tuple is returned."
332 msgstr ""
333
334 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
335 #: calibre.db.cache.Cache.find_identical_books:1
336 msgid ""
337 "Finds books that have a superset of the authors in mi and the same title "
338 "(title is fuzzy matched). See also :meth:`data_for_find_identical_books`."
339 msgstr ""
340
341 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
342 #: calibre.db.cache.Cache.format:1
343 msgid ""
344 "Return the e-book format as a bytestring or `None` if the format doesn't "
345 "exist, or we don't have permission to write to the e-book file."
346 msgstr ""
347
348 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
349 #: calibre.db.cache.Cache.format:4
350 msgid ""
351 "If True the e-book format is returned as a file object. Note that the file "
352 "object is a SpooledTemporaryFile, so if what you want to do is copy the "
353 "format to another file, use :meth:`copy_format_to` instead for performance."
354 msgstr ""
355
356 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
357 #: calibre.db.cache.Cache.format:8
358 msgid ""
359 "Copies the format file to a temp file and returns the path to the temp file"
360 msgstr ""
361
362 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
363 #: calibre.db.cache.Cache.format:10
364 msgid ""
365 "If True and returning a path the filename is the same as that used in the "
366 "library. Note that using this means that repeated calls yield the same temp "
367 "file (which is re-created each time)"
368 msgstr ""
369
370 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
371 #: calibre.db.cache.Cache.format_abspath:1
372 msgid ""
373 "Return absolute path to the e-book file of format `format`. You should "
374 "almost never use this, as it breaks the threadsafe promise of this API. "
375 "Instead use, :meth:`copy_format_to`."
376 msgstr ""
377
378 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
379 #: calibre.db.cache.Cache.format_abspath:5
380 msgid ""
381 "Currently used only in calibredb list, the viewer, edit book, compare_format"
382 " to original format, open with, bulk metadata edit and the catalogs (via "
383 "get_data_as_dict())."
384 msgstr ""
385
386 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
387 #: calibre.db.cache.Cache.format_abspath:9
388 msgid ""
389 "Apart from the viewer, open with and edit book, I don't believe any of the "
390 "others do any file write I/O with the results of this call."
391 msgstr ""
392
393 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
394 #: calibre.db.cache.Cache.format_hash:1
395 msgid ""
396 "Return the hash of the specified format for the specified book. The kind of "
397 "hash is backend dependent, but is usually SHA-256."
398 msgstr ""
399
400 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
401 #: calibre.db.cache.Cache.format_metadata:1
402 msgid ""
403 "Return the path, size and mtime for the specified format for the specified "
404 "book. You should not use path unless you absolutely have to, since accessing"
405 " it directly breaks the threadsafe guarantees of this API. Instead use the "
406 ":meth:`copy_format_to` method."
407 msgstr ""
408
409 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
410 #: calibre.db.cache.Cache.format_metadata:6
411 msgid ""
412 "If ``True`` cached values are used, otherwise a slow filesystem access is "
413 "done. The cache values could be out of date if access was performed to the "
414 "filesystem outside of this API."
415 msgstr ""
416
417 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
418 #: calibre.db.cache.Cache.format_metadata:10
419 msgid ""
420 "If ``True`` The max_size field of the database is updated for this book."
421 msgstr ""
422
423 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
424 #: calibre.db.cache.Cache.formats:1
425 msgid ""
426 "Return tuple of all formats for the specified book. If verify_formats is "
427 "True, verifies that the files exist on disk."
428 msgstr ""
429
430 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
431 #: calibre.db.cache.Cache.get_categories:1
432 msgid "Used internally to implement the Tag Browser"
433 msgstr ""
434
435 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
436 #: calibre.db.cache.Cache.get_custom_book_data:1
437 msgid ""
438 "Get data for name. By default returns data for all book_ids, pass in a list "
439 "of book ids if you only want some data. Returns a map of book_id to values. "
440 "If a particular value could not be decoded, uses default for it."
441 msgstr ""
442
443 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
444 #: calibre.db.cache.Cache.get_id_map:1
445 msgid ""
446 "Return a mapping of id numbers to values for the specified field. The field "
447 "must be a many-one or many-many field, otherwise a ValueError is raised."
448 msgstr ""
449
450 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
451 #: calibre.db.cache.Cache.get_ids_for_custom_book_data:1
452 msgid "Return the set of book ids for which name has data."
453 msgstr ""
454
455 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
456 #: calibre.db.cache.Cache.get_item_id:1
457 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
458 #: calibre.db.cache.Cache.get_item_ids:1
459 msgid "Return the item id for item_name (case-insensitive)"
460 msgstr ""
461
462 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
463 #: calibre.db.cache.Cache.get_item_name:1
464 msgid ""
465 "Return the item name for the item specified by item_id in the specified "
466 "field. See also :meth:`get_id_map`."
467 msgstr ""
468
469 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
470 #: calibre.db.cache.Cache.get_metadata:1
471 msgid ""
472 "Return metadata for the book identified by book_id as a "
473 ":class:`calibre.ebooks.metadata.book.base.Metadata` object. Note that the "
474 "list of formats is not verified. If get_cover is True, the cover is "
475 "returned, either a path to temp file as mi.cover or if cover_as_data is True"
476 " then as mi.cover_data."
477 msgstr ""
478
479 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
480 #: calibre.db.cache.Cache.get_next_series_num_for:1
481 msgid ""
482 "Return the next series index for the specified series, taking into account "
483 "the various preferences that control next series number generation."
484 msgstr ""
485
486 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
487 #: calibre.db.cache.Cache.get_next_series_num_for:4
488 msgid "The series-like field (defaults to the builtin series column)"
489 msgstr ""
490
491 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
492 #: calibre.db.cache.Cache.get_next_series_num_for:5
493 msgid ""
494 "If True, returns a mapping of book_id to current series_index value instead."
495 msgstr ""
496
497 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
498 #: calibre.db.cache.Cache.get_proxy_metadata:1
499 msgid ""
500 "Like :meth:`get_metadata` except that it returns a ProxyMetadata object that"
501 " only reads values from the database on demand. This is much faster than "
502 "get_metadata when only a small number of fields need to be accessed from the"
503 " returned metadata object."
504 msgstr ""
505
506 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
507 #: calibre.db.cache.Cache.get_usage_count_by_id:1
508 msgid ""
509 "Return a mapping of id to usage count for all values of the specified field,"
510 " which must be a many-one or many-many field."
511 msgstr ""
512
513 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
514 #: calibre.db.cache.Cache.has_book:1
515 msgid ""
516 "Return True iff the database contains an entry with the same title as the "
517 "passed in Metadata object. The comparison is case-insensitive. See also "
518 ":meth:`data_for_has_book`."
519 msgstr ""
520
521 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
522 #: calibre.db.cache.Cache.has_format:1
523 msgid "Return True iff the format exists on disk"
524 msgstr ""
525
526 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
527 #: calibre.db.cache.Cache.has_id:1
528 msgid "Return True iff the specified book_id exists in the db"
529 msgstr ""
530
531 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
532 #: calibre.db.cache.Cache.init:1
533 msgid "Initialize this cache with data from the backend."
534 msgstr ""
535
536 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
537 #: calibre.db.cache.Cache.multisort:1
538 msgid ""
539 "Return a list of sorted book ids. If ids_to_sort is None, all book ids are "
540 "returned."
541 msgstr ""
542
543 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
544 #: calibre.db.cache.Cache.multisort:4
545 msgid ""
546 "fields must be a list of 2-tuples of the form (field_name, ascending=True or"
547 " False). The most significant field is the first 2-tuple."
548 msgstr ""
549
550 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
551 #: calibre.db.cache.Cache.pref:1
552 msgid ""
553 "Return the value for the specified preference or the value specified as "
554 "``default`` if the preference is not set."
555 msgstr ""
556
557 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
558 #: calibre.db.cache.Cache.read_backup:1
559 msgid ""
560 "Return the OPF metadata backup for the book as a bytestring or None if no "
561 "such backup exists."
562 msgstr ""
563
564 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
565 #: calibre.db.cache.Cache.remove_books:1
566 msgid ""
567 "Remove the books specified by the book_ids from the database and delete "
568 "their format files. If ``permanent`` is False, then the format files are "
569 "placed in the recycle bin."
570 msgstr ""
571
572 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
573 #: calibre.db.cache.Cache.remove_formats:1
574 msgid "Remove the specified formats from the specified books."
575 msgstr ""
576
577 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
578 #: calibre.db.cache.Cache.remove_formats:3
579 msgid "A mapping of book_id to a list of formats to be removed from the book."
580 msgstr ""
581
582 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
583 #: calibre.db.cache.Cache.remove_formats:4
584 msgid ""
585 "If True, only remove the record for the format from the db, do not delete "
586 "the actual format file from the filesystem."
587 msgstr ""
588
589 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
590 #: calibre.db.cache.Cache.remove_items:1
591 msgid ""
592 "Delete all items in the specified field with the specified ids. Returns the "
593 "set of affected book ids. ``restrict_to_book_ids`` is an optional set of "
594 "books ids. If specified the items will only be removed from those books."
595 msgstr ""
596
597 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
598 #: calibre.db.cache.Cache.rename_items:1
599 msgid ""
600 "Rename items from a many-one or many-many field such as tags or series."
601 msgstr ""
602
603 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
604 #: calibre.db.cache.Cache.rename_items:3
605 msgid ""
606 "When renaming in a series-like field also change the series_index values."
607 msgstr ""
608
609 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
610 #: calibre.db.cache.Cache.rename_items:4
611 msgid ""
612 "An optional set of book ids for which the rename is to be performed, "
613 "defaults to all books."
614 msgstr ""
615
616 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
617 #: calibre.db.cache.Cache.restore_book:1
618 msgid ""
619 "Restore the book entry in the database for a book that already exists on the"
620 " filesystem"
621 msgstr ""
622
623 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
624 #: calibre.db.cache.Cache.restore_original_format:1
625 msgid ""
626 "Restore the specified format from the previously saved ORIGINAL_FORMAT, if "
627 "any. Return True on success. The ORIGINAL_FORMAT is deleted after a "
628 "successful restore."
629 msgstr ""
630
631 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
632 #: calibre.db.cache.Cache.safe_read_lock:1
633 msgid ""
634 "A safe read lock is a lock that does nothing if the thread already has a "
635 "write lock, otherwise it acquires a read lock. This is necessary to prevent "
636 "DowngradeLockErrors, which can happen when updating the search cache in the "
637 "presence of composite columns. Updating the search cache holds an exclusive "
638 "lock, but searching a composite column involves reading field values via "
639 "ProxyMetadata which tries to get a shared lock. There may be other scenarios"
640 " that trigger this as well."
641 msgstr ""
642
643 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
644 #: calibre.db.cache.Cache.safe_read_lock:9
645 msgid ""
646 "This property returns a new lock object on every access. This lock object is"
647 " not recursive (for performance) and must only be used in a with statement "
648 "as ``with cache.safe_read_lock:`` otherwise bad things will happen."
649 msgstr ""
650
651 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
652 #: calibre.db.cache.Cache.save_original_format:1
653 msgid ""
654 "Save a copy of the specified format as ORIGINAL_FORMAT, overwriting any "
655 "existing ORIGINAL_FORMAT."
656 msgstr ""
657
658 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
659 #: calibre.db.cache.Cache.search:1
660 msgid ""
661 "Search the database for the specified query, returning a set of matched book"
662 " ids."
663 msgstr ""
664
665 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
666 #: calibre.db.cache.Cache.search:3
667 msgid ""
668 "A restriction that is ANDed to the specified query. Note that restrictions "
669 "are cached, therefore the search for a AND b will be slower than a with "
670 "restriction b."
671 msgstr ""
672
673 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
674 #: calibre.db.cache.Cache.search:6
675 msgid "Used internally (virtual fields such as on_device to search over)."
676 msgstr ""
677
678 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
679 #: calibre.db.cache.Cache.search:8
680 msgid ""
681 "If not None, a set of book ids for which books will be searched instead of "
682 "searching all books."
683 msgstr ""
684
685 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
686 #: calibre.db.cache.Cache.set_conversion_options:1
687 msgid "options must be a map of the form {book_id:conversion_options}"
688 msgstr ""
689
690 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
691 #: calibre.db.cache.Cache.set_cover:1
692 msgid ""
693 "Set the cover for this book. The data can be either a QImage, QPixmap, file "
694 "object or bytestring. It can also be None, in which case any existing cover "
695 "is removed."
696 msgstr ""
697
698 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
699 #: calibre.db.cache.Cache.set_field:1
700 msgid ""
701 "Set the values of the field specified by ``name``. Returns the set of all "
702 "book ids that were affected by the change."
703 msgstr ""
704
705 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
706 #: calibre.db.cache.Cache.set_field:3
707 msgid "Mapping of book_ids to values that should be applied."
708 msgstr ""
709
710 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
711 #: calibre.db.cache.Cache.set_field:4
712 msgid ""
713 "If True, the case of many-one or many-many fields will be changed. For "
714 "example, if a book has the tag ``tag1`` and you set the tag for another "
715 "book to ``Tag1`` then the both books will have the tag ``Tag1`` if "
716 "allow_case_change is True, otherwise they will both have the tag ``tag1``."
717 msgstr ""
718
719 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
720 #: calibre.db.cache.Cache.set_field:8
721 msgid "Used internally, you should never change it."
722 msgstr ""
723
724 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
725 #: calibre.db.cache.Cache.set_metadata:1
726 msgid "Set metadata for the book `id` from the `Metadata` object `mi`"
727 msgstr ""
728
729 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
730 #: calibre.db.cache.Cache.set_metadata:3
731 msgid ""
732 "Setting force_changes=True will force set_metadata to update fields even if "
733 "mi contains empty values. In this case, 'None' is distinguished from "
734 "'empty'. If mi.XXX is None, the XXX is not replaced, otherwise it is. The "
735 "tags, identifiers, and cover attributes are special cases. Tags and "
736 "identifiers cannot be set to None so they will always be replaced if "
737 "force_changes is true. You must ensure that mi contains the values you want "
738 "the book to have. Covers are always changed if a new cover is provided, but "
739 "are never deleted. Also note that force_changes has no effect on setting "
740 "title or authors."
741 msgstr ""
742
743 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
744 #: calibre.db.cache.Cache.set_pref:1
745 msgid ""
746 "Set the specified preference to the specified value. See also :meth:`pref`."
747 msgstr ""
748
749 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
750 #: calibre.db.cache.Cache.tags_older_than:1
751 msgid ""
752 "Return the ids of all books having the tag ``tag`` that are older than the "
753 "specified time. tag comparison is case insensitive."
754 msgstr ""
755
756 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
757 #: calibre.db.cache.Cache.tags_older_than:4
758 msgid ""
759 "A timedelta object or None. If None, then all ids with the tag are returned."
760 msgstr ""
761
762 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
763 #: calibre.db.cache.Cache.tags_older_than:7
764 msgid ""
765 "If not None the list of matches will be restricted to books that have this "
766 "tag"
767 msgstr ""
768
769 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
770 #: calibre.db.cache.Cache.tags_older_than:10
771 msgid ""
772 "A list of authors. If not None the list of matches will be restricted to "
773 "books that have these authors (case insensitive)."
774 msgstr ""
775
776 #: ../../__w/calibre/calibre/src/calibre/db/cache.pydocstring of
777 #: calibre.db.cache.Cache.user_categories_for_books:1
778 msgid ""
779 "Return the user categories for the specified books. proxy_metadata_map is "
780 "optional and is useful for a performance boost, in contexts where a "
781 "ProxyMetadata object for the books already exists. It should be a mapping of"
782 " book_ids to their corresponding ProxyMetadata objects."
783 msgstr ""