{
    "info": {
        "author": "Kyle Chard",
        "author_email": "chard@uchicago.edu",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "Minimal Viable Identifier Client\n================================\n\nA minid (Minimal Viable Identifier) is an identifier that is sufficiently simple to make creation and use trivial, while still having enough substance to make data easily findable, accessible, interoperable, and reusable (FAIR). \n\nThe minid server code is avaialble at `https://github.com/fair-research/minid-server <https://github.com/fair-research/minid-server>`_\n\nInstallation\n------------\n\nThe minid client and CLI is avaialble on PyPI. You can install it with the following command::\n  \n  $ pip install minid\n  \nAlternatively, you can download the source code and install using setup tools::\n\n  $ git clone git@github.com:ini-bdds/minid.git\n  \n  $ python setup.py install\n\nConfiguration\n-------------\n\nBefore using the API you first need to validate your email address. Enter the following command::\n\n  $ minid --register_user --email <email> --name <name> [--orcid <orcid>]\n\nA unique code will be sent to your email address. You must present this code along with your \nemail address when accessing the API. As a convenience you can specify this information in \na minid configuration file (`~/.minid/minid-config.cfg`)\n\n\n.. code-block:: ini\n\n    [general]\n    minid_server: http://minid.bd2k.org/minid\n    user: <Name>\n    email: <Email>\n    orcid: <optional Orcid>\n    code: <Code>\n\n\nUsage\n-----\n\nThe CLI supports the following simple operations (Note: the `--test` flag creates names in a test namespace that is removed periodically; remove that flag to create production minids.): \n\n* Create a new identifier (the `--location` option, if provided, must be at the end)::\n\n    $ minid --test --register [--title <title>] <file_name> [--locations <loc1>..<locN>]\n    \n* Retrieve metadata about a file::\n\n    $ minid --test <file_name>\n    \n* Retrieve metadata about an identifier::\n\n    $ minid --test <identifier>\n\n* Update metadata about an identifier:: \n\n    $ minid --test --update [--title <title>] [--status <status>] [--obsoleted_by <minid>] [--locations <loc1> <loc2>] <identifier>\n    \n*  View all minid options:: \n\n    $ minid -h\n\nLanding pages are accessible via the minid website: minid.bd2k.org/minid/landingpage/<identifier>. \n\n\nfile manifest format\n--------------------\nMinids can only be assigned to a single file. In order to assign a minid to a collection of files we recommend using a `BDBag <https://github.com/ini-bdds/bdbag>`_ or the minid file manifest format. \n\nThe minid file manifest format is a JSON-based format that enumerates a list of files as JSON objects that have the following attributes:\n\n* length: The length of the file in bytes.\n\n* filename: The filename (or path) relative to the manifest file.\n\n* One or more (only one of each) of the following `algorithm:checksum` key-value pairs:\n  \n  * md5:<md5 hex value>\n  \n  * sha256:<sha256 hex value>\n  \n  * sha512:<sha512 hex value>\n\n* url: the URL to the file.\n\nThe manifest may be used to create a minid for a collection of files or alternatively as input to the minid batch-register command. \n\nBelow is a sample file manifest configuration file::\n\n  [\n      {\n          \"length\":321,\n          \"filename\":\"file1.txt\",\n          \"md5\":\"5bbf5a52328e7439ae6e719dfe712200\",\n          \"sha256\":\"2c8b08da5ce60398e1f19af0e5dccc744df274b826abe585eaba68c525434806\",\n          \"url\" : \"globus://ddb59aef-6d04-11e5-ba46-22000b92c6ec/share/godata/file1.txt\"\n      },\n      {\n          \"length\": 632860,\n          \"filename\": \"minid_v0.1_Nov_2015.pdf\",\n          \"sha256\": \"cacc1abf711425d3c554277a5989df269cefaa906d27f1aaa72205d30224ed5f\",\n          \"url\" : \"http://bd2k.ini.usc.edu/assets/all-hands-meeting/minid_v0.1_Nov_2015.pdf\"\n      }\n  ]\n\n\nMore information\n----------------\n\n\"`I'll take that to go: Big data bags and minimal identifiers for exchange of large, complex datasets <https://zenodo.org/record/820878>`_\" explains the motivation for Minids and the related BDBag construct, provides details on design and implementation, and gives examples of use.\n\n\"`Reproducible big data science: A case study in continuous FAIRness <https://www.biorxiv.org/content/early/2018/02/27/268755>`_\" presents a use case in which BDBags and Minids are used to capture a transcription factor binding site analysis.\n\nMore information about the project can be found at: `http://minid.bd2k.org/ <http://minid.bd2k.org/>`_",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://minid.bd2k.org/",
        "keywords": "",
        "license": "Apache 2.0",
        "maintainer": "",
        "maintainer_email": "",
        "name": "minid",
        "package_url": "https://pypi.org/project/minid/",
        "platform": "",
        "project_url": "https://pypi.org/project/minid/",
        "project_urls": {
            "Homepage": "http://minid.bd2k.org/"
        },
        "release_url": "https://pypi.org/project/minid/1.3.0/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "BD2K Minimum Viable Identifier",
        "version": "1.3.0"
    },
    "last_serial": 3951864,
    "releases": {
        "1.1.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "568895903ba0afb1a2172c310094e8f2",
                    "sha256": "d7d82b661cc134b04913b0194edb3ff3716ea5ae367eb3291f6d7887af256c2d"
                },
                "downloads": -1,
                "filename": "minid-1.1.2.tar.gz",
                "has_sig": false,
                "md5_digest": "568895903ba0afb1a2172c310094e8f2",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 9780,
                "upload_time": "2018-01-19T17:26:37",
                "url": "https://files.pythonhosted.org/packages/44/37/ab776a559e3944287e19be058659ec67179754b91066125494ff39d0edf7/minid-1.1.2.tar.gz"
            }
        ],
        "1.2.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5b825b30542b856a18f6e7929e01745b",
                    "sha256": "1c381cbe7e91de653ef3140c05e1dc1843235eb8c3be2dc4e469377bf0b7c531"
                },
                "downloads": -1,
                "filename": "minid-1.2.2.tar.gz",
                "has_sig": false,
                "md5_digest": "5b825b30542b856a18f6e7929e01745b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13435,
                "upload_time": "2018-03-16T21:18:45",
                "url": "https://files.pythonhosted.org/packages/62/ff/04a3a81f51782df6fa1bd744896f239acc393f4365db18634ac2723090c4/minid-1.2.2.tar.gz"
            }
        ],
        "1.2.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "d21c96e36a1193232a4576d83bd5b4a5",
                    "sha256": "aea833428aab20e43b912a77c18d8503cc92675795f3937e1d256d62b55c6957"
                },
                "downloads": -1,
                "filename": "minid-1.2.3.tar.gz",
                "has_sig": false,
                "md5_digest": "d21c96e36a1193232a4576d83bd5b4a5",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 13438,
                "upload_time": "2018-03-28T19:32:38",
                "url": "https://files.pythonhosted.org/packages/92/10/4372796da455cdd53632f5731181c87243bdc0a86fff5525fee1c57e8fbc/minid-1.2.3.tar.gz"
            }
        ],
        "1.3.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b0b7e0b46a8916a18c12c7261ff35784",
                    "sha256": "dbe6505c50357c77e369b5e1f6ea303301e6392f02d49acb99af2af6cf499d7c"
                },
                "downloads": -1,
                "filename": "minid-1.3.0.tar.gz",
                "has_sig": false,
                "md5_digest": "b0b7e0b46a8916a18c12c7261ff35784",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 14761,
                "upload_time": "2018-06-11T21:25:47",
                "url": "https://files.pythonhosted.org/packages/84/18/66d94e01ee717e28819746377b1cae2e07ea6692d4253becff33cd128a66/minid-1.3.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "b0b7e0b46a8916a18c12c7261ff35784",
                "sha256": "dbe6505c50357c77e369b5e1f6ea303301e6392f02d49acb99af2af6cf499d7c"
            },
            "downloads": -1,
            "filename": "minid-1.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "b0b7e0b46a8916a18c12c7261ff35784",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 14761,
            "upload_time": "2018-06-11T21:25:47",
            "url": "https://files.pythonhosted.org/packages/84/18/66d94e01ee717e28819746377b1cae2e07ea6692d4253becff33cd128a66/minid-1.3.0.tar.gz"
        }
    ]
}