Simple Weather App

A Python-based weather application that displays current weather information for any ZIP code using the WeatherStack API.

Features

• Clean, modern UI built with Kivy
• Real-time weather data from WeatherStack
• Displays temperature, location, time, and weather conditions
• Weather condition icons
• Save and manage favorite locations
• Responsive design that works on different screen sizes

Setup

1. Clone the repository:

git clone <your-repo-url>
cd SimpleWeatherApp

2. Create and activate a virtual environment (recommended):

python -m venv .venv
# On Windows:
.venv\Scripts\activate
# On Unix or MacOS:
source .venv/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up environment variables:

   • Copy .env.example to .env:

     cp .env.example .env

   • Get your API key from WeatherStack
   • Edit .env and replace your_api_key_here with your actual WeatherStack API key

5. Run the application:

python main.py

Development Setup

For development, you can install the package in development mode:

pip install -e .

This will allow you to modify the code and see changes immediately without reinstalling.

Environment Variables

The application uses the following environment variables:

• WEATHERSTACK_API_KEY: Your WeatherStack API key

These should be placed in a .env file in the root directory. A template is provided in .env.example.

Project Structure

SimpleWeatherApp/
├── main.py              # Application entry point
├── requirements.txt     # Python dependencies
├── setup.py            # Package setup file
├── .env.example        # Environment variables template
├── src/
│   └── weather_app/
│       ├── api/        # Weather API client
│       ├── ui/         # Kivy UI components
│       └── storage/    # Location storage

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Testing

Running Tests

To run the test suite:

1. Install test dependencies:

pip install -r requirements-test.txt

2. Run tests with coverage:

pytest tests/ --cov=weather_app --cov-report=html

This will run all tests and generate a coverage report in the htmlcov directory.

Test Structure

The test suite is organized into three categories:

1. Unit Tests (tests/unit/):

   • test_weather_client.py: Tests for the WeatherStack API client
   • test_location_storage.py: Tests for location data storage

2. UI Tests (tests/ui/):

   • test_weather_app.py: Tests for the main application UI

3. Integration Tests (tests/integration/):

   • Tests for component interactions

Test Coverage

The test suite covers:

• API client functionality
• Location storage operations
• UI component behavior
• Error handling
• Resource cleanup
• Keyboard event handling

Writing New Tests

When adding new features, please follow these guidelines:

1. Add unit tests for new functionality
2. Update integration tests if component interactions change
3. Add UI tests for new UI components
4. Ensure all tests pass before submitting changes
5. Maintain or improve code coverage