/*
    * Licensed to the Apache Software Foundation (ASF) under one or more
    * contributor license agreements.  See the NOTICE file distributed with
    * this work for additional information regarding copyright ownership.
    * The ASF licenses this file to You under the Apache License, Version 2.0
    * (the "License"); you may not use this file except in compliance with
    * the License.  You may obtain a copy of the License at
    *
    *     https://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  package org.apache.commons.configuration2.convert;
  
  import static org.junit.jupiter.api.Assertions.assertEquals;
  import static org.junit.jupiter.api.Assertions.assertIterableEquals;
  import static org.mockito.Mockito.mock;
  import static org.mockito.Mockito.verify;
  import static org.mockito.Mockito.verifyNoMoreInteractions;
  import static org.mockito.Mockito.when;
  
  import java.util.Arrays;
  import java.util.Collection;
  import java.util.List;
  
  import org.junit.jupiter.api.BeforeEach;
  import org.junit.jupiter.api.Test;
  
  /**
   * Test class for {@code DefaultListDelimiterHandler}.
   */
  public class TestDefaultListDelimiterHandler {
  
      /** The handler to be tested. */
      private DefaultListDelimiterHandler handler;
  
      /**
       * Helper methods for testing a split operation. A split is executed with the passed in parameters. Then the results are
       * compared to the expected elements.
       *
       * @param value the value to be split
       * @param trim the trim flag
       * @param expectedElements the expected results
       */
      private void checkSplit(final String value, final boolean trim, final String... expectedElements) {
          final Collection<String> elems = handler.split(value, trim);
          assertIterableEquals(Arrays.asList(expectedElements), elems);
      }
  
      @BeforeEach
      public void setUp() throws Exception {
          handler = new DefaultListDelimiterHandler(',');
      }
  
      @Test
      void testEscapeIntegerList() {
          final ValueTransformer trans = ListDelimiterHandler.NOOP_TRANSFORMER;
          final List<Integer> data = Arrays.asList(1, 2, 3, 4);
          assertEquals("1,2,3,4", handler.escapeList(data, trans));
      }
  
      /**
       * Tests whether a list is correctly escaped.
       */
      @Test
      void testEscapeList() {
          final ValueTransformer trans = value -> String.valueOf(value) + "_trans";
          final List<String> data = Arrays.asList("simple", "Hello,world!", "\\,\\", "end");
          assertEquals("simple_trans,Hello\\,world!_trans,\\\\\\,\\\\_trans,end_trans", handler.escapeList(data, trans));
      }
  
      /**
       * Tests whether a backslash is correctly escaped.
       */
      @Test
      void testEscapeStringBackslash() {
          assertEquals("C:\\\\Temp\\\\", handler.escapeString("C:\\Temp\\"));
      }
  
      /**
       * Tests whether the list delimiter character is correctly escaped in a string.
       */
      @Test
      void testEscapeStringListDelimiter() {
          assertEquals("3\\,1415", handler.escapeString("3,1415"));
      }
  
      /**
       * Tests whether combinations of list delimiters and backslashes are correctly escaped.
       */
      @Test
      void testEscapeStringListDelimiterAndBackslash() {
          assertEquals("C:\\\\Temp\\\\\\,\\\\\\\\Share\\,/root", handler.escapeString("C:\\Temp\\,\\\\Share,/root"));
      }
  
     /**
      * Tests whether a string is correctly escaped which does not contain any special character.
      */
     @Test
     void testEscapeStringNoSpecialCharacter() {
         assertEquals("test", handler.escapeString("test"));
     }
 
     /**
      * Tests whether a value transformer is correctly called when escaping a single value.
      */
     @Test
     void testEscapeWithTransformer() {
         final ValueTransformer trans = mock(ValueTransformer.class);
 
         when(trans.transformValue("a\\,b")).thenReturn("ok");
 
         assertEquals("ok", handler.escape("a,b", trans));
 
         verify(trans).transformValue("a\\,b");
         verifyNoMoreInteractions(trans);
     }
 
     /**
      * Tests whether split() deals correctly with escaped backslashes.
      */
     @Test
     void testSplitEscapeBackslash() {
         checkSplit("C:\\\\Temp\\\\", true, "C:\\Temp\\");
     }
 
     /**
      * Tests whether a line delimiter can be escaped when splitting a list.
      */
     @Test
     void testSplitEscapeLineDelimiter() {
         checkSplit("3\\,1415", true, "3,1415");
     }
 
     /**
      * Tests a split operation with a complex combination of list delimiters and backslashes.
      */
     @Test
     void testSplitEscapeListDelimiterAndBackslashes() {
         checkSplit("C:\\\\Temp\\\\\\,\\\\\\\\Share\\\\,/root", false, "C:\\Temp\\,\\\\Share\\", "/root");
     }
 
     /**
      * Tests whether a string list is split correctly.
      */
     @Test
     void testSplitList() {
         checkSplit("a, b,c   ,   d", true, "a", "b", "c", "d");
     }
 
     /**
      * Tests whether trimming can be disabled when splitting a list.
      */
     @Test
     void testSplitNoTrim() {
         checkSplit("a , b,  c  ,d", false, "a ", " b", "  c  ", "d");
     }
 
     /**
      * Tests split() if there is only a single element.
      */
     @Test
     void testSplitSingleElement() {
         checkSplit("test", true, "test");
     }
 
     /**
      * Tests whether an unexpected escape character is handled properly.
      */
     @Test
     void testSplitUnexpectedEscape() {
         checkSplit("\\x, \\,y, \\", true, "\\x", ",y", "\\");
     }
 }