[pirateweather] Initial contribution

CODEOWNERS

@@ -315,6 +315,7 @@
 /bundles/org.openhab.binding.pihole/ @magx2
 /bundles/org.openhab.binding.pilight/ @stefanroellin @niklasdoerfler
 /bundles/org.openhab.binding.pioneeravr/ @Stratehm
+/bundles/org.openhab.binding.pirateweather/ @computergeek1507
 /bundles/org.openhab.binding.pixometer/ @Confectrician
 /bundles/org.openhab.binding.pjlinkdevice/ @nils
 /bundles/org.openhab.binding.playstation/ @FluBBaOfWard

bom/openhab-addons/pom.xml

@@ -1556,6 +1556,11 @@
       <artifactId>org.openhab.binding.pioneeravr</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.pirateweather</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.pixometer</artifactId>

bundles/org.openhab.binding.pirateweather/NOTICE

@@ -0,0 +1,13 @@
+This content is produced and maintained by the openHAB project.
+
+* Project home: https://www.openhab.org
+
+== Declared Project Licenses
+
+This program and the accompanying materials are made available under the terms
+of the Eclipse Public License 2.0 which is available at
+https://www.eclipse.org/legal/epl-2.0/.
+
+== Source Code
+
+https://github.com/openhab/openhab-addons

bundles/org.openhab.binding.pirateweather/pom.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>org.openhab.addons.bundles</groupId>
+    <artifactId>org.openhab.addons.reactor.bundles</artifactId>
+    <version>5.2.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.pirateweather</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: Pirate Weather Binding</name>
+
+</project>

bundles/org.openhab.binding.pirateweather/src/main/feature/feature.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="org.openhab.binding.pirateweather-${project.version}" xmlns="http://karaf.apache.org/xmlns/features/v1.4.0">
+	<repository>mvn:org.openhab.core.features.karaf/org.openhab.core.features.karaf.openhab-core/${ohc.version}/xml/features</repository>
+
+	<feature name="openhab-binding-pirateweather" description="Pirate Weather Binding" version="${project.version}">
+		<feature>openhab-runtime-base</feature>
+		<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.pirateweather/${project.version}</bundle>
+	</feature>
+</features>

bundles/org.openhab.binding.pirateweather/src/main/java/org/openhab/binding/pirateweather/internal/PirateWeatherBindingConstants.java

@@ -0,0 +1,95 @@
+/*
+ * Copyright (c) 2010-2026 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.pirateweather.internal;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.core.thing.ThingTypeUID;
+import org.openhab.core.thing.type.ChannelGroupTypeUID;
+
+/**
+ * The {@link PirateWeatherBindingConstants} class defines common constants, which are used across the whole binding.
+ *
+ * @author Scott Hanson - Initial contribution
+ */
+@NonNullByDefault
+public class PirateWeatherBindingConstants {
+
+    public static final String BINDING_ID = "pirateweather";
+
+    public static final String API = "api";
+    public static final String LOCAL = "local";
+
+    // Bridge
+    public static final ThingTypeUID THING_TYPE_WEATHER_API = new ThingTypeUID(BINDING_ID, "weather-api");
+
+    // Thing
+    public static final ThingTypeUID THING_TYPE_WEATHER_AND_FORECAST = new ThingTypeUID(BINDING_ID,
+            "weather-and-forecast");
+
+    // List of all properties
+    public static final String CONFIG_API_KEY = "apikey";
+    public static final String CONFIG_LANGUAGE = "language";
+    public static final String CONFIG_LOCATION = "location";
+    public static final String DEFAULT_LANGUAGE = "en";
+
+    // Channel group types
+    public static final ChannelGroupTypeUID CHANNEL_GROUP_TYPE_HOURLY_FORECAST = new ChannelGroupTypeUID(BINDING_ID,
+            "hourly-forecast");
+    public static final ChannelGroupTypeUID CHANNEL_GROUP_TYPE_DAILY_FORECAST = new ChannelGroupTypeUID(BINDING_ID,
+            "daily-forecast");
+    public static final ChannelGroupTypeUID CHANNEL_GROUP_TYPE_ALERTS = new ChannelGroupTypeUID(BINDING_ID, "alerts");
+
+    // List of all channel groups
+    public static final String CHANNEL_GROUP_CURRENT_WEATHER = "current";
+    public static final String CHANNEL_GROUP_FORECAST_TODAY = "forecast-today";
+    public static final String CHANNEL_GROUP_FORECAST_TOMORROW = "forecast-tomorrow";
+    public static final String CHANNEL_GROUP_ALERTS = "alerts";
+
+    // List of all channels
+    public static final String CHANNEL_TIME_STAMP = "time-stamp";
+    public static final String CHANNEL_CONDITION = "condition";
+    public static final String CHANNEL_CONDITION_ICON_ID = "icon-id";
+    public static final String CHANNEL_TEMPERATURE = "temperature";
+    public static final String CHANNEL_MIN_TEMPERATURE = "min-temperature";
+    public static final String CHANNEL_MAX_TEMPERATURE = "max-temperature";
+    public static final String CHANNEL_APPARENT_TEMPERATURE = "apparent-temperature";
+    public static final String CHANNEL_MIN_APPARENT_TEMPERATURE = "min-apparent-temperature";
+    public static final String CHANNEL_MAX_APPARENT_TEMPERATURE = "max-apparent-temperature";
+    public static final String CHANNEL_PRESSURE = "pressure";
+    public static final String CHANNEL_HUMIDITY = "humidity";
+    public static final String CHANNEL_WIND_SPEED = "wind-speed";
+    public static final String CHANNEL_WIND_DIRECTION = "wind-direction";
+    public static final String CHANNEL_GUST_SPEED = "gust-speed";
+    public static final String CHANNEL_CLOUDINESS = "cloudiness";
+    public static final String CHANNEL_VISIBILITY = "visibility";
+    public static final String CHANNEL_RAIN = "rain";
+    public static final String CHANNEL_SNOW = "snow";
+    public static final String CHANNEL_PRECIPITATION_INTENSITY = "precip-intensity";
+    public static final String CHANNEL_PRECIPITATION_PROBABILITY = "precip-probability";
+    public static final String CHANNEL_PRECIPITATION_TYPE = "precip-type";
+    public static final String CHANNEL_UVINDEX = "uvindex";
+    public static final String CHANNEL_OZONE = "ozone";
+    public static final String CHANNEL_SUNRISE = "sunrise";
+    public static final String CHANNEL_SUNSET = "sunset";
+    public static final String CHANNEL_ALERT_TITLE = "title";
+    public static final String CHANNEL_ALERT_ISSUED = "issued";
+    public static final String CHANNEL_ALERT_EXPIRES = "expires";
+    public static final String CHANNEL_ALERT_DESCRIPTION = "description";
+    public static final String CHANNEL_ALERT_SEVERITY = "severity";
+    public static final String CHANNEL_ALERT_URI = "uri";
+
+    public static final String TRIGGER_SUNRISE = CHANNEL_GROUP_CURRENT_WEATHER + "#sunrise-event";
+    public static final String TRIGGER_SUNSET = CHANNEL_GROUP_CURRENT_WEATHER + "#sunset-event";
+
+    public static final String EVENT_START = "START";
+}

bundles/org.openhab.binding.pirateweather/src/main/java/org/openhab/binding/pirateweather/internal/config/PirateWeatherAPIConfiguration.java

@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2010-2026 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.pirateweather.internal.config;
+
+import java.util.Collections;
+import java.util.Set;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.binding.pirateweather.internal.handler.PirateWeatherAPIHandler;
+
+/**
+ * The {@link PirateWeatherAPIConfiguration} is the class used to match the {@link PirateWeatherAPIHandler}s
+ * configuration.
+ *
+ * @author Scott Hanson - Initial contribution
+ */
+@NonNullByDefault
+public class PirateWeatherAPIConfiguration {
+
+    // supported languages (see https://pirateweather.net/dev/docs#forecast-request)
+    public static final Set<String> SUPPORTED_LANGUAGES = Collections
+            .unmodifiableSet(Stream
+                    .of("ar", "az", "be", "bg", "bn", "bs", "ca", "cs", "cy", "da", "de", "el", "en", "eo", "es", "et",
+                            "fa", "fi", "fr", "ga", "gd", "he", "hi", "hr", "hu", "id", "is", "it", "ja", "ka", "kn",
+                            "ko", "kw", "lv", "ml", "mr", "nl", "no", "pa", "pl", "pt", "ro", "ru", "sk", "sl", "sr",
+                            "sv", "ta", "te", "tet", "tr", "uk", "ur", "vi", "x-pig-latin", "zh", "zh-tw")
+                    .collect(Collectors.toSet()));
+
+    public String apikey = "";
+    public int refreshInterval = 60;
+    public String language = "";
+}

bundles/org.openhab.binding.pirateweather/src/main/java/org/openhab/binding/pirateweather/internal/config/PirateWeatherChannelConfiguration.java

@@ -0,0 +1,95 @@
+/*
+ * Copyright (c) 2010-2026 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.pirateweather.internal.config;
+
+import java.time.Duration;
+import java.time.LocalTime;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeParseException;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+/**
+ * The {@link PirateWeatherChannelConfiguration} is the class used to match the sunrise and sunset event configuration.
+ *
+ * @author Scott Hanson - Initial contribution
+ */
+@NonNullByDefault
+public class PirateWeatherChannelConfiguration {
+
+    private final Logger logger = LoggerFactory.getLogger(PirateWeatherChannelConfiguration.class);
+
+    private int offset;
+    private @Nullable String earliest;
+    private @Nullable String latest;
+
+    public int getOffset() {
+        return offset;
+    }
+
+    public void setOffset(int offset) {
+        this.offset = offset;
+    }
+
+    public @Nullable String getEarliest() {
+        return earliest;
+    }
+
+    public long getEarliestInMinutes() {
+        return getMinutesFromTime(earliest);
+    }
+
+    public void setEarliest(String earliest) {
+        this.earliest = earliest;
+    }
+
+    public @Nullable String getLatest() {
+        return latest;
+    }
+
+    public long getLatestInMinutes() {
+        return getMinutesFromTime(latest);
+    }
+
+    public void setLatest(String latest) {
+        this.latest = latest;
+    }
+
+    @Override
+    public String toString() {
+        return String.format("[offset=%d, earliest='%s', latest='%s']", offset, earliest, latest);
+    }
+
+    /**
+     * Parses a hh:mm string and returns the minutes.
+     */
+    public long getMinutesFromTime(@Nullable String configTime) {
+        if (configTime == null || configTime.isBlank()) {
+            return 0;
+        }
+
+        String time = configTime.trim();
+        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("HH:mm");
+        try {
+            LocalTime localTime = LocalTime.parse(time, formatter);
+            return Duration.ofHours(localTime.getHour()).plusMinutes(localTime.getMinute()).toMinutes();
+        } catch (DateTimeParseException ex) {
+            logger.warn("Cannot parse channel configuration '{}' to hour and minutes, use pattern HH:mm, ignoring!",
+                    time);
+            return 0;
+        }
+    }
+}

bundles/org.openhab.binding.pirateweather/src/main/java/org/openhab/binding/pirateweather/internal/config/PirateWeatherWeatherAndForecastConfiguration.java

@@ -0,0 +1,30 @@
+/*
+ * Copyright (c) 2010-2026 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.pirateweather.internal.config;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.openhab.binding.pirateweather.internal.handler.PirateWeatherWeatherAndForecastHandler;
+
+/**
+ * The {@link PirateWeatherWeatherAndForecastConfiguration} is the class used to match the
+ * {@link PirateWeatherWeatherAndForecastHandler}s configuration.
+ *
+ * @author Scott Hanson - Initial contribution
+ */
+@NonNullByDefault
+public class PirateWeatherWeatherAndForecastConfiguration {
+    public int forecastHours;
+    public int forecastDays;
+    public int numberOfAlerts;
+    public String location = "";
+}

bundles/org.openhab.binding.pirateweather/src/main/java/org/openhab/binding/pirateweather/internal/connection/PirateWeatherCommunicationException.java

@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) 2010-2026 Contributors to the openHAB project
+ *
+ * See the NOTICE file(s) distributed with this work for additional
+ * information.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the Eclipse Public License 2.0 which is available at
+ * http://www.eclipse.org/legal/epl-2.0
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ */
+package org.openhab.binding.pirateweather.internal.connection;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+
+/**
+ * The {@link PirateWeatherCommunicationException} is a communication exception for the connections to Pirate Weather
+ * API.
+ *
+ * @author Scott Hanson - Initial contribution
+ */
+@NonNullByDefault
+public class PirateWeatherCommunicationException extends Exception {
+
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * Constructs a new exception with null as its detail message.
+     */
+    public PirateWeatherCommunicationException() {
+        super();
+    }
+
+    /**
+     * Constructs a new exception with the specified detail message.
+     *
+     * @param message Detail message
+     */
+    public PirateWeatherCommunicationException(String message) {
+        super(message);
+    }
+
+    /**
+     * Constructs a new exception with the specified cause.
+     *
+     * @param cause The cause
+     */
+    public PirateWeatherCommunicationException(Throwable cause) {
+        super(cause);
+    }
+
+    /**
+     * Constructs a new exception with the specified detail message and cause.
+     *
+     * @param message Detail message
+     * @param cause The cause
+     */
+    public PirateWeatherCommunicationException(String message, Throwable cause) {
+        super(message, cause);
+    }
+}