[Editor Plugin] epubveri library

[Kayadelenium]

epubveri library checks every book in your calibre library and tells you what is actually wrong with it.

https://github.com/veripublica/epubv...library-v0.1.0

Why it exists, next to the epubveri Edit Book plugin. That one validates the book you have open, and it is very good at that — but it can only tell you about a book you already decided to open. If you have three thousand books, the question you actually have is which ones. Nobody opens three thousand books to find out. This plugin answers that question, and hands the answer to the other plugin.

What you get. Not a list of broken books — a list of defects, each with the number of books carrying it, most widespread first. The shape of it, sketched (your library's rows and numbers will be its own):

MESSAGE   WHAT IT SAYS                              BOOKS   FINDINGS
RSC-005   element "…" is not allowed here             ...        ...
OPF-003   resource is not declared in the manifest    ...        ...
RSC-007   referenced resource is missing              ...        ...

That shape is the point. A library does not have four hundred unrelated problems; it has a handful of producer defects repeated across hundreds of books. Understand one row and you have understood a hundred books — and if a row is something epubsana can repair, you have a batch job rather than an afternoon.

Then the two plugins join up. Click a row, and calibre's own book list filters to exactly the books that defect is in. Open one in Edit Book and the epubveri plugin puts you on the line. Which → what → fixed.

It is fast enough that this is worth doing at all. About 0.2 seconds a book — roughly ten minutes for three thousand, as a background job you can keep working through, and cancelling still shows you what it found. When I timed the two, epubcheck came out around eleven times slower on the same books, and its command line takes one file per run: the same library is an afternoon.

The difference between the two plugins, in full, since they now sit next to each other in the plugin list under the same name:

                    epubveri                  epubveri library
                    (Edit Book)               (main window)

opens from          Edit Book's toolbar       the calibre toolbar
checks              the book you have open    every book in the library,
                                              or just the ones you select
reads               the book as the editor    the .epub file as it sits
                    holds it, unsaved         on disk
                    changes included
answers             WHAT is wrong             WHICH books have a problem
shows               every finding, in place,  one row per defect, ordered
                    with line and column      by how many books carry it
takes               under a second            about 0.2 s a book
clicking a row      jumps the cursor to it    filters the book list to the
                                              books that row affects

Same validator underneath, same findings, same message ids. Two questions, two answers.

Nothing is bundled and nothing is trusted blindly. The plugin ships no binary: on first use it fetches the epubveri build for your platform from epubveri's own releases and verifies it against that release's published checksums before extracting anything, then re-checks it before every scan. A SHA256SUMS.txt sits beside the plugin zip too, if you want to check what you downloaded.

Installing — it is not in calibre's plugin index yet, so: download the zip, Preferences → Plugins → Load plugin from file, restart calibre. If no button appears, add it under Preferences → Toolbars & menus.

Worth knowing before you try it: it reads the EPUB format only; errors and warnings are ranked while usage notes and epubveri's advisory findings wait behind a checkbox that re-sorts rather than re-scans; and it has run on calibre 9.14 on macOS and nowhere else so far.

If you find anywhere it disagrees with epubcheck, that is the most useful thing you can send me — every real defect these plugins have had arrived that way.