{ "info": { "author": "Maik Derstappen (MrTango)", "author_email": "md@derico.de", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License v2 (GPLv2)", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Software Development :: Build Tools" ], "description": "Pure Python RIS files parser\n============================\n\nUsage\n-----\n\n.. code:: python\n\n >>> import os\n >>> from pprint import pprint\n >>> from RISparser import readris\n >>> filepath = 'tests/example_full.ris'\n >>> with open(filepath, 'r') as bibliography_file:\n ... entries = readris(bibliography_file)\n ... for entry in entries:\n ... print(entry['id'])\n ... print(entry['first_authors'])\n 12345\n ['Marx, Karl', 'Lindgren, Astrid']\n 12345\n ['Marxus, Karlus', 'Lindgren, Astrid']\n\n\nExample RIS entry\n-----------------\n\n.. code:: text\n\n 1.\n TY - JOUR\n ID - 12345\n T1 - Title of reference\n A1 - Marx, Karl\n A1 - Lindgren, Astrid\n A2 - Glattauer, Daniel\n Y1 - 2014//\n N2 - BACKGROUND: Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. RESULTS: Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. CONCLUSIONS: Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium.\n KW - Pippi\n KW - Nordwind\n KW - Piraten\n JF - Lorem\n JA - lorem\n VL - 9\n IS - 3\n SP - e0815\n CY - United States\n PB - Fun Factory\n PB - Fun Factory USA\n SN - 1932-6208\n M1 - 1008150341\n L2 - http://example.com\n ER -\n\n\nTAG_KEY_MAPPING\n---------------\n\nThe most fields contain string values, but some like first_authors (A1) are parsed into lists.\n\nComplete list of ListType tags\n******************************\n\n.. code:: python\n\n >>> from RISparser.config import LIST_TYPE_TAGS\n >>> pprint(LIST_TYPE_TAGS)\n ('A1', 'A2', 'A3', 'A4', 'AU', 'KW', 'N1')\n\n\nComplete default mapping\n************************\n\n.. code:: python\n\n >>> from RISparser.config import TAG_KEY_MAPPING\n >>> pprint(TAG_KEY_MAPPING)\n {'A1': 'first_authors',\n 'A2': 'secondary_authors',\n 'A3': 'tertiary_authors',\n 'A4': 'subsidiary_authors',\n 'AB': 'abstract',\n 'AD': 'author_address',\n 'AN': 'accession_number',\n 'AU': 'authors',\n 'C1': 'custom1',\n 'C2': 'custom2',\n 'C3': 'custom3',\n 'C4': 'custom4',\n 'C5': 'custom5',\n 'C6': 'custom6',\n 'C7': 'custom7',\n 'C8': 'custom8',\n 'CA': 'caption',\n 'CN': 'call_number',\n 'CY': 'place_published',\n 'DA': 'date',\n 'DB': 'name_of_database',\n 'DO': 'doi',\n 'DP': 'database_provider',\n 'EP': 'end_page',\n 'ER': 'end_of_reference',\n 'ET': 'edition',\n 'ID': 'id',\n 'IS': 'number',\n 'J2': 'alternate_title1',\n 'JA': 'alternate_title2',\n 'JF': 'alternate_title3',\n 'JO': 'journal_name',\n 'KW': 'keywords',\n 'L1': 'file_attachments1',\n 'L2': 'file_attachments2',\n 'L4': 'figure',\n 'LA': 'language',\n 'LB': 'label',\n 'M1': 'note',\n 'M3': 'type_of_work',\n 'N1': 'notes',\n 'N2': 'abstract',\n 'NV': 'number_of_Volumes',\n 'OP': 'original_publication',\n 'PB': 'publisher',\n 'PY': 'year',\n 'RI': 'reviewed_item',\n 'RN': 'research_notes',\n 'RP': 'reprint_edition',\n 'SE': 'version',\n 'SN': 'issn',\n 'SP': 'start_page',\n 'ST': 'short_title',\n 'T1': 'primary_title',\n 'T2': 'secondary_title',\n 'T3': 'tertiary_title',\n 'TA': 'translated_author',\n 'TI': 'title',\n 'TT': 'translated_title',\n 'TY': 'type_of_reference',\n 'UK': 'unknown_tag',\n 'UR': 'url',\n 'VL': 'volume',\n 'Y1': 'publication_year',\n 'Y2': 'access_date'}\n\nOverride key mapping\n********************\n\nThe parser use a ``TAG_KEY_MAPPING``, which one can override by calling ``readris()`` with a custom mapping.\n\n.. code:: python\n\n >>> import os\n >>> from RISparser import readris, TAG_KEY_MAPPING\n >>> from pprint import pprint\n\n >>> filepath = 'tests/example_full.ris'\n >>> mapping = TAG_KEY_MAPPING\n >>> mapping[\"SP\"] = \"pages_this_is_my_fun\"\n >>> with open(filepath, 'r') as bibliography_file:\n ... entries = list(readris(bibliography_file, mapping=mapping))\n ... pprint(sorted(entries[0].keys()))\n ['abstract',\n 'alternate_title2',\n 'alternate_title3',\n 'file_attachments2',\n 'first_authors',\n 'id',\n 'issn',\n 'keywords',\n 'note',\n 'number',\n 'pages_this_is_my_fun',\n 'place_published',\n 'primary_title',\n 'publication_year',\n 'publisher',\n 'secondary_authors',\n 'type_of_reference',\n 'url',\n 'volume']\n\n\nTests\n-----\n\nTests are launched via the command-line using pytest_:\n\n.. _pytest: https://pypi.python.org/pypi/pytest\n\n.. code:: bash\n\n $ cd /RISparser\n $ py.test\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mrtango/RISparser", "keywords": "RIS parser bibliograph", "license": "GNU General Public License v2 (GPLv2)", "maintainer": "", "maintainer_email": "", "name": "RISparser", "package_url": "https://pypi.org/project/RISparser/", "platform": "", "project_url": "https://pypi.org/project/RISparser/", "project_urls": { "Homepage": "https://github.com/mrtango/RISparser" }, "release_url": "https://pypi.org/project/RISparser/0.4.3/", "requires_dist": null, "requires_python": "", "summary": "Reads RIS files into dictionaries via a generator for large files", "version": "0.4.3" }, "last_serial": 3753597, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "7be360b1d631640b13a197f1561fcff0", "sha256": "d0250ad6caef00e49a9c2662cd55e74a3ef9ce292fbc4a87f186e9664e4cea39" }, "downloads": -1, "filename": "RISparser-0.1.tar.gz", "has_sig": false, "md5_digest": "7be360b1d631640b13a197f1561fcff0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6460, "upload_time": "2015-01-17T14:42:23", "url": "https://files.pythonhosted.org/packages/63/a3/8bf5824250b3b3210e86b6c03628b07e5c1a544e56ae1553918cacc69f93/RISparser-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "115351d01fb61c58a3384d52ff3e4b6b", "sha256": "728a75ed6ce4835e4c6d5562a68fdd870d6de0cc214bd0f280cf6d38f752824b" }, "downloads": -1, "filename": "RISparser-0.2.tar.gz", "has_sig": false, "md5_digest": "115351d01fb61c58a3384d52ff3e4b6b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6749, "upload_time": "2015-01-17T19:54:23", "url": "https://files.pythonhosted.org/packages/23/b9/5e114f1855dd41d7e543c05876ae84479de41db1ec61a8e1da3d9336be32/RISparser-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "9a8ab89a467374539162cac5c98d345d", "sha256": "2353c2aea0b3738c53bc60e8f48eced94c33a7a424b93fbadb6b606b45d4724d" }, "downloads": -1, "filename": "RISparser-0.3.tar.gz", "has_sig": false, "md5_digest": "9a8ab89a467374539162cac5c98d345d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8104, "upload_time": "2015-01-19T10:39:48", "url": "https://files.pythonhosted.org/packages/50/32/e9789c0864cff2276cd30db3a4db75739d0dbba2598a9c1b344c41e3e072/RISparser-0.3.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "aa9a284a6b936a7dfe6276347d86f6c9", "sha256": "55cb576b1609b7a29b1bff422cdee12ad49b469e1bd58495ac28b90fd510245f" }, "downloads": -1, "filename": "RISparser-0.3.1.tar.gz", "has_sig": false, "md5_digest": "aa9a284a6b936a7dfe6276347d86f6c9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8291, "upload_time": "2015-01-19T10:53:24", "url": "https://files.pythonhosted.org/packages/35/b2/fd686fb76a16293f3ef27c51e4ebec83634bdbea4bfc97ad446066c0d8da/RISparser-0.3.1.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "6753486b0424e7ba3e2c9af757b2ec78", "sha256": "aec90adafc176d8b31faff45472ddfa53308c0b971140ca04ae53d2926983a28" }, "downloads": -1, "filename": "RISparser-0.4.tar.gz", "has_sig": false, "md5_digest": "6753486b0424e7ba3e2c9af757b2ec78", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8287, "upload_time": "2015-01-19T13:23:47", "url": "https://files.pythonhosted.org/packages/16/46/bbf61557c2f13f4a3ecb799905816d7d1f6a0263be266b413c3759415ca0/RISparser-0.4.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "2b172875cd2315c7d167945ff784727e", "sha256": "e464c86ad0c18bc41ea93dfe3be02527afdb617f0ffc35f78c74b4bb5a52f456" }, "downloads": -1, "filename": "RISparser-0.4.1.tar.gz", "has_sig": false, "md5_digest": "2b172875cd2315c7d167945ff784727e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8450, "upload_time": "2015-01-19T13:39:57", "url": "https://files.pythonhosted.org/packages/ac/e7/9118c466d8b1ead3907d85464f8a228fb42ff1b10a9d4a7510fcce6000b6/RISparser-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "d68145f158930b262da21eadc5cc70c5", "sha256": "ff99cbbde93cb017236234363db6e17a0615b861313d0ea5ce04e6067848850f" }, "downloads": -1, "filename": "RISparser-0.4.2-py3-none-any.whl", "has_sig": false, "md5_digest": "d68145f158930b262da21eadc5cc70c5", "packagetype": "bdist_wheel", "python_version": "3.6", "requires_python": null, "size": 9481, "upload_time": "2017-05-30T02:57:01", "url": "https://files.pythonhosted.org/packages/96/d3/dd47ee8344731bcf8b26ee53ea57e47610658d0ce760deb2d76d59ef463b/RISparser-0.4.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2961f8b8697fa69af584e0f0447ae2cb", "sha256": "8e1c9ca67a6a90d6a876f5f886f67bab1660a951a2c0e78ed737bdccc2a05c1e" }, "downloads": -1, "filename": "RISparser-0.4.2.tar.gz", "has_sig": false, "md5_digest": "2961f8b8697fa69af584e0f0447ae2cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14683, "upload_time": "2017-05-30T02:56:59", "url": "https://files.pythonhosted.org/packages/eb/14/b5e8281ca9b155e4a5533c2be5980b7d9273c10d1bb3152b4dfa5699448d/RISparser-0.4.2.tar.gz" } ], "0.4.3": [ { "comment_text": "", "digests": { "md5": "6a24eaaa88141e1945256b3c5663f657", "sha256": "bae6e5865c7c9dab4e11574503d2d844beb68dcda8e8bd5e772870e7e95a26ae" }, "downloads": -1, "filename": "RISparser-0.4.3-py3-none-any.whl", "has_sig": false, "md5_digest": "6a24eaaa88141e1945256b3c5663f657", "packagetype": "bdist_wheel", "python_version": "3.6", "requires_python": null, "size": 9544, "upload_time": "2018-04-10T20:26:55", "url": "https://files.pythonhosted.org/packages/e8/93/bd800e71c87e45d1dd1d4a3cda6db8a413a76c47f9c3468f0ba01ef53ea2/RISparser-0.4.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3b75014566ecd65fdeeadd20161637d0", "sha256": "3190fbea0caec3fac21ade66a4bc3e9a53d6e6887666631ecb67bae0e619ae9a" }, "downloads": -1, "filename": "RISparser-0.4.3.tar.gz", "has_sig": false, "md5_digest": "3b75014566ecd65fdeeadd20161637d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14880, "upload_time": "2018-04-10T20:26:50", "url": "https://files.pythonhosted.org/packages/7e/04/0318a216321819c481fd907b9297a45717e43e606eb3ba9503adf5ae593a/RISparser-0.4.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6a24eaaa88141e1945256b3c5663f657", "sha256": "bae6e5865c7c9dab4e11574503d2d844beb68dcda8e8bd5e772870e7e95a26ae" }, "downloads": -1, "filename": "RISparser-0.4.3-py3-none-any.whl", "has_sig": false, "md5_digest": "6a24eaaa88141e1945256b3c5663f657", "packagetype": "bdist_wheel", "python_version": "3.6", "requires_python": null, "size": 9544, "upload_time": "2018-04-10T20:26:55", "url": "https://files.pythonhosted.org/packages/e8/93/bd800e71c87e45d1dd1d4a3cda6db8a413a76c47f9c3468f0ba01ef53ea2/RISparser-0.4.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3b75014566ecd65fdeeadd20161637d0", "sha256": "3190fbea0caec3fac21ade66a4bc3e9a53d6e6887666631ecb67bae0e619ae9a" }, "downloads": -1, "filename": "RISparser-0.4.3.tar.gz", "has_sig": false, "md5_digest": "3b75014566ecd65fdeeadd20161637d0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14880, "upload_time": "2018-04-10T20:26:50", "url": "https://files.pythonhosted.org/packages/7e/04/0318a216321819c481fd907b9297a45717e43e606eb3ba9503adf5ae593a/RISparser-0.4.3.tar.gz" } ] }