fix: small fix, web_run.py created

KeremDUZENLI · KeremDUZENLI · commit 5a2d305c6ba5 · 2026-02-25T19:25:47.000+01:00
diff --git a/.gitignore b/.gitignore
@@ -104,13 +104,13 @@ celerybeat.pid
 *.sage.py
 
 # Environments
-.env
 .envrc
-.venv
-env/
-venv/
 ENV/
+.env
+env/
 env.bak/
+.venv*
+venv/
 venv.bak/
 
 # Spyder project settings
diff --git a/LICENSE b/LICENSE
@@ -1,21 +1,18 @@
-MIT License
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License
 
-Copyright (c) 2025 Kerem DÜZENLİ
+Copyright (c) 2026 [Your Name or GitHub Username]
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+This work is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+You are free to:
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+- Share: copy and redistribute the material in any medium or format
+- Adapt: remix, transform, and build upon the material
+
+Under the following terms:
+
+- Attribution: You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
+- NonCommercial: You may not use the material for commercial purposes. This project is strictly for educational and academic use.
+- ShareAlike: If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
+
+To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
diff --git a/README.md b/README.md
@@ -30,3 +30,111 @@ python -m xamples.chart_xxx
 ```bash
 streamlit run web_app.py
 ```
+
+## COMPILE
+
+### Windows
+
+```bash
+pyInstaller --noconfirm --onefile \
+   --name DataVisualizer \
+   --add-data "web_app.py;." \
+   --add-data "data/dataset.example.csv;data" \
+   --hidden-import web_app \
+   --collect-all streamlit \
+   --collect-all plotly \
+   --copy-metadata streamlit \
+   web_run.py
+```
+
+### Linux & MacOS
+
+```bash
+python3 -m PyInstaller --noconfirm --onefile \
+   --name DataVisualizer \
+   --add-data "web_app.py:." \
+   --add-data "data/dataset.example.csv:data" \
+   --hidden-import web_app \
+   --collect-all streamlit \
+   --collect-all plotly \
+   --copy-metadata streamlit \
+   web_run.py
+```
+
+## ⚠️ TROUBLESHOOTING: PRISMA Chart (Graphviz Error)
+
+If you attempt to draw the **PRISMA Chart** and receive an error (such as `graphviz.backend.ExecutableNotFound: failed to execute ['dot', ...]`), it means your computer does not have the core Graphviz rendering software installed.
+
+Because this software is large, it is not bundled directly inside the app. You will need to install it once on your system:
+
+### Windows
+
+**Option 1: Standard Installer (Recommended)**
+
+1. Go to the [Official Graphviz Download Page](https://graphviz.org/download/).
+2. Download the latest **64-bit EXE installer**.
+3. Run the installer. **CRITICAL STEP:** During installation, when prompted, you MUST select **"Add Graphviz to the system PATH for all users"** (or current user). If you skip this, the app still won't find it!
+4. Restart your computer (or terminal) and open the app again.
+
+**Option 2: Using Windows Package Manager (Winget)**
+Open PowerShell as Administrator and run:
+`winget install graphviz`
+
+### Linux (Ubuntu / Debian)
+
+Open your terminal and run:
+
+```bash
+sudo apt-get update
+sudo apt-get install graphviz
+```
+
+### macOS
+
+If you are running the source code on a Mac, use Homebrew:
+
+```Bash
+brew install graphviz
+```
+
+## CONTRIBUTE
+
+1. Fork the repository.
+2. Create a new branch:
+   ```sh
+   git checkout -b YourBranch
+   ```
+3. Make your changes and commit them:
+   ```sh
+   git commit -m "Add some feature"
+   ```
+4. Push to the branch:
+   ```sh
+   git push origin YourBranch
+   ```
+5. Open a pull request.
+
+## LICENSE
+
+This project is licensed under the **Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)**. This means you are free to:
+
+- **Share** – Copy and redistribute the material in any medium or format.
+- **Adapt** – Remix, transform, and build upon the material.
+
+However, **you may not use the material for commercial purposes**.
+
+[![License: CC BY-NC-SA 4.0](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-nc-sa/4.0/)
+
+## DISCLAIMER
+
+This repository is intended **only for educational and research purposes**. The authors and contributors assume no responsibility for misuse of the code or any implications arising from its use.
+
+## SUPPORT
+
+If you find this resource valuable and would like to help support my education and doctoral research, please consider treating me to a cup of coffee (or tea) via Revolut.
+
+<div align="center">
+  <a href="https://revolut.me/krmdznl" target="_blank">
+    <img src="https://img.shields.io/badge/Support%20My%20Projects-Donate%20via%20Revolut-orange?style=for-the-badge" alt="Support my education via Revolut" />
+  </a>
+</div>
diff --git a/setup/setup_datasets.py b/setup/setup_datasets.py
@@ -7,7 +7,7 @@
 )
 
 
-DATASET = read_dataset(csv_path="data/dataset.csv")
+DATASET = read_dataset(csv_path="data/dataset.example.csv")
 DATASET_SOFTWARE_STACKED = group_dataset_by_fields(
     datasets=[
         (
diff --git a/web_run.py b/web_run.py
@@ -0,0 +1,20 @@
+import os
+import sys
+import streamlit.web.cli as stcli
+
+
+if __name__ == "__main__":
+    if getattr(sys, "frozen", False):
+        app_path = os.path.join(sys._MEIPASS, "web_app.py")
+        os.chdir(sys._MEIPASS)
+    else:
+        app_path = os.path.join(os.path.dirname(__file__), "web_app.py")
+
+    sys.argv = [
+        "streamlit",
+        "run",
+        app_path,
+        "--server.port=8501",
+        "--global.developmentMode=false",
+    ]
+    sys.exit(stcli.main())

Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@`
`7`	`7`	`)`
`8`	`8`
`9`	`9`
`10`		`-DATASET = read_dataset(csv_path="data/dataset.csv")`
	`10`	`+DATASET = read_dataset(csv_path="data/dataset.example.csv")`
`11`	`11`	`DATASET_SOFTWARE_STACKED = group_dataset_by_fields(`
`12`	`12`	`datasets=[`
`13`	`13`	`(`