Skip to content

bloominstituteoftechnology/DS_SC_11_Starter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Air Quality Dashboard Sprint Challenge

Overview

Build a Flask-powered web application that displays air quality data from the OpenAQ API v3. The dashboard will store data in a SQLite database and filter for potentially risky PM2.5 levels.

Quick Start

1. Setup Environment

# Install dependencies
pip install flask flask-sqlalchemy requests py-openaq pytest

# Or use pipenv
pipenv install flask flask-sqlalchemy requests py-openaq pytest

2. Get API Key

  1. Visit OpenAQ API Key page
  2. Sign up for a free account
  3. Generate an API key

3. Download Required Files

  • Download openaq.py from the course materials
  • Place it in your project directory

4. Start Coding

  • Use starter.py as your starting point
  • Follow the step-by-step instructions in the assignment
  • Complete all TODO items

Project Structure

your-project/
├── aq_dashboard.py         # Your completed solution
├── openaq.py               # OpenAQ API wrapper (download from course)
├── test_aq_dashboard.py    # Test file
├── requirements.txt        # Dependencies
└── db.sqlite3              # SQLite database (created automatically)

Key Features to Implement

Part 1: Flask Setup

Part 2: OpenAQ API v3 Integration

Part 3: Database Integration

Part 4: Dashboard Filtering

API v3 Changes (January 2025)

Testing

# Run tests
python -m pytest test_aq_dashboard.py -v

# Expected output: 4 tests passing

Running the Application

# Python execution

Troubleshooting

Common Issues

Debug Tips

Success Criteria

Stretch Goals (Optional)

Good luck! 🚀

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages