Add draft ItemConfigurator support for Folder

pom.xml

@@ -68,7 +68,6 @@
     <dependency>
       <groupId>io.jenkins</groupId>
       <artifactId>configuration-as-code</artifactId>
-      <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>io.jenkins.configuration-as-code</groupId>

src/main/java/com/cloudbees/hudson/plugins/folder/FolderItemConfigurator.java

@@ -0,0 +1,52 @@
+package com.cloudbees.hudson.plugins.folder;
+
+import hudson.Extension;
+import io.jenkins.plugins.casc.ConfigurationContext;
+import io.jenkins.plugins.casc.ConfiguratorException;
+import io.jenkins.plugins.casc.ItemConfigurator;
+import io.jenkins.plugins.casc.model.CNode;
+import io.jenkins.plugins.casc.model.Mapping;
+import jenkins.model.Jenkins;
+import java.io.IOException;
+
+@Extension
+public class FolderItemConfigurator implements ItemConfigurator<Folder> {
+
+	@Override
+	public String getName() {
+		return "folder";
+	}
+
+	@Override
+	public Class<Folder> getTarget() {
+		return Folder.class;
+	}
+
+	@Override
+	public Folder configure(String name, CNode config, ConfigurationContext context) throws ConfiguratorException {
+		try {
+			Jenkins jenkins = Jenkins.get();
+			Folder folder = (Folder) jenkins.getItem(name);
+
+			if (folder == null) {
+				folder = jenkins.createProject(Folder.class, name);
+			}
+
+			Mapping mapping = config.asMapping();
+
+			if (mapping.containsKey("description")) {
+				folder.setDescription(mapping.getScalarValue("description"));
+			}
+
+			if (mapping.containsKey("displayName")) {
+				folder.setDisplayName(mapping.getScalarValue("displayName"));
+			}
+
+			folder.save();
+			return folder;
+
+		} catch (IOException e) {
+			throw new ConfiguratorException("Failed to configure folder: " + name, e);
+		}
+	}
+}

src/test/java/com/cloudbees/hudson/plugins/folder/FolderItemConfiguratorTest.java

@@ -0,0 +1,46 @@
+package com.cloudbees.hudson.plugins.folder;
+
+import io.jenkins.plugins.casc.ConfigurationAsCode;
+import io.jenkins.plugins.casc.misc.ConfiguredWithCode;
+import io.jenkins.plugins.casc.misc.JenkinsConfiguredWithCodeRule;
+import jenkins.model.Jenkins;
+import org.junit.Rule;
+import org.junit.Test;
+
+import java.util.Objects;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+
+public class FolderItemConfiguratorTest {
+
+	@Rule
+	public JenkinsConfiguredWithCodeRule j = new JenkinsConfiguredWithCodeRule();
+
+	@Test
+	@ConfiguredWithCode("create-folder.yaml")
+	public void shouldCreateNewFolder() {
+		Folder folder = (Folder) Jenkins.get().getItem("team-alpha");
+
+		assertNotNull("Folder should have been created by JCasC", folder);
+		assertEquals("Team Alpha", folder.getDisplayName());
+		assertEquals("Description for Team Alpha", folder.getDescription());
+	}
+
+	@Test
+	public void shouldUpdateExistingFolder() throws Exception {
+		Folder existingFolder = j.jenkins.createProject(Folder.class, "team-beta");
+		existingFolder.setDescription("Old Description");
+		existingFolder.setDisplayName("Old Display Name");
+
+		ConfigurationAsCode.get().configure(
+			Objects.requireNonNull(getClass().getResource("update-folder.yaml")).toExternalForm()
+		);
+
+		Folder updatedFolder = (Folder) Jenkins.get().getItem("team-beta");
+
+		assertNotNull(updatedFolder);
+		assertEquals("Team Beta Updated", updatedFolder.getDisplayName());
+		assertEquals("New Description via JCasC", updatedFolder.getDescription());
+	}
+}

src/test/resources/com/cloudbees/hudson/plugins/folder/create-folder.yaml

@@ -0,0 +1,5 @@
+items:
+  - folder:
+      name: "team-alpha"
+      displayName: "Team Alpha"
+      description: "Description for Team Alpha"

src/test/resources/com/cloudbees/hudson/plugins/folder/update-folder.yaml

@@ -0,0 +1,5 @@
+items:
+  - folder:
+      name: "team-beta"
+      displayName: "Team Beta Updated"
+      description: "New Description via JCasC"