Metadata-Version: 2.1
Name: pyDOI
Version: 0.1.0
Summary: Python DOI Resolver
Home-page: https://github.com/lcnittl/pyDOI
Author: Christian Knittl-Frank
Author-email: lcnittl@gmail.com
License: GPL-3.0
Download-URL: http://pypi.python.org/pypi/pyDOI
Project-URL: GitHub: repo, https://github.com/lcnittl/pyDOI
Project-URL: GitHub: issues, https://github.com/lcnittl/pyDOI/issues
Description: # pyDOI -- Python DOI Resolver
        
        [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white.svg)](https://github.com/pre-commit/pre-commit)
        [![pre-commit.ci status](https://results.pre-commit.ci/badge/github/lcnittl/pyDOI/master.svg)](https://results.pre-commit.ci/latest/github/lcnittl/pyDOI/master)
        [![Code style: black](https://img.shields.io/badge/code_style-black-000000.svg)](https://github.com/psf/black)
        [![Code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)
        
        Wrapper for the [DOI system Proxy Server REST API][api-docs].
        
        ## Usage
        
        ```ipython
        In [1]: import pydoi
        
        In [2]: # Get full response
        
        In [3]: pydoi.resolve("10.1002/chem.202000622")
        Out[3]:
        {'responseCode': 1,
         'handle': '10.1002/chem.202000622',
         'values': [{'index': 1,
           'type': 'URL',
           'data': {'format': 'string',
            'value': 'https://onlinelibrary.wiley.com/doi/10.1002/chem.202000622'},
           'ttl': 86400,
           'timestamp': '2020-09-25T16:02:07Z'},
          {'index': 700050,
           'type': '700050',
           'data': {'format': 'string', 'value': '2020100503563800217'},
           'ttl': 86400,
           'timestamp': '2020-10-05T12:25:43Z'},
          {'index': 100,
           'type': 'HS_ADMIN',
           'data': {'format': 'admin',
            'value': {'handle': '0.na/10.1002',
             'index': 200,
             'permissions': '111111110010'}},
           'ttl': 86400,
           'timestamp': '2020-03-30T02:01:43Z'}]}
        
        In [4]: # Get URL
        
        In [5]: pydoi.get_url("10.1016/j.chempr.2020.04.016")
        Out[5]: 'https://linkinghub.elsevier.com/retrieve/pii/S2451929420301844'
        
        In [6]: # pyDOI supports the use of query parameters
        
        In [7]: pydoi.resolve("10.1002/anie.201804551", params=[("type", "URL")])
        Out[7]:
        {'responseCode': 1,
         'handle': '10.1002/anie.201804551',
         'values': [{'index': 1,
           'type': 'URL',
           'data': {'format': 'string',
            'value': 'https://onlinelibrary.wiley.com/doi/abs/10.1002/anie.201804551'},
           'ttl': 86400,
           'timestamp': '2020-03-19T11:37:54Z'}]}
        
        In [8]: pydoi.resolve("10.1002/anie.201804551", params=[("type", "HS_ADMIN")])
        Out[8]:
        {'responseCode': 1,
         'handle': '10.1002/anie.201804551',
         'values': [{'index': 100,
           'type': 'HS_ADMIN',
           'data': {'format': 'admin',
            'value': {'handle': '0.na/10.1002',
             'index': 200,
             'permissions': '111111110010'}},
           'ttl': 86400,
           'timestamp': '2018-05-15T11:31:52Z'}]}
        ```
        
        ### Installation
        
        Installable with `pip`.
        
        ```cmd
        pip install pyDOI
        ```
        
        ## License
        
        GNU General Public License v3.0 or later
        
        See [LICENSE][license] for the full text.
        
        [api-docs]: https://www.doi.org/factsheets/DOIProxy.html#rest-api
        [license]: LICENSE
        [pypi]: https://pypi.org/
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: System :: Hardware
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
