idutils


Nameidutils JSON
Version 1.2.1 PyPI version JSON
download
home_pagehttps://github.com/inveniosoftware/idutils
Summary"Small library for persistent identifiers used in scholarly communication."
upload_time2023-03-14 12:48:34
maintainer
docs_urlhttps://pythonhosted.org/idutils/
authorInvenio Software
requires_python>=3.7
licenseRevised BSD License
keywords persistent identifiers
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            ..
   This file is part of IDUtils
   Copyright (C) 2015 CERN.

   IDUtils is free software; you can redistribute it and/or modify
   it under the terms of the Revised BSD License; see LICENSE file for
   more details.

   In applying this license, CERN does not waive the privileges and immunities
   granted to it by virtue of its status as an Intergovernmental Organization
   or submit itself to any jurisdiction.


=======
IDUtils
=======

.. image:: https://github.com/inveniosoftware/idutils/workflows/CI/badge.svg
        :target: https://github.com/inveniosoftware/idutils/actions?query=workflow%3ACI

.. image:: https://img.shields.io/coveralls/inveniosoftware/idutils.svg
        :target: https://coveralls.io/r/inveniosoftware/idutils

.. image:: https://img.shields.io/github/tag/inveniosoftware/idutils.svg
        :target: https://github.com/inveniosoftware/idutils/releases

.. image:: https://img.shields.io/pypi/dm/idutils.svg
        :target: https://pypi.python.org/pypi/idutils

.. image:: https://img.shields.io/github/license/inveniosoftware/idutils.svg
        :target: https://github.com/inveniosoftware/idutils/blob/master/LICENSE


Small library for validating and normalising persistent identifiers used in
scholarly communication.

* Free software: Revised BSD license
* Documentation: https://idutils.readthedocs.io.

Features
========

- Validation and normalization of persistent identifiers.
- Detection of persistent identifier scheme.
- Generation of resolving links for persistent identifiers.
- Supported schemes: ISBN10, ISBN13, ISSN, ISTC, DOI, Handle, EAN8, EAN13, ISNI
  ORCID, ARK, PURL, LSID, URN, Bibcode, arXiv, PubMed ID, PubMed Central ID,
  GND, SRA, BioProject, BioSample, Ensembl, UniProt, RefSeq, GenBank/RefSeq.

Installation
============

The IDUtils package is on PyPI so all you need is:

.. code-block:: console

    $ pip install idutils

..
   This file is part of IDUtils
   Copyright (C) 2015-2023 CERN.
   Copyright (C) 2022 Northwestern University.

   IDUtils is free software; you can redistribute it and/or modify
   it under the terms of the Revised BSD License; see LICENSE file for
   more details.

   In applying this license, CERN does not waive the privileges and immunities
   granted to it by virtue of its status as an Intergovernmental Organization
   or submit itself to any jurisdiction.


Changes
=======

Version 1.2.1 (2023-03-02)

- Fixes ORCiD validation, by adding the new ISNI block range.

Version 1.2.0 (2023-01-30)

- schemes: add support for viaf and urn

Version 1.1.12 (2022-02-28)

- Replaces ``isbnid_fork`` with ``isbnlib``

Version 1.1.11 (2022-01-28)

- Normalize pmid + their URL identifiers

Version 1.1.10 (2022-01-11)

- Add purl.fdlp.gov as a valid PURL netloc
- Normalize ror identifiers

Version 1.1.9 (2021-08-30)

- Update ARK's NAAN regex per https://datatracker.ietf.org/doc/html/draft-kunze-ark-28#section-2.3.

Version 1.1.8 (2020-08-13)

- Adds support for GEO and ArrayExpress identifiers.

Version 1.1.7 (2020-06-22)

- Updates Software Heritage identifiers
- Adds Research Organization Registry identifiers
- Fixes DeprctationWarnings by using raw strings for regular expressions

Version 1.1.6 (2020-05-07)

- Deprecates Python versions lower than 3.6.0. Now supporting 3.6.0 and 3.7.0.

Version 1.1.5 (2020-02-26)

- Adds support for Software Heritage identifiers.
- Fixes handling of non-digit characters in DOI detection.

Version 1.1.4 (2019-09-27)

- Adds support for ASCL identifiers.
- Fixes the ADS identifier regex to also detect lower-case author initials.

Version 1.1.3 (2019-09-17)

- Adds support for HTTPS ORCiD identifiers.

Version 1.1.2 (2019-02-12)

- Adds support for HAL identifiers.

Version 1.1.1 (2018-11-18)

- Changes URL resolution for bibcodes to use https://ui.adsabs.harvard instead
  of https://adsabs.harvard.edu/abs/.
- Allows choosing HTTP/HTTPS for any generated URL by ``idutils.to_url``.

Version 1.1.0 (2018-08-17)

- Adds support for genomic identifiers: SRA, BioProject, BioSample, Ensembl,
  UniProt, RefSeq, GenBank/RefSeq.
- Fixes bug in bibcode detection for non-capitalized journals.

Version 1.0.1 (2018-05-02)

- Fixes bug causing invalid DOIs to be accepted.

Version 1.0.0 (2017-12-07)

- Fixes handling of unicode characters in DOIs.
- Adds support for APS style arXiv identifiers.

Version 0.2.4 (2017-01-30)

- Removes `Python 3.3` from a list of supported Python versions and
  adds `Python 3.6`
- Moves from `isbnid (v0.3.4)` to `isbnid_fork (v0.4.4)` library.

Version 0.2.3 (2016-09-21)

- Adds an optional parameter in `idutils.to_url` to use HTTPS scheme
  for PID providers that support it.
- Detects and parses Handles and DOIs without the "http(s)://", and
  ignores whitespace after scheme tags (eg. "doi:  10.123/456").

Version 0.2.2 (2016-09-16)

- Fixes issue where a valid ISBN with dashes and spaces could not be
  normalized.

Version 0.2.1 (2016-06-17)

- Changes ISBN normalization to use `isbnid` instead of `isbnlib`. Now,
  importing this library will not change the default socket timeout, resulting
  in unwanted side effects.

Version 0.2.0 (2016-04-07)

- Changes URL resolution for DOIs to use https://doi.org instead of
  http://dx.doi.org according to
  https://www.doi.org/doi_handbook/3_Resolution.html#3.8

Version 0.1.1 (2015-07-22)

- Fixes GND validation and normalization.
- Replaces invalid package name in `run-tests.sh` and makes `run-tests.sh` file
  executable. One can now use `docker-compose run --rm web /code/run-tests.sh`
  to run all the CI tests (pep257, sphinx, test suite).
- Initial release of Docker configuration suitable for local developments.
  `docker-compose build` rebuilds the image,
  `docker-compose run --rm web /code/run-tests.sh` runs the test suite.

Version 0.1.0 (2015-07-02)

- First public release.



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/inveniosoftware/idutils",
    "name": "idutils",
    "maintainer": "",
    "docs_url": "https://pythonhosted.org/idutils/",
    "requires_python": ">=3.7",
    "maintainer_email": "",
    "keywords": "persistent identifiers",
    "author": "Invenio Software",
    "author_email": "info@inveniosoftware.org",
    "download_url": "https://files.pythonhosted.org/packages/31/bf/373a19718c80dfb30d17a0274026cd17ed999050429d39c79eda0189f503/idutils-1.2.1.tar.gz",
    "platform": "any",
    "description": "..\n   This file is part of IDUtils\n   Copyright (C) 2015 CERN.\n\n   IDUtils is free software; you can redistribute it and/or modify\n   it under the terms of the Revised BSD License; see LICENSE file for\n   more details.\n\n   In applying this license, CERN does not waive the privileges and immunities\n   granted to it by virtue of its status as an Intergovernmental Organization\n   or submit itself to any jurisdiction.\n\n\n=======\nIDUtils\n=======\n\n.. image:: https://github.com/inveniosoftware/idutils/workflows/CI/badge.svg\n        :target: https://github.com/inveniosoftware/idutils/actions?query=workflow%3ACI\n\n.. image:: https://img.shields.io/coveralls/inveniosoftware/idutils.svg\n        :target: https://coveralls.io/r/inveniosoftware/idutils\n\n.. image:: https://img.shields.io/github/tag/inveniosoftware/idutils.svg\n        :target: https://github.com/inveniosoftware/idutils/releases\n\n.. image:: https://img.shields.io/pypi/dm/idutils.svg\n        :target: https://pypi.python.org/pypi/idutils\n\n.. image:: https://img.shields.io/github/license/inveniosoftware/idutils.svg\n        :target: https://github.com/inveniosoftware/idutils/blob/master/LICENSE\n\n\nSmall library for validating and normalising persistent identifiers used in\nscholarly communication.\n\n* Free software: Revised BSD license\n* Documentation: https://idutils.readthedocs.io.\n\nFeatures\n========\n\n- Validation and normalization of persistent identifiers.\n- Detection of persistent identifier scheme.\n- Generation of resolving links for persistent identifiers.\n- Supported schemes: ISBN10, ISBN13, ISSN, ISTC, DOI, Handle, EAN8, EAN13, ISNI\n  ORCID, ARK, PURL, LSID, URN, Bibcode, arXiv, PubMed ID, PubMed Central ID,\n  GND, SRA, BioProject, BioSample, Ensembl, UniProt, RefSeq, GenBank/RefSeq.\n\nInstallation\n============\n\nThe IDUtils package is on PyPI so all you need is:\n\n.. code-block:: console\n\n    $ pip install idutils\n\n..\n   This file is part of IDUtils\n   Copyright (C) 2015-2023 CERN.\n   Copyright (C) 2022 Northwestern University.\n\n   IDUtils is free software; you can redistribute it and/or modify\n   it under the terms of the Revised BSD License; see LICENSE file for\n   more details.\n\n   In applying this license, CERN does not waive the privileges and immunities\n   granted to it by virtue of its status as an Intergovernmental Organization\n   or submit itself to any jurisdiction.\n\n\nChanges\n=======\n\nVersion 1.2.1 (2023-03-02)\n\n- Fixes ORCiD validation, by adding the new ISNI block range.\n\nVersion 1.2.0 (2023-01-30)\n\n- schemes: add support for viaf and urn\n\nVersion 1.1.12 (2022-02-28)\n\n- Replaces ``isbnid_fork`` with ``isbnlib``\n\nVersion 1.1.11 (2022-01-28)\n\n- Normalize pmid + their URL identifiers\n\nVersion 1.1.10 (2022-01-11)\n\n- Add purl.fdlp.gov as a valid PURL netloc\n- Normalize ror identifiers\n\nVersion 1.1.9 (2021-08-30)\n\n- Update ARK's NAAN regex per https://datatracker.ietf.org/doc/html/draft-kunze-ark-28#section-2.3.\n\nVersion 1.1.8 (2020-08-13)\n\n- Adds support for GEO and ArrayExpress identifiers.\n\nVersion 1.1.7 (2020-06-22)\n\n- Updates Software Heritage identifiers\n- Adds Research Organization Registry identifiers\n- Fixes DeprctationWarnings by using raw strings for regular expressions\n\nVersion 1.1.6 (2020-05-07)\n\n- Deprecates Python versions lower than 3.6.0. Now supporting 3.6.0 and 3.7.0.\n\nVersion 1.1.5 (2020-02-26)\n\n- Adds support for Software Heritage identifiers.\n- Fixes handling of non-digit characters in DOI detection.\n\nVersion 1.1.4 (2019-09-27)\n\n- Adds support for ASCL identifiers.\n- Fixes the ADS identifier regex to also detect lower-case author initials.\n\nVersion 1.1.3 (2019-09-17)\n\n- Adds support for HTTPS ORCiD identifiers.\n\nVersion 1.1.2 (2019-02-12)\n\n- Adds support for HAL identifiers.\n\nVersion 1.1.1 (2018-11-18)\n\n- Changes URL resolution for bibcodes to use https://ui.adsabs.harvard instead\n  of https://adsabs.harvard.edu/abs/.\n- Allows choosing HTTP/HTTPS for any generated URL by ``idutils.to_url``.\n\nVersion 1.1.0 (2018-08-17)\n\n- Adds support for genomic identifiers: SRA, BioProject, BioSample, Ensembl,\n  UniProt, RefSeq, GenBank/RefSeq.\n- Fixes bug in bibcode detection for non-capitalized journals.\n\nVersion 1.0.1 (2018-05-02)\n\n- Fixes bug causing invalid DOIs to be accepted.\n\nVersion 1.0.0 (2017-12-07)\n\n- Fixes handling of unicode characters in DOIs.\n- Adds support for APS style arXiv identifiers.\n\nVersion 0.2.4 (2017-01-30)\n\n- Removes `Python 3.3` from a list of supported Python versions and\n  adds `Python 3.6`\n- Moves from `isbnid (v0.3.4)` to `isbnid_fork (v0.4.4)` library.\n\nVersion 0.2.3 (2016-09-21)\n\n- Adds an optional parameter in `idutils.to_url` to use HTTPS scheme\n  for PID providers that support it.\n- Detects and parses Handles and DOIs without the \"http(s)://\", and\n  ignores whitespace after scheme tags (eg. \"doi:  10.123/456\").\n\nVersion 0.2.2 (2016-09-16)\n\n- Fixes issue where a valid ISBN with dashes and spaces could not be\n  normalized.\n\nVersion 0.2.1 (2016-06-17)\n\n- Changes ISBN normalization to use `isbnid` instead of `isbnlib`. Now,\n  importing this library will not change the default socket timeout, resulting\n  in unwanted side effects.\n\nVersion 0.2.0 (2016-04-07)\n\n- Changes URL resolution for DOIs to use https://doi.org instead of\n  http://dx.doi.org according to\n  https://www.doi.org/doi_handbook/3_Resolution.html#3.8\n\nVersion 0.1.1 (2015-07-22)\n\n- Fixes GND validation and normalization.\n- Replaces invalid package name in `run-tests.sh` and makes `run-tests.sh` file\n  executable. One can now use `docker-compose run --rm web /code/run-tests.sh`\n  to run all the CI tests (pep257, sphinx, test suite).\n- Initial release of Docker configuration suitable for local developments.\n  `docker-compose build` rebuilds the image,\n  `docker-compose run --rm web /code/run-tests.sh` runs the test suite.\n\nVersion 0.1.0 (2015-07-02)\n\n- First public release.\n\n\n",
    "bugtrack_url": null,
    "license": "Revised BSD License",
    "summary": "\"Small library for persistent identifiers used in scholarly communication.\"",
    "version": "1.2.1",
    "split_keywords": [
        "persistent",
        "identifiers"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "70dce2dc4f45905a62ee9d88eb2fc5f2853ef828cbd3c6db285c7b4eb6cf9a17",
                "md5": "9d5ae13b1bf78ce52986736d8c6e14a1",
                "sha256": "908aabada07bb26e5e8f2d78ff222611b493cd721a05f1451f96d373a48f504d"
            },
            "downloads": -1,
            "filename": "idutils-1.2.1-py2.py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9d5ae13b1bf78ce52986736d8c6e14a1",
            "packagetype": "bdist_wheel",
            "python_version": "py2.py3",
            "requires_python": ">=3.7",
            "size": 14642,
            "upload_time": "2023-03-14T12:48:32",
            "upload_time_iso_8601": "2023-03-14T12:48:32.773211Z",
            "url": "https://files.pythonhosted.org/packages/70/dc/e2dc4f45905a62ee9d88eb2fc5f2853ef828cbd3c6db285c7b4eb6cf9a17/idutils-1.2.1-py2.py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "31bf373a19718c80dfb30d17a0274026cd17ed999050429d39c79eda0189f503",
                "md5": "42b9a15da65973ff94b121f919bf9f14",
                "sha256": "d09220edd893c3164837890f0d1da303111a16a231dd9dd331c64d3d6f2b52cb"
            },
            "downloads": -1,
            "filename": "idutils-1.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "42b9a15da65973ff94b121f919bf9f14",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 27546,
            "upload_time": "2023-03-14T12:48:34",
            "upload_time_iso_8601": "2023-03-14T12:48:34.152872Z",
            "url": "https://files.pythonhosted.org/packages/31/bf/373a19718c80dfb30d17a0274026cd17ed999050429d39c79eda0189f503/idutils-1.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-03-14 12:48:34",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "inveniosoftware",
    "github_project": "idutils",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "lcname": "idutils"
}
        
Elapsed time: 0.04381s