Tkinter Python GUI #696 - Weather Forecaster

tkinter_python_gui/README.md

@@ -0,0 +1,41 @@
+# Tkinter Python GUI Example - US City Weather Forecaster
+
+Tkinter is a Python module used to create cross-platform GUIs.  USWeatherForecast.py demonstrates an example of a Tkinter application.
+
+## How it works:
+1. Run the script `USWeatherForecast.py` by typing either:
+    ```bash
+    python3 USWeatherForecast.py
+    ```
+    or
+    ```bash
+    python USWeatherForecast.py
+    ```
+2. A window will pop up that looks like the following screen:
+
+![Windows 10 display of US Weather Forecaster application](./images/demo.png)
+
+From this screen, enter in a US city name and click the "Get Weather" button.
+
+3. The interface should update to display a table with the city's weather information.
+
+![Windows 10 display of US Weather Forecaster with city entries](./images/demoData.png)
+
+4. To add another city, enter a new city in the text box and click the "Add New City" button.
+
+
+## API Information
+The application displays the following information:
+
+- The US city name entered by the user
+- The current temperature in Fahrenheit
+- The minimum daily temperature (Fahrenheit)
+- The maximum daily temperature (Fahrenheit)
+- The current weather condition
+- A brief description of the type of weather condition (more detail)
+
+All of the above information is from the free, open-source [Open Weather Map RapidAPI](https://rapidapi.com/community/api/open-weather-map/)
+
+## Author(s)
+
+Megan Dolan @mgndolan

tkinter_python_gui/USWeatherForecast.py

@@ -0,0 +1,122 @@
+import tkinter as tk
+import tkinter.ttk as ttk
+import requests
+
+# Free Open Weather API (https://rapidapi.com/community/api/open-weather-map/)
+url = "https://community-open-weather-map.p.rapidapi.com/forecast"
+
+headers = {'x-rapidapi-host': "community-open-weather-map.p.rapidapi.com",
+           'x-rapidapi-key':
+           "8e9e50a21bmshda23fe83770e19ep14a949jsn482dfa5dc300"}
+
+# initialize tkinter GUI
+root = tk.Tk()
+weather_frame = tk.Frame(root)
+weather_frame.grid(columnspan=3, row=3)
+weather_view = ttk.Treeview(weather_frame)
+
+
+# Initialize table for US city weather information
+def createTable(data, city):
+    weather_view['columns'] = ('city', 'temperature',
+                               'minTemp', 'maxTemp',
+                               'condition', 'description')
+    weather_view.column("#0", width=0, stretch=tk.NO)
+    weather_view.column("city", anchor=tk.CENTER, width=85)
+    weather_view.column("temperature", anchor=tk.CENTER, width=95)
+    weather_view.column("minTemp", anchor=tk.CENTER, width=75)
+    weather_view.column("maxTemp", anchor=tk.CENTER, width=75)
+    weather_view.column("condition", anchor=tk.CENTER, width=75)
+    weather_view.column("description", anchor=tk.CENTER, width=95)
+
+    weather_view.heading("#0", text="", anchor=tk.CENTER)
+    weather_view.heading("city", text="City Name", anchor=tk.CENTER)
+    weather_view.heading("temperature", text="Temperature (F)",
+                         anchor=tk.CENTER)
+    weather_view.heading("minTemp", text="Min Temp", anchor=tk.CENTER)
+    weather_view.heading("maxTemp", text="Max Temp", anchor=tk.CENTER)
+    weather_view.heading("condition", text="Condition", anchor=tk.CENTER)
+    weather_view.heading("description", text="Description", anchor=tk.CENTER)
+    NewEntry(data, city)
+
+
+# Populate table with weather information for each new US city
+def NewEntry(data, city):
+    try:
+        temp = str(round((((int(data['list'][1]['main']['temp'])
+                            - 273.15) * 1.8) + 32), 2))
+        temp_min = str(round((((int(data['list'][1]['main']['temp_min'])
+                                - 273.15) * 1.8) + 32), 2))
+        temp_max = str(round((((int(data['list'][1]['main']['temp_max'])
+                                - 273.15) * 1.8) + 32), 2))
+        weather = data['list'][2]['weather'][0]['main']
+        weather_desc = data['list'][2]['weather'][0]['description']
+        weather_view.insert(parent='', index='end', iid=None, text='',
+                            values=(city, temp, temp_min, temp_max,
+                                    weather, weather_desc))
+        weather_view.grid(columnspan=3, row=3)
+    except Exception:
+        weather_view.insert(parent='', index='end', iid=None, text='',
+                            values=(city, None, None, None, None, None))
+        weather_view.grid(columnspan=3, row=3)
+
+
+root.title("US Weather Tracker")
+
+canvas = tk.Canvas(root, width=600, height=120)
+canvas.grid(columnspan=3, rowspan=5)
+
+# Weather Tracker application - title
+label = tk.Label(root, text="US Weather Tracker")
+label.grid(columnspan=3, row=0, pady=30)
+label.configure(font=("Courier", 25, "bold"), fg='#092653')
+
+# Weather Tracker application - title
+desc = tk.Label(root, text="Provide a US city name below...")
+desc.grid(columnspan=3, row=1, pady=10)
+desc.configure(font=("Courier", 10))
+
+# Prompts the user to enter a city
+cityLabel = tk.Label(text="City Name:")
+cityLabel.grid(column=0, row=2, pady=20)
+cityLabel.configure(font=("Courier", 16))
+
+cityEntry = tk.Entry(root, width=50, borderwidth=2)
+cityEntry.grid(column=1, row=2, pady=20)
+
+# Global variables to update button text and check if table exists
+newTable = True
+button_text = tk.StringVar()
+button_text.set("Get Weather")
+
+
+# Function to add a new city to the list of weather forecasts
+def addWeather():
+    global newTable
+    if newTable:
+        city = cityEntry.get()
+        location = city + ",us"
+        querystring = {"q": location}
+        response = requests.request("GET", url, headers=headers,
+                                    params=querystring)
+        createTable(response.json(), city)
+        button_text.set("Add New City")
+        newTable = False
+    elif not newTable:
+        city = cityEntry.get()
+        location = city + ",us"
+        querystring = {"q": location}
+        response = requests.request("GET", url, headers=headers,
+                                    params=querystring)
+        NewEntry(response.json(), city)
+
+
+# Button to add cities to weather forecast table
+getCityWeather = tk.Button(root, textvariable=button_text,
+                           command=addWeather, width=30,
+                           font=("Courier", 15),
+                           bg='#092653',
+                           fg="white").grid(columnspan=3, row=4, pady=10)
+
+
+root.mainloop()

tkinter_python_gui/requirements.txt

@@ -0,0 +1,2 @@
+tkinter
+requests