Add miscellaneous test cases

Author: Exlll

README.md

@@ -80,15 +80,15 @@ public final class Example {
         var configFile = Paths.get("/tmp/config.yml");
         var config = new UserConfiguration();
 
-        // Save a new instance to the configuration file
+        // Save an instance to the configuration file
         YamlConfigurations.save(configFile, UserConfiguration.class, config);
 
         // Load a new instance from the configuration file
         config = YamlConfigurations.load(configFile, UserConfiguration.class);
         System.out.println(config.admin.username);
         System.out.println(config.blockedUsers);
 
-        // Modify and save the configuration file
+        // Modify the configuration and save it again
         config.blockedUsers.add(new User("user3", "pass3"));
         YamlConfigurations.save(configFile, UserConfiguration.class, config);
     }
@@ -446,8 +446,8 @@ missing. That can happen, for example, when somebody deleted that value from the
 when you add configuration elements to your configuration type, or when the `NameFormatter` that
 was used to create that file is replaced.
 
-In such cases, fields of configuration types keep the default value you assigned to them and record
-components are initialized with the default value of their corresponding type.
+In such cases, fields of configuration classes keep the default value you assigned to them and
+record components are initialized with the default value of their corresponding type.
 
 #### Null values
 
@@ -792,7 +792,7 @@ public final class RecursiveTypDefinitions {
 
 </details>
 
-## Project structure
+## Project and repository structure
 
 This project contains three classes of modules:
 
@@ -811,6 +811,13 @@ This project contains three classes of modules:
       object which adds support for the serialization of Bukkit classes like `ItemStack` as
       described [here](#support-for-bukkit-classes-like-itemstack).
 
+The GitHub repository of this project uses two branches:
+
+* The `master` branch contains the functionality of the latest release version.
+* The `dev` branch contains the newest, possibly unstable features and refactorings.
+
+If you plan to contribute to this project, please base your commits on the `dev` branch.
+
 ## Import
 
 To use this library, import it into your project with Maven or Gradle. Examples of how to do that
@@ -876,7 +883,9 @@ dependencies { implementation("com.github.Exlll.ConfigLib:configlib-yaml:v4.1.0"
 </details>
 
 <details>
- <summary>Import via GitHub</summary>
+ <summary>
+    Import via GitHub
+ </summary>
 
 Importing via GitHub requires authentication. Check
 this [issue](https://github.com/Exlll/ConfigLib/issues/12) if you have any trouble with that.

configlib-core/src/main/java/de/exlll/configlib/SerializeWith.java

@@ -75,7 +75,8 @@
      *
      * @return the type of serializer to use
      */
-    Class<? extends Serializer<?, ?>> serializer();
+    @SuppressWarnings("rawtypes")
+    Class<? extends Serializer> serializer();
 
     /**
      * Returns the nesting level at which to apply the serializer.

configlib-core/src/test/java/de/exlll/configlib/ExampleConfigurationTests.java

@@ -254,4 +254,25 @@ void deserializeExampleRecord2() {
         ExampleRecord2 deserialize2 = serializer.deserialize(EXAMPLE_RECORD2_2);
         assertExampleRecord2Equal(ExampleInitializer.EXAMPLE_RECORD2_2, deserialize2);
     }
+
+    @Test
+    void serializeExampleConfigurationCustom() {
+        ConfigurationSerializer<ExampleConfigurationCustom> serializer =
+                new ConfigurationSerializer<>(ExampleConfigurationCustom.class, PROPERTIES_ALLOW_NULL);
+
+        ExampleConfigurationCustom config = new ExampleConfigurationCustom();
+        Map<?, ?> serialized = serializer.serialize(config);
+        assertEquals(EXAMPLE_CONFIGURATION_CUSTOM, serialized);
+    }
+
+    @Test
+    void deserializeExampleConfigurationCustom() {
+        ConfigurationSerializer<ExampleConfigurationCustom> serializer =
+                new ConfigurationSerializer<>(ExampleConfigurationCustom.class, PROPERTIES_ALLOW_NULL);
+
+        assertExampleConfigurationsCustomEqual(
+                serializer.deserialize(EXAMPLE_CONFIGURATION_CUSTOM),
+                new ExampleConfigurationCustom()
+        );
+    }
 }

configlib-core/src/test/java/de/exlll/configlib/SerializerSelectorTest.java

@@ -539,7 +539,7 @@ static class Z {
         }
 
         @Test
-        void selectCustomSerializerfieldAsElement() {
+        void selectCustomSerializerForField() {
             var serializer = SELECTOR.select(fieldAsElement(Z.class, "string"));
             assertThat(serializer, instanceOf(IdentitySerializer.class));
         }
@@ -690,6 +690,63 @@ private record SerializerWithContext(SerializerContext ctx)
             @Override
             public String deserialize(String element) {return null;}
         }
+
+        @Test
+        void selectCustomSerializerWithOnUnsupportedTypes() {
+            record Box<T>(T element) {}
+
+            @SuppressWarnings("rawtypes")
+            final class UnsupportedTypes<T> {
+                @SerializeWith(serializer = IdentitySerializer.class)
+                Map<Point, String> mapPointString1;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                Map<List<String>, String> mapListStringString;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                Box<String> boxString;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                List<? extends String> listWildcardExtendsString;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                List<?> listWildcard;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                List<?>[] arrayListWildcard;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                T typeVariable;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                List listRaw;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                List[] arrayListRaw;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                List<String>[] arrayListString;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                Set<Integer>[] arraySetInteger;
+                @SerializeWith(serializer = IdentitySerializer.class)
+                Map<Byte, Byte>[] arrayMapByteByte;
+            }
+
+            final class Config {
+                @SerializeWith(serializer = IdentitySerializer.class)
+                UnsupportedTypes<Point> unsupportedTypes;
+            }
+
+            assertInstanceOfIdentitySerializer(Config.class, "unsupportedTypes");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "mapPointString1");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "mapListStringString");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "boxString");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "listWildcardExtendsString");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "listWildcard");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "arrayListWildcard");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "typeVariable");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "listRaw");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "arrayListRaw");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "arrayListString");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "arraySetInteger");
+            assertInstanceOfIdentitySerializer(UnsupportedTypes.class, "arrayMapByteByte");
+        }
+
+        static void assertInstanceOfIdentitySerializer(Class<?> type, String fieldName) {
+            var serializer = SELECTOR.select(fieldAsElement(type, fieldName));
+            assertThat(serializer, instanceOf(IdentitySerializer.class));
+        }
     }
 
     static final class SerializeWithOnTypesTest {

configlib-core/src/testFixtures/java/de/exlll/configlib/TestUtils.java

@@ -131,16 +131,38 @@ public record IdentitySerializer(SerializerContext context)
             implements Serializer<Object, Object> {
 
         @Override
-            public Object serialize(Object element) {
-                return element;
-            }
-
-            @Override
-            public Object deserialize(Object element) {
-                return element;
-            }
+        public Object serialize(Object element) {
+            return element;
+        }
+
+        @Override
+        public Object deserialize(Object element) {
+            return element;
+        }
+    }
+
+    public record ThrowingSerializer(SerializerContext context)
+            implements Serializer<Object, Object> {
+
+        public ThrowingSerializer {
+            throw new UnsupportedOperationException(context.toString());
         }
 
+        @Override
+        public Object serialize(Object element) {
+            throw new UnsupportedOperationException(element.toString());
+        }
+
+        @Override
+        public Object deserialize(Object element) {
+            throw new UnsupportedOperationException(element.toString());
+        }
+    }
+
+    @SafeVarargs
+    public static <E> List<E> asList(E... elements) {
+        return new ArrayList<>(Arrays.asList(elements));
+    }
 
     @SafeVarargs
     public static <E> Set<E> asSet(E... elements) {