<h4 align='center'>
<img src="data_visualizer/media/images/Data-V-Logo-500-200.png" alt="Project logo"/>
<br>
<br>
V. 0.1.7
</h4>
<br>
<h1> Project Description</h1>
A python program that visualizes data from a `.csv` file. It uses the [PySimpleGui](https://github.com/PySimpleGUI) python library for its GUI.
At the moment, this program can only read data from `.csv` files, but in the future I plan on adding support for other filetypes, and an option to connect to a SQL or a MongoDb database.
<h1> Table of Contents </h1>
- [Features](#features)
- [Display data](#display-data)
- [Search data](#search-data)
- [Filter data](#filter-data)
- [Installation](#installation)
- [Using pip](#using-pip)
- [From source](#from-source)
- [Usage](#usage)
- [Pip](#pip)
- [Manually](#manually)
- [Dependencies](#dependencies)
- [PySimpleGui](#pysimplegui)
- [Tkinter](#tkinter)
- [Pip installation](#pip-installation)
- [File Support](#file-support)
- [Header bug](#header-bug)
- [Bug example](#bug-example)
- [License](#license)
- [PySimpleGui](#pysimplegui-1)
# Features
If you want to test the program yourself, I recommend you visit the page [mockaroo](https://mockaroo.com/) to get some sample data in `.csv` format.
## Display data
<div align="center">
<img src="data_visualizer/media/gifs/open-gif.gif" width="500" alt="gif-display-data">
</div>
<br>
## Search data
<div align="center">
<img src="data_visualizer/media/gifs/search-gif.gif" width="500" alt="gif-search-data">
</div>
<br>
## Filter data
<div align="center">
<img src="data_visualizer/media/gifs/filter-gif.gif" width="500" alt="gif-filter-data">
</div>
<br>
---
# Installation
### Using pip
Data visualizer can be installed with pip, along with all the program dependencies in the case they aren't installed. To do so, run the follow command:
```shell
pip install data-visualizer
```
### From source
On the other hand, if you want to, you can also download the program from the repo. If you want to do so, follow these steps to do so.
1. Clone the repo into your local machine:
<div align="center">
<img src="data_visualizer/media/gifs/clone-repo.gif" width="500" alt="gif-clone-repo">
</div>
<br>
2. Open the cloned folder and run the `"data_visualizer"` folder as a module with the following command:
```shell
python3 -m data_visualizer
```
---
# Usage
There are several ways in which you can open the program.
## Pip
If Data Visualizer was installed with pip, you can run the program in the terminal by simple writing `data-visualizer` in the terminal. The program will then open.
## Manually
Another way you can run the program is by opening either the module folder installed by pip, or the cloned folder from the repo. Then, once inside the folder, simply run the `data_visualizer` folder as a python module with the following command:
```shell
python3 -m data_visualizer
```
# Dependencies
## PySimpleGui
By default, Data Visualizer's `setup.py` file was setup in a way that automatically downloads all the packages the program uses and depends of. However, if for some reason you want to install them yourself, Data Visualizer requires the PySimpleGui library to work.
You can install them with pip using the following commands:
```shell
pip install PySimpleGUI
```
In the case that you don't have pip, scroll down to the [Pip Instalation](#pip-installation) section to see how to install it.
---
### Tkinter
Data Visualizer is made using the PySimpleGui library, which uses Tkinter under the hood. So, it is very important to have Tkinter already setup to your Python version for Data Visualizer to work.
If you don't have Tkinter already with your Python configuration, you will need to do that first.
- Windows: [Follow this video guide](https://www.youtube.com/watch?v=O2PzLeiBEuE).
- MacOs (Using Homebrew): `brew install python-tk`
- Linux (Ubuntu): `sudo apt-get update && sudo apt-get install python3-tk`
---
## Pip installation
Don't have pip? You can install it like this:
<h4>Linux & MacOs</h4>
```shell
python3 -m ensurepip
```
<h4>Windows</h4>
```shell
py -m ensurepip
```
Please note that the installation of pip in windows can sometimes be... _complicated_. If you are having problems making pip work, I recommend you this [video guide](https://youtu.be/c_qNC1lL4qA) on how to install it.
# File Support
Data visualizer supports the following types of files:
| File Type | Support |
| --------- | ------- |
| .csv | ✅ |
| .json | ❌ |
| SQL | 📅 |
| Mongodb | ❌ |
Keywords: `✅ Yes`, `❌ No`, `📅 work in progress`
# Header bug
Currently, there's a bug where the first row of header-less `.csv` files gets confused for the file's headers. This happens because Data Visualizer always takes the first row of a .csv file that comes with pre-defined headers, and uses it as the headers of the file. The usefulness of this feature can be seen with files that has its data pre-categorize in the forms of these headers. However, for files that don't do this , this feature becomes a problem.
The nature of this bug makes it pretty difficult to fix, but with time, I think I'll be able to get it done. So, keep that in mind while working with files wihout a proper header for the time being.
## Bug example
Note: The files used in this example were taken from [mockaroo](https://mockaroo.com/).
<hr>
<div align='center'>
<p>File with pre-defined headers</p>
<img src="./design/With%20Headers%20example.png" alt='example of file with headers' width='500'>
<hr>
<p>File without pre-defined headers</p>
<img src="./design/Header-less%20example.png" alt='example of file without headers' width='500'>
</div>
<!-- # Changelog
[❯ Read the changelog here →](changelog.md) 📄 -->
# License
This project makes use of the MIT license. To read more about it, you can check it out [here](LICENSE.md).
### PySimpleGui
This project makes uses of the PySimpleGui python library, which makes use of the LGPL-3.0 license. Read more about this license in the project repo [here](https://github.com/PySimpleGUI/PySimpleGUI/blob/master/license.txt).
Raw data
{
"_id": null,
"home_page": "https://github.com/AsleyR/Data-Visualizer",
"name": "data-visualizer",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python,data,csv,visualization,data visualization,data parsing",
"author": "Asley R.",
"author_email": "asleyrobleto@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d7/de/101b92bd1211e26e153e1bd5e9e44295463eb8ae74108d3ec6b6bc85449a/data-visualizer-0.1.8.tar.gz",
"platform": null,
"description": "\n<h4 align='center'>\n <img src=\"data_visualizer/media/images/Data-V-Logo-500-200.png\" alt=\"Project logo\"/>\n <br>\n <br>\n V. 0.1.7\n</h4>\n\n<br>\n\n<h1> Project Description</h1>\n\nA python program that visualizes data from a `.csv` file. It uses the [PySimpleGui](https://github.com/PySimpleGUI) python library for its GUI.\n\nAt the moment, this program can only read data from `.csv` files, but in the future I plan on adding support for other filetypes, and an option to connect to a SQL or a MongoDb database.\n\n<h1> Table of Contents </h1>\n\n- [Features](#features)\n - [Display data](#display-data)\n - [Search data](#search-data)\n - [Filter data](#filter-data)\n- [Installation](#installation)\n - [Using pip](#using-pip)\n - [From source](#from-source)\n- [Usage](#usage)\n - [Pip](#pip)\n - [Manually](#manually)\n- [Dependencies](#dependencies)\n - [PySimpleGui](#pysimplegui)\n - [Tkinter](#tkinter)\n - [Pip installation](#pip-installation)\n- [File Support](#file-support)\n- [Header bug](#header-bug)\n - [Bug example](#bug-example)\n- [License](#license)\n - [PySimpleGui](#pysimplegui-1)\n\n# Features\n\nIf you want to test the program yourself, I recommend you visit the page [mockaroo](https://mockaroo.com/) to get some sample data in `.csv` format.\n\n## Display data\n\n<div align=\"center\">\n<img src=\"data_visualizer/media/gifs/open-gif.gif\" width=\"500\" alt=\"gif-display-data\">\n</div>\n<br>\n\n## Search data\n\n<div align=\"center\">\n<img src=\"data_visualizer/media/gifs/search-gif.gif\" width=\"500\" alt=\"gif-search-data\">\n</div>\n\n<br>\n\n## Filter data\n\n<div align=\"center\">\n<img src=\"data_visualizer/media/gifs/filter-gif.gif\" width=\"500\" alt=\"gif-filter-data\">\n</div>\n\n<br>\n\n---\n\n# Installation\n\n### Using pip\n\nData visualizer can be installed with pip, along with all the program dependencies in the case they aren't installed. To do so, run the follow command:\n\n```shell\npip install data-visualizer\n```\n\n### From source\n\nOn the other hand, if you want to, you can also download the program from the repo. If you want to do so, follow these steps to do so.\n\n1. Clone the repo into your local machine:\n\n<div align=\"center\">\n<img src=\"data_visualizer/media/gifs/clone-repo.gif\" width=\"500\" alt=\"gif-clone-repo\">\n</div>\n\n<br>\n\n 2. Open the cloned folder and run the `\"data_visualizer\"` folder as a module with the following command:\n\n ```shell\n python3 -m data_visualizer\n ```\n\n---\n\n# Usage\n\nThere are several ways in which you can open the program.\n\n## Pip\n\nIf Data Visualizer was installed with pip, you can run the program in the terminal by simple writing `data-visualizer` in the terminal. The program will then open.\n\n## Manually\n\nAnother way you can run the program is by opening either the module folder installed by pip, or the cloned folder from the repo. Then, once inside the folder, simply run the `data_visualizer` folder as a python module with the following command:\n\n```shell\npython3 -m data_visualizer\n```\n\n# Dependencies\n\n## PySimpleGui\n\nBy default, Data Visualizer's `setup.py` file was setup in a way that automatically downloads all the packages the program uses and depends of. However, if for some reason you want to install them yourself, Data Visualizer requires the PySimpleGui library to work.\n\nYou can install them with pip using the following commands:\n\n```shell\npip install PySimpleGUI\n```\n\nIn the case that you don't have pip, scroll down to the [Pip Instalation](#pip-installation) section to see how to install it.\n\n---\n\n### Tkinter\nData Visualizer is made using the PySimpleGui library, which uses Tkinter under the hood. So, it is very important to have Tkinter already setup to your Python version for Data Visualizer to work.\n\nIf you don't have Tkinter already with your Python configuration, you will need to do that first.\n\n- Windows: [Follow this video guide](https://www.youtube.com/watch?v=O2PzLeiBEuE).\n- MacOs (Using Homebrew): `brew install python-tk`\n- Linux (Ubuntu): `sudo apt-get update && sudo apt-get install python3-tk`\n\n---\n\n## Pip installation\n\nDon't have pip? You can install it like this:\n\n<h4>Linux & MacOs</h4>\n\n```shell\npython3 -m ensurepip\n```\n\n<h4>Windows</h4>\n\n```shell\npy -m ensurepip\n```\nPlease note that the installation of pip in windows can sometimes be... _complicated_. If you are having problems making pip work, I recommend you this [video guide](https://youtu.be/c_qNC1lL4qA) on how to install it.\n\n# File Support\n\nData visualizer supports the following types of files:\n\n| File Type | Support |\n| --------- | ------- |\n| .csv | \u2705 |\n| .json | \u274c |\n| SQL | \ud83d\udcc5 |\n| Mongodb | \u274c |\n\nKeywords: `\u2705 Yes`, `\u274c No`, `\ud83d\udcc5 work in progress`\n\n# Header bug\n\nCurrently, there's a bug where the first row of header-less `.csv` files gets confused for the file's headers. This happens because Data Visualizer always takes the first row of a .csv file that comes with pre-defined headers, and uses it as the headers of the file. The usefulness of this feature can be seen with files that has its data pre-categorize in the forms of these headers. However, for files that don't do this , this feature becomes a problem.\n\nThe nature of this bug makes it pretty difficult to fix, but with time, I think I'll be able to get it done. So, keep that in mind while working with files wihout a proper header for the time being.\n\n## Bug example\n\nNote: The files used in this example were taken from [mockaroo](https://mockaroo.com/).\n\n<hr>\n\n<div align='center'>\n\n<p>File with pre-defined headers</p>\n<img src=\"./design/With%20Headers%20example.png\" alt='example of file with headers' width='500'>\n\n<hr>\n\n<p>File without pre-defined headers</p>\n<img src=\"./design/Header-less%20example.png\" alt='example of file without headers' width='500'>\n</div>\n\n<!-- # Changelog\n\n[\u276f Read the changelog here \u2192](changelog.md) \ud83d\udcc4 -->\n\n# License\n\nThis project makes use of the MIT license. To read more about it, you can check it out [here](LICENSE.md).\n\n### PySimpleGui\n\nThis project makes uses of the PySimpleGui python library, which makes use of the LGPL-3.0 license. Read more about this license in the project repo [here](https://github.com/PySimpleGUI/PySimpleGUI/blob/master/license.txt).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "'Python program that visualizes data from a .csv file.'",
"version": "0.1.8",
"split_keywords": [
"python",
"data",
"csv",
"visualization",
"data visualization",
"data parsing"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "9bb2fda6280da0a765d7bf5b4de4dbba",
"sha256": "322651ecb16bdf28ff33aea96065d88d221512f512f5a3bd83aa24f7f1cb44fe"
},
"downloads": -1,
"filename": "data-visualizer-0.1.8.tar.gz",
"has_sig": false,
"md5_digest": "9bb2fda6280da0a765d7bf5b4de4dbba",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14111,
"upload_time": "2022-12-13T22:38:01",
"upload_time_iso_8601": "2022-12-13T22:38:01.177474Z",
"url": "https://files.pythonhosted.org/packages/d7/de/101b92bd1211e26e153e1bd5e9e44295463eb8ae74108d3ec6b6bc85449a/data-visualizer-0.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-13 22:38:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "AsleyR",
"github_project": "Data-Visualizer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "data-visualizer"
}
JSON
