Trunk: Merged the Devel-branch (branches/griatch) into /trunk. This constitutes a major refactoring of Evennia. Development will now continue in trunk. See the wiki and the past posts to the mailing list for info. /Griatch

game/gamesrc/world/examples/batch_cmds.ev

@@ -3,9 +3,8 @@
 #
 # It allows batch processing of normal Evennia commands.
 # Test it by loading it with the @batchprocess command
-# (superuser only):
 #
-#   @batchprocess[/interactive] </full/path/to/this/file>
+#   @batchprocess[/interactive] examples.batch_example
 #
 # A # as the first symbol on a line begins a comment and
 # marks the end of a previous command definition (important!).
@@ -18,12 +17,12 @@
 
 # This creates a red button
 
-@create button
+@create button:examples.red_button.RedButton
 
 # This comment ends input for @create
 # Next command: 
 
-@set button=desc: 
+@set button/desc =  
   This is a large red button. Now and then 
   it flashes in an evil, yet strangely tantalizing way. 
 
@@ -52,6 +51,6 @@ know you want to!
 @teleport #2
 
 #... and drop it (remember, this comment ends input to @teleport, so don't
-#forget it!) The very last command in the file needs not be ended with #.
+#forget it!) The very last command in the file need not be ended with #.
 
 drop button

game/gamesrc/world/examples/batch_code.py

@@ -0,0 +1,71 @@
+#
+# Batchcode script
+# 
+#
+# The Batch-code processor accepts full python modules (e.g. "batch.py") that
+# looks identical to normal Python files with a few exceptions that allows them
+# to the executed in blocks. This way of working assures a sequential execution
+# of the file and allows for features like stepping from block to block
+# (without executing those coming before), as well as automatic deletion
+# of created objects etc. You can however also run a batch-code python file
+# directly using Python (and can also be de). 
+
+# Code blocks are separated by python comments starting with special code words. 
+
+# #HEADER - this denotes commands global to the entire file, such as
+#           import statements and global variables. They will
+#           automatically be made available for each block.  Observe
+#           that changes to these variables made in one block is not
+#           preserved between blocks!)
+# #CODE [objname, objname, ...] - This designates a code block that will be executed like a 
+#            stand-alone piece of code together with any #HEADER
+#            defined. <objname>s mark the (variable-)names of objects created in the code, 
+#            and which may be auto-deleted by the processor if desired (such as when 
+#            debugging the script). E.g., if the code contains the command 
+#            myobj = create.create_object(...), you could put 'myobj' in the #CODE header
+#            regardless of what the created object is actually called in-game. 
+
+# The following variables are automatically made available for the script:
+
+# caller - the object executing the script
+#
+#
+
+#HEADER 
+
+# everything in this block will be imported to all CODE blocks when
+# they are executed.
+
+from src.utils import create, search
+from game.gamesrc.typeclasses.examples import red_button
+from game.gamesrc.typeclasses import basetypes
+
+#CODE 
+
+# This is the first code block. Within each block, python
+# code works as normal.
+
+# get the limbo room.
+limbo = search.objects(caller, 'Limbo', global_search=True)[0]
+caller.msg(limbo)
+# create a red button in limbo
+red_button = create.create_object(red_button.RedButton, key="Red button", 
+                                  location=limbo, aliases=["button"])
+
+# we take a look at what we created
+caller.msg("A %s was created." % red_button.key)
+
+#CODE table, chair
+
+# this code block has 'table' and 'chair' set as deletable
+# objects. This means that when the batchcode processor runs in
+# testing mode, objects created in these variables will be deleted
+# again (so as to avoid duplicate objects when testing the script).
+
+limbo = search.objects(caller, 'Limbo', global_search=True)[0]
+caller.msg(limbo.key)
+table = create.create_object(basetypes.Object, key="Table", location=limbo)
+chair = create.create_object(basetypes.Object, key="Chair", location=limbo)
+
+string = "A %s and %s were created. If debug was active, they were deleted again." 
+caller.msg(string % (table, chair))