https://github.com/andredisa/pythondevhub
🐍 This repository includes three command-line tools that integrate with real-world APIs to fetch data, visualize it, and interact with the user through practical examples.
https://github.com/andredisa/pythondevhub
api educational-project matplotlib-python newsapi openrouteservice openstreetmap openwheatherapi projects python
Last synced: 14 days ago
JSON representation
🐍 This repository includes three command-line tools that integrate with real-world APIs to fetch data, visualize it, and interact with the user through practical examples.
- Host: GitHub
- URL: https://github.com/andredisa/pythondevhub
- Owner: andredisa
- License: mit
- Created: 2025-04-14T12:50:45.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-23T06:36:29.000Z (12 months ago)
- Last Synced: 2025-06-20T09:44:11.907Z (11 months ago)
- Topics: api, educational-project, matplotlib-python, newsapi, openrouteservice, openstreetmap, openwheatherapi, projects, python
- Language: Python
- Homepage:
- Size: 43.9 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: newsApi/README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐍 Python API Projects Collection
Welcome to my collection of **Python projects**! 🎓
> This repository includes three command-line tools that integrate with real-world APIs to fetch data, visualize it, and interact with the user through practical examples. Each project focuses on a specific domain — **news**, **travel**, and **finance** — and is ideal for learning how to work with APIs, parse JSON, and organize Python code.
---
## 📦 Project Overview
### 1. 📰 News Aggregator
**Folder:** `newsApi/`
Fetch and explore the latest headlines from around the world using the [NewsAPI.org](https://newsapi.org/) service.
- 🌍 Top headlines by country or language
- 🔍 Keyword or topic search
- 📅 Filter by date range
- 🌟 Sort by popularity or domain
- 📖 View full article content
> 🔧 Technologies: **Python 3**, `requests`, **NewsAPI**
> 📌 Concepts: `REST API`, `HTTP parameters`, `JSON parsing`, `OOP`, `CLI`
---
### 2. 🌍 Route Planner + Weather Forecast
**Folder:** `calcKmPrevisione/`
Plan a multi-stop trip and get live weather info at each destination. Calculates distance and estimated travel time.
- 🗺️ Add and validate multiple locations
- 🧭 Calculates distances and travel time between stops
- 🌦️ Fetches current weather using OpenWeatherMap
- 🔁 Ensures at least two locations before building a route
- 📈 Displays totals at the end
> 🔧 Technologies: **Python 3**, `requests`, `OpenStreetMap`, `OpenRouteService`, `OpenWeatherMap`
> 📌 Concepts: `Multi-API integration`, `modular Python`, `data aggregation`, `CLI input`
---
### 3. 📈 Stock Price Visualizer
**Folder:** `graficoFinanza/`
Visualize a stock’s daily **Open** and **Close** prices for a selected month and year with a beautiful line graph.
- 🗓️ User input for month, year, and stock symbol
- 📊 Graphs daily Open/Close prices
- ✅ Validates stock symbols and dates
- 🔒 API key handled via config file
- 🖼️ Line plot with `matplotlib`
> 🔧 Technologies: **Python 3**, `matplotlib`, `requests`, **Polygon.io**
> 📌 Concepts: `API interaction`, `data visualization`, `OOP`, `config management`
---
## 🎓 Shared Learning Objectives
Each project is designed to help you:
- ✅ Understand and integrate REST APIs
- 🧾 Parse and process JSON responses
- 🧱 Structure Python projects using classes and modules
- 📊 Visualize or display real-world data
- 🧠 Handle user input in CLI environments
---
## 🛠️ Setup Instructions
> Each project is standalone. Follow individual project READMEs for detailed API setup and usage.
### 🔃 Common Dependencies
Install core dependencies using:
```bash
pip install requests matplotlib
```
**⚠️ Note: You’ll need to get free API keys from the respective services (NewsAPI, OpenWeatherMap, OpenRouteService, Polygon.io) and add them in config files or directly in the code (as instructed).**
---
## 🚀 Ideas for Future Improvements
- 🖼️ Add GUI versions with Tkinter or Flask
- 💾 Save outputs (JSON, text, plots) to local files
- 🔐 Move API keys to .env and use python-dotenv
- 🧪 Add unit tests for key components
- 🌐 Convert CLI projects into web apps
---
## ⚠️ Disclaimer
`These projects are for educational purposes only. Data may be subject to rate limits and may not be suitable for real-time or commercial use.`
---
## ☕ Support Me
If you find my work useful and would like to support me, you can buy me a coffee! Your support helps me keep creating and improving my projects. Thank you! 😊
---
### 👨💻 Happy coding and have fun exploring APIs with Python!