Data.gouv.fr Datasets

Framework for registering and synchronising open datasets from
data.gouv.fr in Drupal.

This module is for French Drupal developers who want to integrate public
service data into their sites. It provides the infrastructure; companion
dataset modules supply the import logic for specific datasets.

How it works

• Register datasets as config entities — exportable and deployment-safe.
• Schedule retrieval on a daily, weekly, or monthly basis.
• Sync via cron or trigger manually from the admin UI.
• Change detection using SHA-256 hashing — unchanged data is skipped.
• Queue-based processing to avoid PHP timeouts on large datasets.

Available dataset modules

More dataset modules are planned.

Configuration

1. Navigate to Administration > Configuration > System > Data.gouv.fr Datasets.
2. Add or manage registered datasets.
3. Trigger syncs manually or let cron handle them automatically.

For developers

The module uses a plugin system to support new datasets. To add support for a
new data.gouv.fr dataset:

1. Create a new module.
2. Implement a @DatagouvDatasetSync plugin (extend DatagouvDatasetSyncBase).
3. Ship a config entity YAML that registers the dataset URL, schedule, and
   plugin ID.

See datagouv_dataset_wdc for a complete working example.

Translation

French translations are included in translations/.