Add Bosk.simple factory method

Author: prdoyle

bosk-core/src/main/java/works/bosk/Bosk.java

@@ -100,7 +100,7 @@ public class Bosk<R extends StateTreeNode> implements BoskInfo<R> {
 	private volatile R currentRoot;
 
 	/**
-	 * @param name Any string that identifies this object.
+	 * @param name A distinctive identifier string. The bosk framework doesn't use this, so there are no requirements on this string: it can be anything that identifies the object.
 	 * @param rootType The @{link Type} of the root node of the state tree, whose {@link Reference#path path} is <code>"/"</code>.
 	 * @param defaultRootFunction The root object to use if the driver chooses not to supply one,
 	 *    and instead delegates {@link BoskDriver#initialRoot} all the way to the local driver.
@@ -155,6 +155,18 @@ public Bosk(String name, Type rootType, DefaultRootFunction<R> defaultRootFuncti
 		this(name, rootType, defaultRootFunction, driverFactory, Bosk.simpleRegistrar());
 	}
 
+	/**
+	 * Convenience method to create a bosk with only the basic functionality,
+	 * to get going quickly.
+	 * To customize the bosk behaviour later,
+	 * you can inline this into your call site and modify it as desired.
+	 * @param name A distinctive identifier string. The bosk framework doesn't use this, so there are no requirements on this string: it can be anything that identifies the object.
+	 * @param initialRoot The starting value of the bosk state tree, before any updates.
+	 */
+	public static <RR extends StateTreeNode> Bosk<RR> simple(String name, RR initialRoot) {
+		return new Bosk<>(requireNonNull(name), initialRoot.getClass(), b -> initialRoot, simpleDriver(), simpleRegistrar());
+	}
+
 	public interface DefaultRootFunction<RR extends StateTreeNode> {
 		RR apply(Bosk<RR> bosk) throws InvalidTypeException;
 	}

bosk-core/src/test/java/works/bosk/BoskConstructorTest.java

@@ -114,18 +114,9 @@ void driverInitialRoot_matches() {
 	@Test
 	void defaultRoot_matches() {
 		SimpleTypes root = newEntity();
-		{
-			Bosk<StateTreeNode> valueBosk = new Bosk<>(boskName(), SimpleTypes.class, _ -> root, Bosk.simpleDriver(), Bosk.simpleRegistrar());
-			try (var _ = valueBosk.readContext()) {
-				assertSame(root, valueBosk.rootReference().value());
-			}
-		}
-
-		{
-			Bosk<StateTreeNode> functionBosk = new Bosk<StateTreeNode>(boskName(), SimpleTypes.class, _ -> root, Bosk.simpleDriver(), Bosk.simpleRegistrar());
-			try (var _ = functionBosk.readContext()) {
-				assertSame(root, functionBosk.rootReference().value());
-			}
+		Bosk<StateTreeNode> valueBosk = Bosk.simple(boskName(), root);
+		try (var _ = valueBosk.readContext()) {
+			assertSame(root, valueBosk.rootReference().value());
 		}
 	}