Skip to main content

Python client for Météo-France API.

Project description

Client Python pour l’API Météo-France. | Python client for Météo-France API.

PyPI GitHub Release Python Version License

Read the documentation at https://meteofrance-api.readthedocs.io/ Tests Codecov GitHub Activity

pre-commit Black

You will find English README content in the section For English speaking users.

Vous trouverez le contenu francophone du README dans la section Pour les francophones.

Pour les francophones

Description

Ce package Python permet de gérer la communication avec l’API non publique de Météo-France utilisée par les applications mobiles officielles.

Le client permet:

  • Rechercher des lieux de prévisions.

  • Accéder aux prévisions météorologiques horaires ou quotidiennes.

  • Accéder aux prévisions de pluie dans l’heure quand disponibles.

  • Accéder aux alertes météo pour chaque département français et d’Andorre. Deux bulletins sont disponibles : un synthétique et un second avec l’évolution des alertes pour les prochaines 24 heures (exemple ici).

Ce package a été développé avec l’intention d’être utilisé par Home-Assistant mais il peut être utilisé dans d’autres contextes.

Installation

Pour utiliser le module Python meteofrance vous devez en premier installer le package en utilisant pip depuis PyPI:

$ pip install meteofrance-api

Vous pouvez trouver un exemple d’usage dans un module Python en regardant le test d’intégration.

Contribuer

Les contributions sont les bienvenues. Veuillez consulter les bonnes pratiques détaillées dans CONTRIBUTING.rst.

For English speaking users

Description

This Python package manages the communication with the private Météo-France API used by the official mobile applications.

The client allows:

  • Search a forecast location.

  • Fetch daily or hourly weather forecast.

  • Fetch rain forecast within the next hour if available.

  • Fetch the weather alerts or phenomenons for each French department or Andorre. Two bulletin are available: one basic and an other advanced with the timelaps evolution for the next 24 hours (example here).

This package have been developed to be used with Home-Assistant but it can be used in other contexts.

Installation

To use the meteofrance Python module, you have to install this package first via pip from PyPI:

$ pip install meteofrance-api

You will find an example ot usage in a Python program in the integration test.

Contributing

Contributions are welcomed. Please check the guidelines in CONTRIBUTING.rst.

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meteofrance_api-1.4.0.tar.gz (17.7 kB view details)

Uploaded Source

Built Distribution

meteofrance_api-1.4.0-py3-none-any.whl (21.9 kB view details)

Uploaded Python 3

File details

Details for the file meteofrance_api-1.4.0.tar.gz.

File metadata

  • Download URL: meteofrance_api-1.4.0.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.8

File hashes

Hashes for meteofrance_api-1.4.0.tar.gz
Algorithm Hash digest
SHA256 4a957ee94d7d6cc215cbe1ffef058f8eec788e23d6682cb2e18d5a9bb3b309c0
MD5 4b46a6d740367cfe545c3d9ff01c08bd
BLAKE2b-256 87151c8fe7e537042e9d83d5fc4707c2632483c95194418b7cf75fc261739674

See more details on using hashes here.

File details

Details for the file meteofrance_api-1.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for meteofrance_api-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3a4bccdd0aaf2c07816fb869bd71eff202267cef2788e3080273dcdaaa990820
MD5 ed1320f7fa45149d87acdb0e93a5a506
BLAKE2b-256 c5a365719e512aa05a5f6b9e752450dc0deb6681e9fd9ab468fee19170726dc6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page