1.2.3

Fix phpunit version vulnerabilty with composer update

1.2.2

Modifié

• ThematicsEcvEndpoint::transformResponse() : prise en charge des réponses API en liste (tableau indexé) ; si data est une liste, retourne un tableau d'objets ECV[], sinon un seul ECV. Gestion explicite de data vide ou non-tableau (retour des données brutes).

Ajouté

• Tests : testTransformResponseWithListDataReturnsArrayOfEcv dans ThematicsEcvEndpointTest.

1.2.1

Modifié

• ECV::fromArray() : parsing assoupli pour les réponses API sans champ name ou slug ; utilisation du slug comme nom de repli, ou valeurs par défaut ('ecv', '—') pour éviter « ECV name cannot be empty » lorsque l'API /thematiques/ecv/{id} renvoie une structure incomplète.

Ajouté

• Tests : tests de transformResponse dans TransportEndpointTest, ThematicsEcvEndpointTest ; tests ECV fromArray sans name/slug dans ECVTest.

1.2.0

Ajouté

• ApiResponse : objet de réponse normalisé avec getData() (données hydratées en objets de la librairie) et getWarning() (message d'avertissement éventuel).
• Endpoint::transformResponse() : méthode pour convertir la réponse API en ApiResponse, surchargée dans ThematicsEndpoint, TransportEndpoint et ThematicsEcvEndpoint pour retourner des objets de la librairie.
• Tests : ApiResponseTest, tests de transformResponse dans EndpointTest et ThematicsEndpointTest.

Modifié

• Client::execute() : retourne désormais une ApiResponse (au lieu du tableau brut) ; la réponse est transformée via $endpoint->transformResponse(). Les endpoints Thématiques, Transport et Détail thématique (ECV) hydratent automatiquement les données en Thematic[], Transport[] et ECV.
• README : exemples avec $result->getData() et $result->getWarning() ; format des réponses documenté ; gestion des erreurs corrigée (variable $endpoint définie, alias Impactco2Exception) ; valeurs de language précisées (minuscules / constantes).

1.1.0

Ajouté

• Endpoint Alimentation : AlimentationEndpoint et AlimentationCategoryEnum pour interroger l’API par catégorie (group, rayon, popularity).
• ThematicsEcvEndpoint : prise en charge des slugs en plus des IDs (ex. 'mobilier', 'transport') via ThematicEnum::getIdFromSlug() et la propriété $slugs.
• TransportsEnum : nouvelle constante WALKING (30) pour la marche à pied.
• Entités : méthodes fromArray() et toArray() sur Item, Usage, Thematic, Transport et ECV pour construction et sérialisation depuis les réponses API.
• Validation : contrôles dans les constructeurs des entités (Item, Usage, Thematic, Transport) avec InvalidArgumentException (ID positifs, valeurs non négatives, noms/slugs non vides).
• Tests : AlimentationEndpointTest, AlimentationCategoryEnumTest, EndpointMultipleCallsTest et tests unitaires pour les nouvelles validations et méthodes des entités.
• Coverage : make test-coverage utilise XDEBUG_MODE=coverage pour le rapport de couverture.

Modifié

• Entités : Item, Usage, Thematic, Transport et ECV passent en readonly avec constructeur obligatoire ; les setters ont été supprimés.
• TransportsEnum : ON_FOOT (7) renommé en BIKE (vélo) ; libellé « Vélo » et emoji 🚴. « À pied » et 🚶 déplacés sur WALKING.
• Endpoint : getPath() ne modifie plus l’instance ; construction du path dans une variable locale et exclusion des paramètres de requête null dans l’URL.
• ThematicsEcvEndpoint : constructeur accepte int|string (ID ou slug) ; message d’exception : « Invalid thematic ECV identifier or slug ».
• Enums : declare(strict_types=1) ajouté dans FoodEnum, HeaterEnum, ThematicEnum, TransportsEnum.
• Tests : adaptations aux nouveaux constructeurs, messages d’exception et types (ex. 999 au lieu de 'invalid_type' pour Heater/Transport).
• Version : 1.0.5 → 1.1.0.

Supprimé

• PHPStan : retiré des dépendances (require-dev), de GrumPHP et de la cible lint du makefile.
• Setters : suppression de tous les setters sur les entités concernées (remplacés par des objets immuables).

1.0.0

Première Release : v1.0.0

Nous sommes ravis d'annoncer la première release de cette librairie PHP, ImpactCO2-PHP ! 🎉

Description

ImpactCO2-PHP est une librairie PHP permettant de comparer la consommation en CO₂e de divers équivalents. Elle offre une interface simple et intuitive pour interagir avec l'API ImpactCO2 et obtenir des données précises sur l'empreinte carbone de différentes activités.

Fonctionnalités

Endpoints :

ThematicsEndpoint : Récupère les thématiques disponibles.
ThematicsEcvEndpoint : Récupère les détails des thématiques ECV.
HeaterEnpoint : Calcule les émissions de CO₂e pour différents types de chauffage.
FruitsVegetables : Calcule les émissions de CO₂e pour les fruits et légumes.
TransportEndpoint : Calcule les émissions de CO₂e pour différents modes de transport.