omnischolar / openlibrary

1.x-dev 2026-10-03 16:42 UTC

Requires

• php: >=8.2
• glitchr/omnischolar: ^1.0@dev
• symfony/http-client: ^6.4|^7.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^11.0

LGPL-3.0-or-later

• Marco Meyer

• ISBN
• books
• openlibrary
• publications
• scholarly
• covers
• omnischolar

Published on Packagist.org on 2026-10-03 16:46 UTC

README

Open Library for glitchr/omnischolar: an author's books, one record per edition - its ISBNs, publisher, date, cover - for the Merger to group the editions of each book; a book by ISBN or Open Library id; a search; an author's page. No key.

$openlibrary = (new OpenLibrarySourceFactory($http))->create(['mailto' => '[e-mail]']);
$editions = $openlibrary->works('Monica Neagoy');         // every spelling of the name, every edition
$books = (new Merger())->merge($editions);                 // Planting the Seeds of Algebra PreK-2: one book, two editions
$openlibrary->work('9781452279701');

omnischolar:
    sources:
        openlibrary:
            factory: openlibrary
            options:
                mailto: '[e-mail]'   # in the User-Agent, as Open Library asks
                editions: true                 # false: one record per work
                throttle: 0.4                  # seconds between two calls

See docs/.

License: LGPL-3.0-or-later.