wos


Namewos JSON
Version 0.1.15 PyPI version JSON
download
home_pagehttp://github.com/enricobacis/wos
SummaryWeb of Science client using API v3.
upload_time2018-01-24 11:28:18
maintainer
docs_urlNone
authorEnrico Bacis
requires_python
licenseMIT
keywords wos isi web of science knowledge api client
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage No coveralls.
            Description
-----------

.. image:: https://travis-ci.org/enricobacis/wos.svg?branch=master
    :target: https://travis-ci.org/enricobacis/wos

Web of Science (previously Web of Knowledge) is an online subscription-based
scientific citation indexing service maintained by Thomson Reuters.

``wos`` is a python SOAP Client (both API and command-line tool) to query the
WOS database in order to get XML data from a query using the WWS access.

Installation
------------

The package has been uploaded to `PyPI`_, so you can
install the package using pip:

    pip install wos

Usage
-----

You can use the ``wos`` command to query the Web of Science API. If you want to
access data that needs to be accessed using the premium API, you also have to
authenticate using your username and password.


    usage: wos [-h] [--close] [-l] [-u USER] [-p PASSWORD] [-s SID]
               {query,doi,connect} ...

    Query the Web of Science.

    positional arguments:
      {query,doi,connect}   sub-command help
        query               query the Web of Science.
        doi                 get the WOS ID from the DOI.
        connect             connect and get an SID.

    optional arguments:
      -h, --help            show this help message and exit
      --close               Close session.
      --proxy PROXY         HTTP proxy
      --timeout TIMEOUT     API timeout
      -l, --lite            Wos Lite
      -v, --verbose         Verbose

    authentication:
      API credentials for premium access.

      -u USER, --user USER
      -p PASSWORD, --password PASSWORD
      -s SID, --sid SID

You can use the WOS Lite API using the ``--lite`` parameter (for each query).

You can also authenticate using the session id (SID). In fact the sessions are
not closed by the command line utility. Example:

.. code::

    $ wos --user JohnDoe --password 12345 connect
    Authenticated using SID: ABCDEFGHIJKLM

    $ wos --sid ABCDEFGHIJKLM query 'AU=Knuth Donald' -c1
    Authenticated using SID: ABCDEFGHIJKLM
    <?xml version="1.0" ?>
    <records>
        <REC r_id_disclaimer="ResearcherID data provided by Thomson Reuters">
            <UID>WOS:000287850200007</UID>
            <static_data>
                <summary>
                    <EWUID>
                        <WUID coll_id="WOS"/>
                        <edition value="WOS.SCI"/>
                    </EWUID>
                    <pub_info coverdate="MAR 2011" has_abstract="N" issue="1"
                              pubmonth="MAR" pubtype="Journal" pubyear="2011"
                              sortdate="2011-03-01" vol="33">
                        <page begin="33" end="45" page_count="13">33-45</page>
                    </pub_info>
                    <titles count="6">
                        <title type="source">MATHEMATICAL INTELLIGENCER</title>
    ....

    $ wos --sid ABCDEFGHIJKLM doi '10.1007/s00283-010-9170-7'
    10.1007/s00283-010-9170-7

Check the `user_query`_ documentation to understand how to create query strings.

Example
-------

Obviously you can also use the python client programmatically:

.. code:: python

    from wos import WosClient
    import wos.utils

    with WosClient('JohnDoe', '12345') as client:
        print(wos.utils.query(client, 'AU=Knuth Donald'))

APIs
----

In ``wos`` 0.1.11+, the ``WosClient`` class can access the following APIs.

 - ``retrieve`` [`lite <http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/retrieve.html>`__ / `premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/retrieve.html>`__]

 - ``retrieveById`` [`lite <http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/retrieveById.html>`__ / `premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/retrieveById.html>`__]

 - ``search`` [`lite <http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/search.html>`__ / `premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/search.html>`__]

 - ``citedReferences`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/citedReferences.html>`__]

 - ``citedReferencesRetrieve`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/citedRefRetrieve.html>`__]

 - ``citingArticles`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/citingArticles.html>`__]

 - ``relatedRecords`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/relatedRecords.html>`__]

[FAQ] I cannot connect ...
--------------------------

I am not affiliated with Thomson Reuters. The library leverages the Web of Science `WWS`_ API (Web Services Premium or Lite), which is a paid service offered by Thomson Reuters. This means that your institution has to pay for the Web of Science Core Collection access. The simple registration to Web of Knowledge / Web of Science does not entitle you to access the WWS API service.

So if you receive errors like ``No matches returned for Username`` or ``No matches returned for IP``, these errors are thrown directly by the WWS API server. This means that the library is correctly communicating with the server, but you do not have access to the Web Services API. If you think this is an error and you should be entitled to access the services, please do not open an issue here but contact Thomson Reuters support, because the problem is on their side.


.. _PyPI: https://pypi.python.org
.. _user_query: http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/user_query.html
.. _WWS: http://wokinfo.com/products_tools/products/related/webservices/
            

Raw data

            {
    "_id": null,
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "cheesecake_code_kwalitee_id": null,
    "keywords": "wos isi web of science knowledge api client",
    "upload_time": "2018-01-24 11:28:18",
    "author": "Enrico Bacis",
    "home_page": "http://github.com/enricobacis/wos",
    "github_user": "enricobacis",
    "download_url": "https://pypi.python.org/packages/11/41/d39c3f01e08be9aebc46e5d3c28a1f40b4704530f8c5aaf484c981ac07e8/wos-0.1.15.tar.gz",
    "platform": "",
    "version": "0.1.15",
    "cheesecake_documentation_id": null,
    "description": "Description\n-----------\n\n.. image:: https://travis-ci.org/enricobacis/wos.svg?branch=master\n    :target: https://travis-ci.org/enricobacis/wos\n\nWeb of Science (previously Web of Knowledge) is an online subscription-based\nscientific citation indexing service maintained by Thomson Reuters.\n\n``wos`` is a python SOAP Client (both API and command-line tool) to query the\nWOS database in order to get XML data from a query using the WWS access.\n\nInstallation\n------------\n\nThe package has been uploaded to `PyPI`_, so you can\ninstall the package using pip:\n\n    pip install wos\n\nUsage\n-----\n\nYou can use the ``wos`` command to query the Web of Science API. If you want to\naccess data that needs to be accessed using the premium API, you also have to\nauthenticate using your username and password.\n\n\n    usage: wos [-h] [--close] [-l] [-u USER] [-p PASSWORD] [-s SID]\n               {query,doi,connect} ...\n\n    Query the Web of Science.\n\n    positional arguments:\n      {query,doi,connect}   sub-command help\n        query               query the Web of Science.\n        doi                 get the WOS ID from the DOI.\n        connect             connect and get an SID.\n\n    optional arguments:\n      -h, --help            show this help message and exit\n      --close               Close session.\n      --proxy PROXY         HTTP proxy\n      --timeout TIMEOUT     API timeout\n      -l, --lite            Wos Lite\n      -v, --verbose         Verbose\n\n    authentication:\n      API credentials for premium access.\n\n      -u USER, --user USER\n      -p PASSWORD, --password PASSWORD\n      -s SID, --sid SID\n\nYou can use the WOS Lite API using the ``--lite`` parameter (for each query).\n\nYou can also authenticate using the session id (SID). In fact the sessions are\nnot closed by the command line utility. Example:\n\n.. code::\n\n    $ wos --user JohnDoe --password 12345 connect\n    Authenticated using SID: ABCDEFGHIJKLM\n\n    $ wos --sid ABCDEFGHIJKLM query 'AU=Knuth Donald' -c1\n    Authenticated using SID: ABCDEFGHIJKLM\n    <?xml version=\"1.0\" ?>\n    <records>\n        <REC r_id_disclaimer=\"ResearcherID data provided by Thomson Reuters\">\n            <UID>WOS:000287850200007</UID>\n            <static_data>\n                <summary>\n                    <EWUID>\n                        <WUID coll_id=\"WOS\"/>\n                        <edition value=\"WOS.SCI\"/>\n                    </EWUID>\n                    <pub_info coverdate=\"MAR 2011\" has_abstract=\"N\" issue=\"1\"\n                              pubmonth=\"MAR\" pubtype=\"Journal\" pubyear=\"2011\"\n                              sortdate=\"2011-03-01\" vol=\"33\">\n                        <page begin=\"33\" end=\"45\" page_count=\"13\">33-45</page>\n                    </pub_info>\n                    <titles count=\"6\">\n                        <title type=\"source\">MATHEMATICAL INTELLIGENCER</title>\n    ....\n\n    $ wos --sid ABCDEFGHIJKLM doi '10.1007/s00283-010-9170-7'\n    10.1007/s00283-010-9170-7\n\nCheck the `user_query`_ documentation to understand how to create query strings.\n\nExample\n-------\n\nObviously you can also use the python client programmatically:\n\n.. code:: python\n\n    from wos import WosClient\n    import wos.utils\n\n    with WosClient('JohnDoe', '12345') as client:\n        print(wos.utils.query(client, 'AU=Knuth Donald'))\n\nAPIs\n----\n\nIn ``wos`` 0.1.11+, the ``WosClient`` class can access the following APIs.\n\n - ``retrieve`` [`lite <http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/retrieve.html>`__ / `premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/retrieve.html>`__]\n\n - ``retrieveById`` [`lite <http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/retrieveById.html>`__ / `premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/retrieveById.html>`__]\n\n - ``search`` [`lite <http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/search.html>`__ / `premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/search.html>`__]\n\n - ``citedReferences`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/citedReferences.html>`__]\n\n - ``citedReferencesRetrieve`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/citedRefRetrieve.html>`__]\n\n - ``citingArticles`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/citingArticles.html>`__]\n\n - ``relatedRecords`` [`premium <http://ipscience-help.thomsonreuters.com/wosWebServicesExpanded/WebServiceOperationsGroup/WSPremiumOperations/wokSearchGroup/relatedRecords.html>`__]\n\n[FAQ] I cannot connect ...\n--------------------------\n\nI am not affiliated with Thomson Reuters. The library leverages the Web of Science `WWS`_ API (Web Services Premium or Lite), which is a paid service offered by Thomson Reuters. This means that your institution has to pay for the Web of Science Core Collection access. The simple registration to Web of Knowledge / Web of Science does not entitle you to access the WWS API service.\n\nSo if you receive errors like ``No matches returned for Username`` or ``No matches returned for IP``, these errors are thrown directly by the WWS API server. This means that the library is correctly communicating with the server, but you do not have access to the Web Services API. If you think this is an error and you should be entitled to access the services, please do not open an issue here but contact Thomson Reuters support, because the problem is on their side.\n\n\n.. _PyPI: https://pypi.python.org\n.. _user_query: http://ipscience-help.thomsonreuters.com/wosWebServicesLite/WebServiceOperationsGroup/WebServiceOperations/g2/user_query.html\n.. _WWS: http://wokinfo.com/products_tools/products/related/webservices/",
    "lcname": "wos",
    "name": "wos",
    "github": true,
    "coveralls": false,
    "bugtrack_url": null,
    "license": "MIT",
    "travis_ci": true,
    "github_project": "wos",
    "summary": "Web of Science client using API v3.",
    "split_keywords": [
        "wos",
        "isi",
        "web",
        "of",
        "science",
        "knowledge",
        "api",
        "client"
    ],
    "author_email": "enrico.bacis@gmail.com",
    "urls": [
        {
            "has_sig": false,
            "upload_time": "2018-01-24T11:28:18",
            "comment_text": "",
            "python_version": "source",
            "url": "https://pypi.python.org/packages/11/41/d39c3f01e08be9aebc46e5d3c28a1f40b4704530f8c5aaf484c981ac07e8/wos-0.1.15.tar.gz",
            "md5_digest": "d8a2ad27afdd2edf474a83efbe9b8227",
            "downloads": 0,
            "filename": "wos-0.1.15.tar.gz",
            "packagetype": "sdist",
            "path": "11/41/d39c3f01e08be9aebc46e5d3c28a1f40b4704530f8c5aaf484c981ac07e8/wos-0.1.15.tar.gz",
            "size": 8137
        }
    ],
    "cheesecake_installability_id": null
}
        
Elapsed time: 0.09764s