Now deprecated and is no longer supported. Most useful functionality has now been integrated into Open Library itself, or openlibrary-client.

This (was) an experimental extension of the openlibrary-client, and some of its features have been moved back into the parent client as they proved successful.

Usage:

from catharbot import catharbot
bot = catharbot.CatharBot()

gives you a bot that is a sub-class of the olclient OpenLibrary which can do everything the parent can do, and more!

edition = bot.load_doc("OL12345M")

Loads JSON representation of an OpenLibrary document (Author, Work, or Edition) by ID.

The fields can then be read and manipulated.

edition['title'] = "Changed Title"

To save the edition back to Open Library:

bot.save_one(edition, "Some comment describing the changes")

Multiple documents can be saved in one commit by passing a list to

bot.save_many([e1, e2, w1, a1, a2, ... etc], "Comment for all the changes")

This bot has some functions that perform changes in one step, use with caution!

use with caution! Performs a simplistic merge, assuming all data on duplicates has already been transferred to the target master :

bot.merge_editions(["OL...1M, "OL...2M", "OL...3M"], "OL<master>M")

This takes a list of edition OLIDs and converts them into redirects pointing the master edition.

use with caution! Performs a simplistic merge, assuming all data on duplicates has already been transferred to the target master:

bot.merge_works(["OL...1W, "OL...2W", "OL...3W"], "OL<master>W")

This collects all editions of the duplicate works, and changes their work key to point to the master work, then converts the duplicate works to redirects to the master.

use with caution! This does not check for external references and could leave things broken -- only use when absolutely sure the records should go. Redirects are always preferred when relevant.

bot.delete_list(["OL...1M, "OL...2M", "OL...3M"], "Comment explaining reason for deletion")

Catharbot (deprecated) Copyright © 2017-2020 Charles Horn.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.