Metadata-Version: 1.1
Name: whotracksme
Version: 2017.11
Summary: Learn about tracking technologies, market structure and data-sharing on the web
Home-page: https://whotracks.me
Author: Cliqz Gmbh
Author-email: privacy@cliqz.com
License: MIT
Description-Content-Type: UNKNOWN
Description: 
        
        <img
        alt="whotracks.me"
        style="width: 200px"
        src="https://raw.githubusercontent.com/cliqz-oss/whotracks.me/master/static/img/who-tracksme-logo.png">
        
        Bringing Transparency to online tracking - built by Cliqz and Ghostery.
        
        ___
        
        This repository contains:
        
        * data on trackers and websites as shown on [whotracks.me](https://whotracks.me) (`./data`)
        * database mapping tracker domains to companies (`./db`)
        * code to render the [whotracks.me](https://whotracks.me) site
        
        
        # Installation
        
        Python 3.x is needed to build the site. We recommend creating a
        [virtualenv](http://docs.python-guide.org/en/latest/dev/virtualenvs/) (or
        `pipenv`) to install the dependencies.
        
        ## From Pypi
        
        ```sh
        $ pip install whotracksme
        ```
        
        ## From source
        
        ```sh
        $ pip install -e .
        ```
        
        That's all you need to get started!
        
        # Using the data
        
        To get started with the data, everything you need can be found in
        `whotracksme.data`:
        
        ```python
        from whotracksme.data import (
            load_apps,
            load_companies,
            load_overview,
            load_sites,
            load_tracker_db,
        )
        
        print(load_apps())
        ```
        
        For more examples of scripts, have a look in the [contrib](./contrib) folder!
        
        # Building the site
        
        Building the site requires a few extra dependencies, not installed by default to
        not make the installation heavier than it needs to be. You will need to install
        `whotracksme` this way:
        
        ```sh
        $ pip install 'whotracksme[website]'
        ```
        
        Or if you do it from source:
        ```sh
        $ pip install -e '.[website]'
        ```
        
        *Furthermore* you also need to [install sass](http://sass-lang.com/install).
        
        
        Once this is done, you will have access to a `whotracksme` entry point that can
        be used this way:
        
        ```sh
        $ whotracksme website [serve]
        ```
        
        The `serve` part is optional and can be used while making changes on the
        website.
        
        All generated artifacts can be found in the `_site/` folder.
        
        ## Tests
        
        To run tests, you will need `pytest`, or simply install `whotacksme` with the
        `test` extra:
        
        ```sh
        $ pip install -e '.[test,website]'
        $ pytest
        ```
        
        # Contributing
        
        We are happy to take contributions on:
        * guest articles for our blog in the topics of tracking, privacy and security. Feel free to use the data in this repository if you need inspiration.
        * Curating our database of tracker profiles.
        
        
        # License
        
        The content of this project itself is licensed under the [Creative Commons Attribution 4.0 license](https://creativecommons.org/licenses/by/4.0/), and the underlying
        source code used to generate and display that content is licensed under the [MIT license](https://github.com/cliqz-oss/whotracks.me/blob/master/LICENSE.md).
        
Keywords: tracking whotracksme whotracks.me
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Internet
Classifier: Topic :: Scientific/Engineering :: Information Analysis
