msn-weather-wrapper 1.1.5__tar.gz

msn_weather_wrapper-1.1.5/.containerignore

@@ -0,0 +1,49 @@
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environment
+.venv/
+venv/
+ENV/
+
+# Testing
+.pytest_cache/
+htmlcov/
+.coverage
+.tox/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Git
+.git/
+.gitignore
+.github/
+
+# Documentation - exclude most but keep README.md for package build
+API.md
+
+# Frontend - only exclude node_modules and build artifacts
+frontend/node_modules/
+frontend/dist/
+
+# Example files
+example.py
+test_api_manual.py
+WeatherWidget.jsx
+WeatherWidget.tsx
+
+# GitHub
+.github/

msn_weather_wrapper-1.1.5/.env.example

@@ -0,0 +1,146 @@
+# MSN Weather Wrapper Environment Configuration
+# Copy this file to .env and configure as needed
+
+# =============================================================================
+# Flask Configuration
+# =============================================================================
+
+# Flask environment mode (development, production)
+# In production, set to "production" to disable debug mode
+FLASK_ENV=production
+
+# Secret key for Flask sessions (generate a secure random key in production)
+# Generate with: python -c "import secrets; print(secrets.token_hex(32))"
+FLASK_SECRET_KEY=change-this-to-a-secure-random-key-in-production
+
+# Flask debug mode (true/false)
+# NEVER enable debug mode in production
+FLASK_DEBUG=false
+
+# =============================================================================
+# Application Configuration
+# =============================================================================
+
+# Application host and port
+HOST=0.0.0.0
+PORT=5000
+
+# =============================================================================
+# Rate Limiting Configuration
+# =============================================================================
+
+# Rate limit per IP address (requests per minute)
+RATE_LIMIT_PER_IP=30
+
+# Global rate limit (requests per hour)
+RATE_LIMIT_GLOBAL=200
+
+# =============================================================================
+# Caching Configuration
+# =============================================================================
+
+# Weather data cache duration (seconds)
+# Default: 300 seconds (5 minutes)
+CACHE_DURATION=300
+
+# =============================================================================
+# CORS Configuration
+# =============================================================================
+
+# Allowed origins for CORS (comma-separated list)
+# Use "*" for all origins (not recommended in production)
+# Example: https://example.com,https://app.example.com
+CORS_ORIGINS=*
+
+# =============================================================================
+# Logging Configuration
+# =============================================================================
+
+# Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
+LOG_LEVEL=INFO
+
+# Enable structured JSON logging (true/false)
+STRUCTURED_LOGGING=true
+
+# =============================================================================
+# Gunicorn Configuration (Production)
+# =============================================================================
+
+# Number of Gunicorn worker processes
+# Recommended: (2 x CPU cores) + 1
+GUNICORN_WORKERS=4
+
+# Gunicorn timeout (seconds)
+GUNICORN_TIMEOUT=120
+
+# Gunicorn bind address
+GUNICORN_BIND=0.0.0.0:5000
+
+# =============================================================================
+# Database Configuration (Future Use)
+# =============================================================================
+
+# Database URL (not currently used, reserved for future features)
+# DATABASE_URL=postgresql://user:password@localhost:5432/weather_db
+
+# =============================================================================
+# External API Configuration
+# =============================================================================
+
+# MSN Weather base URL (default should work, but can be customized)
+MSN_WEATHER_BASE_URL=https://www.msn.com/en-us/weather
+
+# Request timeout for external API calls (seconds)
+REQUEST_TIMEOUT=30
+
+# User agent for HTTP requests
+USER_AGENT=Mozilla/5.0 (compatible; MSNWeatherWrapper/1.0)
+
+# =============================================================================
+# Security Configuration
+# =============================================================================
+
+# Maximum input length for city/country names
+MAX_INPUT_LENGTH=100
+
+# Enable input validation (true/false)
+# NEVER disable in production
+ENABLE_INPUT_VALIDATION=true
+
+# =============================================================================
+# Development Configuration
+# =============================================================================
+
+# Enable hot reload in development (true/false)
+DEV_HOT_RELOAD=true
+
+# Frontend development server URL (for CORS in development)
+FRONTEND_DEV_URL=http://localhost:5173
+
+# =============================================================================
+# Container Configuration
+# =============================================================================
+
+# Container registry (for pushing images)
+CONTAINER_REGISTRY=ghcr.io
+
+# Container image name
+CONTAINER_IMAGE=jim-wyatt/msn-weather-wrapper
+
+# =============================================================================
+# Health Check Configuration
+# =============================================================================
+
+# Health check timeout (seconds)
+HEALTH_CHECK_TIMEOUT=10
+
+# =============================================================================
+# Notes
+# =============================================================================
+
+# 1. Never commit .env files to version control
+# 2. Use strong, unique values for SECRET_KEY in production
+# 3. Adjust rate limits based on your server capacity
+# 4. Set appropriate CORS origins in production (not "*")
+# 5. Use environment-specific .env files (.env.production, .env.development)
+# 6. Consider using secrets management tools (AWS Secrets Manager, HashiCorp Vault)

msn_weather_wrapper-1.1.5/.github/CODEOWNERS

@@ -0,0 +1,39 @@
+# CODEOWNERS - Automatically request reviews from code owners
+# Docs: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Default owner for everything
+* @jim-wyatt
+
+# Python package and core library
+/src/ @jim-wyatt
+/tests/ @jim-wyatt
+pyproject.toml @jim-wyatt
+
+# Flask API
+api.py @jim-wyatt
+
+# Frontend
+/frontend/ @jim-wyatt
+
+# CI/CD workflows
+/.github/workflows/ @jim-wyatt
+/.github/actions/ @jim-wyatt
+
+# Documentation
+/docs/ @jim-wyatt
+README.md @jim-wyatt
+*.md @jim-wyatt
+
+# Configuration files
+*.yml @jim-wyatt
+*.yaml @jim-wyatt
+*.toml @jim-wyatt
+.pre-commit-config.yaml @jim-wyatt
+
+# Containerfiles
+Containerfile* @jim-wyatt
+podman-compose.yml @jim-wyatt
+
+# Security-related files
+/docs/SECURITY.md @jim-wyatt
+/.github/workflows/security-scan.yml @jim-wyatt

msn_weather_wrapper-1.1.5/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,126 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: ["bug", "triage"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report this bug! Please fill out the sections below to help us investigate.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: When I try to... I expect... but instead...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Go to '...'
+        2. Click on '...'
+        3. Execute command '...'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened? Include error messages, stack traces, or screenshots.
+    validations:
+      required: true
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which component is affected?
+      options:
+        - Python Library (msn_weather_wrapper)
+        - REST API (Flask/api.py)
+        - Web Frontend (React)
+        - Docker/Container
+        - CI/CD
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How severe is this issue?
+      options:
+        - Critical (system crash, data loss)
+        - High (major feature broken)
+        - Medium (feature partially broken)
+        - Low (minor issue, workaround exists)
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: |
+        Provide environment details:
+        - OS (e.g., Ubuntu 22.04, macOS 14.0, Windows 11)
+        - Python version (e.g., 3.12.0)
+        - Package version (e.g., 1.0.0)
+        - Deployment method (local, Docker, Podman)
+      value: |
+        - OS:
+        - Python:
+        - Version:
+        - Deployment:
+      render: markdown
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant Logs
+      description: Include relevant log output, stack traces, or error messages
+      render: shell
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or information about the problem
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      options:
+        - label: I have searched existing issues to avoid duplicates
+          required: true
+        - label: I have tested with the latest version
+          required: true
+        - label: I have included sufficient information to reproduce
+          required: true

msn_weather_wrapper-1.1.5/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 💬 Discussions
+    url: https://github.com/jim-wyatt/msn-weather-wrapper/discussions
+    about: Ask questions, share ideas, or discuss the project with the community
+  - name: 📖 Documentation
+    url: https://jim-wyatt.github.io/msn-weather-wrapper/
+    about: Read the full documentation and guides
+  - name: 🔒 Security Issue
+    url: https://github.com/jim-wyatt/msn-weather-wrapper/security/advisories/new
+    about: Report a security vulnerability privately

msn_weather_wrapper-1.1.5/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,131 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: ["enhancement"]
+assignees: []
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please provide as much detail as possible.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: Describe the problem or pain point this feature would solve
+      placeholder: I'm frustrated when... It would be great if... Currently there's no way to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe your proposed solution
+      placeholder: Add a new endpoint/feature that...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What alternative solutions or workarounds have you considered?
+    validations:
+      required: false
+
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      description: Which component would this feature affect?
+      options:
+        - Python Library (msn_weather_wrapper)
+        - REST API (Flask/api.py)
+        - Web Frontend (React)
+        - Docker/Container
+        - CI/CD
+        - Documentation
+        - Multiple Components
+        - New Component
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Critical (blocking my use case)
+        - High (significant improvement)
+        - Medium (nice to have)
+        - Low (minor enhancement)
+    validations:
+      required: true
+
+  - type: textarea
+    id: usecase
+    attributes:
+      label: Use Case
+      description: Describe your specific use case and how this feature would help
+      placeholder: |
+        As a [user type], I want to [goal] so that [benefit].
+
+        Example: As a mobile app developer, I want to get 7-day forecasts so that I can show weekly weather in my app.
+    validations:
+      required: true
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Examples
+      description: |
+        Provide code examples, API designs, or UI mockups showing how this feature would work
+      render: python
+    validations:
+      required: false
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: Impact Assessment
+      description: |
+        - Who would benefit from this feature?
+        - Are there any breaking changes?
+        - What are the performance/resource implications?
+    validations:
+      required: false
+
+  - type: dropdown
+    id: willing
+    attributes:
+      label: Contribution
+      description: Are you willing to contribute this feature?
+      options:
+        - Yes, I can submit a PR
+        - Yes, with guidance
+        - No, but I can help test
+        - No
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or references (links to similar features in other projects)
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      options:
+        - label: I have searched existing issues and PRs to avoid duplicates
+          required: true
+        - label: This feature aligns with the project's goals and scope
+          required: true

msn_weather_wrapper-1.1.5/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,80 @@
+## Description
+
+<!-- Provide a brief description of the changes in this PR -->
+
+## Type of Change
+
+<!-- Check all that apply -->
+
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📝 Documentation update
+- [ ] 🎨 Code style update (formatting, renaming)
+- [ ] ♻️ Code refactoring (no functional changes)
+- [ ] ⚡ Performance improvement
+- [ ] ✅ Test update
+- [ ] 🔧 Build/CI configuration change
+- [ ] 🔒 Security fix
+
+## Related Issue
+
+<!-- Link to related issue(s) -->
+Fixes #(issue number)
+
+## Changes Made
+
+<!-- List the specific changes made in this PR -->
+
+-
+-
+-
+
+## Testing
+
+<!-- Describe the tests you ran and how to reproduce -->
+
+- [ ] All existing tests pass (`pytest`)
+- [ ] Added new tests for new functionality
+- [ ] Frontend tests pass (`npm test` in frontend/)
+- [ ] Integration tests pass
+- [ ] Manual testing performed
+
+### Test Evidence
+
+<!-- Paste test output or screenshots showing tests passing -->
+
+```
+# Paste relevant test output here
+```
+
+## Checklist
+
+<!-- Check all that apply before requesting review -->
+
+- [ ] My code follows the project's style guidelines (ruff, mypy)
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings or errors
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+- [ ] I have updated the CHANGELOG.md (if applicable)
+- [ ] I have used conventional commit messages (`feat:`, `fix:`, etc.)
+
+## Screenshots/Demo
+
+<!-- If applicable, add screenshots or GIFs to demonstrate the changes -->
+
+## Additional Context
+
+<!-- Add any other context about the PR here -->
+
+## Deployment Notes
+
+<!-- Any special deployment considerations? -->
+
+## Reviewer Notes
+
+<!-- Any specific areas you'd like reviewers to focus on? -->