Chat formatting additions and improvements (#315)

* Pagination, switch to format strings, give box a lang
* working pagination

cogs/utils/chat_formatting.py

@@ -1,20 +1,47 @@
 def bold(text):
-    return "**"+str(text)+"**"
+    return "**{}**".format(text)
 
-def italics(text):
-    return "*"+str(text)+"*"
 
-def strikethrough(text):
+def box(text, lang=""):
-    return "~~"+str(text)+"~~"
+    ret = "```{}\n{}\n```".format(lang, text)
+    return ret
 
-def underline(text):
-    return "__"+str(text)+"__"
-
-def box(text):
-    return "```"+str(text)+"```"
 
 def inline(text):
-    return "`"+str(text)+"`"
+    return "`{}`".format(text)
+
+
+def italics(text):
+    return "*{}*".format(text)
+
+
+def pagify(text, delims=[], escape=True, shorten_by=8):
+    """DOES NOT RESPECT MARKDOWN BOXES OR INLINE CODE"""
+    in_text = text
+    while len(in_text) > 2000:
+        closest_delim = max([in_text.rfind(d, 0, 2000 - shorten_by)
+                             for d in delims])
+        closest_delim = closest_delim if closest_delim != -1 else 2000
+        if escape:
+            to_send = escape_mass_mentions(in_text[:closest_delim])
+        else:
+            to_send = in_text[:closest_delim]
+        yield to_send
+        in_text = in_text[closest_delim:]
+
+    if escape:
+        yield escape_mass_mentions(in_text)
+    else:
+        yield in_text
+
+
+def strikethrough(text):
+    return "~~{}~~".format(text)
+
+
+def underline(text):
+    return "__{}__".format(text)
+
 
 def escape_mass_mentions(text):
     words = {
@@ -23,4 +50,4 @@ def escape_mass_mentions(text):
     }
     for k, v in words.items():
         text = text.replace(k, v)
-    return text
+    return text