[visualcrossing] Initial contribution

CODEOWNERS

@@ -395,6 +395,7 @@
 /bundles/org.openhab.binding.verisure/ @jannegpriv
 /bundles/org.openhab.binding.vesync/ @dag81
 /bundles/org.openhab.binding.vigicrues/ @clinique
+/bundles/org.openhab.binding.visualcrossing/ @magx2
 /bundles/org.openhab.binding.vitotronic/ @steand
 /bundles/org.openhab.binding.vizio/ @mlobstein
 /bundles/org.openhab.binding.volvooncall/ @Jamstah

bom/openhab-addons/pom.xml

@@ -1971,6 +1971,11 @@
       <artifactId>org.openhab.binding.vigicrues</artifactId>
       <version>${project.version}</version>
     </dependency>
+    <dependency>
+      <groupId>org.openhab.addons.bundles</groupId>
+      <artifactId>org.openhab.binding.visualcrossing</artifactId>
+      <version>${project.version}</version>
+    </dependency>
     <dependency>
       <groupId>org.openhab.addons.bundles</groupId>
       <artifactId>org.openhab.binding.vitotronic</artifactId>

bundles/org.openhab.binding.visualcrossing/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.visualcrossing/pom.xml

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://maven.apache.org/POM/4.0.0"
+  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>4.3.0-SNAPSHOT</version>
+  </parent>
+
+  <artifactId>org.openhab.binding.visualcrossing</artifactId>
+
+  <name>openHAB Add-ons :: Bundles :: VisualCrossing Binding</name>
+
+  <dependencies>
+    <!-- TEST -->
+    <dependency>
+      <groupId>org.assertj</groupId>
+      <artifactId>assertj-core</artifactId>
+      <version>3.25.3</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>org.mockito</groupId>
+      <artifactId>mockito-core</artifactId>
+      <version>5.11.0</version>
+      <scope>test</scope>
+    </dependency>
+  </dependencies>
+</project>

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

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="org.openhab.binding.visualcrossing-${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-visualcrossing" description="VisualCrossing Binding" version="${project.version}">
+		<feature>openhab-runtime-base</feature>
+		<bundle start-level="80">mvn:org.openhab.addons.bundles/org.openhab.binding.visualcrossing/${project.version}</bundle>
+	</feature>
+</features>

bundles/org.openhab.binding.visualcrossing/src/main/java/org/openhab/binding/visualcrossing/internal/TypeBuilder.java

@@ -0,0 +1,218 @@
+/**
+ * Copyright (c) 2010-2024 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.visualcrossing.internal;
+
+import static javax.measure.MetricPrefix.MEGA;
+import static org.openhab.core.library.unit.MetricPrefix.*;
+import static org.openhab.core.library.unit.SIUnits.*;
+import static org.openhab.core.library.unit.Units.*;
+import static org.openhab.core.types.UnDefType.UNDEF;
+
+import java.math.BigDecimal;
+import java.time.Instant;
+import java.time.ZoneId;
+import java.util.Collection;
+import java.util.function.Function;
+
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+import org.openhab.core.library.types.DateTimeType;
+import org.openhab.core.library.types.DecimalType;
+import org.openhab.core.library.types.PercentType;
+import org.openhab.core.library.types.QuantityType;
+import org.openhab.core.library.types.StringType;
+import org.openhab.core.types.State;
+
+/**
+ * @author Martin Grześlowski - Initial contribution
+ */
+@NonNullByDefault
+class TypeBuilder {
+    private static State newStringType(@Nullable String string) {
+        return string != null ? new StringType(string) : UNDEF;
+    }
+
+    public static <T> State newStringType(@Nullable T obj, Function<T, @Nullable String> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newStringType(function.apply(obj));
+    }
+
+    private static State newStringType(@Nullable Collection<String> strings) {
+        return strings != null ? new StringType(String.join(",", strings)) : UNDEF;
+    }
+
+    public static <T> State newStringCollectionType(@Nullable T obj,
+            Function<T, @Nullable Collection<String>> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newStringType(function.apply(obj));
+    }
+
+    private static State newDecimalType(@Nullable Number number) {
+        return number != null ? new DecimalType(number) : UNDEF;
+    }
+
+    public static <T> State newDecimalType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newDecimalType(function.apply(obj));
+    }
+
+    private static State newPercentType(@Nullable Number decimal) {
+        if (decimal == null) {
+            return UNDEF;
+        }
+
+        return new PercentType(new BigDecimal(decimal.toString()));
+    }
+
+    public static <T> State newPercentType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newPercentType(function.apply(obj));
+    }
+
+    private static State newTemperatureType(@Nullable Number temp) {
+        return temp != null ? new QuantityType<>(temp, CELSIUS) : UNDEF;
+    }
+
+    public static <T> State newTemperatureType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newTemperatureType(function.apply(obj));
+    }
+
+    private static State newHumidityType(@Nullable Number humidity) {
+        if (humidity == null) {
+            return UNDEF;
+        }
+        return new PercentType(new BigDecimal(humidity.toString()));
+    }
+
+    public static <T> State newHumidityType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newHumidityType(function.apply(obj));
+    }
+
+    private static State newMilliLengthType(@Nullable Number length) {
+        return length != null ? new QuantityType<>(length, MILLI(METRE)) : UNDEF;
+    }
+
+    public static <T> State newMilliLengthType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newMilliLengthType(function.apply(obj));
+    }
+
+    private static State newCentiLengthType(@Nullable Number length) {
+        return length != null ? new QuantityType<>(length, CENTI(METRE)) : UNDEF;
+    }
+
+    public static <T> State newCentiLengthType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newCentiLengthType(function.apply(obj));
+    }
+
+    private static State newSpeedType(@Nullable Number speed) {
+        return speed != null ? new QuantityType<>(speed, KILOMETRE_PER_HOUR) : UNDEF;
+    }
+
+    public static <T> State newSpeedType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newSpeedType(function.apply(obj));
+    }
+
+    private static State newAngleType(@Nullable Number angle) {
+        return angle != null ? new QuantityType<>(angle, DEGREE_ANGLE) : UNDEF;
+    }
+
+    public static <T> State newAngleType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newAngleType(function.apply(obj));
+    }
+
+    private static State newMilliPressureType(@Nullable Number pressure) {
+        return pressure != null ? new QuantityType<>(pressure, MILLI(BAR)) : UNDEF;
+    }
+
+    public static <T> State newMilliPressureType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newMilliPressureType(function.apply(obj));
+    }
+
+    private static State newKiloMeterType(@Nullable Number km) {
+        return km != null ? new QuantityType<>(km, KILO(METRE)) : UNDEF;
+    }
+
+    public static <T> State newKiloMeterType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newKiloMeterType(function.apply(obj));
+    }
+
+    private static State newSolarRadiationType(@Nullable Number solarRadiation) {
+        return solarRadiation != null ? new QuantityType<>(solarRadiation, WATT.divide(METRE.multiply(METRE))) : UNDEF;
+    }
+
+    public static <T> State newSolarRadiationType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newSolarRadiationType(function.apply(obj));
+    }
+
+    private static State newSolarEnergyType(@Nullable Number solarEnergy) {
+        return solarEnergy != null ? new QuantityType<>(solarEnergy, MEGA(JOULE).divide(METRE.multiply(METRE))) : UNDEF;
+    }
+
+    public static <T> State newSolarEnergyType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newSolarEnergyType(function.apply(obj));
+    }
+
+    private static State newDateTimeType(@Nullable Number number) {
+        if (number == null) {
+            return UNDEF;
+        }
+        var instant = Instant.ofEpochSecond(number.longValue());
+        var zonedDateTime = instant.atZone(ZoneId.of("UTC"));
+        return new DateTimeType(zonedDateTime);
+    }
+
+    public static <T> State newDateTimeType(@Nullable T obj, Function<T, @Nullable Number> function) {
+        if (obj == null) {
+            return UNDEF;
+        }
+        return newDateTimeType(function.apply(obj));
+    }
+}