Metadata-Version: 2.1
Name: privacypanda
Version: 0.1.0
Summary: Anonymizing pandas dataframes
Home-page: https://github.com/TTitcombe/PrivacyPanda
Author: Tom Titcombe
Author-email: t.j.titcombe@gmail.com
License: Apache 2.0
Description: ![](https://github.com/TTitcombe/PrivacyPanda/workflows/Test%20build/badge.svg)
        [![Binder](https://mybinder.org/badge_logo.svg)][binder]
        [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE)
        ![](https://img.shields.io/badge/privacy-protecting-black)
        
        
        <p align="center">
          <img src="images/logo.png">
        </p>
        
        # PrivacyPanda
        **PrivacyPanda** is a package for detecting and removing personal, private data (such as names and addresses) from [**pandas**][pandas] dataframes.
        
        ## Why privacypanda
        The volume of available information - personal, private information - of each and every one of us is vast and growing. This information can be used to build such a clear picture of who you are that bad actors can know you better than your partner does. In the wrong hands, this data can influence the way you shop, the way you vote, the way you think...
        
        A necessary step to protect ourselves is to anonymize data - to strip it of any identifying features like our names or addresses. While many of the people handling private data are trustworthy, honest and ethical, we can't always trust that they will successfully scrub a dataset of any information which may be used against us.
        
        `privacypanda` aims to make data anonymization a little bit easier by providing tools to detect identifying features in [`pandas`][pandas] dataframes and expunge them.
        
        ## How to install
        `privacypanda` requires python of `3.7` or above and `pandas >= 1.0.0`.
        
        `privacypanda` can be installed via [pypi](https://pypi.org/) via 
        ```pip install privacypanda```
        
        Alternatively, to install from source:
        1. clone the repository
        2. navigate to the project folder
        3. run `pip install -e .`
        
        ## How to use
        See the [example notebooks](./examples/) for more extensive usage.
        [Click this link][binder] to run the example notebooks online.
        
        With `privacypanda` you can audit the privacy of your dataframe:
        ```python
        import pandas as pd
        import privacypanda as pp
        
        data = pd.DataFrame(
            {
                "privateData":
                    [
                        "an@email.com",
                        "AB1 1AB",
                        "Some other data",
                    ],
                "nonPrivateData":
                    [
                        1,
                        2,
                        3,
                    ],
            }
        )
        
        print(pp.report_privacy(data))
        ```
        
        This prints the names of any colums in the data which break privacy,
        and the ways in which privacy is broken.
        
        ```python
        >>> "privateData": ["address", "email"]
        ```
        
        ## Contributing
        All contributions are important and welcomed.
        Please see the [contributing guide](./CONTRIBUTING.md) for more information.
        
        ## License
        The **PrivacyPanda** project is licensed with Apache 2.0.
        Please refer to the [license](./LICENSE) for more information.
        
        
        [binder]: https://mybinder.org/v2/gh/TTitcombe/PrivacyPanda/master
        [pandas]: https://pandas.pydata.org/
        
Keywords: anonymization privacy pandas privacy-preserving data science
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Security
Requires-Python: >=3.7
Description-Content-Type: text/markdown
