{
    "info": {
        "author": "MolSSI",
        "author_email": "meliseo@vt.edu",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 2 - Pre-Alpha",
            "Intended Audience :: Science/Research",
            "License :: OSI Approved :: BSD License",
            "Natural Language :: English",
            "Programming Language :: Python :: 3.6",
            "Programming Language :: Python :: 3.7",
            "Programming Language :: Python :: 3 :: Only"
        ],
        "description": "reference_handler\n==============================\n[//]: # (Badges)\n[![Travis Build Status](https://travis-ci.org/molssi/reference_handler.png)](https://travis-ci.org/molssi/reference_handler)\n[![AppVeyor Build status](https://ci.appveyor.com/api/projects/status/REPLACE_WITH_APPVEYOR_LINK/branch/master?svg=true)](https://ci.appveyor.com/project/molssi/reference_handler/branch/master)\n[![codecov](https://codecov.io/gh/molssi/reference_handler/branch/master/graph/badge.svg)](https://codecov.io/gh/molssi/reference_handler/branch/master)\n\nA Python package that creates a consolidated list of references (BibTex, RIS) of scientific material \nused in a Python package.\n\n### Motivation\n\nAuthors of modeling tools (scientific software, method or model\ndevelopers) currently find it difficult to get fair attribution to their\nsoftware and scientific work. Scientific software developers create\ntools that do not always get cited, as a typical citable\nscientific article might not exist. Although new mechanisms for more\ndirectly citing software have been recently created (i.e. Zenodo), they have\nnot gained widespread use in the community of computational\nmolecular science. \n\nMethod and model developers face a similar problem. Consider for instance \na molecular dynamics practitioner who needs to develop a new force field using\na specialized quantum mechanical calculation. The practitioner might not be\nfully familiar with the correct references to use for the quantum mechanical software\nand methods. To correctly\ninclude the references, the model developer might spend a considerable amount of time\nfinding out which papers to cite. This problem is exponentially exacerbated in work that\ninvolves complex workflows running hundreds of different software\ncomponents that might involve different areas of computational science.\n\n## Goal\n\nThe goal of the *reference handler* is to provide an easy mechanism for\ndevelopers to record the appropriate references so that users of tools can\nprovide a complete set of citations for a particular run of the software in a\nform convenient for the user. \n\nThe output of *reference handler* is a consolidated list of\nreferences (BibTeX, RIS) to go into the paper with as little effort as possible on the users\npart.\n\n## Audience\n\n**1. Method and scientific software developers.** \n\n**2. Computational molecular science practitioners**\n\n## Package overview\n\nThe reference handler is comprised of the following: \n\n**1. Central SQLite3 database.** It contains two tables. \nThe first is named *citation* and holds the essential data associated to each unique\ncitation, such as the raw citation text and its ID number. \nThe second is the *context* table. It\ncontains information about the context in which a given citation was used. For instance, \nthe function where the citation was used or the number of times the citation was \"mentioned\" \nby any function of your Python package.\n\nEach citation can have many contexts, yielding a one-to-many relationship between the two\ntables. \n\n**2. Functions to ease the interaction with central database. ** Examples are a function\nto cite a desired reference or a function to dump the contents of the database into a \n.bib file for subsequent compliation using BibTeX.\n\n## Minimal example\n\n```python\nimport reference_handler\n\nlj_citation = \"\"\"\n@article{lj1924,\nauthor = {J. E. Jones  and Sydney Chapman },\ntitle = {On the determination of molecular fields. \\&\\#x2014;II. From the equation of state of a gas},\njournal = {Proceedings of the Royal Society of London. Series A, Containing Papers of a Mathematical and Physical Character},\nvolume = {106},\nnumber = {738},\npages = {463-477},\nyear = {1924},\ndoi = {10.1098/rspa.1924.0082},\n}\n\"\"\"\n\ndef lennard_jones(sigma, epsilon, rij):\n    rf.cite(raw=lj_citation, alias='lj_citation', module='lennard_jones',\n        level=1, note='The first version of the Lennard-Jones potential')\n    sig_by_r6 = (sigma / rij ** 6)\n    sig_by_r12 = (sig_by_r6 ** 2)\n    return 4.0 * epsilon * (sig_by_r12 - sig_by_r6)\n\nrf = reference_handler.Reference_Handler('database.db')\n\nsigma = 3.54\nepsilon = 98.0\nrij = 20.0\n\nlj_energy = lennard_jones(sigma, epsilon, rij)\n\nrf.dump(outfile='bibliography.bib')\n```\n\n## Installation\n\n## Documentation\n\n## Contribute\n\n## Citation\n\n### Copyright\n\nCopyright (c) 2019, MolSSI\n\n#### Acknowledgements\n\nProject based on the \n[Computational Molecular Science Python Cookiecutter](https://github.com/molssi/cookiecutter-cms) version 1.0.\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "",
        "keywords": "reference_handler",
        "license": "BSD-3-Clause",
        "maintainer": "",
        "maintainer_email": "",
        "name": "reference-handler",
        "package_url": "https://pypi.org/project/reference-handler/",
        "platform": "",
        "project_url": "https://pypi.org/project/reference-handler/",
        "project_urls": null,
        "release_url": "https://pypi.org/project/reference-handler/0.1.2/",
        "requires_dist": [
            "bibtexparser"
        ],
        "requires_python": "",
        "summary": "",
        "version": "0.1.2"
    },
    "last_serial": 5893045,
    "releases": {
        "0.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "9e28b61d949d068d65335f46440bcac3",
                    "sha256": "395788c74fb24fe21e820025bb8b4256619db3ad62d363d1c75e11ae5fff12b0"
                },
                "downloads": -1,
                "filename": "reference_handler-0.1.2-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "9e28b61d949d068d65335f46440bcac3",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 17958,
                "upload_time": "2019-09-26T22:26:11",
                "url": "https://files.pythonhosted.org/packages/6f/b3/a4fab6ecdee03b20e96d34925a5ddbfe5109110821152ec9928f9b4ef5d2/reference_handler-0.1.2-py2.py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "46d76e65cdcb4dfd9bb91f85f34ba68d",
                    "sha256": "6e75547ddb58344e8f767830dff85221b0c09cda8ac11e875565d7694816523d"
                },
                "downloads": -1,
                "filename": "reference_handler-0.1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "46d76e65cdcb4dfd9bb91f85f34ba68d",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 31972,
                "upload_time": "2019-09-26T22:26:14",
                "url": "https://files.pythonhosted.org/packages/8a/d7/f802f77714f7d019af4e6b1783e7aa2f5385517aed5a3f26a2cd10f72bbf/reference_handler-0.1.2.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "9e28b61d949d068d65335f46440bcac3",
                "sha256": "395788c74fb24fe21e820025bb8b4256619db3ad62d363d1c75e11ae5fff12b0"
            },
            "downloads": -1,
            "filename": "reference_handler-0.1.2-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9e28b61d949d068d65335f46440bcac3",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": null,
            "size": 17958,
            "upload_time": "2019-09-26T22:26:11",
            "url": "https://files.pythonhosted.org/packages/6f/b3/a4fab6ecdee03b20e96d34925a5ddbfe5109110821152ec9928f9b4ef5d2/reference_handler-0.1.2-py2.py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "46d76e65cdcb4dfd9bb91f85f34ba68d",
                "sha256": "6e75547ddb58344e8f767830dff85221b0c09cda8ac11e875565d7694816523d"
            },
            "downloads": -1,
            "filename": "reference_handler-0.1.2.tar.gz",
            "has_sig": false,
            "md5_digest": "46d76e65cdcb4dfd9bb91f85f34ba68d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 31972,
            "upload_time": "2019-09-26T22:26:14",
            "url": "https://files.pythonhosted.org/packages/8a/d7/f802f77714f7d019af4e6b1783e7aa2f5385517aed5a3f26a2cd10f72bbf/reference_handler-0.1.2.tar.gz"
        }
    ]
}