diff --git a/CHANGELOG.md b/CHANGELOG.md index 408cb81..aad7975 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,57 @@ -### Refactor language handling in Weather API (HEAD -> patch-remove-perlexperimental) +### Remove DarkSky API support from Weather module (HEAD -> patch-newversion) +>Tue, 14 Oct 2025 07:35:18 +0200 + +>Author: Marko Oldenburg (fhemdevelopment@cooltux.net) + +>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net) + +The DarkSky API support has been removed from the Weather module documentation, +including its references in both English and German sections. The API +documentation has been updated to exclusively focus on the +OpenWeatherMap API. + +The changes made to `59_Weather.pm` include: + +- Deleted mentions of the DarkSky API in the documentation. +- Updated example command snippets to reference the + OpenWeatherMap API. +- Version number has been incremented from v2.2.35 to v2.3.0. + +In addition, the version number for the OpenWeatherMap API support +has been updated from v3.2.7 to v3.2.8 in the corresponding API file. + +These updates were necessary to streamline the module's +functionality and align it with current API availability, as +DarkSky has been discontinued. There are no breaking changes +for existing users of the OpenWeatherMap API. + + + +### Refactor language handling in Weather API (origin/testing, origin/main, origin/dev, origin/HEAD, testing, main, dev) +>Tue, 14 Oct 2025 07:04:00 +0200 + +>Author: Marko Oldenburg (fhemdevelopment@cooltux.net) + +>Commiter: Marko Oldenburg (fhemdevelopment@cooltux.net) + +Improved the language initialization logic by replacing the +experimental `given/when` construct with a more standard +`if/elsif` structure to enhance code readability and +maintainability. The attribute handling in the `Attr` subroutine +was simplified for clarity, removing unnecessary usage +of `given/when`, which helps reduce complexity throughout +the codebase. + +Additionally, in the OpenWeatherMapAPI module, the logic for +handling weather response data was streamlined by removing +`given/when` statements in favor of `if` conditions. This change +avoids potential confusion and enhances the clarity of the +code logic. No breaking changes were introduced; the overall +functionality remains intact. + + + +### Refactor language handling in Weather API >Tue, 14 Oct 2025 07:03:38 +0200 >Author: Marko Oldenburg (fhemdevelopment@cooltux.net) diff --git a/FHEM/59_Weather.pm b/FHEM/59_Weather.pm index 3b2a855..6a1ab45 100755 --- a/FHEM/59_Weather.pm +++ b/FHEM/59_Weather.pm @@ -78,7 +78,6 @@ __END__ The Weather module works with various weather APIs: @@ -96,7 +95,7 @@ __END__ The parameters have the following meanings:
- +
APIname of the weather API, e.g. DarkSkyAPI
APIname of the weather API, e.g. OpenWeatherMapAPI
apioptionsindivual options for the chosen API
apikeykey for the chosen API
locationlocation for the weather forecast; @@ -108,7 +107,7 @@ __END__

A very simple definition is:

- define <name> Weather apikey=<DarkSkyAPISecretKey>

+ define <name> Weather apikey=<OpenWeatherMapAPISecretKey>

This uses the Dark Sky API with an individual key that you need to retrieve from the Dark Sky web site.

@@ -122,19 +121,6 @@ __END__ API-specific documentation follows.

-

Dark Sky

- - - - - -
APIDarkSkyAPI
apioptionscachemaxage:<cachemaxage>
duration - in seconds to retrieve the forecast from the cache instead from the API
location<latitude,longitude>
- geographic coordinates in degrees of the location for which the - weather is forecast; if missing, the values of the attributes - of the global device are taken, if these exist.
-

-

OpenWeatherMap

@@ -324,7 +310,7 @@ __END__ Die Parameter haben die folgende Bedeutung:
- +
APIName des Wetter-APIs, z.B. DarkSkyAPI
APIName des Wetter-APIs, z.B. OpenWeatherMapAPI
apioptionsIndividuelle Optionen für das gewählte API
apikeySchlüssel für das gewählte API
locationOrt, für den das Wetter vorhergesagt wird. @@ -338,7 +324,7 @@ __END__ Eine ganz einfache Definition ist:

- define <name> Weather apikey=<DarkSkyAPISecretKey>

+ define <name> Weather apikey=<OpenWeatherMapAPISecretKey>

Bei dieser Definition wird die API von Dark Sky verwendet mit einem individuellen Schlüssel, den man sich auf der Webseite von Dark Sky @@ -353,20 +339,6 @@ __END__ Es folgt die API-spezifische Dokumentation.

-

Dark Sky

- - - - - -
APIDarkSkyAPI
apioptionscachemaxage:<cachemaxage>
Zeitdauer in - Sekunden, innerhalb derer die Wettervorhersage nicht neu abgerufen - sondern aus dem Cache zurück geliefert wird.
location<latitude,longitude>
Geographische Breite - und Länge des Ortes in Grad, für den das Wetter vorhergesagt wird. - Bei fehlender Angabe werden die Werte aus den gleichnamigen Attributen - des global-Device genommen, sofern vorhanden.
-

-

OpenWeatherMap

@@ -539,13 +511,12 @@ __END__ "fhem-mod-device", "fhem-core", "Weather", - "DarkSky", "OpenWeatherMap", "Underground" ], "release_status": "stable", "license": "GPL_2", - "version": "v2.2.35", + "version": "v2.3.0", "author": [ "Marko Oldenburg " ], diff --git a/controls_Weather.txt b/controls_Weather.txt index e3d2e88..b20fe7e 100644 --- a/controls_Weather.txt +++ b/controls_Weather.txt @@ -1,4 +1,4 @@ -UPD 2025-02-05_05:56:41 25899 FHEM/59_Weather.pm -UPD 2025-10-14_06:51:10 34175 lib/FHEM/Core/Weather.pm -UPD 2025-10-14_07:00:04 33545 lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm -UPD 2025-10-14_07:03:17 38721 lib/FHEM/APIs/Weather/wundergroundAPI.pm +UPD 2025-10-14_07:34:42 24515 FHEM/59_Weather.pm +UPD 2025-10-14_07:20:30 34175 lib/FHEM/Core/Weather.pm +UPD 2025-10-14_07:25:36 33545 lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm +UPD 2025-10-14_07:20:30 38721 lib/FHEM/APIs/Weather/wundergroundAPI.pm diff --git a/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm b/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm index 88e6a39..281dd51 100644 --- a/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm +++ b/lib/FHEM/APIs/Weather/OpenWeatherMapAPI.pm @@ -1029,7 +1029,7 @@ sub _strftimeWrapper { ], "release_status": "stable", "license": "GPL_2", - "version": "v3.2.7", + "version": "v3.2.8", "author": [ "Marko Oldenburg " ],