git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2023 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   7  * This program and the accompanying materials are made available under the
   8  * terms of the Eclipse Public License 2.0 which is available at
   9  * http://www.eclipse.org/legal/epl-2.0
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.binding.mqtt.generic.values;
  14
  15 import static org.hamcrest.CoreMatchers.is;
  16 import static org.hamcrest.MatcherAssert.assertThat;
  17 import static org.junit.jupiter.api.Assertions.*;
  18
  19 import java.math.BigDecimal;
  20 import java.util.Objects;
  21
  22 import org.eclipse.jdt.annotation.NonNullByDefault;
  23 import org.junit.jupiter.api.Test;
  24 import org.openhab.binding.mqtt.generic.mapping.ColorMode;
  25 import org.openhab.core.library.types.DecimalType;
  26 import org.openhab.core.library.types.HSBType;
  27 import org.openhab.core.library.types.IncreaseDecreaseType;
  28 import org.openhab.core.library.types.OnOffType;
  29 import org.openhab.core.library.types.OpenClosedType;
  30 import org.openhab.core.library.types.PercentType;
  31 import org.openhab.core.library.types.QuantityType;
  32 import org.openhab.core.library.types.StopMoveType;
  33 import org.openhab.core.library.types.StringType;
  34 import org.openhab.core.library.types.UpDownType;
  35 import org.openhab.core.library.unit.MetricPrefix;
  36 import org.openhab.core.library.unit.Units;
  37 import org.openhab.core.types.Command;
  38 import org.openhab.core.types.State;
  39 import org.openhab.core.types.TypeParser;
  40 import org.openhab.core.types.UnDefType;
  41
  42 /**
  43  * Test cases for the value classes. They should throw exceptions if the wrong command type is used
  44  * for an update. The percent value class should raise an exception if the value is out of range.
  45  *
  46  * The on/off value class should accept a multitude of values including the custom defined ones.
  47  *
  48  * The string value class states are tested.
  49  *
  50  * @author David Graeff - Initial contribution
  51  */
  52 @NonNullByDefault
  53 public class ValueTests {
  54     private Command p(Value v, String str) {
  55         return Objects.requireNonNull(TypeParser.parseCommand(v.getSupportedCommandTypes(), str));
  56     }
  57
  58     @Test
  59     public void illegalTextStateUpdate() {
  60         TextValue v = new TextValue("one,two".split(","));
  61         assertThrows(IllegalArgumentException.class, () -> v.parseCommand(p(v, "three")));
  62     }
  63
  64     @Test
  65     public void textStateUpdate() {
  66         TextValue v = new TextValue("one,two".split(","));
  67         v.parseCommand(p(v, "one"));
  68     }
  69
  70     @Test
  71     public void colorUpdate() {
  72         ColorValue v = new ColorValue(ColorMode.RGB, "fancyON", "fancyOFF", 77);
  73         v.update((State) v.parseCommand(p(v, "255,255,255")));
  74
  75         HSBType hsb = (HSBType) v.parseCommand(p(v, "OFF"));
  76         assertThat(hsb.getBrightness().intValue(), is(0));
  77         v.update(hsb);
  78         hsb = (HSBType) v.parseCommand(p(v, "ON"));
  79         assertThat(hsb.getBrightness().intValue(), is(77));
  80
  81         hsb = (HSBType) v.parseCommand(p(v, "0"));
  82         assertThat(hsb.getBrightness().intValue(), is(0));
  83         hsb = (HSBType) v.parseCommand(p(v, "1"));
  84         assertThat(hsb.getBrightness().intValue(), is(1));
  85     }
  86
  87     @Test
  88     public void illegalColorUpdate() {
  89         ColorValue v = new ColorValue(ColorMode.RGB, null, null, 10);
  90         assertThrows(IllegalArgumentException.class, () -> v.parseCommand(p(v, "255,255,abc")));
  91     }
  92
  93     @Test
  94     public void illegalNumberCommand() {
  95         NumberValue v = new NumberValue(null, null, null, null);
  96         assertThrows(IllegalArgumentException.class, () -> v.parseCommand(OnOffType.OFF));
  97     }
  98
  99     @Test
 100     public void illegalPercentCommand() {
 101         PercentageValue v = new PercentageValue(null, null, null, null, null);
 102         assertThrows(IllegalStateException.class, () -> v.parseCommand(new StringType("demo")));
 103     }
 104
 105     @Test
 106     public void illegalOnOffCommand() {
 107         OnOffValue v = new OnOffValue(null, null);
 108         assertThrows(IllegalArgumentException.class, () -> v.parseCommand(new DecimalType(101.0)));
 109     }
 110
 111     @Test
 112     public void illegalPercentUpdate() {
 113         PercentageValue v = new PercentageValue(null, null, null, null, null);
 114         assertThrows(IllegalArgumentException.class, () -> v.parseCommand(new DecimalType(101.0)));
 115     }
 116
 117     @Test
 118     public void onoffUpdate() {
 119         OnOffValue v = new OnOffValue("fancyON", "fancyOff");
 120
 121         // Test with command
 122         assertThat(v.parseCommand(OnOffType.OFF), is(OnOffType.OFF));
 123         assertThat(v.parseCommand(OnOffType.ON), is(OnOffType.ON));
 124
 125         // Test with string, representing the command
 126         assertThat(v.parseCommand(new StringType("OFF")), is(OnOffType.OFF));
 127         assertThat(v.parseCommand(new StringType("ON")), is(OnOffType.ON));
 128
 129         // Test with custom string, setup in the constructor
 130         assertThat(v.parseCommand(new StringType("fancyOff")), is(OnOffType.OFF));
 131         assertThat(v.parseCommand(new StringType("fancyON")), is(OnOffType.ON));
 132
 133         // Test basic formatting
 134         assertThat(v.getMQTTpublishValue(OnOffType.ON, null), is("fancyON"));
 135         assertThat(v.getMQTTpublishValue(OnOffType.OFF, null), is("fancyOff"));
 136
 137         // Test custom formatting
 138         assertThat(v.getMQTTpublishValue(OnOffType.OFF, "=%s"), is("=fancyOff"));
 139         assertThat(v.getMQTTpublishValue(OnOffType.ON, "=%s"), is("=fancyON"));
 140     }
 141
 142     @Test
 143     public void openCloseUpdate() {
 144         OpenCloseValue v = new OpenCloseValue("fancyON", "fancyOff");
 145
 146         // Test with command
 147         assertThat(v.parseCommand(OpenClosedType.CLOSED), is(OpenClosedType.CLOSED));
 148         assertThat(v.parseCommand(OpenClosedType.OPEN), is(OpenClosedType.OPEN));
 149
 150         // Test with string, representing the command
 151         assertThat(v.parseCommand(new StringType("CLOSED")), is(OpenClosedType.CLOSED));
 152         assertThat(v.parseCommand(new StringType("OPEN")), is(OpenClosedType.OPEN));
 153
 154         // Test with custom string, setup in the constructor
 155         assertThat(v.parseCommand(new StringType("fancyOff")), is(OpenClosedType.CLOSED));
 156         assertThat(v.parseCommand(new StringType("fancyON")), is(OpenClosedType.OPEN));
 157
 158         // Test basic formatting
 159         assertThat(v.getMQTTpublishValue(OpenClosedType.CLOSED, null), is("fancyOff"));
 160         assertThat(v.getMQTTpublishValue(OpenClosedType.OPEN, null), is("fancyON"));
 161     }
 162
 163     @Test
 164     public void numberUpdate() {
 165         NumberValue v = new NumberValue(null, null, new BigDecimal(10), Units.WATT);
 166
 167         // Test with command with units
 168         Command command = v.parseCommand(new QuantityType<>(20, Units.WATT));
 169         assertThat(command, is(new QuantityType<>(20, Units.WATT)));
 170         assertThat(v.getMQTTpublishValue(command, null), is("20"));
 171         command = v.parseCommand(new QuantityType<>(20, MetricPrefix.KILO(Units.WATT)));
 172         assertThat(command, is(new QuantityType<>(20, MetricPrefix.KILO(Units.WATT))));
 173         assertThat(v.getMQTTpublishValue(command, null), is("20000"));
 174
 175         // Test with command without units
 176         command = v.parseCommand(new QuantityType<>("20"));
 177         assertThat(command, is(new QuantityType<>(20, Units.WATT)));
 178         assertThat(v.getMQTTpublishValue(command, null), is("20"));
 179
 180         assertThat(v.parseMessage(new StringType("NaN")), is(UnDefType.UNDEF));
 181         assertThat(v.parseMessage(new StringType("nan")), is(UnDefType.UNDEF));
 182     }
 183
 184     @Test
 185     public void numberUpdateMireds() {
 186         NumberValue v = new NumberValue(null, null, new BigDecimal(10), Units.MIRED);
 187
 188         Command command = v.parseCommand(new QuantityType<>(2700, Units.KELVIN));
 189         assertThat(v.getMQTTpublishValue(command, "%.0f"), is("370"));
 190     }
 191
 192     @Test
 193     public void numberPercentageUpdate() {
 194         NumberValue v = new NumberValue(null, null, new BigDecimal(10), Units.PERCENT);
 195
 196         // Test with command with units
 197         Command command = v.parseCommand(new QuantityType<>(20, Units.PERCENT));
 198         assertThat(command, is(new QuantityType<>(20, Units.PERCENT)));
 199         assertThat(v.getMQTTpublishValue(command, null), is("20"));
 200
 201         // Test with command without units
 202         command = v.parseCommand(new QuantityType<>("20"));
 203         assertThat(command, is(new QuantityType<>(20, Units.PERCENT)));
 204         assertThat(v.getMQTTpublishValue(command, null), is("20"));
 205     }
 206
 207     @Test
 208     public void rollershutterUpdateWithStrings() {
 209         RollershutterValue v = new RollershutterValue("fancyON", "fancyOff", "fancyStop");
 210         // Test with UP/DOWN/STOP command
 211         assertThat(v.parseCommand(UpDownType.UP), is(UpDownType.UP));
 212         assertThat(v.getMQTTpublishValue(UpDownType.UP, null), is("fancyON"));
 213         assertThat(v.parseCommand(UpDownType.DOWN), is(UpDownType.DOWN));
 214         assertThat(v.getMQTTpublishValue(UpDownType.DOWN, null), is("fancyOff"));
 215         assertThat(v.parseCommand(StopMoveType.STOP), is(StopMoveType.STOP));
 216         assertThat(v.getMQTTpublishValue(StopMoveType.STOP, null), is("fancyStop"));
 217
 218         // Test with custom string
 219         assertThat(v.parseCommand(new StringType("fancyON")), is(UpDownType.UP));
 220         assertThat(v.parseCommand(new StringType("fancyOff")), is(UpDownType.DOWN));
 221
 222         // Test with exact percent
 223         Command command = new PercentType(27);
 224         assertThat(v.parseCommand((Command) command), is(command));
 225         assertThat(v.getMQTTpublishValue(command, null), is("27"));
 226
 227         // Test formatting 0/100
 228         assertThat(v.getMQTTpublishValue(PercentType.ZERO, null), is("fancyON"));
 229         assertThat(v.getMQTTpublishValue(PercentType.HUNDRED, null), is("fancyOff"));
 230     }
 231
 232     @Test
 233     public void rollershutterUpdateWithOutStrings() {
 234         RollershutterValue v = new RollershutterValue(null, null, "fancyStop");
 235         // Test with command
 236         assertThat(v.parseCommand(UpDownType.UP), is(PercentType.ZERO));
 237         assertThat(v.parseCommand(UpDownType.DOWN), is(PercentType.HUNDRED));
 238
 239         // Test with custom string
 240         // Test formatting 0/100
 241         assertThat(v.getMQTTpublishValue(PercentType.ZERO, null), is("0"));
 242         assertThat(v.getMQTTpublishValue(PercentType.HUNDRED, null), is("100"));
 243     }
 244
 245     @Test
 246     public void percentCalc() {
 247         PercentageValue v = new PercentageValue(new BigDecimal(10.0), new BigDecimal(110.0), new BigDecimal(1.0), null,
 248                 null);
 249         assertThat(v.parseCommand(new DecimalType("110.0")), is(PercentType.HUNDRED));
 250         assertThat(v.getMQTTpublishValue(PercentType.HUNDRED, null), is("110"));
 251         assertThat(v.parseCommand(new DecimalType(10.0)), is(PercentType.ZERO));
 252         assertThat(v.getMQTTpublishValue(PercentType.ZERO, null), is("10"));
 253
 254         assertThat(v.parseCommand(OnOffType.ON), is(PercentType.HUNDRED));
 255         assertThat(v.parseCommand(OnOffType.OFF), is(PercentType.ZERO));
 256     }
 257
 258     @Test
 259     public void percentMQTTValue() {
 260         PercentageValue v = new PercentageValue(null, null, null, null, null);
 261         assertThat(v.parseCommand(new DecimalType("10.10000")), is(new PercentType("10.1")));
 262         assertThat(v.getMQTTpublishValue(new PercentType("10.1"), null), is("10.1"));
 263         Command command;
 264         for (int i = 0; i <= 100; i++) {
 265             command = v.parseCommand(new DecimalType(i));
 266             assertThat(v.getMQTTpublishValue(command, null), is("" + i));
 267         }
 268     }
 269
 270     @Test
 271     public void percentCustomOnOff() {
 272         PercentageValue v = new PercentageValue(new BigDecimal("0.0"), new BigDecimal("100.0"), new BigDecimal("1.0"),
 273                 "on", "off");
 274         assertThat(v.parseCommand(new StringType("on")), is(PercentType.HUNDRED));
 275         assertThat(v.parseCommand(new StringType("off")), is(PercentType.ZERO));
 276     }
 277
 278     @Test
 279     public void decimalCalc() {
 280         PercentageValue v = new PercentageValue(new BigDecimal("0.1"), new BigDecimal("1.0"), new BigDecimal("0.1"),
 281                 null, null);
 282         assertThat(v.parseCommand(new DecimalType(1.0)), is(PercentType.HUNDRED));
 283         assertThat(v.parseCommand(new DecimalType(0.1)), is(PercentType.ZERO));
 284         PercentType command = (PercentType) v.parseCommand(new DecimalType(0.2));
 285         assertEquals(command.floatValue(), 11.11f, 0.01f);
 286     }
 287
 288     @Test
 289     public void increaseDecreaseCalc() {
 290         PercentageValue v = new PercentageValue(new BigDecimal("1.0"), new BigDecimal("11.0"), new BigDecimal("0.5"),
 291                 null, null);
 292
 293         // Normal operation.
 294         PercentType command = (PercentType) v.parseCommand(new DecimalType("6.0"));
 295         assertEquals(command.floatValue(), 50.0f, 0.01f);
 296         v.update(command);
 297         command = (PercentType) v.parseCommand(IncreaseDecreaseType.INCREASE);
 298         assertEquals(command.floatValue(), 55.0f, 0.01f);
 299         command = (PercentType) v.parseCommand(IncreaseDecreaseType.DECREASE);
 300         assertEquals(command.floatValue(), 45.0f, 0.01f);
 301
 302         // Lower limit.
 303         command = (PercentType) v.parseCommand(new DecimalType("1.1"));
 304         assertEquals(command.floatValue(), 1.0f, 0.01f);
 305         v.update(command);
 306         command = (PercentType) v.parseCommand(IncreaseDecreaseType.DECREASE);
 307         assertEquals(command.floatValue(), 0.0f, 0.01f);
 308
 309         // Upper limit.
 310         command = (PercentType) v.parseCommand(new DecimalType("10.8"));
 311         assertEquals(command.floatValue(), 98.0f, 0.01f);
 312         v.update(command);
 313         command = (PercentType) v.parseCommand(IncreaseDecreaseType.INCREASE);
 314         assertEquals(command.floatValue(), 100.0f, 0.01f);
 315     }
 316
 317     @Test
 318     public void upDownCalc() {
 319         PercentageValue v = new PercentageValue(new BigDecimal("1.0"), new BigDecimal("11.0"), new BigDecimal("0.5"),
 320                 null, null);
 321
 322         // Normal operation.
 323         PercentType command = (PercentType) v.parseCommand(new DecimalType("6.0"));
 324         assertEquals(command.floatValue(), 50.0f, 0.01f);
 325         v.update(command);
 326         command = (PercentType) v.parseCommand(UpDownType.UP);
 327         assertEquals(command.floatValue(), 55.0f, 0.01f);
 328         command = (PercentType) v.parseCommand(UpDownType.DOWN);
 329         assertEquals(command.floatValue(), 45.0f, 0.01f);
 330
 331         // Lower limit.
 332         command = (PercentType) v.parseCommand(new DecimalType("1.1"));
 333         assertEquals(command.floatValue(), 1.0f, 0.01f);
 334         v.update(command);
 335         command = (PercentType) v.parseCommand(UpDownType.DOWN);
 336         assertEquals(command.floatValue(), 0.0f, 0.01f);
 337
 338         // Upper limit.
 339         command = (PercentType) v.parseCommand(new DecimalType("10.8"));
 340         assertEquals(command.floatValue(), 98.0f, 0.01f);
 341         v.update(command);
 342         command = (PercentType) v.parseCommand(UpDownType.UP);
 343         assertEquals(command.floatValue(), 100.0f, 0.01f);
 344     }
 345
 346     @Test
 347     public void percentCalcInvalid() {
 348         PercentageValue v = new PercentageValue(new BigDecimal(10.0), new BigDecimal(110.0), new BigDecimal(1.0), null,
 349                 null);
 350         assertThrows(IllegalArgumentException.class, () -> v.parseCommand(new DecimalType(9.0)));
 351     }
 352 }