WatsonExplorer


NameWatsonExplorer JSON
Version 2.0.1 PyPI version JSON
download
home_page
SummaryLook into the data of your DataFrames with Watson Explorer
upload_time2024-01-13 13:56:57
maintainer
docs_urlNone
author
requires_python>=3.8
license
keywords pandas polars explorer watson
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Watson Explorer

Explore the data in your Pandas DataFrames using Watson Explorer.

## Installation

Use the package manager [pip](https://pypi.org/project/WatsonExplorer/) to install Watson Explorer.

```bash
pip install WatsonExplorer
```

<p align="right">(<a href="#readme-top">back to top</a>)</p>

## Usage

```python
from WatsonExplorer import Explorer

"""Place the following statement at the end of your Python file."""
Explorer()

"""
After running the script, it will extract all the dataframes from the file, delete all old HTML files, create new HTML files, and open a local host to display the DataFrames. 
You can access the DataFrames using the dropdown menu. To stop the local host, click on the 'Stop Server' button, and the tab sheet will automatically close.
"""

"""REMARK:
It is not possible to view data from dataframes that are not linked to variables.
For example:
"""

example_dict = {'A' : [1,2,3,4], 'B' : [5,6,7,8]}

class Example():
    def __init__(self, dictionary=None):
        self.dataframe = pd.DataFrame(example_dict)
    
    def return_df_1(self):
        return self.dataframe
    
    def return_df_2(self):
        self.dataframe2 = self.dataframe.assign(D='Test')
        return self.dataframe2

example = Example(example_dict)
example.return_df_1() # The explorer will not include this dataframe.
example_df = example.return_df_2() # The explorer will include this dataframe.

"""REMARK 2:
This library is not designed to load more than 20,000 rows (yet). We recommend using .head() to reduce the size of your dataframe before using this library.
"""
```
<p align="right">(<a href="#readme-top">back to top</a>)</p>

## Contributing

### General
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. <br>
Please make sure to update tests as appropriate.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### CSS
Feel free to adjust the CSS file if you don't like the styling.<br>
Also, if you are a very gifted front-end developer, please let me know. I'm open to upgrading the interface.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

## License
Distributed under the MIT License. See `LICENSE.txt` for more information.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

## Contact
Contact: https://heinburgmans.com <br>
Project Link: https://github.com/HeintjeB/watson

<p align="right">(<a href="#readme-top">back to top</a>)</p>

## Acknowledgments
The creation of this explorer was inspired by Spyder's Variable Explorer.
Shout-out to DataTables.net whose code heavily improved this library!

<p align="right">(<a href="#readme-top">back to top</a>)</p>

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "WatsonExplorer",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "",
    "keywords": "pandas,polars,explorer,watson",
    "author": "",
    "author_email": "HeintjeB <heinburgmans@gmail.com>",
    "download_url": "",
    "platform": null,
    "description": "# Watson Explorer\r\n\r\nExplore the data in your Pandas DataFrames using Watson Explorer.\r\n\r\n## Installation\r\n\r\nUse the package manager [pip](https://pypi.org/project/WatsonExplorer/) to install Watson Explorer.\r\n\r\n```bash\r\npip install WatsonExplorer\r\n```\r\n\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n\r\n## Usage\r\n\r\n```python\r\nfrom WatsonExplorer import Explorer\r\n\r\n\"\"\"Place the following statement at the end of your Python file.\"\"\"\r\nExplorer()\r\n\r\n\"\"\"\r\nAfter running the script, it will extract all the dataframes from the file, delete all old HTML files, create new HTML files, and open a local host to display the DataFrames. \r\nYou can access the DataFrames using the dropdown menu. To stop the local host, click on the 'Stop Server' button, and the tab sheet will automatically close.\r\n\"\"\"\r\n\r\n\"\"\"REMARK:\r\nIt is not possible to view data from dataframes that are not linked to variables.\r\nFor example:\r\n\"\"\"\r\n\r\nexample_dict = {'A' : [1,2,3,4], 'B' : [5,6,7,8]}\r\n\r\nclass Example():\r\n    def __init__(self, dictionary=None):\r\n        self.dataframe = pd.DataFrame(example_dict)\r\n    \r\n    def return_df_1(self):\r\n        return self.dataframe\r\n    \r\n    def return_df_2(self):\r\n        self.dataframe2 = self.dataframe.assign(D='Test')\r\n        return self.dataframe2\r\n\r\nexample = Example(example_dict)\r\nexample.return_df_1() # The explorer will not include this dataframe.\r\nexample_df = example.return_df_2() # The explorer will include this dataframe.\r\n\r\n\"\"\"REMARK 2:\r\nThis library is not designed to load more than 20,000 rows (yet). We recommend using .head() to reduce the size of your dataframe before using this library.\r\n\"\"\"\r\n```\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n\r\n## Contributing\r\n\r\n### General\r\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. <br>\r\nPlease make sure to update tests as appropriate.\r\n\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n\r\n### CSS\r\nFeel free to adjust the CSS file if you don't like the styling.<br>\r\nAlso, if you are a very gifted front-end developer, please let me know. I'm open to upgrading the interface.\r\n\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n\r\n## License\r\nDistributed under the MIT License. See `LICENSE.txt` for more information.\r\n\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n\r\n## Contact\r\nContact: https://heinburgmans.com <br>\r\nProject Link: https://github.com/HeintjeB/watson\r\n\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n\r\n## Acknowledgments\r\nThe creation of this explorer was inspired by Spyder's Variable Explorer.\r\nShout-out to DataTables.net whose code heavily improved this library!\r\n\r\n<p align=\"right\">(<a href=\"#readme-top\">back to top</a>)</p>\r\n",
    "bugtrack_url": null,
    "license": "",
    "summary": "Look into the data of your DataFrames with Watson Explorer",
    "version": "2.0.1",
    "project_urls": {
        "BugTracker": "https://github.com/HeintjeB/watson/issues",
        "Changelog": "https://github.com/HeintjeB/watson/blob/main/CHANGELOG.md",
        "Homepage": "https://cobra-ms.com",
        "Repository": "https://github.com/HeintjeB/watson"
    },
    "split_keywords": [
        "pandas",
        "polars",
        "explorer",
        "watson"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "92e5ea9d557890b94bee371a50bf5eaeb2f1f98ed15a0be2377ad6facc87ee6a",
                "md5": "c77c53bca980c6929075e794608743a1",
                "sha256": "6db65d71a64faf294e130690b9b97f35c3827ef5d16ec3a6ddd101986a862e31"
            },
            "downloads": -1,
            "filename": "WatsonExplorer-2.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "c77c53bca980c6929075e794608743a1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 5642,
            "upload_time": "2024-01-13T13:56:57",
            "upload_time_iso_8601": "2024-01-13T13:56:57.914316Z",
            "url": "https://files.pythonhosted.org/packages/92/e5/ea9d557890b94bee371a50bf5eaeb2f1f98ed15a0be2377ad6facc87ee6a/WatsonExplorer-2.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-01-13 13:56:57",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "HeintjeB",
    "github_project": "watson",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "watsonexplorer"
}
        
Elapsed time: 3.18631s