mirror of
https://github.com/evennia/evennia.git
synced 2026-03-28 10:37:16 +01:00
335 lines
13 KiB
Python
335 lines
13 KiB
Python
"""
|
|
Unit tests for the utilities of the evennia.utils.utils module.
|
|
|
|
TODO: Not nearly all utilities are covered yet.
|
|
|
|
"""
|
|
|
|
import os.path
|
|
import random
|
|
|
|
import mock
|
|
from django.test import TestCase
|
|
from datetime import datetime
|
|
|
|
from evennia.utils.ansi import ANSIString
|
|
from evennia.utils import utils
|
|
|
|
|
|
class TestIsIter(TestCase):
|
|
def test_is_iter(self):
|
|
self.assertEqual(True, utils.is_iter([1, 2, 3, 4]))
|
|
self.assertEqual(False, utils.is_iter("This is not an iterable"))
|
|
|
|
|
|
class TestCrop(TestCase):
|
|
def test_crop(self):
|
|
# No text, return no text
|
|
self.assertEqual("", utils.crop("", width=10, suffix="[...]"))
|
|
# Input length equal to max width, no crop
|
|
self.assertEqual("0123456789", utils.crop("0123456789", width=10, suffix="[...]"))
|
|
# Input length greater than max width, crop (suffix included in width)
|
|
self.assertEqual("0123[...]", utils.crop("0123456789", width=9, suffix="[...]"))
|
|
# Input length less than desired width, no crop
|
|
self.assertEqual("0123", utils.crop("0123", width=9, suffix="[...]"))
|
|
# Width too small or equal to width of suffix
|
|
self.assertEqual("012", utils.crop("0123", width=3, suffix="[...]"))
|
|
self.assertEqual("01234", utils.crop("0123456", width=5, suffix="[...]"))
|
|
|
|
|
|
class TestDedent(TestCase):
|
|
def test_dedent(self):
|
|
# Empty string, return empty string
|
|
self.assertEqual("", utils.dedent(""))
|
|
# No leading whitespace
|
|
self.assertEqual("TestDedent", utils.dedent("TestDedent"))
|
|
# Leading whitespace, single line
|
|
self.assertEqual("TestDedent", utils.dedent(" TestDedent"))
|
|
# Leading whitespace, multi line
|
|
input_string = " hello\n world"
|
|
expected_string = "hello\nworld"
|
|
self.assertEqual(expected_string, utils.dedent(input_string))
|
|
|
|
|
|
class TestListToString(TestCase):
|
|
"""
|
|
Default function header from utils.py:
|
|
list_to_string(inlist, endsep="and", addquote=False)
|
|
|
|
Examples:
|
|
no endsep:
|
|
[1,2,3] -> '1, 2, 3'
|
|
with endsep=='and':
|
|
[1,2,3] -> '1, 2 and 3'
|
|
with addquote and endsep
|
|
[1,2,3] -> '"1", "2" and "3"'
|
|
"""
|
|
|
|
def test_list_to_string(self):
|
|
self.assertEqual("1, 2, 3", utils.list_to_string([1, 2, 3], endsep=""))
|
|
self.assertEqual('"1", "2", "3"', utils.list_to_string([1, 2, 3], endsep="", addquote=True))
|
|
self.assertEqual("1, 2 and 3", utils.list_to_string([1, 2, 3]))
|
|
self.assertEqual(
|
|
'"1", "2" and "3"', utils.list_to_string([1, 2, 3], endsep="and", addquote=True)
|
|
)
|
|
|
|
|
|
class TestMLen(TestCase):
|
|
"""
|
|
Verifies that m_len behaves like len in all situations except those
|
|
where MXP may be involved.
|
|
"""
|
|
|
|
def test_non_mxp_string(self):
|
|
self.assertEqual(utils.m_len("Test_string"), 11)
|
|
|
|
def test_mxp_string(self):
|
|
self.assertEqual(utils.m_len("|lclook|ltat|le"), 2)
|
|
|
|
def test_mxp_ansi_string(self):
|
|
self.assertEqual(utils.m_len(ANSIString("|lcl|gook|ltat|le|n")), 2)
|
|
|
|
def test_non_mxp_ansi_string(self):
|
|
self.assertEqual(utils.m_len(ANSIString("|gHello|n")), 5)
|
|
|
|
def test_list(self):
|
|
self.assertEqual(utils.m_len([None, None]), 2)
|
|
|
|
def test_dict(self):
|
|
self.assertEqual(utils.m_len({"hello": True, "Goodbye": False}), 2)
|
|
|
|
|
|
class TestTimeformat(TestCase):
|
|
"""
|
|
Default function header from utils.py:
|
|
time_format(seconds, style=0)
|
|
|
|
"""
|
|
|
|
def test_style_0(self):
|
|
"""Test the style 0 of time_format."""
|
|
self.assertEqual(utils.time_format(0, 0), "00:00")
|
|
self.assertEqual(utils.time_format(28, 0), "00:00")
|
|
self.assertEqual(utils.time_format(92, 0), "00:01")
|
|
self.assertEqual(utils.time_format(300, 0), "00:05")
|
|
self.assertEqual(utils.time_format(660, 0), "00:11")
|
|
self.assertEqual(utils.time_format(3600, 0), "01:00")
|
|
self.assertEqual(utils.time_format(3725, 0), "01:02")
|
|
self.assertEqual(utils.time_format(86350, 0), "23:59")
|
|
self.assertEqual(utils.time_format(86800, 0), "1d 00:06")
|
|
self.assertEqual(utils.time_format(130800, 0), "1d 12:20")
|
|
self.assertEqual(utils.time_format(530800, 0), "6d 03:26")
|
|
|
|
def test_style_1(self):
|
|
"""Test the style 1 of time_format."""
|
|
self.assertEqual(utils.time_format(0, 1), "0s")
|
|
self.assertEqual(utils.time_format(28, 1), "28s")
|
|
self.assertEqual(utils.time_format(92, 1), "1m")
|
|
self.assertEqual(utils.time_format(300, 1), "5m")
|
|
self.assertEqual(utils.time_format(660, 1), "11m")
|
|
self.assertEqual(utils.time_format(3600, 1), "1h")
|
|
self.assertEqual(utils.time_format(3725, 1), "1h")
|
|
self.assertEqual(utils.time_format(86350, 1), "23h")
|
|
self.assertEqual(utils.time_format(86800, 1), "1d")
|
|
self.assertEqual(utils.time_format(130800, 1), "1d")
|
|
self.assertEqual(utils.time_format(530800, 1), "6d")
|
|
|
|
def test_style_2(self):
|
|
"""Test the style 2 of time_format."""
|
|
self.assertEqual(utils.time_format(0, 2), "0 minutes")
|
|
self.assertEqual(utils.time_format(28, 2), "0 minutes")
|
|
self.assertEqual(utils.time_format(92, 2), "1 minute")
|
|
self.assertEqual(utils.time_format(300, 2), "5 minutes")
|
|
self.assertEqual(utils.time_format(660, 2), "11 minutes")
|
|
self.assertEqual(utils.time_format(3600, 2), "1 hour, 0 minutes")
|
|
self.assertEqual(utils.time_format(3725, 2), "1 hour, 2 minutes")
|
|
self.assertEqual(utils.time_format(86350, 2), "23 hours, 59 minutes")
|
|
self.assertEqual(utils.time_format(86800, 2), "1 day, 0 hours, 6 minutes")
|
|
self.assertEqual(utils.time_format(130800, 2), "1 day, 12 hours, 20 minutes")
|
|
self.assertEqual(utils.time_format(530800, 2), "6 days, 3 hours, 26 minutes")
|
|
|
|
def test_style_3(self):
|
|
"""Test the style 3 of time_format."""
|
|
self.assertEqual(utils.time_format(0, 3), "")
|
|
self.assertEqual(utils.time_format(28, 3), "28 seconds")
|
|
self.assertEqual(utils.time_format(92, 3), "1 minute 32 seconds")
|
|
self.assertEqual(utils.time_format(300, 3), "5 minutes 0 seconds")
|
|
self.assertEqual(utils.time_format(660, 3), "11 minutes 0 seconds")
|
|
self.assertEqual(utils.time_format(3600, 3), "1 hour, 0 minutes")
|
|
self.assertEqual(utils.time_format(3725, 3), "1 hour, 2 minutes 5 seconds")
|
|
self.assertEqual(utils.time_format(86350, 3), "23 hours, 59 minutes 10 seconds")
|
|
self.assertEqual(utils.time_format(86800, 3), "1 day, 0 hours, 6 minutes 40 seconds")
|
|
self.assertEqual(utils.time_format(130800, 3), "1 day, 12 hours, 20 minutes 0 seconds")
|
|
self.assertEqual(utils.time_format(530800, 3), "6 days, 3 hours, 26 minutes 40 seconds")
|
|
|
|
def test_style_4(self):
|
|
"""Test the style 4 of time_format."""
|
|
self.assertEqual(utils.time_format(0, 4), "0 seconds")
|
|
self.assertEqual(utils.time_format(28, 4), "28 seconds")
|
|
self.assertEqual(utils.time_format(92, 4), "a minute")
|
|
self.assertEqual(utils.time_format(300, 4), "5 minutes")
|
|
self.assertEqual(utils.time_format(660, 4), "11 minutes")
|
|
self.assertEqual(utils.time_format(3600, 4), "an hour")
|
|
self.assertEqual(utils.time_format(3725, 4), "an hour")
|
|
self.assertEqual(utils.time_format(86350, 4), "23 hours")
|
|
self.assertEqual(utils.time_format(86800, 4), "a day")
|
|
self.assertEqual(utils.time_format(130800, 4), "a day")
|
|
self.assertEqual(utils.time_format(530800, 4), "6 days")
|
|
self.assertEqual(utils.time_format(3030800, 4), "a month")
|
|
self.assertEqual(utils.time_format(7030800, 4), "2 months")
|
|
self.assertEqual(utils.time_format(40030800, 4), "a year")
|
|
self.assertEqual(utils.time_format(90030800, 4), "2 years")
|
|
|
|
def test_unknown_format(self):
|
|
"""Test that unknown formats raise exceptions."""
|
|
self.assertRaises(ValueError, utils.time_format, 0, 5)
|
|
self.assertRaises(ValueError, utils.time_format, 0, "u")
|
|
|
|
|
|
@mock.patch(
|
|
"evennia.utils.utils.timezone.now",
|
|
new=mock.MagicMock(return_value=datetime(2019, 8, 28, 21, 56)),
|
|
)
|
|
class TestDateTimeFormat(TestCase):
|
|
def test_datetimes(self):
|
|
dtobj = datetime(2017, 7, 26, 22, 54)
|
|
self.assertEqual(utils.datetime_format(dtobj), "Jul 26, 2017")
|
|
dtobj = datetime(2019, 7, 26, 22, 54)
|
|
self.assertEqual(utils.datetime_format(dtobj), "Jul 26")
|
|
dtobj = datetime(2019, 8, 28, 19, 54)
|
|
self.assertEqual(utils.datetime_format(dtobj), "19:54")
|
|
dtobj = datetime(2019, 8, 28, 21, 32)
|
|
self.assertEqual(utils.datetime_format(dtobj), "21:32:00")
|
|
|
|
|
|
class TestImportFunctions(TestCase):
|
|
def _t_dir_file(self, filename):
|
|
testdir = os.path.dirname(os.path.abspath(__file__))
|
|
return os.path.join(testdir, filename)
|
|
|
|
def test_mod_import(self):
|
|
loaded_mod = utils.mod_import("evennia.utils.ansi")
|
|
self.assertIsNotNone(loaded_mod)
|
|
|
|
def test_mod_import_invalid(self):
|
|
loaded_mod = utils.mod_import("evennia.utils.invalid_module")
|
|
self.assertIsNone(loaded_mod)
|
|
|
|
def test_mod_import_from_path(self):
|
|
test_path = self._t_dir_file("test_eveditor.py")
|
|
loaded_mod = utils.mod_import_from_path(test_path)
|
|
self.assertIsNotNone(loaded_mod)
|
|
|
|
def test_mod_import_from_path_invalid(self):
|
|
test_path = self._t_dir_file("invalid_filename.py")
|
|
loaded_mod = utils.mod_import_from_path(test_path)
|
|
self.assertIsNone(loaded_mod)
|
|
|
|
|
|
class LatinifyTest(TestCase):
|
|
def setUp(self):
|
|
super().setUp()
|
|
|
|
self.example_str = "It naïvely says, “plugh.”"
|
|
self.expected_output = 'It naively says, "plugh."'
|
|
|
|
def test_plain_string(self):
|
|
result = utils.latinify(self.example_str)
|
|
self.assertEqual(result, self.expected_output)
|
|
|
|
def test_byte_string(self):
|
|
byte_str = utils.to_bytes(self.example_str)
|
|
result = utils.latinify(byte_str)
|
|
self.assertEqual(result, self.expected_output)
|
|
|
|
|
|
class TestFormatGrid(TestCase):
|
|
|
|
maxDiff = None
|
|
|
|
def setUp(self):
|
|
# make the random only semi-random with a fixed seed
|
|
random.seed(1)
|
|
|
|
def tearDown(self):
|
|
# restore normal randomness
|
|
random.seed(None)
|
|
|
|
def _generate_elements(self, basewidth, variation, amount):
|
|
return [
|
|
"X" * max(1, basewidth + int(random.randint(-variation, variation)))
|
|
for _ in range(amount)
|
|
]
|
|
|
|
def test_even_grid(self):
|
|
"""Grid with small variations"""
|
|
elements = self._generate_elements(3, 1, 30)
|
|
rows = utils.format_grid(elements, width=78)
|
|
self.assertEqual(len(rows), 3)
|
|
self.assertTrue(all(len(row) == 78 for row in rows))
|
|
|
|
def test_disparate_grid(self):
|
|
"""Grid with big variations"""
|
|
elements = self._generate_elements(3, 15, 30)
|
|
rows = utils.format_grid(elements, width=82, sep=" ")
|
|
self.assertEqual(len(rows), 8)
|
|
self.assertTrue(all(len(row) == 82 for row in rows))
|
|
|
|
def test_huge_grid(self):
|
|
"""Grid with very long strings"""
|
|
elements = self._generate_elements(70, 20, 30)
|
|
rows = utils.format_grid(elements, width=78)
|
|
self.assertEqual(len(rows), 30)
|
|
self.assertTrue(all(len(row) == 78 for row in rows))
|
|
|
|
def test_overlap(self):
|
|
"""Grid with elements overlapping into the next slot"""
|
|
elements = (
|
|
"alias",
|
|
"batchcode",
|
|
"batchcommands",
|
|
"cmdsets",
|
|
"copy",
|
|
"cpattr",
|
|
"desc",
|
|
"destroy",
|
|
"dig",
|
|
"examine",
|
|
"find",
|
|
"force",
|
|
"lock",
|
|
)
|
|
rows = utils.format_grid(elements, width=78)
|
|
self.assertEqual(len(rows), 2)
|
|
for element in elements:
|
|
self.assertTrue(element in "\n".join(rows), f"element {element} is missing.")
|
|
|
|
def test_breakline(self):
|
|
"""Grid with line-long elements in middle"""
|
|
elements = self._generate_elements(6, 4, 30)
|
|
elements[10] = elements[20] = "-" * 78
|
|
rows = utils.format_grid(elements, width=78)
|
|
self.assertEqual(len(rows), 8)
|
|
for element in elements:
|
|
self.assertTrue(element in "\n".join(rows), f"element {element} is missing.")
|
|
|
|
|
|
class TestPercent(TestCase):
|
|
"""
|
|
Test the utils.percentage function.
|
|
"""
|
|
|
|
def test_ok_input(self):
|
|
result = utils.percent(3, 0, 10)
|
|
self.assertEqual(result, "30.0%")
|
|
result = utils.percent(2.5, 0, 5, formatting=None)
|
|
self.assertEqual(result, 50.0)
|
|
|
|
def test_bad_input(self):
|
|
"""Gracefully handle weird input."""
|
|
self.assertEqual(utils.percent(3, 10, 1), "0.0%")
|
|
self.assertEqual(utils.percent(3, None, 1), "100.0%")
|
|
self.assertEqual(utils.percent(1, 1, 1), "100.0%")
|
|
self.assertEqual(utils.percent(3, 1, 1), "0.0%")
|
|
self.assertEqual(utils.percent(3, 0, 1), "100.0%")
|
|
self.assertEqual(utils.percent(-3, 0, 1), "0.0%")
|