summaryrefslogtreecommitdiff
path: root/dice/src
diff options
context:
space:
mode:
Diffstat (limited to 'dice/src')
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/DieBoxCLI.java245
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/DieBoxException.java36
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/commands/BindCommand.java5
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/commands/HelpCommand.java5
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/commands/LiteralCommand.java16
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/commands/PolyhedralDieCommand.java12
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/commands/RollCommand.java15
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/commands/ShowBindingsCommand.java6
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/ArrayStatementValue.java16
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/BooleanStatementValue.java7
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/DiePoolStatementValue.java19
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/DieStatementValue.java19
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/IntArrayStatementValue.java50
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/IntegerStatementValue.java12
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/StatementValue.java23
-rw-r--r--dice/src/example/java/bjc/dicelang/neodice/statements/VoidStatementValue.java4
-rw-r--r--dice/src/main/java/bjc/dicelang/neodice/Die.java267
-rw-r--r--dice/src/main/java/bjc/dicelang/neodice/DieFactory.java63
-rw-r--r--dice/src/main/java/bjc/dicelang/neodice/DiePool.java582
-rw-r--r--dice/src/main/java/bjc/dicelang/neodice/DiePoolFactory.java82
-rw-r--r--dice/src/test/java/bjc/dicelang/neodice/DieBoxCLITest.java6
-rw-r--r--dice/src/test/java/bjc/dicelang/neodice/DiePoolTest.java31
-rw-r--r--dice/src/test/java/bjc/dicelang/neodice/DieTest.java42
23 files changed, 761 insertions, 802 deletions
diff --git a/dice/src/example/java/bjc/dicelang/neodice/DieBoxCLI.java b/dice/src/example/java/bjc/dicelang/neodice/DieBoxCLI.java
index 557fd51..2c67e7f 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/DieBoxCLI.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/DieBoxCLI.java
@@ -20,88 +20,111 @@ import bjc.funcdata.*;
*/
public class DieBoxCLI {
private static final Pattern INT_PATTERN = Pattern.compile("(?:\\+|-)?\\d+");
- Scanner input;
+ /**
+ * The scanner we read input from.
+ */
+ public Scanner input;
+ /**
+ * The place we write output to.
+ */
public PrintStream output;
-
- public IMap<String, StatementValue> bindings = new FunctionalMap<>();
+ /**
+ * The current set of variable bindings
+ */
+ public MapEx<String, StatementValue> bindings = new FunctionalMap<>();
+
+ /**
+ * The current source of random numbers.
+ */
public Random rng = new Random();
-
- static final IMap<String, Command> builtInCommands;
- static final IMap<String, Command> builtInliterals;
-
- final IMap<String, Command> commands;
- final IMap<String, Command> literals;
-
+
+ /**
+ * The built-in diebox commands.
+ */
+ public static final MapEx<String, Command> builtInCommands;
+ /**
+ * The built-in diebox literal formers.
+ */
+ public static final MapEx<String, Command> builtInliterals;
+
+ /**
+ * The current set of diebox commands.
+ */
+ public final MapEx<String, Command> commands;
+ /**
+ * The current set of diebox literal-formers.
+ */
+ public final MapEx<String, Command> literals;
+
private int numStatements = 0;
/**
* Whether or not to print out a prompt before asking for input
*/
public boolean doPrompt = true;
-
+
/**
* Whether or not to output the results of each command.
*/
public boolean doOutput = true;
-
+
/**
* Should warning messages be printed?
*/
public boolean doWarn = true;
-
+
static {
// Initialize all of our literal-formers
builtInliterals = new FunctionalMap<>();
-
- builtInliterals.put("void",
- new LiteralCommand(
- VOID_INST,
- "the unique instance of type VOID",
- "Returns a reference to the unique instance of type VOID."));
- builtInliterals.put("true",
- new LiteralCommand(
- TRUE_INST,
- "the unique true value of type BOOLEAN",
- "Returns a reference to the unique true instance of type BOOLEAN"));
- builtInliterals.put("false",
- new LiteralCommand(
- FALSE_INST,
- "the unique false value of type BOOLEAN",
- "Returns a reference to the unique false instance of type BOOLEAN"));
-
+
+ builtInliterals.put("void", new LiteralCommand(VOID_INST,
+ "the unique instance of type VOID",
+ "Returns a reference to the unique instance of type VOID."));
+ builtInliterals.put("true", new LiteralCommand(TRUE_INST,
+ "the unique true value of type BOOLEAN",
+ "Returns a reference to the unique true instance of type BOOLEAN"));
+ builtInliterals.put("false", new LiteralCommand(FALSE_INST,
+ "the unique false value of type BOOLEAN",
+ "Returns a reference to the unique false instance of type BOOLEAN"));
+
builtInliterals.deepFreeze();
-
- // Initialize all of our built-in commands
+
+ // Initialize all of our built-in commands
builtInCommands = new FunctionalMap<>();
-
+
builtInCommands.put("show-bindings", new ShowBindingsCommand());
builtInCommands.put("bind", new BindCommand());
builtInCommands.put("polyhedral-die", new PolyhedralDieCommand());
builtInCommands.put("roll", new RollCommand());
builtInCommands.put("help", new HelpCommand());
+
builtInCommands.deepFreeze();
}
-
+
/**
* Create a new CLI for interacting with dice.
*
- * @param input The place to read input from.
- * @param output The place to read output from.
+ * @param input
+ * The place to read input from.
+ * @param output
+ * The place to read output from.
*/
public DieBoxCLI(Scanner input, PrintStream output) {
- this.input = input;
+ this.input = input;
this.output = output;
-
+
this.commands = builtInCommands.extend();
this.literals = builtInliterals.extend();
}
-
+
/**
* Create a new CLI for interacting with dice.
*
- * @param input The place to read input from.
- * @param output The place to read output from.
+ * @param input
+ * The place to read input from.
+ * @param output
+ * The place to read output from.
*/
public DieBoxCLI(InputStream input, OutputStream output) {
this(new Scanner(input), new PrintStream(output));
@@ -110,45 +133,51 @@ public class DieBoxCLI {
/**
* Main method.
*
- * @param args Currently unused CLI arguments.
+ * @param args
+ * Currently unused CLI arguments.
*/
public static void main(String[] args) {
- Scanner input = new Scanner(System.in);
+ Scanner input = new Scanner(System.in);
PrintStream output = System.out;
-
+
DieBoxCLI box = new DieBoxCLI(input, output);
box.run();
}
- private void run() {
+ private void run() {
if (doPrompt) {
output.println("diebox CLI - enter 'help' for help, 'exit' to exit");
}
-
- if (doPrompt) output.printf("diebox(%d)> ", numStatements);
- while(input.hasNextLine()) {
+
+ if (doPrompt)
+ output.printf("diebox(%d)> ", numStatements);
+ while (input.hasNextLine()) {
String nextLine = input.nextLine().trim();
-
+
numStatements += 1;
-
- if (nextLine.equals("")) continue;
+
+ if (nextLine.equals(""))
+ continue;
// @FIXME Nov 15th, 2020 Ben Culkin :HardcodeExit
// Exit should not be hard-coded like this
- if (nextLine.equals("exit")) break;
-
+ if (nextLine.equals("exit"))
+ break;
+
String[] lineWords = nextLine.split("\\s+");
Iterator<String> wordIter = new ArrayIterator<>(lineWords);
try {
StatementValue val = runStatement(wordIter);
-
- if (doOutput) output.printf("%s%s\n", doPrompt ? "==> " : "", val);
+
+ if (doOutput)
+ output.printf("%s%s\n", doPrompt ? "==> " : "",
+ val);
} catch (DieBoxException dbex) {
output.printf("ERROR (in statement %d): %s\n",
numStatements, dbex.getMessage());
Throwable curEx = dbex.getCause();
while (curEx != null) {
output.printf("...caused by: %s\n", curEx);
-
+
curEx = dbex.getCause();
}
} catch (Exception ex) {
@@ -156,64 +185,90 @@ public class DieBoxCLI {
numStatements, ex.getMessage());
ex.printStackTrace(output);
}
-
- if (doPrompt) output.printf("diebox(%d)> ", numStatements);
+
+ if (doPrompt)
+ output.printf("diebox(%d)> ", numStatements);
}
-
+
input.close();
output.close();
}
+ /**
+ * Extract an instance of {@link StatementValue} from a source of strings.
+ *
+ * @param words The strings to use.
+ *
+ * @return A statement value, parsed from the strings.
+ */
public StatementValue runStatement(Iterator<String> words) {
if (!words.hasNext()) {
return VOID_INST;
}
-
+
String command = words.next().trim();
-
+ DieBoxCLI state = this;
+
if (command.startsWith("$")) {
// All variable refs start with $
String varName = command.substring(1);
-
- if (bindings.containsKey(varName)) {
- return bindings.get(varName);
- } else {
- // @TODO Nov 15th, 2020 Ben Culkin :Autovars
- // Perhaps something along the lines of 'auto-variables' (here
- // called 'spring-loaded variables') should be created? These
- // would be essentially values which invoke a given expression
- // whenever they are referenced.
- throw new DieBoxException("Attempted to reference non-existing variable %s", varName);
- }
+
+ return bindings.get(varName)
+ .orElseThrow(() -> new DieBoxException(
+ "Attempted to reference non-existing variable %s",
+ varName));
+ // @TODO Nov 15th, 2020 Ben Culkin :Autovars
+ // Perhaps something along the lines of 'auto-variables' (here
+ // called 'spring-loaded variables') should be created? These
+ // would be essentially values which invoke a given expression
+ // whenever they are referenced.
} else if (command.startsWith("#")) {
// All literals/literal-formers start with #
String actualCommand = command.substring(1);
-
+
// Attempt to use a mapped literal/literal-former
- Command literalCommand = literals.get(actualCommand);
- if (literalCommand != null) {
- return literalCommand.execute(words, this);
- } else {
- if (INT_PATTERN.matcher(actualCommand).matches()) {
- try {
- int val = Integer.parseInt(actualCommand);
-
- return new IntegerStatementValue(val);
- } catch (NumberFormatException nfex) {
- throw new DieBoxException(nfex, "Improper integer literal (%s)", actualCommand);
- }
- } else {
- throw new DieBoxException("Unknown literal format (%s)", actualCommand);
- }
+ StatementValue val = literals.get(actualCommand)
+ .map((com) -> com.execute(words, state))
+ .orElseGet(() -> parseActualLiteral(actualCommand));
+
+ return val;
+ } else {
+ // Attempt to use a mapped command first
+ StatementValue val = commands.get(command)
+ .map((com) -> com.execute(words, state))
+ .orElseThrow(() -> handleUnknownCommand(command));
+ return val;
+ }
+ }
+
+ private DieBoxException handleUnknownCommand(String command) {
+ StringBuilder msg = new StringBuilder("Unknown command ");
+ msg.append(command);
+ msg.append(".");
+
+ if (INT_PATTERN.matcher(command).matches()) {
+ msg.append("\n...Int literals must start with #, so try #");
+ msg.append(command);
+ msg.append(" instead.");
+ }
+
+ return new DieBoxException(msg.toString());
+ }
+
+ private StatementValue parseActualLiteral(String litText) {
+ if (INT_PATTERN.matcher(litText).matches()) {
+ try {
+ int val = Integer.parseInt(litText);
+
+ return new IntegerStatementValue(val);
+ } catch (NumberFormatException nfex) {
+ throw new DieBoxException(nfex,
+ "Improper integer literal (%s)",
+ litText);
}
} else {
- // Attempt to use a mapped command first
- Command mapCommand = commands.get(command);
- if (mapCommand != null) {
- return mapCommand.execute(words, this);
- } else {
- throw new DieBoxException("Unknown command %s", command);
- }
+ throw new DieBoxException("Unknown literal format (%s)",
+ litText);
}
}
} \ No newline at end of file
diff --git a/dice/src/example/java/bjc/dicelang/neodice/DieBoxException.java b/dice/src/example/java/bjc/dicelang/neodice/DieBoxException.java
index efa3d54..e1de67e 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/DieBoxException.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/DieBoxException.java
@@ -1,28 +1,60 @@
package bjc.dicelang.neodice;
+/**
+ * The exception thrown when something goes wrong with diebox.
+ * @author Ben Culkin
+ *
+ */
public class DieBoxException extends RuntimeException {
private static final long serialVersionUID = 1851356458656622896L;
+ /** Create a new exception */
public DieBoxException() {
super();
}
+ /**
+ * Create a new exception with a given message.
+ *
+ * @param message The message for the exception.
+ */
public DieBoxException(String message) {
super(message);
}
+ /**
+ * Create a new exception with a given formatted message.
+ *
+ * @param format The format string.
+ * @param args The format arguments.
+ */
public DieBoxException(String format, Object... args) {
super(String.format(format, args));
}
+ /**
+ * Create a new diebox exception with a cause.
+ * @param cause The cause of this exception.
+ */
public DieBoxException(Throwable cause) {
super(cause);
}
-
+
+ /**
+ * Create a new diebox exception with a cause and message.
+ * @param cause The cause of this exception.
+ * @param message The message for the exception.
+ */
public DieBoxException(Throwable cause, String message) {
super(message, cause);
}
-
+
+ /**
+ * Create a new diebox exception with a cause and formatted message.
+ * @param cause The cause of this exception.
+ * @param format The format string.
+ * @param args The format arguments.
+ */
public DieBoxException(Throwable cause, String format, Object... args) {
super(String.format(format, args), cause);
}
diff --git a/dice/src/example/java/bjc/dicelang/neodice/commands/BindCommand.java b/dice/src/example/java/bjc/dicelang/neodice/commands/BindCommand.java
index 5091c4b..8664379 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/commands/BindCommand.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/commands/BindCommand.java
@@ -7,6 +7,11 @@ import java.util.*;
import bjc.dicelang.neodice.*;
import bjc.dicelang.neodice.statements.*;
+/**
+ * This command binds a name to a variable slot.
+ * @author Ben Culkin
+ *
+ */
public class BindCommand implements Command {
@Override
public StatementValue execute(Iterator<String> words, DieBoxCLI state) {
diff --git a/dice/src/example/java/bjc/dicelang/neodice/commands/HelpCommand.java b/dice/src/example/java/bjc/dicelang/neodice/commands/HelpCommand.java
index 705745e..c10db4e 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/commands/HelpCommand.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/commands/HelpCommand.java
@@ -7,6 +7,11 @@ import java.util.*;
import bjc.dicelang.neodice.*;
import bjc.dicelang.neodice.statements.*;
+/**
+ * Diebox help command. Unimplemented as of yet.
+ * @author Ben Culkin
+ *
+ */
public class HelpCommand implements Command {
@Override
public StatementValue execute(Iterator<String> words, DieBoxCLI state) {
diff --git a/dice/src/example/java/bjc/dicelang/neodice/commands/LiteralCommand.java b/dice/src/example/java/bjc/dicelang/neodice/commands/LiteralCommand.java
index 9b42b42..b781ae9 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/commands/LiteralCommand.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/commands/LiteralCommand.java
@@ -5,12 +5,28 @@ import java.util.*;
import bjc.dicelang.neodice.*;
import bjc.dicelang.neodice.statements.*;
+/**
+ * A command that produces a literal statement value.
+ *
+ * This command will always produce the same statement value, so passing any sort
+ * of mutable statement value to it is asking to be hurt.
+ *
+ * @author Ben Culkin
+ *
+ */
public class LiteralCommand implements Command {
private final StatementValue value;
private final String shortHelp;
private final String longHelp;
+ /**
+ * Create a new command producing a literal statement value.
+ *
+ * @param value The value this command returns.
+ * @param shortHelp The short-help (summary) for this command.
+ * @param longHelp The long-help (description) for this command.
+ */
public LiteralCommand(StatementValue value, String shortHelp, String longHelp) {
this.value = value;
diff --git a/dice/src/example/java/bjc/dicelang/neodice/commands/PolyhedralDieCommand.java b/dice/src/example/java/bjc/dicelang/neodice/commands/PolyhedralDieCommand.java
index 02fc9cf..e0f66b1 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/commands/PolyhedralDieCommand.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/commands/PolyhedralDieCommand.java
@@ -7,6 +7,12 @@ import java.util.*;
import bjc.dicelang.neodice.*;
import bjc.dicelang.neodice.statements.*;
+/**
+ * A command that produces a polyhedral die.
+ *
+ * @author Ben Culkin
+ *
+ */
public class PolyhedralDieCommand implements Command {
@Override
public StatementValue execute(Iterator<String> words, DieBoxCLI state) {
@@ -20,7 +26,11 @@ public class PolyhedralDieCommand implements Command {
if (numSides < 0) throw new DieBoxException("Number of sides to polyhedral-die was not valid (must be less than 0, was %d)", numSides);
- return new DieStatementValue(DieFactory.polyhedral(numSides));
+ Die<StatementValue> die = Die
+ .polyhedral(numSides)
+ .transform(IntegerStatementValue::new);
+
+ return new DieStatementValue(INTEGER, die);
} else {
throw new DieBoxException("Number of sides to polyhedral-die wasn't an integer (was %s, of type %s)",
sideValue, sideValue.type);
diff --git a/dice/src/example/java/bjc/dicelang/neodice/commands/RollCommand.java b/dice/src/example/java/bjc/dicelang/neodice/commands/RollCommand.java
index eb7b597..cec7c48 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/commands/RollCommand.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/commands/RollCommand.java
@@ -7,6 +7,12 @@ import java.util.*;
import bjc.dicelang.neodice.*;
import bjc.dicelang.neodice.statements.*;
+/**
+ * A command that rolls a die or die-pool.
+ *
+ * @author Ben Culkin
+ *
+ */
public class RollCommand implements Command {
@Override
public StatementValue execute(Iterator<String> words, DieBoxCLI state) {
@@ -18,11 +24,16 @@ public class RollCommand implements Command {
if (toRoll.type == DIE) {
DieStatementValue die = (DieStatementValue) toRoll;
- return new IntegerStatementValue(die.value.roll(state.rng));
+ return die.value.roll(state.rng);
} else if (toRoll.type == DIEPOOL) {
DiePoolStatementValue pool = (DiePoolStatementValue) toRoll;
- return new IntArrayStatementValue(pool.value.roll(state.rng));
+ StatementValue[] values = pool.value
+ .roll(state.rng)
+ .toArray((sz) -> new StatementValue[sz]);
+
+ return new ArrayStatementValue<>(pool.elementType,
+ values);
} else {
throw new DieBoxException("Roll was provided something that wasn't rollable (only DIE and DIEPOOL objects are rollable) (was %s, of type %s)",
toRoll, toRoll.type);
diff --git a/dice/src/example/java/bjc/dicelang/neodice/commands/ShowBindingsCommand.java b/dice/src/example/java/bjc/dicelang/neodice/commands/ShowBindingsCommand.java
index fe2ac89..75811b6 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/commands/ShowBindingsCommand.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/commands/ShowBindingsCommand.java
@@ -7,6 +7,12 @@ import java.util.*;
import bjc.dicelang.neodice.*;
import bjc.dicelang.neodice.statements.*;
+/**
+ * A command that shows all of the currently bound variables.
+ *
+ * @author Ben Culkin
+ *
+ */
public class ShowBindingsCommand implements Command {
@Override
public StatementValue execute(Iterator<String> words, DieBoxCLI state) {
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/ArrayStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/ArrayStatementValue.java
index 66e14ad..1a54ca5 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/ArrayStatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/ArrayStatementValue.java
@@ -4,10 +4,24 @@ import static bjc.dicelang.neodice.statements.StatementValue.Type.*;
import java.util.*;
+/**
+ * A statement value which represents an array of statement values.
+ * @author Ben Culkin
+ *
+ * @param <ElementType> The contained type of value.
+ */
public class ArrayStatementValue<ElementType extends StatementValue> extends StatementValue {
- public final Type elementType;
+ /** The type of the contained values. */
+ public final Type elementType;
+ /** The contained values. */
public final ElementType[] values;
+ /**
+ * Create a new array statement value.
+ *
+ * @param elementType The type of the contained values.
+ * @param values The contained values.
+ */
@SafeVarargs
public ArrayStatementValue(Type elementType, ElementType... values) {
super(ARRAY);
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/BooleanStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/BooleanStatementValue.java
index ba89893..aef912b 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/BooleanStatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/BooleanStatementValue.java
@@ -4,10 +4,17 @@ import static bjc.dicelang.neodice.statements.StatementValue.Type.*;
import java.util.*;
+/**
+ * Represents the boolean type for diebox.
+ * @author Ben Culkin
+ *
+ */
public class BooleanStatementValue extends StatementValue {
private boolean value;
+ /** The true boolean instance. */
public static final BooleanStatementValue TRUE_INST = new BooleanStatementValue(true);
+ /** The false boolean instance. */
public static final BooleanStatementValue FALSE_INST = new BooleanStatementValue(false);
private BooleanStatementValue(boolean value) {
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/DiePoolStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/DiePoolStatementValue.java
index a4a9104..114475c 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/DiePoolStatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/DiePoolStatementValue.java
@@ -6,12 +6,27 @@ import java.util.*;
import bjc.dicelang.neodice.*;
+/**
+ * A StatementValue that represesnts a die pool
+ * @author Ben Culkin
+ *
+ */
public class DiePoolStatementValue extends StatementValue {
- public final DiePool value;
+ /** The type of the contained value. */
+ public final Type elementType;
+ /** The die pool itself. */
+ public final DiePool<StatementValue> value;
- public DiePoolStatementValue(DiePool value) {
+ /**
+ * Create a new diepool value.
+ *
+ * @param elementType The contained type.
+ * @param value The die pool itself.
+ */
+ public DiePoolStatementValue(Type elementType, DiePool<StatementValue> value) {
super(DIEPOOL);
+ this.elementType = elementType;
this.value = value;
}
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/DieStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/DieStatementValue.java
index 55a6856..5662a59 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/DieStatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/DieStatementValue.java
@@ -6,12 +6,27 @@ import java.util.*;
import bjc.dicelang.neodice.*;
+/**
+ * A StatementValue that represents a die.
+ * @author Ben Culkin
+ *
+ */
public class DieStatementValue extends StatementValue {
- public final Die value;
+ /** The type of values this die rolls. */
+ public final Type sideType;
+ /** The die itself. */
+ public final Die<StatementValue> value;
- public DieStatementValue(Die value) {
+ /**
+ * Create a new die StatementValue.
+ *
+ * @param sideType The type of value this die rolls.
+ * @param value The die itself.
+ */
+ public DieStatementValue(Type sideType, Die<StatementValue> value) {
super(DIE);
+ this.sideType = sideType;
this.value = value;
}
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/IntArrayStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/IntArrayStatementValue.java
deleted file mode 100644
index b313d42..0000000
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/IntArrayStatementValue.java
+++ /dev/null
@@ -1,50 +0,0 @@
-package bjc.dicelang.neodice.statements;
-
-import static bjc.dicelang.neodice.statements.StatementValue.Type.*;
-
-import java.util.*;
-
-public class IntArrayStatementValue extends StatementValue {
- public final int[] values;
-
- public IntArrayStatementValue(int... values) {
- super(INT_ARRAY);
-
- this.values = values;
- }
-
- @Override
- public String toString() {
- StringBuilder buffer = new StringBuilder();
-
- buffer.append('(');
- for (int index = 0; index < values.length; index++) {
- int value = values[index];
-
- buffer.append(value);
- if (index < values.length - 1) buffer.append(", ");
- }
- buffer.append(')');
-
- return buffer.toString();
- }
-
- @Override
- public int hashCode() {
- final int prime = 31;
- int result = super.hashCode();
- result = prime * result + Arrays.hashCode(values);
- return result;
- }
-
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (!super.equals(obj)) return false;
- if (getClass() != obj.getClass()) return false;
-
- IntArrayStatementValue other = (IntArrayStatementValue) obj;
-
- return Arrays.equals(values, other.values);
- }
-} \ No newline at end of file
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/IntegerStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/IntegerStatementValue.java
index 91e45b6..88508d2 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/IntegerStatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/IntegerStatementValue.java
@@ -2,9 +2,19 @@ package bjc.dicelang.neodice.statements;
import static bjc.dicelang.neodice.statements.StatementValue.Type.*;
+/**
+ * Statement value that represents an integer.
+ * @author Ben Culkin
+ *
+ */
public class IntegerStatementValue extends StatementValue {
- public final int value;
+ /** The integer value. */
+ public final int value;
+ /**
+ * Create an integer statement value.
+ * @param value The int to use as the value.
+ */
public IntegerStatementValue(int value) {
super(INTEGER);
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/StatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/StatementValue.java
index 5090bc7..d804a10 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/StatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/StatementValue.java
@@ -2,22 +2,41 @@ package bjc.dicelang.neodice.statements;
import java.util.*;
+/**
+ * Represents a value for diebox, as a base class.
+ * @author Ben Culkin
+ *
+ */
public abstract class StatementValue {
+ /**
+ * The type of the value.
+ * @author Ben Culkin
+ *
+ */
public static enum Type {
+ /** The 'void' value. There is only one value of this type. */
VOID,
+ /** The 'boolean' type. There is one true value, and one false value. */
BOOLEAN,
+ /** Represents an integer. */
INTEGER,
- INT_ARRAY,
-
+ /** Represents a single die. */
DIE,
+ /** Represents a pool of dice. */
DIEPOOL,
+ /** Represents an array of some type. */
ARRAY,
}
+ /** The type of this value. */
public final Type type;
+ /**
+ * Create a new statement value.
+ * @param type The type of the value.
+ */
protected StatementValue(Type type) {
this.type = type;
}
diff --git a/dice/src/example/java/bjc/dicelang/neodice/statements/VoidStatementValue.java b/dice/src/example/java/bjc/dicelang/neodice/statements/VoidStatementValue.java
index 7e437e7..a71d49c 100644
--- a/dice/src/example/java/bjc/dicelang/neodice/statements/VoidStatementValue.java
+++ b/dice/src/example/java/bjc/dicelang/neodice/statements/VoidStatementValue.java
@@ -3,11 +3,13 @@ package bjc.dicelang.neodice.statements;
import static bjc.dicelang.neodice.statements.StatementValue.Type.*;
/**
+ * The statement value of the null type.
* @author Ben Culkin
*
*/
public class VoidStatementValue extends StatementValue {
- public static final VoidStatementValue VOID_INST = new VoidStatementValue();
+ /** The singular instance of the null value. */
+ public static final VoidStatementValue VOID_INST = new VoidStatementValue();
private VoidStatementValue() {
super(VOID);
diff --git a/dice/src/main/java/bjc/dicelang/neodice/Die.java b/dice/src/main/java/bjc/dicelang/neodice/Die.java
index a986ca2..56e4327 100644
--- a/dice/src/main/java/bjc/dicelang/neodice/Die.java
+++ b/dice/src/main/java/bjc/dicelang/neodice/Die.java
@@ -9,10 +9,12 @@ import bjc.esodata.*;
/**
* Represents a single polyhedral die.
* @author Ben Culkin
+ *
+ * @param <SideType> The type of value represented by this die.
*
*/
@FunctionalInterface
-public interface Die {
+public interface Die<SideType> {
/**
* Rolls this die.
*
@@ -20,7 +22,7 @@ public interface Die {
*
* @return The result of rolling the die.
*/
- public int roll(Random rng);
+ public SideType roll(Random rng);
/**
* Returns a die pool which rolls this die the specified number of times.
@@ -29,143 +31,202 @@ public interface Die {
*
* @return A die pool that rolls this die the specified number of times.
*/
- default DiePool times(int numTimes) {
- return new TimesDiePool(this, numTimes);
+ default DiePool<SideType> times(int numTimes) {
+ return new ExpandDiePool<>(this, (die, rng) -> {
+ return Stream.generate(() -> die.roll(rng))
+ .limit(numTimes);
+ });
};
/**
* Returns a die which will reroll this die as long as the provided condition is true.
*
+ * @param comparer The thing to use to compare die values.
* @param condition The condition to reroll the die on.
*
* @return A die that rerolls when the given condition is met.
*/
- default Die reroll(IntPredicate condition) {
- return new RerollDie(this, condition, (lst) -> lst.get(lst.size()));
+ default Die<SideType> reroll(
+ Comparator<SideType> comparer,
+ Predicate<SideType> condition) {
+ return RerollDie.create(comparer, this, condition,
+ (list) -> list.get(list.size()));
}
/**
* Returns a die which will reroll this die up to a specified number of times,
* as long as the provided condition is true.
*
+ * @param comparer The thing to use to compare die values.
* @param condition The condition to reroll the die on.
* @param limit The maximum number of times to reroll the die.
*
* @return A die that rerolls when the given condition is met.
*/
- default Die reroll(IntPredicate condition, int limit) {
- return new RerollDie(this, condition, (lst) -> lst.get(lst.size()), limit);
+ default Die<SideType> reroll(
+ Comparator<SideType> comparer,
+ Predicate<SideType> condition,
+ int limit) {
+ return RerollDie.create(comparer, this, condition,
+ (list) -> list.get(list.size()), limit);
}
/**
- * Create an iterator which gives rolls of this dice.
+ * Create an stream which gives rolls of this dice.
*
* @param rng The source for random numbers.
*
* @return An iterator which gives rolls of this dice.
*/
- default Iterator<Integer> iterator(Random rng) {
- return IntStream.generate(() -> this.roll(rng)).iterator();
+ default Stream<SideType> stream(Random rng) {
+ return Stream.generate(() -> this.roll(rng));
+ }
+
+ /**
+ * Create a new transforming die.
+ *
+ * @param <NewType> The new type of the die.
+ *
+ * @param mapper The function to use for mapping.
+ *
+ * @return A die that transforms with the given mapping.
+ */
+ default <NewType> Die<NewType> transform(Function<SideType, NewType> mapper) {
+ return (rng) -> mapper.apply(this.roll(rng));
+ }
+
+ /**
+ * Create a simple polyhedral die with a fixed number of sides.
+ *
+ * @param sides The number of sides for the die.
+ *
+ * @return A die which returns a result from 1 to sides.
+ */
+ static Die<Integer> polyhedral(int sides) {
+ return new PolyhedralDie(sides);
}
}
-final class TimesDiePool implements DiePool {
- private final Die contained;
- private final int numDice;
+class PolyhedralDie implements Die<Integer> {
+ private final int sides;
- public TimesDiePool(Die contained, int numDice) {
- this.contained = contained;
- this.numDice = numDice;
- }
+ public PolyhedralDie(int sides) {
+ this.sides = sides;
+ }
- @Override
- public int[] roll(Random rng) {
- int[] results = new int[numDice];
-
- for (int index = 0; index < numDice; index++) {
- results[index] = contained.roll(rng);
- }
-
- return results;
- }
-
- @Override
- public Die[] contained() {
- Die[] results = new Die[numDice];
-
- for (int index = 0; index < numDice; index++) {
- results[index] = contained;
- }
-
- return results;
- }
+ @Override
+ public Integer roll(Random rng) {
+ // Dice are one-based, not zero-based.
+ return rng.nextInt(sides) + 1;
+ }
- @Override
- public String toString() {
- return String.format("%d%s", numDice, contained);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(contained, numDice);
- }
+ @Override
+ public String toString() {
+ return String.format("d%d", sides);
+ }
+
+ @Override
+ public int hashCode() {
+ final int prime = 31;
+ int result = 1;
+ result = prime * result + sides;
+ return result;
+ }
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- TimesDiePool other = (TimesDiePool) obj;
-
- return Objects.equals(contained, other.contained) && numDice == other.numDice;
- }
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj) return true;
+ if (obj == null) return false;
+ if (getClass() != obj.getClass()) return false;
+
+ PolyhedralDie other = (PolyhedralDie) obj;
+
+ if (sides != other.sides) return false;
+ else return true;
+ }
}
-final class RerollDie implements Die {
- private final Die contained;
-
- private final IntPredicate condition;
- private final Function<MinMaxList<Integer>, Integer> chooser;
-
- private int limit = Integer.MAX_VALUE;
-
-
- public RerollDie(Die contained, IntPredicate condition,
- Function<MinMaxList<Integer>, Integer> chooser) {
- this.contained = contained;
-
- this.condition = condition;
- this.chooser = chooser;
- }
-
- public RerollDie(Die contained, IntPredicate condition,
- Function<MinMaxList<Integer>, Integer> chooser, int limit) {
- this.contained = contained;
-
- this.condition = condition;
- this.chooser = chooser;
-
- this.limit = limit;
- }
-
- @Override
- public int roll(Random rng) {
- int roll = contained.roll(rng);
-
- MinMaxList<Integer> newRolls = new MinMaxList<Integer>(
- Comparator.naturalOrder(), roll);
-
- int rerollCount = 0;
- while (condition.test(roll) && rerollCount < limit) {
- roll = contained.roll(rng);
- newRolls.add(roll);
-
- rerollCount += 1;
- }
-
- return chooser.apply(newRolls);
- }
+class RerollDie<SideType> implements Die<SideType> {
+ private final Die<SideType> contained;
+
+ private final Predicate<SideType> condition;
+ private final Function<MinMaxList<SideType>, SideType> chooser;
+
+ private final Comparator<SideType> comparer;
+
+ private int limit = Integer.MAX_VALUE;
+
+ private RerollDie(
+ Comparator<SideType> comparer,
+ Die<SideType> contained,
+ Predicate<SideType> condition,
+ Function<MinMaxList<SideType>, SideType> chooser) {
+ this.comparer = comparer;
+
+ this.contained = contained;
+
+ this.condition = condition;
+ this.chooser = chooser;
+ }
+
+ private RerollDie(
+ Comparator<SideType> comparer,
+ Die<SideType> contained,
+ Predicate<SideType> condition,
+ Function<MinMaxList<SideType>, SideType> chooser,
+ int limit) {
+ this(comparer, contained, condition, chooser);
+
+ this.limit = limit;
+ }
+
+ @Override
+ public SideType roll(Random rng) {
+ SideType roll = contained.roll(rng);
+
+ MinMaxList<SideType> newRolls = new MinMaxList<>(comparer, roll);
+
+ int rerollCount = 0;
+ while (condition.test(roll) && rerollCount < limit) {
+ roll = contained.roll(rng);
+ newRolls.add(roll);
+
+ rerollCount += 1;
+ }
+
+ return chooser.apply(newRolls);
+ }
+
+ public static <Side extends Comparable<Side>> Die<Side> create(
+ Die<Side> contained,
+ Predicate<Side> condition,
+ Function<MinMaxList<Side>, Side> chooser) {
+ return new RerollDie<>(Comparator.naturalOrder(), contained, condition, chooser);
+ }
+
+ public static <Side extends Comparable<Side>> Die<Side> create(
+ Die<Side> contained,
+ Predicate<Side> condition,
+ Function<MinMaxList<Side>, Side> chooser,
+ int limit) {
+ return new RerollDie<>(Comparator.naturalOrder(), contained, condition, chooser, limit);
+ }
+
- // No toString, because IntPredicate can't be converted to a string
+ public static <Side> Die<Side> create(
+ Comparator<Side> comparer,
+ Die<Side> contained,
+ Predicate<Side> condition,
+ Function<MinMaxList<Side>, Side> chooser) {
+ return new RerollDie<>(comparer, contained, condition, chooser);
+ }
+
+ public static <Side> Die<Side> create(
+ Comparator<Side> comparer,
+ Die<Side> contained,
+ Predicate<Side> condition,
+ Function<MinMaxList<Side>, Side> chooser,
+ int limit) {
+ return new RerollDie<>(comparer, contained, condition, chooser, limit);
+ }
} \ No newline at end of file
diff --git a/dice/src/main/java/bjc/dicelang/neodice/DieFactory.java b/dice/src/main/java/bjc/dicelang/neodice/DieFactory.java
deleted file mode 100644
index d9bae7e..0000000
--- a/dice/src/main/java/bjc/dicelang/neodice/DieFactory.java
+++ /dev/null
@@ -1,63 +0,0 @@
-package bjc.dicelang.neodice;
-
-import java.util.*;
-
-/**
- * Various static functions which create instances of Die.
- *
- * @author Ben Culkin
- *
- */
-public class DieFactory {
- /**
- * Create a simple polyhedral die with a fixed number of sides.
- *
- * @param sides The number of sides for the die.
- *
- * @return A die which returns a result from 1 to sides.
- */
- public static Die polyhedral(int sides) {
- return new PolyhedralDie(sides);
- }
-}
-
-final class PolyhedralDie implements Die {
- private final int sides;
-
- public PolyhedralDie(int sides) {
- this.sides = sides;
- }
-
- @Override
- public int roll(Random rng) {
- // Dice are one-based, not zero-based.
- return rng.nextInt(sides) + 1;
- }
-
- @Override
- public String toString() {
- return String.format("d%d", sides);
- }
-
- @Override
- public int hashCode() {
- final int prime = 31;
- int result = 1;
- result = prime * result + sides;
- return result;
- }
-
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- PolyhedralDie other = (PolyhedralDie) obj;
-
- if (sides != other.sides) return false;
- else return true;
- }
-
-
-} \ No newline at end of file
diff --git a/dice/src/main/java/bjc/dicelang/neodice/DiePool.java b/dice/src/main/java/bjc/dicelang/neodice/DiePool.java
index 70dfa50..16bec48 100644
--- a/dice/src/main/java/bjc/dicelang/neodice/DiePool.java
+++ b/dice/src/main/java/bjc/dicelang/neodice/DiePool.java
@@ -2,38 +2,40 @@ package bjc.dicelang.neodice;
import java.util.*;
import java.util.function.*;
+import java.util.stream.*;
/**
* Represents a pool of dice.
*
* @author Ben Culkin
- *
+ *
+ * @param <SideType> The type of the sides of the contained dice.
*/
@FunctionalInterface
-public interface DiePool {
+public interface DiePool<SideType> {
/**
* Roll each die in the pool, and return the results.
*
- * Note that this array is not guaranteed to be the same size every time it
+ * Note that this list is not guaranteed to be the same size every time it
* is rolled, because there are some pool types that could add/remove dice.
*
* @param rng The source for random numbers
*
* @return The result of rolling each die in the pool.
*/
- public int[] roll(Random rng);
+ public Stream<SideType> roll(Random rng);
/**
* Gets the dice contained in this pool.
*
- * Note that the length of this array may not be the same as the length of
- * the array returned by roll, because certain pool types may add additional
+ * Note that the length of this list may not be the same as the length of
+ * the list returned by roll, because certain pool types may add additional
* dice.
*
- * Also note that this array (and the Die instances contained in it) should
+ * Also note that this list (and the Die instances contained in it) should
* not be modified. That may work for certain pool types, but it isn't
* guaranteed to work, and can lead to unintuitive behavior. For instances,
- * certain pool types may return an array where multiple elements of it refer
+ * certain pool types may return an list where multiple elements of it refer
* to the same Die instance.
*
* The default implementation throws an UnsupportedOperationException.
@@ -42,7 +44,7 @@ public interface DiePool {
*
* @throws UnsupportedOperationException If the composite dice can't be retrieved.
*/
- default Die[] contained() {
+ default List<Die<SideType>> contained() {
throw new UnsupportedOperationException("Can't get composite dice");
}
@@ -54,16 +56,19 @@ public interface DiePool {
* Returns a version of this die pool which returns its results in sorted
* order.
*
- * At the moment, sorting in descending order is somewhat less efficent than
- * sorting in ascending order, because Java doesn't provide a built-in
- * descending sort for primitive arrays.
- *
+ * @param comparer The comparator to use for the dice.
* @param isDescending True to sort in descending order, false to sort in ascending order.
*
* @return The die pool, which returns its results in sorted order.
*/
- default DiePool sorted(boolean isDescending) {
- return new SortedDiePool(this, isDescending);
+ default DiePool<SideType> sorted(
+ Comparator<SideType> comparer,
+ boolean isDescending) {
+ return new TransformDiePool<>(this,
+ (pool) -> pool.sorted(
+ isDescending
+ ? comparer.reversed()
+ : comparer));
}
/**
@@ -74,8 +79,9 @@ public interface DiePool {
*
* @return A die pool which contains only entries that pass the predicate.
*/
- default DiePool filtered(IntPredicate matcher) {
- return new FilteredDiePool(this, matcher);
+ default DiePool<SideType> filtered(Predicate<SideType> matcher) {
+ return new TransformDiePool<>(this,
+ (pool) -> pool.filter(matcher));
}
/**
@@ -85,8 +91,9 @@ public interface DiePool {
*
* @return A die pool which has the first entries dropped.
*/
- default DiePool dropFirst(int number) {
- return new DropFirstPool(this, number);
+ default DiePool<SideType> dropFirst(int number) {
+ return new TransformDiePool<>(this,
+ (pool) -> pool.skip(number));
}
/**
@@ -96,8 +103,16 @@ public interface DiePool {
*
* @return A die pool which has the last entries dropped.
*/
- default DiePool dropLast(int number) {
- return new DropLastPool(this, number);
+ default DiePool<SideType> dropLast(int number) {
+ return new TransformDiePool<>(this, (pool) -> {
+ Deque<SideType> temp = new ArrayDeque<>();
+
+ pool.forEachOrdered((die) -> temp.add(die));
+
+ for (int i = 0; i < number; i++) temp.pollLast();
+
+ return temp.stream();
+ });
}
/**
@@ -107,8 +122,9 @@ public interface DiePool {
*
* @return A die pool which has the first entries kept.
*/
- default DiePool keepFirst(int number) {
- return new KeepFirstDiePool(this, number);
+ default DiePool<SideType> keepFirst(int number) {
+ return new TransformDiePool<>(this,
+ (pool) -> pool.limit(number));
}
/**
@@ -118,8 +134,16 @@ public interface DiePool {
*
* @return A die pool which has the last entries kept.
*/
- default DiePool keepLast(int number) {
- return new KeepLastDiePool(this, number);
+ default DiePool<SideType> keepLast(int number) {
+ return new TransformDiePool<>(this, (pool) -> {
+ Deque<SideType> temp = new ArrayDeque<>();
+
+ pool.forEachOrdered((die) -> temp.add(die));
+
+ while (temp.size() > number) temp.pollFirst();
+
+ return temp.stream();
+ });
}
/*
@@ -130,45 +154,49 @@ public interface DiePool {
/**
* Return a die pool which rolls this one, then drops a number of the lowest values.
*
+ * @param comparer The comparer to use for the sides.
* @param number The number of lowest values to drop.
*
* @return A die pool which has the lowest entries dropped.
*/
- default DiePool dropLowest(int number) {
- return this.sorted(false).dropFirst(number);
+ default DiePool<SideType> dropLowest(Comparator<SideType> comparer, int number) {
+ return this.sorted(comparer, false).dropFirst(number);
}
/**
* Return a die pool which rolls this one, then drops a number of the lowest values.
*
+ * @param comparer The comparer to use for the sides.
* @param number The number of lowest values to drop.
*
* @return A die pool which has the lowest entries dropped.
*/
- default DiePool dropHighest(int number) {
- return this.sorted(false).dropLast(number);
+ default DiePool<SideType> dropHighest(Comparator<SideType> comparer,int number) {
+ return this.sorted(comparer, false).dropLast(number);
}
/**
* Return a die pool which rolls this one, then keeps a number of the lowest values.
*
+ * @param comparer The comparer to use for the sides.
* @param number The number of lowest values to keep.
*
* @return A die pool which has the lowest entries kept.
*/
- default DiePool keepLowest(int number) {
- return this.sorted(false).keepFirst(number);
+ default DiePool<SideType> keepLowest(Comparator<SideType> comparer,int number) {
+ return this.sorted(comparer, false).keepFirst(number);
}
/**
* Return a die pool which rolls this one, then keeps a number of the highest values.
*
+ * @param comparer The comparer to use for the sides.
* @param number The number of highest values to keep.
*
* @return A die pool which has the highest entries kept.
*/
- default DiePool keepHighest(int number) {
- return this.sorted(false).keepLast(number);
+ default DiePool<SideType> keepHighest(Comparator<SideType> comparer,int number) {
+ return this.sorted(comparer, false).keepLast(number);
}
/* These are misc. operations that don't form new dice pools. */
@@ -180,318 +208,230 @@ public interface DiePool {
*
* @return An iterator over a single roll of this die pool.
*/
- default Iterator<Integer> iterator(Random rng) {
- return Arrays.stream(this.roll(rng)).iterator();
- }
-}
-
-final class SortedDiePool implements DiePool {
- private final boolean isDescending;
- private final DiePool pool;
-
- public SortedDiePool(DiePool pool, boolean isDescending) {
- this.pool = pool;
- this.isDescending = isDescending;
+ default Iterator<SideType> iterator(Random rng) {
+ return this.roll(rng).iterator();
}
- @Override
- public int[] roll(Random rng) {
- int[] rolls = pool.roll(rng);
-
- Arrays.sort(rolls);
-
- if (isDescending) {
- int[] newRolls = new int[rolls.length];
-
- int newIndex = newRolls.length;
- for (int index = 0; index < rolls.length; index++) {
- newRolls[newIndex--] = rolls[index];
- }
-
- return newRolls;
- } else {
- return rolls;
- }
+ /**
+ * Create a die pool containing the provided dice.
+ *
+ * @param <Side> The type of the sides.
+ *
+ * @param dice The dice to put into the pool.
+ *
+ * @return A pool which contains the provided dice.
+ */
+ @SafeVarargs
+ static <Side> DiePool<Side> containing(Die<Side>... dice) {
+ return new FixedDiePool<>(dice);
}
- @Override
- public Die[] contained() {
- return pool.contained();
+ /**
+ * Create an expanding die pool
+ *
+ * @param <Side> The type of the sides.
+ *
+ * @param contained The contained die.
+ * @param expander The expanding function.
+ *
+ * @return A die pool that expands the result given the provided function.
+ */
+ static <Side> DiePool<Side> expanding(Die<Side> contained,
+ BiFunction<Die<Side>, Random, Stream<Side>> expander)
+ {
+ return new ExpandDiePool<>(contained, expander);
}
+}
- @Override
- public String toString() {
- return String.format("%s (sorted %s)", pool,
- isDescending ? " descending" : "ascending");
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(isDescending, pool);
- }
+/**
+ * A die pool that can expand dice.
+ * @author Ben Culkin
+ *
+ * @param <SideType> The type the die uses.
+ */
+class ExpandDiePool<SideType> implements DiePool<SideType> {
+ private final Die<SideType> contained;
+
+ private final BiFunction<Die<SideType>, Random, Stream<SideType>> expander;
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- SortedDiePool other = (SortedDiePool) obj;
-
- return isDescending == other.isDescending
- && Objects.equals(pool, other.pool);
- }
+ /**
+ * Create a new expanding die pool.
+ *
+ * @param contained The die to expand.
+ * @param expander The function to use for expanding.
+ */
+ public ExpandDiePool(Die<SideType> contained,
+ BiFunction<Die<SideType>, Random, Stream<SideType>> expander) {
+ this.contained = contained;
+ this.expander = expander;
+ }
+
+ @Override
+ public Stream<SideType> roll(Random rng) {
+ return expander.apply(contained, rng);
+ }
+
+ @Override
+ public List<Die<SideType>> contained()
+ {
+ return Arrays.asList(contained);
+ }
}
-final class FilteredDiePool implements DiePool {
- private final DiePool pool;
- private final IntPredicate filter;
-
- public FilteredDiePool(DiePool pool, IntPredicate filter) {
- this.pool = pool;
- this.filter = filter;
- }
-
- @Override
- public int[] roll(Random rng) {
- int[] rolls = pool.roll(rng);
-
- return Arrays.stream(rolls).filter(filter).toArray();
- }
+/**
+ * A die pool that has a fixed size.
+ *
+ * @author Ben Culkin
+ *
+ * @param <SideType> The type of the sides of the dice.
+ */
+class FixedDiePool<SideType> implements DiePool<SideType> {
+ private final List<Die<SideType>> dice;
- @Override
- public Die[] contained() {
- return pool.contained();
- }
-
- // No toString, since there isn't any sensible to output the filter
-
- @Override
- public int hashCode() {
- return Objects.hash(filter, pool);
- }
+ /**
+ * Create a new fixed dice pool.
+ * @param dice The dice to put into the pool.
+ */
+ public FixedDiePool(List<Die<SideType>> dice) {
+ this.dice = dice;
+ }
+
+ /**
+ * Create a new fixed dice pool from an array of dice.
+ * @param dice The dice to put into the pool.
+ */
+ @SafeVarargs
+ public FixedDiePool(Die<SideType>...dice) {
+ this.dice = new ArrayList<>(dice.length);
+ for (Die<SideType> die : dice) {
+ this.dice.add(die);
+ }
+ }
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- FilteredDiePool other = (FilteredDiePool) obj;
-
- return Objects.equals(filter, other.filter)
- && Objects.equals(pool, other.pool);
- }
-}
+ @Override
+ public Stream<SideType> roll(Random rng) {
+ return dice.stream().map((die) -> die.roll(rng));
+ }
-final class DropFirstPool implements DiePool {
- private final int number;
- private final DiePool pool;
-
- public DropFirstPool(DiePool pool, int number) {
- this.pool = pool;
- this.number = number;
- }
+ @Override
+ public List<Die<SideType>> contained() {
+ return dice;
+ }
- @Override
- public int[] roll(Random rng) {
- int[] rolls = pool.roll(rng);
-
- if (number >= rolls.length) {
- return new int[0];
- } else {
- int[] newRolls = new int[rolls.length - number];
-
- for (int index = number - 1; index < rolls.length; index++) {
- newRolls[index - number] = rolls[index];
- }
-
- return newRolls;
- }
- }
-
- @Override
- public Die[] contained() {
- return pool.contained();
- }
+
+ @Override
+ public String toString() {
+ return dice.stream()
+ .map(Die<SideType>::toString)
+ .collect(Collectors.joining(", "));
+ }
- @Override
- public String toString() {
- return String.format("%sdF%d", pool, number);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(number, pool);
- }
+ @Override
+ public int hashCode() {
+ return Objects.hash(dice);
+ }
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- DropFirstPool other = (DropFirstPool) obj;
-
- return number == other.number && Objects.equals(pool, other.pool);
- }
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj) return true;
+ if (obj == null) return false;
+ if (getClass() != obj.getClass()) return false;
+
+ FixedDiePool<?> other = (FixedDiePool<?>) obj;
+
+ return Objects.equals(dice, other.dice);
+ }
}
-final class DropLastPool implements DiePool {
- private final int number;
- private final DiePool pool;
-
- public DropLastPool(DiePool pool, int number) {
- this.pool = pool;
- this.number = number;
- }
+class TimesDiePool<SideType> implements DiePool<SideType> {
+ private final Die<SideType> contained;
+ private final int numDice;
- @Override
- public int[] roll(Random rng) {
- int[] rolls = pool.roll(rng);
-
- if (number >= rolls.length) {
- return new int[0];
- } else {
- int[] newRolls = new int[rolls.length - number];
-
- for (int index = 0; index < rolls.length - number; index++) {
- newRolls[index] = rolls[index];
- }
-
- return newRolls;
- }
- }
-
- @Override
- public Die[] contained() {
- return pool.contained();
- }
+ public TimesDiePool(Die<SideType> contained, int numDice) {
+ this.contained = contained;
+ this.numDice = numDice;
+ }
- @Override
- public String toString() {
- return String.format("%sdL%d", pool, number);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(number, pool);
- }
+ @Override
+ public Stream<SideType> roll(Random rng) {
+ return Stream.generate(() -> contained.roll(rng))
+ .limit(numDice);
+ }
+
+ @Override
+ public List<Die<SideType>> contained() {
+ List<Die<SideType>> results = new ArrayList<>(numDice);
+
+ for (int index = 0; index < numDice; index++) {
+ results.add(contained);
+ }
+
+ return results;
+ }
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- DropLastPool other = (DropLastPool) obj;
-
- return number == other.number && Objects.equals(pool, other.pool);
- }
-}
+ @Override
+ public String toString() {
+ return String.format("%d%s", numDice, contained);
+ }
+
+ @Override
+ public int hashCode() {
+ return Objects.hash(contained, numDice);
+ }
-final class KeepFirstDiePool implements DiePool {
- private final int number;
- private final DiePool pool;
-
- public KeepFirstDiePool(DiePool pool, int number) {
- this.pool = pool;
- this.number = number;
- }
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj) return true;
+ if (obj == null) return false;
+ if (getClass() != obj.getClass()) return false;
+
+ TimesDiePool<?> other = (TimesDiePool<?>) obj;
+
+ return Objects.equals(contained, other.contained) && numDice == other.numDice;
+ }
+}
- @Override
- public int[] roll(Random rng) {
- int[] rolls = pool.roll(rng);
-
- if (rolls.length >= number) {
- return rolls;
- } else {
- int[] newRolls = new int[number];
-
- for (int index = 0; index < number; index++) {
- newRolls[index] = rolls[index];
- }
-
- return newRolls;
- }
- }
-
- @Override
- public Die[] contained() {
- return pool.contained();
- }
-
- @Override
- public String toString() {
- return String.format("%skF%d", pool, number);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(number, pool);
- }
+class TransformDiePool<SideType> implements DiePool<SideType> {
+ private final DiePool<SideType> contained;
+
+ private UnaryOperator<Stream<SideType>> transform;
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- KeepFirstDiePool other = (KeepFirstDiePool) obj;
-
- return number == other.number && Objects.equals(pool, other.pool);
- }
-}
+ public TransformDiePool(DiePool<SideType> contained,
+ UnaryOperator<Stream<SideType>> transform) {
+ super();
+ this.contained = contained;
+ this.transform = transform;
+ }
-final class KeepLastDiePool implements DiePool {
- private final int number;
- private final DiePool pool;
-
- public KeepLastDiePool(DiePool pool, int number) {
- this.pool = pool;
- this.number = number;
- }
+ @Override
+ public Stream<SideType> roll(Random rng) {
+ return transform.apply(contained.roll(rng));
+ }
+
+ @Override
+ public List<Die<SideType>> contained() {
+ return contained.contained();
+ }
- @Override
- public int[] roll(Random rng) {
- int[] rolls = pool.roll(rng);
-
- if (rolls.length >= number) {
- return rolls;
- } else {
- int[] newRolls = new int[number];
-
- for (int index = number; index > index; index--) {
- newRolls[index] = rolls[rolls.length - index];
- }
-
- return newRolls;
- }
- }
-
- @Override
- public Die[] contained() {
- return pool.contained();
- }
-
- @Override
- public String toString() {
- return String.format("%skL%d", pool, number);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(number, pool);
- }
+ @Override
+ public int hashCode() {
+ return Objects.hash(contained, transform);
+ }
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- KeepLastDiePool other = (KeepLastDiePool) obj;
-
- return number == other.number && Objects.equals(pool, other.pool);
- }
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj) return true;
+ if (obj == null) return false;
+ if (getClass() != obj.getClass()) return false;
+
+ TransformDiePool<?> other = (TransformDiePool<?>) obj;
+
+ return Objects.equals(contained, other.contained)
+ && Objects.equals(transform, other.transform);
+ }
+
+ @Override
+ public String toString() {
+ return contained.toString() + "(transformed)";
+ }
} \ No newline at end of file
diff --git a/dice/src/main/java/bjc/dicelang/neodice/DiePoolFactory.java b/dice/src/main/java/bjc/dicelang/neodice/DiePoolFactory.java
deleted file mode 100644
index 6d9314d..0000000
--- a/dice/src/main/java/bjc/dicelang/neodice/DiePoolFactory.java
+++ /dev/null
@@ -1,82 +0,0 @@
-package bjc.dicelang.neodice;
-
-import java.util.*;
-
-/**
- * Various static functions which create instances of DiePool.
- *
- * @author Ben Culkin
- *
- */
-public class DiePoolFactory {
- /**
- * Create a die pool containing the provided dice.
- *
- * @param dice The dice to put into the pool.
- *
- * @return A pool which contains the provided dice.
- */
- public static DiePool containing(Die... dice) {
- return new FixedDiePool(dice);
- }
-}
-
-final class FixedDiePool implements DiePool {
- private final Die[] dice;
-
- public FixedDiePool(Die[] dice) {
- this.dice = dice;
- }
-
- @Override
- public int[] roll(Random rng) {
- int[] results = new int[dice.length];
-
- for (int index = 0; index < dice.length; index++) {
- results[index] = dice[index].roll(rng);
- }
-
- return results;
- }
-
- @Override
- public Die[] contained() {
- return dice;
- }
-
-
- @Override
- public String toString() {
- StringBuilder builder = new StringBuilder();
-
- for (int i = 0; i < dice.length; i++) {
- Die die = dice[i];
-
- builder.append(die);
-
- // Don't add an extra trailing comma
- if (i < dice.length - 1) builder.append(", ");
- }
-
- return builder.toString();
- }
-
- @Override
- public int hashCode() {
- final int prime = 31;
- int result = 1;
- result = prime * result + Arrays.hashCode(dice);
- return result;
- }
-
- @Override
- public boolean equals(Object obj) {
- if (this == obj) return true;
- if (obj == null) return false;
- if (getClass() != obj.getClass()) return false;
-
- FixedDiePool other = (FixedDiePool) obj;
-
- return Arrays.equals(dice, other.dice);
- }
-} \ No newline at end of file
diff --git a/dice/src/test/java/bjc/dicelang/neodice/DieBoxCLITest.java b/dice/src/test/java/bjc/dicelang/neodice/DieBoxCLITest.java
index 678194b..fd4cc07 100644
--- a/dice/src/test/java/bjc/dicelang/neodice/DieBoxCLITest.java
+++ b/dice/src/test/java/bjc/dicelang/neodice/DieBoxCLITest.java
@@ -1,14 +1,12 @@
package bjc.dicelang.neodice;
-import static org.junit.Assert.*;
-
import java.io.*;
import org.junit.*;
@SuppressWarnings("javadoc")
public class DieBoxCLITest {
- private DieBoxCLI diebox;
+ //private DieBoxCLI diebox;
private OutputStream dieBoxInput;
private InputStream dieBoxOutput;
@@ -21,7 +19,7 @@ public class DieBoxCLITest {
PipedOutputStream pipeOutput = new PipedOutputStream();
dieBoxOutput = new PipedInputStream(pipeOutput);
- diebox = new DieBoxCLI(pipeInput, pipeOutput);
+ //diebox = new DieBoxCLI(pipeInput, pipeOutput);
}
@After
diff --git a/dice/src/test/java/bjc/dicelang/neodice/DiePoolTest.java b/dice/src/test/java/bjc/dicelang/neodice/DiePoolTest.java
index 1a217d3..be667f5 100644
--- a/dice/src/test/java/bjc/dicelang/neodice/DiePoolTest.java
+++ b/dice/src/test/java/bjc/dicelang/neodice/DiePoolTest.java
@@ -1,33 +1,6 @@
package bjc.dicelang.neodice;
-import static org.junit.Assert.*;
-
-import java.util.*;
-
-import org.junit.*;
-
@SuppressWarnings("javadoc")
-public class DiePoolTest {
- private static final Random rng = new Random();
-
- @Test
- public void containedOneDieYieldsOneDie() {
- Die oneSidedDie = DieFactory.polyhedral(1);
- DiePool pool = DiePoolFactory.containing(oneSidedDie);
-
- assertArrayEquals(
- "A contained pool created with one die, yields that die",
- new Die[] {oneSidedDie}, pool.contained());
- }
-
- @Test
- public void containedOneDieRollsOneDie() {
- Die oneSidedDie = DieFactory.polyhedral(1);
- DiePool pool = DiePoolFactory.containing(oneSidedDie);
-
- for (int i = 0; i < 10; i++) {
- assertArrayEquals("One-die pools roll one die",
- new int[] {1}, pool.roll(rng));
- }
- }
+public class DiePoolTest {
+ // Some tests, I suppose
}
diff --git a/dice/src/test/java/bjc/dicelang/neodice/DieTest.java b/dice/src/test/java/bjc/dicelang/neodice/DieTest.java
index 60f2ae2..66aaaca 100644
--- a/dice/src/test/java/bjc/dicelang/neodice/DieTest.java
+++ b/dice/src/test/java/bjc/dicelang/neodice/DieTest.java
@@ -1,46 +1,6 @@
package bjc.dicelang.neodice;
-import static org.junit.Assert.*;
-
-import java.util.*;
-
-import org.junit.*;
-
@SuppressWarnings("javadoc")
public class DieTest {
- private final static Random rng = new Random();
-
- @Test
- public void onesidedDiceReturnOne() {
- Die die = DieFactory.polyhedral(1);
-
- for (int i = 0; i < 10; i++) {
- assertEquals("One-sided dice always return 1", 1, die.roll(rng));
- }
- }
-
- @Test
- public void polyhedralDiceStayInRange() {
- Die die = DieFactory.polyhedral(6);
-
- for (int i = 0; i < 50; i++) {
- int result = die.roll(rng);
-
- boolean inRange = result <= 6 && result >= 1;
-
- assertTrue("Six-sided dice always return a value from 1 to 6", inRange);
- }
- }
-
- @Test
- public void polyhedralDiceEqualityFunctionsProperly() {
- Die dieA1 = DieFactory.polyhedral(1);
- Die dieA2 = DieFactory.polyhedral(1);
- Die dieB1 = DieFactory.polyhedral(2);
-
- assertEquals("Polyhedral dice with the same number of sides are equal",
- dieA1, dieA2);
- assertNotEquals("Polyhedral dice with a diffeent number of sides aren't equal",
- dieA1, dieB1);
- }
+ // Some tests, I guess
}