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 phenomenoms for each French department or Andorre. Two bulletin are availabe: 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.3.0.tar.gz (17.8 kB view details)

Uploaded Source

Built Distribution

meteofrance_api-1.3.0-py3-none-any.whl (22.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: meteofrance_api-1.3.0.tar.gz
  • Upload date:
  • Size: 17.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for meteofrance_api-1.3.0.tar.gz
Algorithm Hash digest
SHA256 895a243f4fc7b352d8d533afee7b6b351677e1ab66b1c7ac14aae25b6214b1dc
MD5 452383346776903b57177593fab7e3e7
BLAKE2b-256 18551a1a83fe7eeb8daab3cabfd55f973fb7f822f2c10b5120f292d1c321521b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for meteofrance_api-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 eafd1f817caa30b9f37d0fa8b941a58f137c93d7557d6f1eb533e03642c68486
MD5 8753104b8dcdf5ca2afbec4334e3c21f
BLAKE2b-256 4ad7949148abc4eb89f9b89ad81816e251fa07c0f140a48a036974c147ebd6a8

See more details on using hashes here.

Supported by

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