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.5.0.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meteofrance_api-1.5.0-py3-none-any.whl (21.7 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for meteofrance_api-1.5.0.tar.gz
Algorithm Hash digest
SHA256 cf8bc5a1fd2ca071b2dbd737eee15504397f1476bbf58758ae986e0e16574f39
MD5 37d49bced41643bcc6fdd0280fd32d5f
BLAKE2b-256 2d945a62ed0fb8b51edbfa75226735fd5b1d460ad1977c7b13d954683eeb0417

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for meteofrance_api-1.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ebbe98e0b1f61fc367d1e8462a4b5ab98eed9b71954fcc0e2a5f856a94475a63
MD5 5f5d734418606fc07ae4b75f507cfd38
BLAKE2b-256 ccd634771feea5707018fefbfd8961fc104fdb0aa46fa62c00712494a812d2f3

See more details on using hashes here.

Supported by

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