meteo-greece-api 0.1.0

A Python client for the Meteo Greece API (meteostations-gr-api)

Meteo Greece API Client

A simple, asynchronous Python client for the Meteostations GR Private API, which provides live meteorological data from Greek weather stations and city forecasts from meteo.gr.

This package is designed for easy integration with Home Assistant and other asynchronous Python applications.

Installation

pip install meteo-greece-api

Usage

import asyncio
from meteo_greece_api import MeteoGreeceClient

async def main():
    async with MeteoGreeceClient() as client:
        # Get all available stations
        stations = await client.get_available_stations()
        print(f"Found {len(stations.get('stations', []))} stations.")
        
        # Get live data for a specific station (e.g., 'aggelokastro')
        data = await client.get_station_data('aggelokastro')
        print(data)

        # Get all available cities for forecasts
        cities = await client.get_cities()
        print(f"Found {len(cities.get('cities', []))} cities.")
        
        # Get forecast for a specific city (e.g., 12 for Athens)
        forecast = await client.get_forecast(12)
        print(forecast)

if __name__ == "__main__":
    asyncio.run(main())

Features

• Asynchronous: Uses aiohttp for non-blocking network requests, ideal for Home Assistant integrations.
• Context Manager: Supports async with for easy resource management.
• Minimal Dependencies: Only requires aiohttp.

Development

To set up the development environment:

# Clone the repository
git clone https://github.com/apo-mak/meteo-greece-api.git
cd meteo-greece-api

# Install dependencies including development ones
pip install -e ".[dev]"

# Run tests
pytest

Publishing to PyPI

To build and publish this package to PyPI, you can use the build and twine tools:

# Install build tools
pip install build twine

# Build the package (sdist and wheel)
python -m build

# Upload to PyPI (will prompt for your PyPI token)
twine upload dist/*