Metadata-Version: 2.1
Name: reconciler
Version: 0.1.2
Summary: Python utility to reconcile Pandas DataFrames
Home-page: https://github.com/jvfe/reconciler
Author: João Vitor F. Cavalcante
Author-email: jvfe@ufrn.edu.br
License: BSD license
Description: # reconciler
        
        <!-- badges: start -->
        [![license](https://img.shields.io/badge/license-BSD%202--Clause-green)](https://github.com/jvfe/reconciler/blob/master/LICENSE)
        [![pytest status](https://github.com/jvfe/reconciler/workflows/reconciler/badge.svg)](https://github.com/jvfe/reconciler/actions)
        <!-- badges: end -->
        
        `reconciler` is a python package to reconcile tabular data with various reconciliation services, such as 
        [Wikidata](https://www.wikidata.org/wiki/Wikidata:Main_Page), working similarly to what [OpenRefine](https://openrefine.org/) 
        does, but entirely within Python, using Pandas.
        
        ## Quickstart
        
        You can install the latest version of reconciler from PyPI with:
        
        ``` bash
        pip install reconciler
        ```
        
        Then to use it:
        
        ```python
        from reconciler import reconcile
        import pandas as pd
        
        # A DataFrame with a column you want to reconcile.
        test_df = pd.DataFrame(
            {
                "City": ["Rio de Janeiro", "São Paulo", "São Paulo", "Natal"],
            }
        )
        
        # Reconcile against type city (Q515), getting the best match for each item.
        reconciled = reconcile(test_df["City"], type_id="Q515")
        ```
        
        The resulting dataframe would look like this:
        
        | id      | match   | name           |   score | type                   | type_id   | input_value    |
        |:--------|:--------|:---------------|--------:|:-----------------------|:-----------|:---------------|
        | Q8678   | True    | Rio de Janeiro |     100 | city                   | Q515       | Rio de Janeiro |
        | Q174    | True    | São Paulo      |     100 | city                   | Q515       | São Paulo      |
        | Q131620 | True    | Natal          |     100 | municipality of Brazil | Q3184121   | Natal          |
        
        Check out the [documentation](https://jvfe.github.io/reconciler/) for more advanced usage and to learn [how to contribute](https://jvfe.github.io/reconciler/contributing/).
        
Keywords: tabular wikidata opendata linked-data
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
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
Description-Content-Type: text/markdown
