Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ejoliet/python-microservice
for now, weather microservice playground
https://github.com/ejoliet/python-microservice
microservice python tomorrow-io weather-api
Last synced: 27 days ago
JSON representation
for now, weather microservice playground
- Host: GitHub
- URL: https://github.com/ejoliet/python-microservice
- Owner: ejoliet
- Created: 2024-01-25T03:03:32.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-25T03:26:14.000Z (about 1 year ago)
- Last Synced: 2024-11-09T23:12:37.131Z (3 months ago)
- Topics: microservice, python, tomorrow-io, weather-api
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Python Weather Microservice
## Description
This Python microservice provides real-time weather information based on city names. It utilizes the [Tomorrow.io Weather API](https://www.tomorrow.io/weather-api/) to fetch weather data, returning details such as temperature, weather conditions, and a symbolic ASCII art representation of the current weather.
## Installation
### Prerequisites
- Python 3.x
- `requests` library (for making HTTP requests)
- An API key from Tomorrow.io
### Setup
1. **Clone the Repository**
```bash
git clone [Your Repository URL]
cd [Your Repository Directory]
```
2. **Install Dependencies**
Use virtual env, create one
```bash
python3 -m venv weather_env
```
Then activate by executing
```bash
source weather_env/bin/activate
```
Deactivate:
```bash
deactivate
```
Use pip to install the required Python packages:
```bash
pip3 install requests art json
```
4. **API Key Configuration**
- Obtain an API key from [Tomorrow.io](https://www.tomorrow.io/weather-api/).
- Create a `config.json` file in the same directory as your Python script with the following content:
```json
{
"TOMORROW_IO_API_KEY": "your_api_key_here"
}
```
- Replace `your_api_key_here` with your actual API key.
- Ensure `config.json` is added to your `.gitignore` file to prevent it from being pushed to public repositories.
## Usage
1. **Run the Server**
Start the microservice by running:
```bash
python3 weather.py
```
This will start the HTTP server on port 8000.
2. **Accessing the Service**
To fetch weather information, access the service via a web browser or a tool like `curl` using:
```
http://localhost:8000/?city=CityName
```
Replace `CityName` with the desired city's name.
Example:
```
http://localhost:8000/?city=Toronto
```
3. **Response Format**
The service returns a JSON object containing weather data, including temperature, weather conditions, and an ASCII representation of the current weather.