{ "info": { "author": "Jonathan Sick", "author_email": "jonathansick@mac.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: MacOS :: MacOS X", "Topic :: Scientific/Engineering :: Astronomy" ], "description": "ADS to BibDesk\n==============\n\nThis is the command line edition of ADS to BibDesk, a tool for retrieving the bibtex, abstract and PDF of an astronomical journal article published on `ADS `_ or `arXiv.org `_ and add it to your `BibDesk `_ database.\n\nADS to BibDesk is a tool for retrieving the bibtex, abstract and PDF of an astronomical journal article published on `ADS `_ or `arXiv.org `_ and adding it to your `BibDesk `_ database.\n\nADS to BibDesk comes in two flavours: an Automator Service that you can use to grab papers in any app (e.g., in Safari, or Mail), or a command line app.\n\n*Developers:* please read the `CONTRIBUTING `_ document for details on how to build the ADS to BibDesk CLI/Service from source, make changes, and submit pull requests.\n\nCommand Line Quickstart\n-----------------------\n\nADS to BibDesk can also be run directly from the command line.\nThe command line script can be installed via::\n\n python setup.py install\n\nYou may need to run the last command with `sudo`.\n\nOnce `adsbibdesk` is installed, you can call it with the same types of article tokens you can launch the Service with, e.g.,::\n\n adsbibdesk 1998ApJ...500..525S\n\nA full summary of `adsbibdesk` commands is available via::\n\n adsbibdesk --help\n\nSummary of article tokens\n-------------------------\n\n* The URL of an ADS or arXiv article page,\n* The ADS bibcode of an article (e.g. `1998ApJ...500..525S`),\n* The arXiv identifier of an article (e.g. `0911.4956`), or\n* An article DOI.\n\nOther Modes\n-----------\n\nBesides the primary mode (adding a single paper to BibDesk, ADS to BibDesk has three other modes: previewing papers, updated preprints, and ingesting PDF archives into BibDesk.\n\nPreviewing Papers\n~~~~~~~~~~~~~~~~~\n\nUse the `-o` switch to simply download and view the PDF of an article without adding it to BibDesk. E.g.,::\n\n adsbibdesk -o 1998ApJ...500..525S\n\nUpdating Preprints\n~~~~~~~~~~~~~~~~~~\n\nRun ADS to BibDesk with the `-u` switch to find and update all astro-ph preprints in your BibDesk bibliography::\n\n adsbibdesk -u\n\nTo restrict this update to a date range, you can use the `--from_date` (`-f`) and `--to_date` (`-t`) flags with dates in `MM/YY` format. For example, to update preprints published in 2012, run::\n\n adsbibdesk -u --from_date=01/12 --to_date=12/12\n\nNote that this operation can take some time since we throttle requests to ADS to be a nicer robot.\n\nPDF Ingest Mode\n~~~~~~~~~~~~~~~\n\nWith the command-line ADS to BibDesk, you can ingest a folder of PDFs that originated from ADS into BibDesk.\nThis is great for users who have amassed a literature folder, but are just starting to use BibDesk.\nThis will get you started quickly.\n\nYou need the program `pdf2json `_ to use\nthis script. The easiest way to get pdf2json and its dependencies is through\n`Homebrew `_, the Mac package manager.\nOnce homebrew is setup, simply run `brew install pdf2json`.\n\nTo run this workflow,::\n\n adsbibdesk -p my_pdf_dir/\n\nwhere `my_pdf_dir/` is a directory containing PDFs that you want to ingest.\n\nNote that this workflow relies on a DOI existing in the PDF.\nAs such, it will not identify astro-ph pre-prints, or published papers older than a few years.\nTypically the DOI is published on the first page of modern papers.\nThis method was inspired by a script by `Dr Lucy Lim `_.\n\nLicense\n-------\n\nCopyright 2014 Jonathan Sick, Rui Pereira and Dan-Foreman Mackey\n\nADS to BibDesk is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nADS to BibDesk is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with ADS to BibDesk. If not, see .", "description_content_type": null, "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://www.jonathansick.ca/adsbibdesk/", "keywords": "bibtex astronomy", "license": null, "maintainer": null, "maintainer_email": null, "name": "adsbibdesk", "package_url": "https://pypi.org/project/adsbibdesk/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/adsbibdesk/", "project_urls": { "Homepage": "http://www.jonathansick.ca/adsbibdesk/" }, "release_url": "https://pypi.org/project/adsbibdesk/3.2.0/", "requires_dist": null, "requires_python": null, "summary": "Add papers from arxiv.org or NASA/SAO ADS to your BibDesk bibliography.", "version": "3.2.0" }, "last_serial": 1089704, "releases": { "3.0.5": [ { "comment_text": "", "digests": { "md5": "932c0234d18eadf71fe068f247160a1e", "sha256": "87f8a7621bdfcb307b549859eb6091a002f993a8409320db551ae00f929a23ff" }, "downloads": -1, "filename": "adsbibdesk-3.0.5.tar.gz", "has_sig": false, "md5_digest": "932c0234d18eadf71fe068f247160a1e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16031, "upload_time": "2012-10-28T18:45:33", "url": "https://files.pythonhosted.org/packages/a7/d4/54e4c805b7d42c4f50e2b0993034adf83a54e672a1b14f126a0253934ca8/adsbibdesk-3.0.5.tar.gz" } ], "3.0.6": [ { "comment_text": "", "digests": { "md5": "a82848f02add775925b9a9cc11d43c52", "sha256": "d5742c38fb8fd395fcd7f343f137c8c3afda494d285ff2d501ac59ff5fe68f50" }, "downloads": -1, "filename": "adsbibdesk-3.0.6.tar.gz", "has_sig": false, "md5_digest": "a82848f02add775925b9a9cc11d43c52", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16602, "upload_time": "2012-10-31T02:31:09", "url": "https://files.pythonhosted.org/packages/ac/57/91a46e27a0ab8f668613b7fd8d8f85d47cffd6981b7c39278a963a71a70b/adsbibdesk-3.0.6.tar.gz" } ], "3.1": [ { "comment_text": "", "digests": { "md5": "f734899f675185cf569d82acd8705990", "sha256": "4b4d5eebb82ef64ebc173d2a803cac6f6ed6f77424257a3da6bb5b26e9bbbff8" }, "downloads": -1, "filename": "adsbibdesk-3.1.tar.gz", "has_sig": false, "md5_digest": "f734899f675185cf569d82acd8705990", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19407, "upload_time": "2013-01-16T02:40:25", "url": "https://files.pythonhosted.org/packages/e9/c1/ad3d1f1ab7b7cc70f55c6c04bcbf3eee56695068acfb1f85d47980abc096/adsbibdesk-3.1.tar.gz" } ], "3.1.1": [ { "comment_text": "", "digests": { "md5": "4f836dc1df74b364966cca727cc53488", "sha256": "ef49cbe5657961d928d3e2e039bda5cf629fd46e1abc9cb90ebea3b3e2dbe833" }, "downloads": -1, "filename": "adsbibdesk-3.1.1.tar.gz", "has_sig": false, "md5_digest": "4f836dc1df74b364966cca727cc53488", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19416, "upload_time": "2013-05-05T21:21:26", "url": "https://files.pythonhosted.org/packages/6a/b1/054ada552a951018473a426eea22ff59e181dd8a1381dd7eb4b8998732c3/adsbibdesk-3.1.1.tar.gz" } ], "3.2.0": [ { "comment_text": "", "digests": { "md5": "aaac606a41cd7bb1366cb0c797566384", "sha256": "1643516d96f43aaffcebddb5453360812f76a48bb37b16d74c778151bfb3ed24" }, "downloads": -1, "filename": "adsbibdesk-3.2.0.tar.gz", "has_sig": false, "md5_digest": "aaac606a41cd7bb1366cb0c797566384", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21031, "upload_time": "2014-05-12T16:17:53", "url": "https://files.pythonhosted.org/packages/10/13/4ca96f860dbef86559a9de70776490930be610364b8daa5b2bb0ce5d71fd/adsbibdesk-3.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "aaac606a41cd7bb1366cb0c797566384", "sha256": "1643516d96f43aaffcebddb5453360812f76a48bb37b16d74c778151bfb3ed24" }, "downloads": -1, "filename": "adsbibdesk-3.2.0.tar.gz", "has_sig": false, "md5_digest": "aaac606a41cd7bb1366cb0c797566384", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21031, "upload_time": "2014-05-12T16:17:53", "url": "https://files.pythonhosted.org/packages/10/13/4ca96f860dbef86559a9de70776490930be610364b8daa5b2bb0ce5d71fd/adsbibdesk-3.2.0.tar.gz" } ] }