Metadata-Version: 2.1
Name: wikidata2df
Version: 0.1.0
Summary: Utility package for easily turning a SPARQL query into a dataframe
Home-page: https://github.com/jvfe/wikidata2df
Author: João Vitor F. Cavalcante
Author-email: jvfe@ufrn.edu.br
License: BSD license
Keywords: wikidata2df wikidata open-data open data utility
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Requires-Dist: requests
Requires-Dist: pandas

===========
wikidata2df
===========


.. image:: https://img.shields.io/pypi/v/wikidata2df.svg
        :target: https://pypi.python.org/pypi/wikidata2df

.. image:: https://img.shields.io/travis/jvfe/wikidata2df.svg
        :target: https://travis-ci.com/jvfe/wikidata2df

.. image:: https://readthedocs.org/projects/wikidata2df/badge/?version=latest
        :target: https://wikidata2df.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


Utility package for easily turning a SPARQL query into a dataframe

Ever wished you could easily and programatically get data from Wikidata into a nice and analysable Pandas DataFrame?
Well, this package solves that problem: With a single function you can turn your SPARQL query into a pandas DataFrame,
without having to deal with the messy JSON intermediate. 


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


Basic Usage
-----------

To install::

    $ pip install wikidata2df


::

    from wikidata2df import wikidata2df

    # A SPARQL query to return all cats in Wikidata!    

    cat_query = """
    #Cats
    SELECT ?item ?itemLabel 
    WHERE 
    {
    ?item wdt:P31 wd:Q146.
    SERVICE wikibase:label { bd:serviceParam wikibase:language "[AUTO_LANGUAGE],en". }
    }
    """

    cats_dataframe = wikidata2df(cat_query) # Returns a Pandas DataFrame

Alternatives
------------

* Maybe you want more sofisticated functions? Or a way to edit Wikidata programatically? Awesome!

        * Check out `WikidataIntegrator <https://github.com/SuLab/WikidataIntegrator>`__

* Would you rather use R? That's cool too!

        * Check out `WikidataQueryServiceR <https://github.com/wikimedia/WikidataQueryServiceR>`__

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.1.0 (2020-08-08)
------------------

* First release on PyPI.


