completed qz3 and update to hw3 assignment

Author: TorresjDev

README.md

@@ -0,0 +1,56 @@
+# 🐍 Python Programs Portfolio
+
+Welcome to the **Python Programs Portfolio** repository!  
+This collection showcases multiple Python-based projects for data analysis, visualization, and web applications, organized in dedicated subfolders.
+
+---
+
+## 📦 Projects Included
+
+### 📈 Stock Data Application
+
+- **Description:**  
+  An interactive Streamlit web app for exploring historical stock prices and company information.
+- **Location:** `stock-data-app/`
+- **Live Demo:** [View on Streamlit Cloud](https://python-programs-v9puvb4eqw5cfalfr8qgdi.streamlit.app/)
+
+### 🍏 Stock Data with yfinance
+
+- **Description:**  
+  A Python script that retrieves, analyzes, and visualizes 5 years of Apple Inc. stock data using yfinance and Plotly.
+- **Location:** `stock-data-with-yfinance/`
+
+---
+
+## 🚀 Getting Started
+
+1. **Clone the repository**
+   ```bash
+   git clone https://github.com/your-username/Python-Programs.git
+   ```
+2. **Explore each project’s folder** for its own README and setup instructions.
+
+---
+
+## 📂 Folder Structure
+
+```
+Python-Programs/
+│
+├── stock-data-app/             # Streamlit web app
+├── stock-data-with-yfinance/   # Data analysis & visualization script
+└── README.md                   # This documentation
+```
+
+---
+
+## 🙏 Acknowledgements
+
+Some projects in this repository were completed as assignments for West Texas A&M University, CIDM 4310/5310, under the guidance of Dr. Cheng (Carl) Zhang.  
+Special thanks to the open-source community!
+
+---
+
+## 📝 License
+
+This repository is for educational and demonstration purposes

stock-data-app/README.md

@@ -102,7 +102,7 @@ This application was adapted and deployed by **Jesus Torres** as an assignment f
 
 - The original codebase was provided as part of the course material.
 
-Also Special thanks to the open-source community!
+Also Special thanks to the open-source community and the creators of yfinance and Plotly!
 
 ---
 

stock-data-app/main.py

@@ -33,7 +33,11 @@
 today = date.today()
 
 
-def stream_summary(summary):
+def stream_summary(summary: str):
+    """
+    Function to stream the business summary of the stock.
+    This function takes a summary string and yields each word with a slight delay
+    """
     for word in summary.split(" "):
         yield word + " "
         time.sleep(0.02)  # Simulate a delay for streaming effect

stock-data-with-yfinance/README.md

@@ -0,0 +1,81 @@
+# 🍏 Stock Data with yfinance
+
+Welcome to the **Stock Data with yfinance** project!  
+This Python script retrieves, analyzes, and visualizes historical stock data for Apple Inc. using the powerful [yfinance](https://github.com/ranaroussi/yfinance) and [Plotly Express](https://plotly.com/python/plotly-express/) libraries.
+
+---
+
+## 🚀 Features
+
+- **Easy Data Retrieval**: Fetches 5 years of Apple (AAPL) stock data from Yahoo Finance.
+- **Company Insights**: Prints detailed company information, including name, sector, and industry.
+- **Interactive Visualization**: Plots Open, High, Low, and Close prices using Plotly Express for beautiful, interactive charts.
+- **Data Export**: Saves the historical stock data to a CSV file for further analysis.
+
+---
+
+## 🛠️ How to Run
+
+1. **Clone the repository**
+
+   ```bash
+   git clone https://github.com/your-username/Python-Programs.git
+   ```
+
+2. **Navigate to the project directory**  
+   Open your terminal and change to the correct folder:
+
+   ```bash
+   cd Python-Programs/stock-data-with-yfinance
+   ```
+
+3. **Install dependencies**  
+   Make sure you have Python 3.8+ installed.
+
+   ```bash
+   pip install yfinance plotly
+   ```
+
+4. **Run the script in your terminal**
+
+   ```bash
+   python main.py
+   ```
+
+5. **View the chart**  
+   The interactive chart will open in your default web browser.
+
+---
+
+## 📂 Folder Structure
+
+```
+stock-data-with-yfinance/
+│
+├── main.py                      # Main Python script
+├── apple_stock_5y_history.csv   # Output CSV with 5 years of Apple stock data
+└── README.md                    # This documentation
+```
+
+---
+
+## 📚 References
+
+- [yfinance Documentation](https://ranaroussi.github.io/yfinance/index.html)
+- [Plotly Express Documentation](https://plotly.com/python/plotly-express/)
+
+---
+
+## 🙏 Acknowledgements
+
+This program was adapted and modified by Jesus Torres as an assignment for the CIDM 4310/5310 Business Intelligence and Decision Support Systems course at West Texas A&M University, under the guidance of Dr. Cheng (Carl) Zhang.
+
+- The original codebase was provided as part of the course material.
+
+Also special thanks to the open-source community and the authors of yfinance and Plotly!
+
+---
+
+## 📝 License
+
+This project is for educational and demonstration purposes