After lots of discussions, default commands where moved from game/gamesrc/commands/default to src/commands/default in order to make it clearer which parts are updated as part of evennia and which can be tweaked at heart's content. New templates where left in gamesrc/commands that should hopefully make it clearer how to extend the command system. Also game/web was moved to src/web - we'll likely extend this from game/gamesrc/web in the future. If you already did extensions you should just have to edit your import paths and make use of the new cmdset template supplied.

The unit testing was for commands was split out from src/objects/tests.py into the new src/commands/default/test.py in order to keep the testing modules thematically grouped with the things they are testing.

src/commands/default/tests.py

@@ -0,0 +1,126 @@
+# -*- coding: utf-8 -*-
+"""
+ ** OBS - this is not a normal command module! **
+ ** You cannot import anythin in this module as a command! **
+
+This is part of the Evennia unittest framework, for testing the
+stability and integrity of the codebase during updates. This module
+test the default command set. It is instantiated by the
+src/objects/tests.py module, which in turn is run by as part of the
+main test suite started with
+ > python game/manage.py test.
+
+"""
+
+import re, time
+try:
+    # this is a special optimized Django version, only available in current Django devel
+    from django.utils.unittest import TestCase
+except ImportError:
+    from django.test import TestCase
+from django.conf import settings
+from src.utils import create 
+from src.server import session, sessionhandler
+
+#------------------------------------------------------------ 
+# Command testing 
+# ------------------------------------------------------------
+
+# print all feedback from test commands (can become very verbose!)
+VERBOSE = False
+
+class FakeSession(session.SessionProtocol): 
+    """ 
+    A fake session that
+    implements dummy versions of the real thing; this is needed to
+    mimic a logged-in player.  
+    """ 
+    def connectionMade(self):
+        self.prep_session() 
+        sessionhandler.add_session(self)     
+    def prep_session(self): 
+        self.server, self.address = None, "0.0.0.0"
+        self.name, self.uid = None, None 
+        self.logged_in = False
+        self.encoding = "utf-8" 
+        self.cmd_last, self.cmd_last_visible, self.cmd_conn_time = time.time(), time.time(), time.time()
+        self.cmd_total = 0 
+    def disconnectClient(self): 
+        pass 
+    def lineReceived(self, raw_string): 
+        pass 
+    def msg(self, message, markup=True): 
+        if VERBOSE: 
+            print message
+
+class CommandTest(TestCase):
+    """
+    Sets up the basics of testing the default commands and the generic things
+    that should always be present in a command.
+
+    Inherit new tests from this.
+    """
+    def setUp(self):
+        "sets up the testing environment"                
+        self.room1 = create.create_object(settings.BASE_ROOM_TYPECLASS, key="room1")
+        self.room2 = create.create_object(settings.BASE_ROOM_TYPECLASS, key="room2")
+
+        # create a faux player/character for testing.
+        self.char1 = create.create_player("TestingPlayer", "testplayer@test.com", "testpassword", location=self.room1)
+        self.char1.player.user.is_superuser = True 
+        sess = FakeSession()
+        sess.connectionMade()
+        sess.login(self.char1.player)
+        
+        self.char2 = create.create_object(settings.BASE_CHARACTER_TYPECLASS, key="char2", location=self.room1)
+        self.obj1 = create.create_object(settings.BASE_OBJECT_TYPECLASS, key="obj1", location=self.room1)
+        self.obj2 = create.create_object(settings.BASE_OBJECT_TYPECLASS, key="obj2", location=self.room1)
+        self.exit1 = create.create_object(settings.BASE_EXIT_TYPECLASS, key="exit1", location=self.room1)
+        self.exit2 = create.create_object(settings.BASE_EXIT_TYPECLASS, key="exit2", location=self.room2)        
+        
+    def get_cmd(self, cmd_class, argument_string=""):
+        """
+        Obtain a cmd instance from a class and an input string
+        Note: This does not make use of the cmdhandler functionality.
+        """        
+        cmd = cmd_class()
+        cmd.caller = self.char1
+        cmd.cmdstring = cmd_class.key
+        cmd.args = argument_string
+        cmd.cmdset = None
+        cmd.obj = self.char1
+        return cmd
+    
+    def execute_cmd(self, raw_string):
+        """
+        Creates the command through faking a normal command call; 
+        This also mangles the input in various ways to test if the command
+        will be fooled.
+        """ 
+        test1 = re.sub(r'\s', '', raw_string) # remove all whitespace inside it
+        test2 = "%s/åäö öäö;-:$£@*~^' 'test" % raw_string # inserting weird characters in call
+        test3 = "%s %s" % (raw_string, raw_string) # multiple calls 
+        self.char1.execute_cmd(test1)
+        self.char1.execute_cmd(test2)
+        self.char1.execute_cmd(test3)
+        self.char1.execute_cmd(raw_string)
+
+#------------------------------------------------------------
+# Default set Command testing
+#------------------------------------------------------------
+
+class TestHome(CommandTest):
+    def test_call(self):
+        self.char1.home = self.room2
+        self.execute_cmd("home")
+        self.assertEqual(self.char1.location, self.room2)
+class TestLook(CommandTest):
+    def test_call(self):
+        self.execute_cmd("look here")
+class TestPassword(CommandTest):
+    def test_call(self):
+        self.execute_cmd("@password testpassword = newpassword")
+class TestNick(CommandTest):
+    def test_call(self):
+        self.execute_cmd("nickname testalias = testaliasedstring")        
+        self.assertEquals("testaliasedstring", self.char1.nicks.get("testalias", None))