tinderdata


Nametinderdata JSON
Version 0.4.2 PyPI version JSON
download
home_pageNone
SummaryA silly utility to explore your Tinder data.
upload_time2024-07-26 13:32:22
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords utility visualisation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <h1 align="center">
  <b>tinderdata</b>
</h1>

A very simple package to get insight on your Tinder usage.

## Install

This code is compatible with all currently supported Python versions.
Install it in your virtual enrivonment with:

```bash
python -m pip install tinderdata
```

## Usage

This utility requires that you export your data from the Tinder platform, as described [here](https://www.help.tinder.com/hc/en-us/articles/115005626726-How-do-I-request-a-copy-of-my-personal-data-).
You should obtain a single `tinderdata.json` file, which is the input required for this script.

With this package installed in the activated enrivonment, it can be called through `python -m tinderdata` or through a newly created `tinderdata` command.

Detailed usage goes as follows:

```bash
 Usage: python -m tinderdata [OPTIONS] [DATA_PATH]                                      
                                                                                        
 Get insight on your Tinder usage.                                                      
                                                                                        
╭─ Arguments ──────────────────────────────────────────────────────────────────────────╮
│   data_path      [DATA_PATH]  Location, relative or absolute, of the exported JSON   │
│                               file with your user data.                              │
│                               [default: None]                                        │
╰──────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────────────╮
│ --show-figures          --no-show-figures          Whether or not to show figures    │
│                                                    when plotting insights.           │
│                                                    [default: no-show-figures]        │
│ --save-figures          --no-save-figures          Whether or not to save figures    │
│                                                    when plotting insights.           │
│                                                    [default: no-save-figures]        │
│ --log-level                                  TEXT  The base console logging level.   │
│                                                    Can be 'debug', 'info', 'warning' │
│                                                    and 'error'.                      │
│                                                    [default: info]                   │
│ --install-completion                               Install completion for the        │
│                                                    current shell.                    │
│ --show-completion                                  Show completion for the current   │
│                                                    shell, to copy it or customize    │
│                                                    the installation.                 │
│ --help                                             Show this message and exit.       │
╰──────────────────────────────────────────────────────────────────────────────────────╯
```

An example command is then:

```bash
python -m tinderdata path_to_tinderdata.json --save-figures --log-level debug
```

The script print out a number of insight statements, and finally the text you should paste to get a Sankey diagram.
It will then create a `plots` folder and populate it with visuals.

You can otherwise import the high-level object from the package, and use at your convenience:

```python
from tinderdata import TinderData

tinder = TinderData("path/to/tinderdata.json")
tinder.output_sankey_string()
tinder.plot_messages_loyalty(showfig=True, savefig=False)
```

## Output example

Here are examples of the script's outputs:

![Example_1](plots/messages_monthly_stats.png)

![Example_2](plots/swipes_weekdays_stats.png)

---

<div align="center">
  <sub><strong>Made with ♥︎ by fsoubelet</strong></sub>
  <br>
  <sub><strong>MIT &copy 2019 Felix Soubelet</strong></sub>
</div>

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "tinderdata",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "Utility, Visualisation",
    "author": null,
    "author_email": "Felix Soubelet <felix.soubelet@cern.ch>",
    "download_url": "https://files.pythonhosted.org/packages/b5/ba/732470cfb76f99a593583055aaa9aed6374eafc5fb7d2e51d517aea7a829/tinderdata-0.4.2.tar.gz",
    "platform": null,
    "description": "<h1 align=\"center\">\n  <b>tinderdata</b>\n</h1>\n\nA very simple package to get insight on your Tinder usage.\n\n## Install\n\nThis code is compatible with all currently supported Python versions.\nInstall it in your virtual enrivonment with:\n\n```bash\npython -m pip install tinderdata\n```\n\n## Usage\n\nThis utility requires that you export your data from the Tinder platform, as described [here](https://www.help.tinder.com/hc/en-us/articles/115005626726-How-do-I-request-a-copy-of-my-personal-data-).\nYou should obtain a single `tinderdata.json` file, which is the input required for this script.\n\nWith this package installed in the activated enrivonment, it can be called through `python -m tinderdata` or through a newly created `tinderdata` command.\n\nDetailed usage goes as follows:\n\n```bash\n Usage: python -m tinderdata [OPTIONS] [DATA_PATH]                                      \n                                                                                        \n Get insight on your Tinder usage.                                                      \n                                                                                        \n\u256d\u2500 Arguments \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502   data_path      [DATA_PATH]  Location, relative or absolute, of the exported JSON   \u2502\n\u2502                               file with your user data.                              \u2502\n\u2502                               [default: None]                                        \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n\u256d\u2500 Options \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502 --show-figures          --no-show-figures          Whether or not to show figures    \u2502\n\u2502                                                    when plotting insights.           \u2502\n\u2502                                                    [default: no-show-figures]        \u2502\n\u2502 --save-figures          --no-save-figures          Whether or not to save figures    \u2502\n\u2502                                                    when plotting insights.           \u2502\n\u2502                                                    [default: no-save-figures]        \u2502\n\u2502 --log-level                                  TEXT  The base console logging level.   \u2502\n\u2502                                                    Can be 'debug', 'info', 'warning' \u2502\n\u2502                                                    and 'error'.                      \u2502\n\u2502                                                    [default: info]                   \u2502\n\u2502 --install-completion                               Install completion for the        \u2502\n\u2502                                                    current shell.                    \u2502\n\u2502 --show-completion                                  Show completion for the current   \u2502\n\u2502                                                    shell, to copy it or customize    \u2502\n\u2502                                                    the installation.                 \u2502\n\u2502 --help                                             Show this message and exit.       \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n```\n\nAn example command is then:\n\n```bash\npython -m tinderdata path_to_tinderdata.json --save-figures --log-level debug\n```\n\nThe script print out a number of insight statements, and finally the text you should paste to get a Sankey diagram.\nIt will then create a `plots` folder and populate it with visuals.\n\nYou can otherwise import the high-level object from the package, and use at your convenience:\n\n```python\nfrom tinderdata import TinderData\n\ntinder = TinderData(\"path/to/tinderdata.json\")\ntinder.output_sankey_string()\ntinder.plot_messages_loyalty(showfig=True, savefig=False)\n```\n\n## Output example\n\nHere are examples of the script's outputs:\n\n![Example_1](plots/messages_monthly_stats.png)\n\n![Example_2](plots/swipes_weekdays_stats.png)\n\n---\n\n<div align=\"center\">\n  <sub><strong>Made with \u2665\ufe0e by fsoubelet</strong></sub>\n  <br>\n  <sub><strong>MIT &copy 2019 Felix Soubelet</strong></sub>\n</div>\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A silly utility to explore your Tinder data.",
    "version": "0.4.2",
    "project_urls": {
        "homepage": "https://github.com/fsoubelet/Tinder_Data",
        "repository": "https://github.com/fsoubelet/Tinder_Data"
    },
    "split_keywords": [
        "utility",
        " visualisation"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d7f5269ec9317c39b08ab93d7234dfb2cd5ca77a13079ea2d084a9e878922b1b",
                "md5": "09551f18ec41ef394da1e8c9cbd3c04c",
                "sha256": "b0afb7e124074fb4f96ef726f67ae96b3983d8123aad91ee92b8751231c61688"
            },
            "downloads": -1,
            "filename": "tinderdata-0.4.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "09551f18ec41ef394da1e8c9cbd3c04c",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 12140,
            "upload_time": "2024-07-26T13:32:23",
            "upload_time_iso_8601": "2024-07-26T13:32:23.874082Z",
            "url": "https://files.pythonhosted.org/packages/d7/f5/269ec9317c39b08ab93d7234dfb2cd5ca77a13079ea2d084a9e878922b1b/tinderdata-0.4.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b5ba732470cfb76f99a593583055aaa9aed6374eafc5fb7d2e51d517aea7a829",
                "md5": "1466479d0f4a3483ba8f819a1eba7c07",
                "sha256": "3db02f1ca9e12822e00ce3e10ed7c15e020eb07351a54ff19c21cf547a45f2fb"
            },
            "downloads": -1,
            "filename": "tinderdata-0.4.2.tar.gz",
            "has_sig": false,
            "md5_digest": "1466479d0f4a3483ba8f819a1eba7c07",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 5410174,
            "upload_time": "2024-07-26T13:32:22",
            "upload_time_iso_8601": "2024-07-26T13:32:22.122741Z",
            "url": "https://files.pythonhosted.org/packages/b5/ba/732470cfb76f99a593583055aaa9aed6374eafc5fb7d2e51d517aea7a829/tinderdata-0.4.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-07-26 13:32:22",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "fsoubelet",
    "github_project": "Tinder_Data",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "tinderdata"
}
        
Elapsed time: 0.36220s