Project to display OpenWeather Data using Apache Kafka, suited as basic example for Kafka. The folder Docker contains everything needed to run the project inside Docker containers. This might be educational for other projects involving two docker services communicating trough kafka and using secret keys inside docker.

Setup:

1. Install python: https://www.python.org/

2. Create a virtual environment (optional): python -m venv venv # Create a virtual environment named "env" at the current location source venv/bin/activate # Activates the created virtual environment | On Windows, use venv\Scripts\activate

3. Install all dependencies listed in the requirements file via pip: pip3 install -r requirements.txt

4. Make a free account and get an API-KEY at OpenWeather (https://openweathermap.org/) Get your Weather data API-Key (https://home.openweathermap.org/api_keys): create in the same folder a secret.py including your API-Key. The content looks like this: OPENWEATHERMAP_API_KEY="PasteYourKey"

5. Install Kafka (and Zookeeper): https://kafka.apache.org/downloads https://www.conduktor.io/kafka/how-to-install-apache-kafka-on-mac-with-homebrew/ (Mac OS)

6. Start local Kafka Start Zookeeper: /usr/local/bin/zookeeper-server-start /usr/local/etc/zookeeper/zoo.cfg Start Kafka: /usr/local/bin/kafka-server-start /usr/local/etc/kafka/server.properties Create topic: /zsr/local/bin/kafka-topics --create --topic weather-data --bootstrap-server localhost:9092 --partitions 1 --replication-factor 1

   Optionally you can start kafka via a bash script as provided with start_kafka.sh. You can change all paths and parameters as needed for your setup. You may need to give the script permissions to run, as for example with (Mac OS): chmod +x start_kafka.sh xattr -d com.apple.quarantine start_kafka.sh

   To run the script simply use following command: ./start_kafka.sh

7. Run the weather_processor.py and weather-display.py either in your IDE or from the command line.