#1073 Add delay to email recovery command

- Add configurable cooldown period after sending an email for /email recovery
- Change ExpiringMap to remove expired entries (like ExpiringSet)
- Create method to translate durations via the messages file

src/main/java/fr/xephi/authme/message/MessageKey.java

@@ -225,7 +225,35 @@ public enum MessageKey {
     RECOVERY_CODE_SENT("recovery_code_sent"),
 
     /** The recovery code is not correct! Use "/email recovery [email]" to generate a new one */
-    INCORRECT_RECOVERY_CODE("recovery_code_incorrect");
+    INCORRECT_RECOVERY_CODE("recovery_code_incorrect"),
+
+    /** An email was already sent recently. You must wait %time before you can send a new one. */
+    EMAIL_COOLDOWN_ERROR("email_cooldown_error", "%time"),
+
+    /** second */
+    SECOND("second"),
+
+    /** seconds */
+    SECONDS("seconds"),
+
+    /** minute */
+    MINUTE("minute"),
+
+    /** minutes */
+    MINUTES("minutes"),
+
+    /** hour */
+    HOUR("hour"),
+
+    /** hours */
+    HOURS("hours"),
+
+    /** day */
+    DAY("day"),
+
+    /** days */
+    DAYS("days");
+
 
     private String key;
     private String[] tags;

src/main/java/fr/xephi/authme/message/Messages.java

@@ -1,11 +1,15 @@
 package fr.xephi.authme.message;
 
+import com.google.common.collect.ImmutableMap;
 import fr.xephi.authme.ConsoleLogger;
 import fr.xephi.authme.initialization.Reloadable;
+import fr.xephi.authme.util.expiring.Duration;
 import org.bukkit.ChatColor;
 import org.bukkit.command.CommandSender;
 
 import javax.inject.Inject;
+import java.util.Map;
+import java.util.concurrent.TimeUnit;
 
 /**
  * Class for retrieving and sending translatable messages to players.
@@ -15,6 +19,20 @@ public class Messages implements Reloadable {
     // Custom Authme tag replaced to new line
     private static final String NEWLINE_TAG = "%nl%";
 
+    /** Contains the keys of the singular messages for time units. */
+    private static final Map<TimeUnit, MessageKey> TIME_UNIT_SINGULARS = ImmutableMap.<TimeUnit, MessageKey>builder()
+        .put(TimeUnit.SECONDS, MessageKey.SECOND)
+        .put(TimeUnit.MINUTES, MessageKey.MINUTE)
+        .put(TimeUnit.HOURS, MessageKey.HOUR)
+        .put(TimeUnit.DAYS, MessageKey.DAY).build();
+
+    /** Contains the keys of the plural messages for time units. */
+    private static final Map<TimeUnit, MessageKey> TIME_UNIT_PLURALS = ImmutableMap.<TimeUnit, MessageKey>builder()
+        .put(TimeUnit.SECONDS, MessageKey.SECONDS)
+        .put(TimeUnit.MINUTES, MessageKey.MINUTES)
+        .put(TimeUnit.HOURS, MessageKey.HOURS)
+        .put(TimeUnit.DAYS, MessageKey.DAYS).build();
+
     private final MessageFileHandlerProvider messageFileHandlerProvider;
     private MessageFileHandler messageFileHandler;
 
@@ -71,6 +89,22 @@ public class Messages implements Reloadable {
         return message.split("\n");
     }
 
+    /**
+     * Returns the textual representation for the given duration.
+     * Note that this class only supports the time units days, hour, minutes and seconds.
+     *
+     * @param duration the duration to build a text of
+     * @return text of the duration
+     */
+    public String formatDuration(Duration duration) {
+        long value = duration.getDuration();
+        MessageKey timeUnitKey = value == 1
+            ? TIME_UNIT_SINGULARS.get(duration.getTimeUnit())
+            : TIME_UNIT_PLURALS.get(duration.getTimeUnit());
+
+        return value + " " + retrieveMessage(timeUnitKey);
+    }
+
     /**
      * Retrieve the message from the text file.
      *