{
    "info": {
        "author": "Paul-Michael Agapow",
        "author_email": "agapow@bbsrc.ac.uk",
        "bugtrack_url": null,
        "classifiers": [
            "Programming Language :: Python",
            "Topic :: Software Development :: Libraries :: Python Modules"
        ],
        "description": "Introduction\n============\n\nThis package presents a number of methods for querying webservices for\nbibliographic information, and includes two scripts for querying and renaming\nfiles by ISBN.\n\n\nInstallation\n============\n\nbiblio.webquery [#homepage]_ can be installed in a number of ways.\nsetuptools [#setuptools]_ is preferred, but a manual installation will\nsuffice.\n\nVia setuptools / easy_install\n-----------------------------\n\nFrom the commandline call::\n\n\t% easy_install biblio.webquery\n\nSuperuser privileges may be required. \n\n\nVia setup.py\n------------\n\nDownload a source tarball, unpack it and call setup.py to\ninstall::\n\n\t% tar zxvf biblio.webquery.tgz\n\t% cd biblio.webquery\n\t% python setup.py install\n\nSuperuser privileges may be required. \n\n\nUsage\n=====\n\nDepending on your platform, the scripts may be installed as ``.py`` scripts,\nor some form of executable, or both.\n\n\nqueryisbn\n---------\n\nReturn bibliographic information from webservices for supplied ISBNs.\n\n::\n\n\tqueryisbn.py [options] ISBNs ...\n\n\nwith the options:\n\n--version             show program's version number and exit\n-h, --help            show this help message and exit\n--debug               For errors, issue a full traceback instead of just a\n                      message.\n-s SERVICE, --service=SERVICE\n                      The webservice to query. Choices are xisbn (WorldCat\n                      xISBN), isbndb (ISBNdb). The default is xisbn.\n-k KEY, --key=KEY     The access key for the webservice, if one is required.\n\n\nFor example::\n\n\t% queryisbn.py 1568385048 1564145026\n\t1568385048:\n\t   title: Drop the rock : removing character defects\n\t   authors: [Bill Pittman, Todd Weber]\n\t   publisher: Hazelden\n\t   year: 1999\n\t   lang: eng\n\t1564145026:\n\t   title: Stop clutter from stealing your life : discover why you clutter and how you can stop\n\t   authors: [Mike Nelson]\n\t   publisher: New Page Books\n\t   year: 2001\n\t   lang: eng\n\t% /queryisbn.py --debug -s isbndb -k OPNH8HG2 1568385048 1564145026\n\t1568385048:\n\t   title: Drop the Rock: Removing Character Defects\n\t   authors: [Bill Pittman, Todd Weber]\n\t1564145026:\n\t   authors: [Mike Nelson]\n\n\n\nrenamebyisbn\n------------\n\nExtract an ISBN from a file name, look up the associated bibliographic\ninformation in a webservice and rename the file appropriately.\n\n::\n\n\trenamebyisbn.py [options] FILES ...\n\nwith the options:\n\n--version             show program's version number and exit\n-h, --help            show this help message and exit\n--debug               For errors, issue a full traceback instead of just a\n                      message.\n-s SERVICE, --service=SERVICE\n                      The webservice to query. Choices are xisbn (WorldCat\n                      xISBN), isbndb (ISBNdb). The default is xisbn.\n-k KEY, --key=KEY     The access key for the webservice, if one is required.\n-c CASE, --case=CASE  Case conversion of the new file name. Choices are\n                      orig, upper, lower.The default is orig.\n--leave_whitespace    Leave excess whitespace. By default, consecutive\n                      spaces in names are compacted\n--replace_whitespace=REPLACE_WHITESPACE\n                      Replace whitespace in the new name with this string.\n--strip_chars=STRIP_CHARS\n                      Remove these characters from the new name. By default\n                      this are ':!,'\".?()'.\n--overwrite           Overwrite existing files.\n--dryrun              Check function and without renaming files.\n--template=TEMPLATE   The form to use for renaming the file. The fields\n                      recognised are auth (primary authors family name),\n                      title (full title of the book), short_title\n                      (abbreviated title), isbn, year (year of publication).\n                      The default is\n                      '%(auth)s%(year)s_%(short_title)s_(isbn%(isbn)s)'.\n--unknown=UNKNOWN     Use this string if value is undefined.\n\nThe new name is generated first before the various processing options are\napplied. In order, characters are stripped from the name, excess whitespace is\ncollapsed and then the case conversion is applied. We suggest you try a dryrun\nbefore renaming any files. The file extension, if any, is removed before renaming and re-applied afterwards.\n\nFor example, working with 4 files called '0763718165.Jones Course.djvu', 'helm_0671708821 (orig).pdf', 'tutor_9780198568322.rar', 'unce.9783540237730.27380.pdf'::\n\n\t% renamebyisbn.py --dryrun books/*\n\tOriginal books/0763718165.Jones Course.djvu ...\n\t~ extracted ISBN 0763718165 ...\n\t~ found Andersen - Data structures in Java : a laboratory course\n\t~ new name Andersen2001_Data structures in Java_isbn0763718165.\n\t~ new path books/Andersen2001_Data structures in Java_isbn0763718165.djvu.\n\tOriginal books/helm_0671708821 (orig).pdf ...\n\t~ extracted ISBN 0671708821 ...\n\t~ found Helmstetter - What to say when you talk about yourself.\n\t~ new name Helmstetter1990_What to say when you talk about yourself_isbn0671708821.\n\t~ new path books/Helmstetter1990_What to say when you talk about yourself_isbn0671708821.pdf.\n\tOriginal books/tutor_9780198568322.rar ...\n\t~ extracted ISBN 9780198568322 ...\n\t~ found Skilling - Data analysis : a Bayesian tutorial ; [for scientists and engineers]\n\t~ new name Skilling2006_Data analysis_isbn9780198568322.\n\t~ new path books/Skilling2006_Data analysis_isbn9780198568322.rar.\n\tOriginal books/unce.9783540237730.27380.pdf ...\n\t~ extracted ISBN 9783540237730 ...\n\t~ found McDaniel - Uncertainty and surprise in complex systems questions on working with the unexpected\n\t~ new name McDaniel2005_Uncertainty and surprise in complex systems questions on working with the unexpected_isbn9783540237730.\n\t~ new path books/McDaniel2005_Uncertainty and surprise in complex systems questions on working with the unexpected_isbn9783540237730.pdf.\n\t\n\t% renamebyisbn.py --case lower --replace_whitespace ' ' --template '%(auth)s%(year)s_%(short_title)s_isbn%(isbn)s' books/*\n\tOriginal books/0763718165.Jones Course.djvu ...\n\t~ extracted ISBN 0763718165 ...\n\t~ found Andersen - Data structures in Java : a laboratory course\n\t~ new name andersen2001_data-structures-in-java_isbn0763718165.\n\t~ new path books/andersen2001_data-structures-in-java_isbn0763718165.djvu.\n\t~ renaming file\n\tOriginal books/helm_0671708821 (orig).pdf ...\n\t~ extracted ISBN 0671708821 ...\n\t~ found Helmstetter - What to say when you talk about yourself.\n\t~ new name helmstetter1990_what-to-say-when-you-talk-about-yourself_isbn0671708821.\n\t~ new path books/helmstetter1990_what-to-say-when-you-talk-about-yourself_isbn0671708821.pdf.\n\t~ renaming file\n\tOriginal books/tutor_9780198568322.rar ...\n\t~ extracted ISBN 9780198568322 ...\n\t~ found Skilling - Data analysis : a Bayesian tutorial ; [for scientists and engineers]\n\t~ new name skilling2006_data-analysis_isbn9780198568322.\n\t~ new path books/skilling2006_data-analysis_isbn9780198568322.rar.\n\t~ renaming file\n\tOriginal books/unce.9783540237730.27380.pdf ...\n\t~ extracted ISBN 9783540237730 ...\n\t~ found McDaniel - Uncertainty and surprise in complex systems questions on working with the unexpected\n\t~ new name mcdaniel2005_uncertainty-and-surprise-in-complex-systems-questions-on-working-with-the-unexpected_isbn9783540237730.\n\t~ new path books/mcdaniel2005_uncertainty-and-surprise-in-complex-systems-questions-on-working-with-the-unexpected_isbn9783540237730.pdf.\n\t~ renaming file\n\n\n\nDeveloper notes\n===============\n\nbiblio.webquery presents several classes that may be useful to other developers::\n\n\t* BaseWebQuery, a simple class for encapsulating queries to webservices\n\t\n\t* BaseKeyedWebQuery, ditto except allowing for access keys\n\t\n\t* XisbnQuery and IsbndbQuery, for fetching bibliographic information from\n\tWorldcat xISBN and ISBNdb services respectively\n\t\n\t* QueryThrottle, for limiting the frequency or total number of service\n\tqueries.\n\t\n\t* BibRecord, a general class for holding bibliographic information\n\t\n\t* PersonalName, a class for holding a name along functions for parsing\n\tnames into this class.\n\n\nConsult the API documentation and scripts for further information.\n\nThanos Vassilakis has posted what looks like `a very useful module\n<http://pypi.python.org/pypi/book>`__ for querying by ISBN. However it seems\nto have disappeared from its home website.\n\nThe ``biblio`` namespace is open to other developers.\n\n\nReferences\n==========\n\n.. [#homepage] `biblio.webquery homepage <http://www.agapow/net/software/biblio.webquery>`__\n\n.. [#setuptools] `Installing setuptools <http://peak.telecommunity.com/DevCenter/setuptools#installing-setuptools>`__\n\n\n\n\nHistory\n=======\n\nv0.4.3b, 2009-05-07\n-------------------\n\n* Include documentation in source distribution.\n\n\nv0.4b, 2009-05-06\n-----------------\n\n* First public release.\n\n\nv0.2, 2009-02-10\n----------------\n\n* Initial release.",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://www.agapow.net/software/biblio.webquery",
        "keywords": "web-service REST book",
        "license": "BSD",
        "maintainer": null,
        "maintainer_email": null,
        "name": "biblio.webquery",
        "package_url": "https://pypi.org/project/biblio.webquery/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/biblio.webquery/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "http://www.agapow.net/software/biblio.webquery"
        },
        "release_url": "https://pypi.org/project/biblio.webquery/0.4.3b/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Extracting bibliographic information from web services",
        "version": "0.4.3b"
    },
    "last_serial": 786837,
    "releases": {
        "0.4.3b": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "488bf2d53a67285033d89033206e0329",
                    "sha256": "78505d8452afde5cde0d21f080ca1b736751ac87640e3cc6583da34241d7d7b1"
                },
                "downloads": -1,
                "filename": "biblio.webquery-0.4.3b-py2.5.egg",
                "has_sig": false,
                "md5_digest": "488bf2d53a67285033d89033206e0329",
                "packagetype": "bdist_egg",
                "python_version": "2.5",
                "requires_python": null,
                "size": 62417,
                "upload_time": "2009-05-07T11:17:29",
                "url": "https://files.pythonhosted.org/packages/53/73/53951e0c77927e96bdd0d42a70363545133bc69c5994ab5c57ab27a43ef1/biblio.webquery-0.4.3b-py2.5.egg"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "4a48b59089007c365d4c114d4424e298",
                    "sha256": "2216f11630598de7fb3e22c1eafb8f1eff5e25472ba47e91cf07c87cf75f27cb"
                },
                "downloads": -1,
                "filename": "biblio.webquery-0.4.3b.tar.gz",
                "has_sig": false,
                "md5_digest": "4a48b59089007c365d4c114d4424e298",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 652311,
                "upload_time": "2009-05-07T11:17:30",
                "url": "https://files.pythonhosted.org/packages/66/75/0df78030d654586af94586880ce2f3918b6e721b047e347ff8ec4539e14f/biblio.webquery-0.4.3b.tar.gz"
            }
        ],
        "0.4b": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "656e2fbb7bb11cdfb30697986361cf60",
                    "sha256": "b1af7f8f5f66c908520dbbef4da87597d1cc9b58d8129dd57fe71042ce237169"
                },
                "downloads": -1,
                "filename": "biblio.webquery-0.4b-py2.5.egg",
                "has_sig": false,
                "md5_digest": "656e2fbb7bb11cdfb30697986361cf60",
                "packagetype": "bdist_egg",
                "python_version": "2.5",
                "requires_python": null,
                "size": 61584,
                "upload_time": "2009-05-06T20:50:09",
                "url": "https://files.pythonhosted.org/packages/10/fd/b8d7b04eb8bf80206b153e57e62f4877d664f40f1c918ce1df4d7159709a/biblio.webquery-0.4b-py2.5.egg"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "fc8d2ca7a7b3aa4be8d3994f61ee9a09",
                    "sha256": "54e8a40e538f5cbaa2d8826be591cfe8830a916cb56ec35139eca111f6e1f084"
                },
                "downloads": -1,
                "filename": "biblio.webquery-0.4b.tar.gz",
                "has_sig": false,
                "md5_digest": "fc8d2ca7a7b3aa4be8d3994f61ee9a09",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 21402,
                "upload_time": "2009-05-06T20:50:11",
                "url": "https://files.pythonhosted.org/packages/0c/e1/8443f68e34ccf78988f267cd2a63c39cf7d4211ccf8f6c9913b78b0a08a0/biblio.webquery-0.4b.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "488bf2d53a67285033d89033206e0329",
                "sha256": "78505d8452afde5cde0d21f080ca1b736751ac87640e3cc6583da34241d7d7b1"
            },
            "downloads": -1,
            "filename": "biblio.webquery-0.4.3b-py2.5.egg",
            "has_sig": false,
            "md5_digest": "488bf2d53a67285033d89033206e0329",
            "packagetype": "bdist_egg",
            "python_version": "2.5",
            "requires_python": null,
            "size": 62417,
            "upload_time": "2009-05-07T11:17:29",
            "url": "https://files.pythonhosted.org/packages/53/73/53951e0c77927e96bdd0d42a70363545133bc69c5994ab5c57ab27a43ef1/biblio.webquery-0.4.3b-py2.5.egg"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "4a48b59089007c365d4c114d4424e298",
                "sha256": "2216f11630598de7fb3e22c1eafb8f1eff5e25472ba47e91cf07c87cf75f27cb"
            },
            "downloads": -1,
            "filename": "biblio.webquery-0.4.3b.tar.gz",
            "has_sig": false,
            "md5_digest": "4a48b59089007c365d4c114d4424e298",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 652311,
            "upload_time": "2009-05-07T11:17:30",
            "url": "https://files.pythonhosted.org/packages/66/75/0df78030d654586af94586880ce2f3918b6e721b047e347ff8ec4539e14f/biblio.webquery-0.4.3b.tar.gz"
        }
    ]
}