home · contact · privacy
Remove unused variable.
[plomrogue] / roguelike-server
1 #!/usr/bin/python3
2
3 # This file is part of PlomRogue. PlomRogue is licensed under the GPL version 3
4 # or any later version. For details on its copyright, license, and warranties,
5 # see the file NOTICE in the root directory of the PlomRogue source package.
6
7
8 import argparse
9 import errno
10 import os
11 import shlex
12 import shutil
13 import time
14 import ctypes
15
16
17 class RandomnessIO:
18     """"Interface to libplomrogue's pseudo-randomness generator."""
19
20     def set_seed(self, seed):
21         libpr.seed_rrand(1, seed)
22
23     def get_seed(self):
24         return libpr.seed_rrand(0, 0)
25
26     def next(self):
27         return libpr.rrand()
28
29     seed = property(get_seed, set_seed)
30
31
32 def prep_library():
33     """Prepare ctypes library at ./libplomrogue.so"""
34     libpath = ("./libplomrogue.so")
35     if not os.access(libpath, os.F_OK):
36         raise SystemExit("No library " + libpath + ", run ./redo first?")
37     libpr = ctypes.cdll.LoadLibrary(libpath)
38     libpr.seed_rrand.restype = ctypes.c_uint32
39     return libpr
40
41
42 def c_pointer_to_bytearray(ba):
43     """Return C char * pointer to ba."""
44     type = ctypes.c_char * len(ba)
45     return type.from_buffer(ba)
46
47
48 def strong_write(file, string):
49     """Apply write(string), then flush()."""
50     file.write(string)
51     file.flush()
52
53
54 def setup_server_io():
55     """Fill IO files DB with proper file( path)s. Write process IO test string.
56
57     Ensure IO files directory at server/. Remove any old input file if found.
58     Set up new input file for reading, and new output file for writing. Start
59     output file with process hash line of format PID + " " + floated UNIX time
60     (io_db["teststring"]). Raise SystemExit if file is found at path of either
61     record or save file plus io_db["tmp_suffix"].
62     """
63     def detect_atomic_leftover(path, tmp_suffix):
64         path_tmp = path + tmp_suffix
65         msg = "Found file '" + path_tmp + "' that may be a leftover from an " \
66               "aborted previous attempt to write '" + path + "'. Aborting " \
67               "until matter is resolved by removing it from its current path."
68         if os.access(path_tmp, os.F_OK):
69             raise SystemExit(msg)
70     io_db["teststring"] = str(os.getpid()) + " " + str(time.time())
71     io_db["save_wait"] = 0
72     io_db["verbose"] = False
73     io_db["record_chunk"] = ""
74     os.makedirs(io_db["path_server"], exist_ok=True)
75     io_db["file_out"] = open(io_db["path_out"], "w")
76     strong_write(io_db["file_out"], io_db["teststring"] + "\n")
77     if os.access(io_db["path_in"], os.F_OK):
78         os.remove(io_db["path_in"])
79     io_db["file_in"] = open(io_db["path_in"], "w")
80     io_db["file_in"].close()
81     io_db["file_in"] = open(io_db["path_in"], "r")
82     detect_atomic_leftover(io_db["path_save"], io_db["tmp_suffix"])
83     detect_atomic_leftover(io_db["path_record"], io_db["tmp_suffix"])
84
85
86 def cleanup_server_io():
87     """Close and (if io_db["kicked_by_rival"] false) remove files in io_db."""
88     def helper(file_key, path_key):
89         if file_key in io_db:
90             io_db[file_key].close()
91         if not io_db["kicked_by_rival"] \
92            and os.access(io_db[path_key], os.F_OK):
93             os.remove(io_db[path_key])
94     helper("file_in", "path_in")
95     helper("file_out", "path_out")
96     helper("file_worldstate", "path_worldstate")
97     if "file_record" in io_db:
98         io_db["file_record"].close()
99
100
101 def obey(command, prefix, replay=False, do_record=False):
102     """Call function from commands_db mapped to command's first token.
103
104     Tokenize command string with shlex.split(comments=True). If replay is set,
105     a non-meta command from the commands_db merely triggers obey() on the next
106     command from the records file. If not, non-meta commands set
107     io_db["worldstate_updateable"] to world_db["WORLD_ACTIVE"], and, if
108     do_record is set, are recorded to io_db["record_chunk"], and save_world()
109     is called (and io_db["record_chunk"] written) if 15 seconds have passed
110     since the last time it was called. The prefix string is inserted into the
111     server's input message between its beginning 'input ' and ':'. All activity
112     is preceded by a server_test() call.
113     """
114     server_test()
115     if io_db["verbose"]:
116         print("input " + prefix + ": " + command)
117     try:
118         tokens = shlex.split(command, comments=True)
119     except ValueError as err:
120         print("Can't tokenize command string: " + str(err) + ".")
121         return
122     if len(tokens) > 0 and tokens[0] in commands_db \
123        and len(tokens) == commands_db[tokens[0]][0] + 1:
124         if commands_db[tokens[0]][1]:
125             commands_db[tokens[0]][2](*tokens[1:])
126         elif replay:
127             print("Due to replay mode, reading command as 'go on in record'.")
128             line = io_db["file_record"].readline()
129             if len(line) > 0:
130                 obey(line.rstrip(), io_db["file_record"].prefix
131                      + str(io_db["file_record"].line_n))
132                 io_db["file_record"].line_n = io_db["file_record"].line_n + 1
133             else:
134                 print("Reached end of record file.")
135         else:
136             commands_db[tokens[0]][2](*tokens[1:])
137             if do_record:
138                 io_db["record_chunk"] += command + "\n"
139                 if time.time() > io_db["save_wait"] + 15:
140                     atomic_write(io_db["path_record"], io_db["record_chunk"],
141                                  do_append=True)
142                     save_world()
143                     io_db["record_chunk"] = ""
144                     io_db["save_wait"] = time.time()
145             io_db["worldstate_updateable"] = world_db["WORLD_ACTIVE"]
146     elif 0 != len(tokens):
147         print("Invalid command/argument, or bad number of tokens.")
148
149
150 def atomic_write(path, text, do_append=False, delete=True):
151     """Atomic write of text to file at path, appended if do_append is set."""
152     path_tmp = path + io_db["tmp_suffix"]
153     mode = "w"
154     if do_append:
155         mode = "a"
156         if os.access(path, os.F_OK):
157             shutil.copyfile(path, path_tmp)
158     file = open(path_tmp, mode)
159     strong_write(file, text)
160     file.close()
161     if delete and os.access(path, os.F_OK):
162         os.remove(path)
163     os.rename(path_tmp, path)
164
165
166 def save_world():
167     """Save all commands needed to reconstruct current world state."""
168
169     def quote(string):
170         string = string.replace("\u005C", '\u005C\u005C')
171         return '"' + string.replace('"', '\u005C"') + '"'
172
173     def mapsetter(key):
174         def helper(id):
175             string = ""
176             if world_db["Things"][id][key]:
177                 map = world_db["Things"][id][key]
178                 length = world_db["MAP_LENGTH"]
179                 for i in range(length):
180                     line = map[i * length:(i * length) + length].decode()
181                     string = string + key + " " + str(i) + " " + quote(line) \
182                         + "\n"
183             return string
184         return helper
185
186     def memthing(id):
187         string = ""
188         for memthing in world_db["Things"][id]["T_MEMTHING"]:
189             string = string + "T_MEMTHING " + str(memthing[0]) + " " + \
190                 str(memthing[1]) + " " + str(memthing[2]) + "\n"
191         return string
192
193     def helper(category, id_string, special_keys={}):
194         string = ""
195         for id in sorted(world_db[category].keys()):
196             string = string + id_string + " " + str(id) + "\n"
197             for key in sorted(world_db[category][id].keys()):
198                 if not key in special_keys:
199                     x = world_db[category][id][key]
200                     argument = quote(x) if str == type(x) else str(x)
201                     string = string + key + " " + argument + "\n"
202                 elif special_keys[key]:
203                     string = string + special_keys[key](id)
204         return string
205
206     string = ""
207     for key in sorted(world_db.keys()):
208         if (not isinstance(world_db[key], dict)) and key != "MAP" and \
209            key != "WORLD_ACTIVE" and key != "SEED_MAP":
210             string = string + key + " " + str(world_db[key]) + "\n"
211     string = string + "SEED_MAP " + str(world_db["SEED_MAP"]) + "\n"
212     string = string + helper("ThingActions", "TA_ID")
213     string = string + helper("ThingTypes", "TT_ID", {"TT_CORPSE_ID": False})
214     for id in sorted(world_db["ThingTypes"].keys()):
215         string = string + "TT_ID " + str(id) + "\n" + "TT_CORPSE_ID " + \
216             str(world_db["ThingTypes"][id]["TT_CORPSE_ID"]) + "\n"
217     string = string + helper("Things", "T_ID",
218                              {"T_CARRIES": False, "carried": False,
219                               "T_MEMMAP": mapsetter("T_MEMMAP"),
220                               "T_MEMTHING": memthing, "fovmap": False,
221                               "T_MEMDEPTHMAP": mapsetter("T_MEMDEPTHMAP")})
222     for id in sorted(world_db["Things"].keys()):
223         if [] != world_db["Things"][id]["T_CARRIES"]:
224             string = string + "T_ID " + str(id) + "\n"
225             for carried in sorted(world_db["Things"][id]["T_CARRIES"].keys()):
226                 string = string + "T_CARRIES " + str(carried) + "\n"
227     string = string + "SEED_RANDOMNESS " + str(rand.seed) + "\n" + \
228         "WORLD_ACTIVE " + str(world_db["WORLD_ACTIVE"])
229     atomic_write(io_db["path_save"], string)
230
231
232 def obey_lines_in_file(path, name, do_record=False):
233     """Call obey() on each line of path's file, use name in input prefix."""
234     file = open(path, "r")
235     line_n = 1
236     for line in file.readlines():
237         obey(line.rstrip(), name + "file line " + str(line_n),
238              do_record=do_record)
239         line_n = line_n + 1
240     file.close()
241
242
243 def parse_command_line_arguments():
244     """Return settings values read from command line arguments."""
245     parser = argparse.ArgumentParser()
246     parser.add_argument('-s', nargs='?', type=int, dest='replay', const=1,
247                         action='store')
248     parser.add_argument('-l', nargs="?", const="save", dest='savefile',
249                         action="store")
250     parser.add_argument('-v', dest='verbose', action='store_true')
251     opts, unknown = parser.parse_known_args()
252     return opts
253
254
255 def server_test():
256     """Ensure valid server out file belonging to current process.
257
258     This is done by comparing io_db["teststring"] to what's found at the start
259     of the current file at io_db["path_out"]. On failure, set
260     io_db["kicked_by_rival"] and raise SystemExit.
261     """
262     if not os.access(io_db["path_out"], os.F_OK):
263         raise SystemExit("Server output file has disappeared.")
264     file = open(io_db["path_out"], "r")
265     test = file.readline().rstrip("\n")
266     file.close()
267     if test != io_db["teststring"]:
268         io_db["kicked_by_rival"] = True
269         msg = "Server test string in server output file does not match. This" \
270               " indicates that the current server process has been " \
271               "superseded by another one."
272         raise SystemExit(msg)
273
274
275 def read_command():
276     """Return next newline-delimited command from server in file.
277
278     Keep building return string until a newline is encountered. Pause between
279     unsuccessful reads, and after too much waiting, run server_test().
280     """
281     wait_on_fail = 0.03333
282     max_wait = 5
283     now = time.time()
284     command = ""
285     while True:
286         add = io_db["file_in"].readline()
287         if len(add) > 0:
288             command = command + add
289             if len(command) > 0 and "\n" == command[-1]:
290                 command = command[:-1]
291                 break
292         else:
293             time.sleep(wait_on_fail)
294             if now + max_wait < time.time():
295                 server_test()
296                 now = time.time()
297     return command
298
299
300 def try_worldstate_update():
301     """Write worldstate file if io_db["worldstate_updateable"] is set."""
302     if io_db["worldstate_updateable"]:
303
304         def draw_visible_Things(map, run):
305             for id in world_db["Things"]:
306                 type = world_db["Things"][id]["T_TYPE"]
307                 consumable = world_db["ThingTypes"][type]["TT_CONSUMABLE"]
308                 alive = world_db["ThingTypes"][type]["TT_LIFEPOINTS"]
309                 if (0 == run and not consumable and not alive) \
310                    or (1 == run and consumable and not alive) \
311                    or (2 == run and alive):
312                     y = world_db["Things"][id]["T_POSY"]
313                     x = world_db["Things"][id]["T_POSX"]
314                     fovflag = world_db["Things"][0]["fovmap"][(y * length) + x]
315                     if 'v' == chr(fovflag):
316                         c = world_db["ThingTypes"][type]["TT_SYMBOL"]
317                         map[(y * length) + x] = ord(c)
318
319         def write_map(string, map):
320             for i in range(length):
321                 line = map[i * length:(i * length) + length].decode()
322                 string = string + line + "\n"
323             return string
324
325         inventory = ""
326         if [] == world_db["Things"][0]["T_CARRIES"]:
327             inventory = "(none)\n"
328         else:
329             for id in world_db["Things"][0]["T_CARRIES"]:
330                 type_id = world_db["Things"][id]["T_TYPE"]
331                 name = world_db["ThingTypes"][type_id]["TT_NAME"]
332                 inventory = inventory + name + "\n"
333         string = str(world_db["TURN"]) + "\n" + \
334             str(world_db["Things"][0]["T_LIFEPOINTS"]) + "\n" + \
335             str(world_db["Things"][0]["T_SATIATION"]) + "\n" + \
336             inventory + "%\n" + \
337             str(world_db["Things"][0]["T_POSY"]) + "\n" + \
338             str(world_db["Things"][0]["T_POSX"]) + "\n" + \
339             str(world_db["MAP_LENGTH"]) + "\n"
340         length = world_db["MAP_LENGTH"]
341         fov = bytearray(b' ' * (length ** 2))
342         for pos in range(length ** 2):
343             if 'v' == chr(world_db["Things"][0]["fovmap"][pos]):
344                 fov[pos] = world_db["MAP"][pos]
345         for i in range(3):
346             draw_visible_Things(fov, i)
347         string = write_map(string, fov)
348         mem = world_db["Things"][0]["T_MEMMAP"][:]
349         for i in range(2):
350             for mt in world_db["Things"][0]["T_MEMTHING"]:
351                 consumable = world_db["ThingTypes"][mt[0]]["TT_CONSUMABLE"]
352                 if (i == 0 and not consumable) or (i == 1 and consumable):
353                     c = world_db["ThingTypes"][mt[0]]["TT_SYMBOL"]
354                     mem[(mt[1] * length) + mt[2]] = ord(c)
355         string = write_map(string, mem)
356         atomic_write(io_db["path_worldstate"], string, delete=False)
357         strong_write(io_db["file_out"], "WORLD_UPDATED\n")
358         io_db["worldstate_updateable"] = False
359
360
361 def replay_game():
362     """Replay game from record file.
363
364     Use opts.replay as breakpoint turn to which to replay automatically before
365     switching to manual input by non-meta commands in server input file
366     triggering further reads of record file. Ensure opts.replay is at least 1.
367     Run try_worldstate_update() before each interactive obey()/read_command().
368     """
369     if opts.replay < 1:
370         opts.replay = 1
371     print("Replay mode. Auto-replaying up to turn " + str(opts.replay) +
372           " (if so late a turn is to be found).")
373     if not os.access(io_db["path_record"], os.F_OK):
374         raise SystemExit("No record file found to replay.")
375     io_db["file_record"] = open(io_db["path_record"], "r")
376     io_db["file_record"].prefix = "record file line "
377     io_db["file_record"].line_n = 1
378     while world_db["TURN"] < opts.replay:
379         line = io_db["file_record"].readline()
380         if "" == line:
381             break
382         obey(line.rstrip(), io_db["file_record"].prefix
383              + str(io_db["file_record"].line_n))
384         io_db["file_record"].line_n = io_db["file_record"].line_n + 1
385     while True:
386         try_worldstate_update()
387         obey(read_command(), "in file", replay=True)
388
389
390 def play_game():
391     """Play game by server input file commands. Before, load save file found.
392
393     If no save file is found, a new world is generated from the commands in the
394     world config plus a 'MAKE WORLD [current Unix timestamp]'. Record this
395     command and all that follow via the server input file. Run
396     try_worldstate_update() before each interactive obey()/read_command().
397     """
398     if os.access(io_db["path_save"], os.F_OK):
399         obey_lines_in_file(io_db["path_save"], "save")
400     else:
401         if not os.access(io_db["path_worldconf"], os.F_OK):
402             msg = "No world config file from which to start a new world."
403             raise SystemExit(msg)
404         obey_lines_in_file(io_db["path_worldconf"], "world config ",
405                            do_record=True)
406         obey("MAKE_WORLD " + str(int(time.time())), "in file", do_record=True)
407     while True:
408         try_worldstate_update()
409         obey(read_command(), "in file", do_record=True)
410
411
412 def remake_map():
413     """(Re-)make island map.
414
415     Let "~" represent water, "." land, "X" trees: Build island shape randomly,
416     start with one land cell in the middle, then go into cycle of repeatedly
417     selecting a random sea cell and transforming it into land if it is neighbor
418     to land. The cycle ends when a land cell is due to be created at the map's
419     border. Then put some trees on the map (TODO: more precise algorithm desc).
420     """
421     def is_neighbor(coordinates, type):
422         y = coordinates[0]
423         x = coordinates[1]
424         length = world_db["MAP_LENGTH"]
425         ind = y % 2
426         diag_west = x + (ind > 0)
427         diag_east = x + (ind < (length - 1))
428         pos = (y * length) + x
429         if (y > 0 and diag_east
430             and type == chr(world_db["MAP"][pos - length + ind])) \
431            or (x < (length - 1)
432                and type == chr(world_db["MAP"][pos + 1])) \
433            or (y < (length - 1) and diag_east
434                and type == chr(world_db["MAP"][pos + length + ind])) \
435            or (y > 0 and diag_west
436                and type == chr(world_db["MAP"][pos - length - (not ind)])) \
437            or (x > 0
438                and type == chr(world_db["MAP"][pos - 1])) \
439            or (y < (length - 1) and diag_west
440                and type == chr(world_db["MAP"][pos + length - (not ind)])):
441             return True
442         return False
443     store_seed = rand.seed
444     rand.seed = world_db["SEED_MAP"]
445     world_db["MAP"] = bytearray(b'~' * (world_db["MAP_LENGTH"] ** 2))
446     length = world_db["MAP_LENGTH"]
447     add_half_width = (not (length % 2)) * int(length / 2)
448     world_db["MAP"][int((length ** 2) / 2) + add_half_width] = ord(".")
449     while (1):
450         y = rand.next() % length
451         x = rand.next() % length
452         pos = (y * length) + x
453         if "~" == chr(world_db["MAP"][pos]) and is_neighbor((y, x), "."):
454             if y == 0 or y == (length - 1) or x == 0 or x == (length - 1):
455                 break
456             world_db["MAP"][pos] = ord(".")
457     n_trees = int((length ** 2) / 16)
458     i_trees = 0
459     while (i_trees <= n_trees):
460         single_allowed = rand.next() % 32
461         y = rand.next() % length
462         x = rand.next() % length
463         pos = (y * length) + x
464         if "." == chr(world_db["MAP"][pos]) \
465                 and ((not single_allowed) or is_neighbor((y, x), "X")):
466             world_db["MAP"][pos] = ord("X")
467             i_trees += 1
468     rand.seed = store_seed
469     # This all-too-precise replica of the original C code misses iter_limit().
470
471
472 def update_map_memory(t, age_map=True):
473     """Update t's T_MEMMAP with what's in its FOV now,age its T_MEMMEPTHMAP."""
474     def age_some_memdepthmap_on_nonfov_cells():
475         # OUTSOURCED TO libplomrogue.so:
476         # for pos in [pos for pos in range(world_db["MAP_LENGTH"] ** 2)
477         #             if not ord_v == t["fovmap"][pos]
478         #             if ord_0 <= t["T_MEMDEPTHMAP"][pos]
479         #             if ord_9 > t["T_MEMDEPTHMAP"][pos]
480         #             if not rand.next() % (2 **
481         #                                   (t["T_MEMDEPTHMAP"][pos] - 48))]:
482         #     t["T_MEMDEPTHMAP"][pos] += 1
483         memdepthmap = c_pointer_to_bytearray(t["T_MEMDEPTHMAP"])
484         fovmap = c_pointer_to_bytearray(t["fovmap"])
485         libpr.age_some_memdepthmap_on_nonfov_cells(memdepthmap, fovmap)
486     if not t["T_MEMMAP"]:
487         t["T_MEMMAP"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
488     if not t["T_MEMDEPTHMAP"]:
489         t["T_MEMDEPTHMAP"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
490     ord_v = ord("v")
491     ord_0 = ord("0")
492     ord_space = ord(" ")
493     for pos in [pos for pos in range(world_db["MAP_LENGTH"] ** 2)
494                 if ord_v == t["fovmap"][pos]]:
495         t["T_MEMDEPTHMAP"][pos] = ord_0
496         if ord_space == t["T_MEMMAP"][pos]:
497             t["T_MEMMAP"][pos] = world_db["MAP"][pos]
498     if age_map:
499         age_some_memdepthmap_on_nonfov_cells()
500     for mt in [mt for mt in t["T_MEMTHING"]
501                if "v" == chr(t["fovmap"][(mt[1] * world_db["MAP_LENGTH"])
502                                          + mt[2]])]:
503         t["T_MEMTHING"].remove(mt)
504     for id in [id for id in world_db["Things"]
505                if not world_db["Things"][id]["carried"]]:
506         type = world_db["Things"][id]["T_TYPE"]
507         if not world_db["ThingTypes"][type]["TT_LIFEPOINTS"]:
508             y = world_db["Things"][id]["T_POSY"]
509             x = world_db["Things"][id]["T_POSX"]
510             if "v" == chr(t["fovmap"][(y * world_db["MAP_LENGTH"]) + x]):
511                 t["T_MEMTHING"].append((type, y, x))
512
513
514 def set_world_inactive():
515     """Set world_db["WORLD_ACTIVE"] to 0 and remove worldstate file."""
516     server_test()
517     if os.access(io_db["path_worldstate"], os.F_OK):
518         os.remove(io_db["path_worldstate"])
519     world_db["WORLD_ACTIVE"] = 0
520
521
522 def integer_test(val_string, min, max=None):
523     """Return val_string if integer >= min & (if max set) <= max, else None."""
524     try:
525         val = int(val_string)
526         if val < min or (max is not None and val > max):
527             raise ValueError
528         return val
529     except ValueError:
530         msg = "Ignoring: Please use integer >= " + str(min)
531         if max is not None:
532             msg += " and <= " + str(max)
533         msg += "."
534         print(msg)
535         return None
536
537
538 def setter(category, key, min, max=None):
539     """Build setter for world_db([category + "s"][id])[key] to >=min/<=max."""
540     if category is None:
541         def f(val_string):
542             val = integer_test(val_string, min, max)
543             if None != val:
544                 world_db[key] = val
545     else:
546         if category == "Thing":
547             id_store = command_tid
548             decorator = test_Thing_id
549         elif category == "ThingType":
550             id_store = command_ttid
551             decorator = test_ThingType_id
552         elif category == "ThingAction":
553             id_store = command_taid
554             decorator = test_ThingAction_id
555
556         @decorator
557         def f(val_string):
558             val = integer_test(val_string, min, max)
559             if None != val:
560                 world_db[category + "s"][id_store.id][key] = val
561     return f
562
563
564 def build_fov_map(t):
565     """Build Thing's FOV map."""
566     t["fovmap"] = bytearray(b'v' * (world_db["MAP_LENGTH"] ** 2))
567     fovmap = c_pointer_to_bytearray(t["fovmap"])
568     map = c_pointer_to_bytearray(world_db["MAP"])
569     if libpr.build_fov_map(t["T_POSY"], t["T_POSX"], fovmap, map):
570         raise RuntimeError("Malloc error in build_fov_Map().")
571
572
573 def decrement_lifepoints(t):
574     """Decrement t's lifepoints by 1, and if to zero, corpse it.
575
576     If t is the player avatar, only blank its fovmap, so that the client may
577     still display memory data. On non-player things, erase fovmap and memory.
578     """
579     t["T_LIFEPOINTS"] -= 1
580     if 0 == t["T_LIFEPOINTS"]:
581         t["T_TYPE"] = world_db["ThingTypes"][t["T_TYPE"]]["TT_CORPSE_ID"]
582         if world_db["Things"][0] == t:
583             t["fovmap"] = bytearray(b' ' * (world_db["MAP_LENGTH"] ** 2))
584             strong_write(io_db["file_out"], "LOG You die.\n")
585         else:
586             t["fovmap"] = False
587             t["T_MEMMAP"] = False
588             t["T_MEMDEPTHMAP"] = False
589             t["T_MEMTHING"] = []
590             strong_write(io_db["file_out"], "LOG It dies.\n")
591
592
593 def mv_yx_in_dir_legal(dir, y, x):
594     """Wrapper around libpr.mv_yx_in_dir_legal to simplify its use."""
595     dir_c = dir.encode("ascii")[0]
596     test = libpr.mv_yx_in_dir_legal_wrap(dir_c, y, x)
597     if -1 == test:
598         raise RuntimeError("Too much wrapping in mv_yx_in_dir_legal_wrap()!")
599     return (test, libpr.result_y(), libpr.result_x())
600
601
602 def actor_wait(t):
603     """Make t do nothing (but loudly, if player avatar)."""
604     if t == world_db["Things"][0]:
605         strong_write(io_db["file_out"], "LOG You wait.\n")
606
607
608 def actor_move(t):
609     """If passable, move/collide(=attack) thing into T_ARGUMENT's direction."""
610     passable = False
611     move_result = mv_yx_in_dir_legal(chr(t["T_ARGUMENT"]),
612                                      t["T_POSY"], t["T_POSX"])
613     if 1 == move_result[0]:
614         pos = (move_result[1] * world_db["MAP_LENGTH"]) + move_result[2]
615         passable = "." == chr(world_db["MAP"][pos])
616         hitted = [id for id in world_db["Things"]
617                   if world_db["Things"][id] != t
618                   if world_db["Things"][id]["T_LIFEPOINTS"]
619                   if world_db["Things"][id]["T_POSY"] == move_result[1]
620                   if world_db["Things"][id]["T_POSX"] == move_result[2]]
621         if len(hitted):
622             hit_id = hitted[0]
623             hitter_name = world_db["ThingTypes"][t["T_TYPE"]]["TT_NAME"]
624             hitter = "You" if t == world_db["Things"][0] else hitter_name
625             hitted_type = world_db["Things"][hit_id]["T_TYPE"]
626             hitted_name = world_db["ThingTypes"][hitted_type]["TT_NAME"]
627             hitted = "you" if hit_id == 0 else hitted_name
628             verb = " wound " if hitter == "You" else " wounds "
629             strong_write(io_db["file_out"], "LOG " + hitter + verb + hitted +
630                                             ".\n")
631             decrement_lifepoints(world_db["Things"][hit_id])
632             return
633     dir = [dir for dir in directions_db
634            if directions_db[dir] == chr(t["T_ARGUMENT"])][0]
635     if passable:
636         t["T_POSY"] = move_result[1]
637         t["T_POSX"] = move_result[2]
638         for id in t["T_CARRIES"]:
639             world_db["Things"][id]["T_POSY"] = move_result[1]
640             world_db["Things"][id]["T_POSX"] = move_result[2]
641         build_fov_map(t)
642         if t == world_db["Things"][0]:
643             strong_write(io_db["file_out"], "LOG You move " + dir + ".\n")
644     elif t == world_db["Things"][0]:
645         strong_write(io_db["file_out"], "LOG You fail to move " + dir + ".\n")
646
647
648 def actor_pick_up(t):
649     """Make t pick up (topmost?) Thing from ground into inventory."""
650     # Topmostness is actually not defined so far. Picks Thing with highest ID.
651     ids = [id for id in world_db["Things"] if world_db["Things"][id] != t
652            if not world_db["Things"][id]["carried"]
653            if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
654            if world_db["Things"][id]["T_POSX"] == t["T_POSX"]]
655     if len(ids):
656         highest_id = 0
657         for id in ids:
658             if id > highest_id:
659                 highest_id = id
660         world_db["Things"][highest_id]["carried"] = True
661         t["T_CARRIES"].append(highest_id)
662         if t == world_db["Things"][0]:
663             strong_write(io_db["file_out"], "LOG You pick up an object.\n")
664     elif t == world_db["Things"][0]:
665         err = "You try to pick up an object, but there is none."
666         strong_write(io_db["file_out"], "LOG " + err + "\n")
667
668
669 def actor_drop(t):
670     """Make t rop Thing from inventory to ground indexed by T_ARGUMENT."""
671     # TODO: Handle case where T_ARGUMENT matches nothing.
672     if len(t["T_CARRIES"]):
673         id = t["T_CARRIES"][t["T_ARGUMENT"]]
674         t["T_CARRIES"].remove(id)
675         world_db["Things"][id]["carried"] = False
676         if t == world_db["Things"][0]:
677             strong_write(io_db["file_out"], "LOG You drop an object.\n")
678     elif t == world_db["Things"][0]:
679         err = "You try to drop an object, but you own none."
680         strong_write(io_db["file_out"], "LOG " + err + "\n")
681
682
683 def actor_use(t):
684     """Make t use (for now: consume) T_ARGUMENT-indexed Thing in inventory."""
685     # TODO: Handle case where T_ARGUMENT matches nothing.
686     if len(t["T_CARRIES"]):
687         id = t["T_CARRIES"][t["T_ARGUMENT"]]
688         type = world_db["Things"][id]["T_TYPE"]
689         if world_db["ThingTypes"][type]["TT_CONSUMABLE"]:
690             t["T_CARRIES"].remove(id)
691             del world_db["Things"][id]
692             t["T_SATIATION"] += world_db["ThingTypes"][type]["TT_CONSUMABLE"]
693             if t == world_db["Things"][0]:
694                 strong_write(io_db["file_out"],
695                              "LOG You consume this object.\n")
696         elif t == world_db["Things"][0]:
697             strong_write(io_db["file_out"],
698                          "LOG You try to use this object, but fail.\n")
699     elif t == world_db["Things"][0]:
700         strong_write(io_db["file_out"],
701                      "LOG You try to use an object, but you own none.\n")
702
703
704 def thingproliferation(t):
705     """To chance of 1/TT_PROLIFERATE, create t offspring in neighbor cell.
706
707     Naturally only works with TT_PROLIFERATE > 0. The neighbor cell must be
708     passable and not be inhabited by a Thing of the same type, or, if Thing is
709     animate, any other animate Thing. If there are several map cell candidates,
710     one is selected randomly.
711     """
712     def test_cell(t, y, x):
713         if "." == chr(world_db["MAP"][(y * world_db["MAP_LENGTH"]) + x]):
714             for id in [id for id in world_db["Things"]
715                        if y == world_db["Things"][id]["T_POSY"]
716                        if x == world_db["Things"][id]["T_POSX"]
717                        if (t["T_TYPE"] == world_db["Things"][id]["T_TYPE"])
718                        or (t["T_LIFEPOINTS"] and
719                            world_db["Things"][id]["T_LIFEPOINTS"])]:
720                 return False
721             return True
722         return False
723     prolscore = world_db["ThingTypes"][t["T_TYPE"]]["TT_PROLIFERATE"]
724     if prolscore and (1 == prolscore or 1 == (rand.next() % prolscore)):
725         candidates = []
726         for dir in [directions_db[key] for key in directions_db]:
727             mv_result = mv_yx_in_dir_legal(dir, t["T_POSY"], t["T_POSX"])
728             if mv_result[0] and test_cell(t, mv_result[1], mv_result[2]):
729                 candidates.append((mv_result[1], mv_result[2]))
730         if len(candidates):
731             i = rand.next() % len(candidates)
732             id = id_setter(-1, "Things")
733             newT = new_Thing(t["T_TYPE"], (candidates[i][0], candidates[i][1]))
734             world_db["Things"][id] = newT
735
736
737 def try_healing(t):
738     """Grow t's HP to a 1/32 chance if < HP max, satiation > 0, and waiting.
739
740     On success, decrease satiation score by 32.
741     """
742     if t["T_SATIATION"] > 0 \
743        and t["T_LIFEPOINTS"] < \
744         world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"] \
745        and 0 == (rand.next() % 31) \
746        and t["T_COMMAND"] == [id for id in world_db["ThingActions"]
747                               if world_db["ThingActions"][id]["TA_NAME"] ==
748                               "wait"][0]:
749         t["T_LIFEPOINTS"] += 1
750         t["T_SATIATION"] -= 32
751         if t == world_db["Things"][0]:
752             strong_write(io_db["file_out"], "LOG You heal.\n")
753         else:
754             name = world_db["ThingTypes"][t["T_TYPE"]]["TT_NAME"]
755             strong_write(io_db["file_out"], "LOG " + name + "heals.\n")
756
757
758 def hunger(t):
759     """Decrement t's satiation,dependent on it trigger lifepoint dec chance."""
760     if t["T_SATIATION"] > -32768:
761         t["T_SATIATION"] -= 1
762     testbase = t["T_SATIATION"] if t["T_SATIATION"] >= 0 else -t["T_SATIATION"]
763     if not world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"]:
764         raise RuntimeError("A thing that should not hunger is hungering.")
765     stomach = int(32767 / world_db["ThingTypes"][t["T_TYPE"]]["TT_LIFEPOINTS"])
766     if int(int(testbase / stomach) / ((rand.next() % stomach) + 1)):
767         if t == world_db["Things"][0]:
768             strong_write(io_db["file_out"], "LOG You suffer from hunger.\n")
769         else:
770             name = world_db["ThingTypes"][t["T_TYPE"]]["TT_NAME"]
771             strong_write(io_db["file_out"], "LOG " + name +
772                                             " suffers from hunger.\n")
773         decrement_lifepoints(t)
774
775
776 def get_dir_to_target(t, filter):
777     """Try to set T_COMMAND/T_ARGUMENT for move to "filter"-determined target.
778
779     The path-wise nearest target is chosen, via the shortest available path.
780     Target must not be t. On succcess, return positive value, else False.
781     Filters:
782     "a": Thing in FOV is below a certain distance, animate, but of ThingType
783          that is not t's, and starts out weaker than t is; build path as
784          avoiding things of t's ThingType
785     "f": neighbor cell (not inhabited by any animate Thing) further away from
786          animate Thing not further than x steps away and in FOV and of a
787          ThingType that is not t's, and starts out stronger or as strong as t
788          is currently; or (cornered), if no such flight cell, but Thing of
789          above criteria is too near,1 a cell closer to it, or, if less near,
790          just wait
791     "c": Thing in memorized map is consumable
792     "s": memory map cell with greatest-reachable degree of unexploredness
793     """
794
795     def zero_score_map_where_char_on_memdepthmap(c):
796         # OUTSOURCED TO libplomrogue.so:
797         # for i in [i for i in range(world_db["MAP_LENGTH"] ** 2)
798         #           if t["T_MEMDEPTHMAP"][i] == mem_depth_c[0]]:
799         #     set_map_score(i, 0)
800         map = c_pointer_to_bytearray(t["T_MEMDEPTHMAP"])
801         if libpr.zero_score_map_where_char_on_memdepthmap(c, map):
802             raise RuntimeError("No score map allocated for "
803                                "zero_score_map_where_char_on_memdepthmap().")
804
805     def set_map_score(pos, score):
806         test = libpr.set_map_score(pos, score)
807         if test:
808             raise RuntimeError("No score map allocated for set_map_score().")
809
810     def get_map_score(pos):
811         result = libpr.get_map_score(pos)
812         if result < 0:
813             raise RuntimeError("No score map allocated for get_map_score().")
814         return result
815
816     def seeing_thing():
817         if t["fovmap"] and ("a" == filter or "f" == filter):
818             for id in world_db["Things"]:
819                 Thing = world_db["Things"][id]
820                 if Thing != t and Thing["T_LIFEPOINTS"] and \
821                    t["T_TYPE"] != Thing["T_TYPE"] and \
822                    'v' == chr(t["fovmap"][(Thing["T_POSY"]
823                                           * world_db["MAP_LENGTH"])
824                                           + Thing["T_POSX"]]):
825                     ThingType = world_db["ThingTypes"][Thing["T_TYPE"]]
826                     if ("f" == filter and ThingType["TT_LIFEPOINTS"] >=
827                         t["T_LIFEPOINTS"]) \
828                        or ("a" == filter and ThingType["TT_LIFEPOINTS"] <
829                             t["T_LIFEPOINTS"]):
830                         return True
831         elif t["T_MEMMAP"] and "c" == filter:
832             for mt in t["T_MEMTHING"]:
833                 if ' ' != chr(t["T_MEMMAP"][(mt[1] * world_db["MAP_LENGTH"])
834                                             + mt[2]]) \
835                    and world_db["ThingTypes"][mt[0]]["TT_CONSUMABLE"]:
836                     return True
837         return False
838
839     def set_cells_passable_on_memmap_to_65534_on_scoremap():
840         # OUTSOURCED TO libplomrogue.so:
841         # ord_dot = ord(".")
842         # memmap = t["T_MEMMAP"]
843         # for i in [i for i in range(world_db["MAP_LENGTH"] ** 2)
844         #            if ord_dot == memmap[i]]:
845         #     set_map_score(i, 65534) # i.e. 65535-1
846         map = c_pointer_to_bytearray(t["T_MEMMAP"])
847         if libpr.set_cells_passable_on_memmap_to_65534_on_scoremap(map):
848             raise RuntimeError("No score map allocated for set_cells_passable"
849                                "_on_memmap_to_65534_on_scoremap().")
850
851     def init_score_map():
852         test = libpr.init_score_map()
853         if test:
854             raise RuntimeError("Malloc error in init_score_map().")
855         ord_v = ord("v")
856         ord_blank = ord(" ")
857         set_cells_passable_on_memmap_to_65534_on_scoremap()
858         if "a" == filter:
859             for id in world_db["Things"]:
860                 Thing = world_db["Things"][id]
861                 pos = Thing["T_POSY"] * world_db["MAP_LENGTH"] \
862                     + Thing["T_POSX"]
863                 if t != Thing and Thing["T_LIFEPOINTS"] and \
864                    t["T_TYPE"] != Thing["T_TYPE"] and \
865                    ord_v == t["fovmap"][pos] and \
866                    t["T_LIFEPOINTS"] > \
867                    world_db["ThingTypes"][Thing["T_TYPE"]]["TT_LIFEPOINTS"]:
868                     set_map_score(pos, 0)
869                 elif t["T_TYPE"] == Thing["T_TYPE"]:
870                     set_map_score(pos, 65535)
871         elif "f" == filter:
872             for id in [id for id in world_db["Things"]
873                        if world_db["Things"][id]["T_LIFEPOINTS"]]:
874                 Thing = world_db["Things"][id]
875                 pos = Thing["T_POSY"] * world_db["MAP_LENGTH"] \
876                     + Thing["T_POSX"]
877                 if t["T_TYPE"] != Thing["T_TYPE"] and \
878                    ord_v == t["fovmap"][pos] and \
879                    t["T_LIFEPOINTS"] <= \
880                    world_db["ThingTypes"][Thing["T_TYPE"]]["TT_LIFEPOINTS"]:
881                     set_map_score(pos, 0)
882         elif "c" == filter:
883             for mt in [mt for mt in t["T_MEMTHING"]
884                        if ord_blank != t["T_MEMMAP"][mt[1]
885                                                      * world_db["MAP_LENGTH"]
886                                                      + mt[2]]
887                        if world_db["ThingTypes"][mt[0]]["TT_CONSUMABLE"]]:
888                 set_map_score(mt[1] * world_db["MAP_LENGTH"] + mt[2], 0)
889         elif "s" == filter:
890             zero_score_map_where_char_on_memdepthmap(mem_depth_c[0])
891
892     def rand_target_dir(neighbors, cmp, dirs):
893         candidates = []
894         n_candidates = 0
895         for i in range(len(dirs)):
896             if cmp == neighbors[i]:
897                 candidates.append(dirs[i])
898                 n_candidates += 1
899         return candidates[rand.next() % n_candidates] if n_candidates else 0
900
901     def get_neighbor_scores(dirs, eye_pos):
902         scores = []
903         if libpr.ready_neighbor_scores(eye_pos):
904             raise RuntimeError("No score map allocated for " +
905                                "ready_neighbor_scores.()")
906         for i in range(len(dirs)):
907             scores.append(libpr.get_neighbor_score(i))
908         return scores
909
910     def get_dir_from_neighbors():
911         dir_to_target = False
912         dirs = "edcxsw"
913         eye_pos = t["T_POSY"] * world_db["MAP_LENGTH"] + t["T_POSX"]
914         neighbors = get_neighbor_scores(dirs, eye_pos)
915         if "f" == filter:
916             inhabited = [world_db["Things"][id]["T_POSY"]
917                          * world_db["MAP_LENGTH"]
918                          + world_db["Things"][id]["T_POSX"]
919                          for id in world_db["Things"]
920                          if world_db["Things"][id]["T_LIFEPOINTS"]]
921             for i in range(len(dirs)):
922                 mv_yx_in_dir_legal(dirs[i], t["T_POSY"], t["T_POSX"])
923                 pos_cmp = libpr.result_y() * world_db["MAP_LENGTH"] \
924                     + libpr.result_x()
925                 for pos in [pos for pos in inhabited if pos == pos_cmp]:
926                     neighbors[i] = 65535
927                     break
928         minmax_start = 0 if "f" == filter else 65535 - 1
929         minmax_neighbor = minmax_start
930         for i in range(len(dirs)):
931             if ("f" == filter and get_map_score(eye_pos) < neighbors[i] and
932                 minmax_neighbor < neighbors[i] and 65535 != neighbors[i]) \
933                or ("f" != filter and minmax_neighbor > neighbors[i]):
934                 minmax_neighbor = neighbors[i]
935         if minmax_neighbor != minmax_start:
936             dir_to_target = rand_target_dir(neighbors, minmax_neighbor, dirs)
937         if "f" == filter:
938             if not dir_to_target:
939                 if 1 == get_map_score(eye_pos):
940                     dir_to_target = rand_target_dir(neighbors, 0, dirs)
941                 elif 3 >= get_map_score(eye_pos):
942                     t["T_COMMAND"] = [id for id in world_db["ThingActions"]
943                                       if
944                                       world_db["ThingActions"][id]["TA_NAME"]
945                                       == "wait"][0]
946                     return 1
947             elif dir_to_target and 3 < get_map_score(eye_pos):
948                 dir_to_target = 0
949         elif "a" == filter and 10 <= get_map_score(eye_pos):
950             dir_to_target = 0
951         return dir_to_target
952
953     dir_to_target = False
954     mem_depth_c = b' '
955     run_i = 9 + 1 if "s" == filter else 1
956     while run_i and not dir_to_target and ("s" == filter or seeing_thing()):
957         run_i -= 1
958         init_score_map()
959         mem_depth_c = b'9' if b' ' == mem_depth_c \
960             else bytes([mem_depth_c[0] - 1])
961         if libpr.dijkstra_map():
962             raise RuntimeError("No score map allocated for dijkstra_map().")
963         dir_to_target = get_dir_from_neighbors()
964         libpr.free_score_map()
965         if dir_to_target and str == type(dir_to_target):
966             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
967                               if world_db["ThingActions"][id]["TA_NAME"]
968                               == "move"][0]
969             t["T_ARGUMENT"] = ord(dir_to_target)
970     return dir_to_target
971
972
973 def standing_on_consumable(t):
974     """Return True/False whether t is standing on a consumable."""
975     for id in [id for id in world_db["Things"] if world_db["Things"][id] != t
976                if world_db["Things"][id]["T_POSY"] == t["T_POSY"]
977                if world_db["Things"][id]["T_POSX"] == t["T_POSX"]
978                if world_db["ThingTypes"][world_db["Things"][id]["T_TYPE"]]
979                           ["TT_CONSUMABLE"]]:
980         return True
981     return False
982
983
984 def get_inventory_slot_to_consume(t):
985     """Return slot Id of strongest consumable in t's inventory, else -1."""
986     cmp_consumability = 0
987     selection = -1
988     i = 0
989     for id in t["T_CARRIES"]:
990         type = world_db["Things"][id]["T_TYPE"]
991         if world_db["ThingTypes"][type]["TT_CONSUMABLE"] > cmp_consumability:
992             cmp_consumability = world_db["ThingTypes"][type]["TT_CONSUMABLE"]
993             selection = i
994         i += 1
995     return selection
996
997
998 def ai(t):
999     """Determine next command/argment for actor t via AI algorithms.
1000
1001     AI will look for, and move towards, enemies (animate Things not of their
1002     own ThingType); if they see none, they will consume consumables in their
1003     inventory; if there are none, they will pick up what they stand on if they
1004     stand on consumables; if they stand on none, they will move towards the
1005     next consumable they see or remember on the map; if they see or remember
1006     none, they will explore parts of the map unseen since ever or for at least
1007     one turn; if there is nothing to explore, they will simply wait.
1008     """
1009     t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1010                       if world_db["ThingActions"][id]["TA_NAME"] == "wait"][0]
1011     if not get_dir_to_target(t, "f"):
1012         sel = get_inventory_slot_to_consume(t)
1013         if -1 != sel:
1014             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1015                               if world_db["ThingActions"][id]["TA_NAME"]
1016                               == "use"][0]
1017             t["T_ARGUMENT"] = sel
1018         elif standing_on_consumable(t):
1019             t["T_COMMAND"] = [id for id in world_db["ThingActions"]
1020                               if world_db["ThingActions"][id]["TA_NAME"]
1021                               == "pick_up"][0]
1022         elif (not get_dir_to_target(t, "c")) and \
1023              (not get_dir_to_target(t, "a")):
1024             get_dir_to_target(t, "s")
1025
1026
1027 def turn_over():
1028     """Run game world and its inhabitants until new player input expected."""
1029     id = 0
1030     whilebreaker = False
1031     while world_db["Things"][0]["T_LIFEPOINTS"]:
1032         for id in [id for id in world_db["Things"]]:  # Only what's from start!
1033             if not id in world_db["Things"] or \
1034                world_db["Things"][id]["carried"]:   # May have been consumed or
1035                 continue                            # picked up during turn …
1036             Thing = world_db["Things"][id]
1037             if Thing["T_LIFEPOINTS"]:
1038                 if not Thing["T_COMMAND"]:
1039                     update_map_memory(Thing)
1040                     if 0 == id:
1041                         whilebreaker = True
1042                         break
1043                     ai(Thing)
1044                 try_healing(Thing)
1045                 Thing["T_PROGRESS"] += 1
1046                 taid = [a for a in world_db["ThingActions"]
1047                         if a == Thing["T_COMMAND"]][0]
1048                 ThingAction = world_db["ThingActions"][taid]
1049                 if Thing["T_PROGRESS"] == ThingAction["TA_EFFORT"]:
1050                     eval("actor_" + ThingAction["TA_NAME"])(Thing)
1051                     Thing["T_COMMAND"] = 0
1052                     Thing["T_PROGRESS"] = 0
1053                 hunger(Thing)
1054             thingproliferation(Thing)
1055         if whilebreaker:
1056             break
1057         world_db["TURN"] += 1
1058
1059
1060 def new_Thing(type, pos=(0, 0)):
1061     """Return Thing of type T_TYPE, with fovmap if alive and world active."""
1062     thing = {
1063         "T_LIFEPOINTS": world_db["ThingTypes"][type]["TT_LIFEPOINTS"],
1064         "T_ARGUMENT": 0,
1065         "T_PROGRESS": 0,
1066         "T_SATIATION": 0,
1067         "T_COMMAND": 0,
1068         "T_TYPE": type,
1069         "T_POSY": pos[0],
1070         "T_POSX": pos[1],
1071         "T_CARRIES": [],
1072         "carried": False,
1073         "T_MEMTHING": [],
1074         "T_MEMMAP": False,
1075         "T_MEMDEPTHMAP": False,
1076         "fovmap": False
1077     }
1078     if world_db["WORLD_ACTIVE"] and thing["T_LIFEPOINTS"]:
1079         build_fov_map(thing)
1080     return thing
1081
1082
1083 def id_setter(id, category, id_store=False, start_at_1=False):
1084     """Set ID of object of category to manipulate ID unused? Create new one.
1085     The ID is stored as id_store.id (if id_store is set). If the integer of the
1086     input is valid (if start_at_1, >= 0, else >= -1), but <0 or (if start_at_1)
1087     <1, calculate new ID: lowest unused ID >=0 or (if start_at_1) >= 1. None is
1088     always returned when no new object is created, else the new object's ID.
1089     """
1090     min = 0 if start_at_1 else -1
1091     if str == type(id):
1092         id = integer_test(id, min)
1093     if None != id:
1094         if id in world_db[category]:
1095             if id_store:
1096                 id_store.id = id
1097             return None
1098         else:
1099             if (start_at_1 and 0 == id) \
1100                or ((not start_at_1) and (id < 0)):
1101                 id = 0 if start_at_1 else -1
1102                 while 1:
1103                     id = id + 1
1104                     if id not in world_db[category]:
1105                         break
1106             if id_store:
1107                 id_store.id = id
1108     return id
1109
1110
1111 def command_ping():
1112     """Send PONG line to server output file."""
1113     strong_write(io_db["file_out"], "PONG\n")
1114
1115
1116 def command_quit():
1117     """Abort server process."""
1118     save_world()
1119     atomic_write(io_db["path_record"], io_db["record_chunk"], do_append=True)
1120     raise SystemExit("received QUIT command")
1121
1122
1123 def command_thingshere(str_y, str_x):
1124     """Write to out file list of Things known to player at coordinate y, x."""
1125     if world_db["WORLD_ACTIVE"]:
1126         y = integer_test(str_y, 0, 255)
1127         x = integer_test(str_x, 0, 255)
1128         length = world_db["MAP_LENGTH"]
1129         if None != y and None != x and y < length and x < length:
1130             pos = (y * world_db["MAP_LENGTH"]) + x
1131             strong_write(io_db["file_out"], "THINGS_HERE START\n")
1132             if "v" == chr(world_db["Things"][0]["fovmap"][pos]):
1133                 for id in world_db["Things"]:
1134                     if y == world_db["Things"][id]["T_POSY"] \
1135                        and x == world_db["Things"][id]["T_POSX"] \
1136                        and not world_db["Things"][id]["carried"]:
1137                         type = world_db["Things"][id]["T_TYPE"]
1138                         name = world_db["ThingTypes"][type]["TT_NAME"]
1139                         strong_write(io_db["file_out"], name + "\n")
1140             else:
1141                 for mt in world_db["Things"][0]["T_MEMTHING"]:
1142                     if y == mt[1] and x == mt[2]:
1143                         name = world_db["ThingTypes"][mt[0]]["TT_NAME"]
1144                         strong_write(io_db["file_out"], name + "\n")
1145             strong_write(io_db["file_out"], "THINGS_HERE END\n")
1146         else:
1147             print("Ignoring: Invalid map coordinates.")
1148     else:
1149         print("Ignoring: Command only works on existing worlds.")
1150
1151
1152 def play_commander(action, args=False):
1153     """Setter for player's T_COMMAND and T_ARGUMENT, then calling turn_over().
1154
1155     T_ARGUMENT is set to direction char if action=="wait",or 8-bit int if args.
1156     """
1157
1158     def set_command():
1159         id = [x for x in world_db["ThingActions"]
1160               if world_db["ThingActions"][x]["TA_NAME"] == action][0]
1161         world_db["Things"][0]["T_COMMAND"] = id
1162         turn_over()
1163
1164     def set_command_and_argument_int(str_arg):
1165         val = integer_test(str_arg, 0, 255)
1166         if None != val:
1167             world_db["Things"][0]["T_ARGUMENT"] = val
1168             set_command()
1169
1170     def set_command_and_argument_movestring(str_arg):
1171         if str_arg in directions_db:
1172             world_db["Things"][0]["T_ARGUMENT"] = ord(directions_db[str_arg])
1173             set_command()
1174         else:
1175             print("Ignoring: Argument must be valid direction string.")
1176
1177     if action == "move":
1178         return set_command_and_argument_movestring
1179     elif args:
1180         return set_command_and_argument_int
1181     else:
1182         return set_command
1183
1184
1185 def command_seedrandomness(seed_string):
1186     """Set rand seed to int(seed_string)."""
1187     val = integer_test(seed_string, 0, 4294967295)
1188     if None != val:
1189         rand.seed = val
1190
1191
1192 def command_seedmap(seed_string):
1193     """Set world_db["SEED_MAP"] to int(seed_string), then (re-)make map."""
1194     setter(None, "SEED_MAP", 0, 4294967295)(seed_string)
1195     remake_map()
1196
1197
1198 def command_makeworld(seed_string):
1199     """(Re-)build game world, i.e. map, things, to a new turn 1 from seed.
1200
1201     Seed rand with seed, fill it into world_db["SEED_MAP"]. Do more only with a
1202     "wait" ThingAction and world["PLAYER_TYPE"] matching ThingType of
1203     TT_START_NUMBER > 0. Then, world_db["Things"] emptied, call remake_map()
1204     and set world_db["WORLD_ACTIVE"], world_db["TURN"] to 1. Build new Things
1205     according to ThingTypes' TT_START_NUMBERS, with Thing of ID 0 to ThingType
1206     of ID = world["PLAYER_TYPE"]. Place Things randomly, and actors not on each
1207     other. Init player's memory map. Write "NEW_WORLD" line to out file.
1208     """
1209
1210     def free_pos():
1211         i = 0
1212         while 1:
1213             err = "Space to put thing on too hard to find. Map too small?"
1214             while 1:
1215                 y = rand.next() % world_db["MAP_LENGTH"]
1216                 x = rand.next() % world_db["MAP_LENGTH"]
1217                 if "." == chr(world_db["MAP"][y * world_db["MAP_LENGTH"] + x]):
1218                     break
1219                 i += 1
1220                 if i == 65535:
1221                     raise SystemExit(err)
1222             # Replica of C code, wrongly ignores animatedness of new Thing.
1223             pos_clear = (0 == len([id for id in world_db["Things"]
1224                                    if world_db["Things"][id]["T_LIFEPOINTS"]
1225                                    if world_db["Things"][id]["T_POSY"] == y
1226                                    if world_db["Things"][id]["T_POSX"] == x]))
1227             if pos_clear:
1228                 break
1229         return (y, x)
1230
1231     val = integer_test(seed_string, 0, 4294967295)
1232     if None == val:
1233         return
1234     rand.seed = val
1235     world_db["SEED_MAP"] = val
1236     player_will_be_generated = False
1237     playertype = world_db["PLAYER_TYPE"]
1238     for ThingType in world_db["ThingTypes"]:
1239         if playertype == ThingType:
1240             if 0 < world_db["ThingTypes"][ThingType]["TT_START_NUMBER"]:
1241                 player_will_be_generated = True
1242             break
1243     if not player_will_be_generated:
1244         print("Ignoring beyond SEED_MAP: " +
1245               "No player type with start number >0 defined.")
1246         return
1247     wait_action = False
1248     for ThingAction in world_db["ThingActions"]:
1249         if "wait" == world_db["ThingActions"][ThingAction]["TA_NAME"]:
1250             wait_action = True
1251     if not wait_action:
1252         print("Ignoring beyond SEED_MAP: " +
1253               "No thing action with name 'wait' defined.")
1254         return
1255     world_db["Things"] = {}
1256     remake_map()
1257     world_db["WORLD_ACTIVE"] = 1
1258     world_db["TURN"] = 1
1259     for i in range(world_db["ThingTypes"][playertype]["TT_START_NUMBER"]):
1260         id = id_setter(-1, "Things")
1261         world_db["Things"][id] = new_Thing(playertype, free_pos())
1262     update_map_memory(world_db["Things"][0])
1263     for type in world_db["ThingTypes"]:
1264         for i in range(world_db["ThingTypes"][type]["TT_START_NUMBER"]):
1265             if type != playertype:
1266                 id = id_setter(-1, "Things")
1267                 world_db["Things"][id] = new_Thing(type, free_pos())
1268     strong_write(io_db["file_out"], "NEW_WORLD\n")
1269
1270
1271 def command_maplength(maplength_string):
1272     """Redefine map length. Invalidate map, therefore lose all things on it."""
1273     val = integer_test(maplength_string, 1, 256)
1274     if None != val:
1275         world_db["MAP_LENGTH"] = val
1276         set_world_inactive()
1277         world_db["Things"] = {}
1278         libpr.set_maplength(val)
1279
1280
1281 def command_worldactive(worldactive_string):
1282     """Toggle world_db["WORLD_ACTIVE"] if possible.
1283
1284     An active world can always be set inactive. An inactive world can only be
1285     set active with a "wait" ThingAction, and a player Thing (of ID 0). On
1286     activation, rebuild all Things' FOVs, and the player's map memory.
1287     """
1288     # In original version, map existence was also tested (unnecessarily?).
1289     val = integer_test(worldactive_string, 0, 1)
1290     if val:
1291         if 0 != world_db["WORLD_ACTIVE"]:
1292             if 0 == val:
1293                 set_world_inactive()
1294             else:
1295                 print("World already active.")
1296         elif 0 == world_db["WORLD_ACTIVE"]:
1297             wait_exists = False
1298             for ThingAction in world_db["ThingActions"]:
1299                 if "wait" == world_db["ThingActions"][ThingAction]["TA_NAME"]:
1300                     wait_exists = True
1301                     break
1302             player_exists = False
1303             for Thing in world_db["Things"]:
1304                 if 0 == Thing:
1305                     player_exists = True
1306                     break
1307             if wait_exists and player_exists:
1308                 for id in world_db["Things"]:
1309                     if world_db["Things"][id]["T_LIFEPOINTS"]:
1310                         build_fov_map(world_db["Things"][id])
1311                         if 0 == id:
1312                             update_map_memory(world_db["Things"][id], False)
1313                 world_db["WORLD_ACTIVE"] = 1
1314
1315
1316 def test_for_id_maker(object, category):
1317     """Return decorator testing for object having "id" attribute."""
1318     def decorator(f):
1319         def helper(*args):
1320             if hasattr(object, "id"):
1321                 f(*args)
1322             else:
1323                 print("Ignoring: No " + category +
1324                       " defined to manipulate yet.")
1325         return helper
1326     return decorator
1327
1328
1329 def command_tid(id_string):
1330     """Set ID of Thing to manipulate. ID unused? Create new one.
1331
1332     Default new Thing's type to the first available ThingType, others: zero.
1333     """
1334     id = id_setter(id_string, "Things", command_tid)
1335     if None != id:
1336         if world_db["ThingTypes"] == {}:
1337             print("Ignoring: No ThingType to settle new Thing in.")
1338             return
1339         type = list(world_db["ThingTypes"].keys())[0]
1340         world_db["Things"][id] = new_Thing(type)
1341
1342
1343 test_Thing_id = test_for_id_maker(command_tid, "Thing")
1344
1345
1346 @test_Thing_id
1347 def command_tcommand(str_int):
1348     """Set T_COMMAND of selected Thing."""
1349     val = integer_test(str_int, 0)
1350     if None != val:
1351         if 0 == val or val in world_db["ThingActions"]:
1352             world_db["Things"][command_tid.id]["T_COMMAND"] = val
1353         else:
1354             print("Ignoring: ThingAction ID belongs to no known ThingAction.")
1355
1356
1357 @test_Thing_id
1358 def command_ttype(str_int):
1359     """Set T_TYPE of selected Thing."""
1360     val = integer_test(str_int, 0)
1361     if None != val:
1362         if val in world_db["ThingTypes"]:
1363             world_db["Things"][command_tid.id]["T_TYPE"] = val
1364         else:
1365             print("Ignoring: ThingType ID belongs to no known ThingType.")
1366
1367
1368 @test_Thing_id
1369 def command_tcarries(str_int):
1370     """Append int(str_int) to T_CARRIES of selected Thing.
1371
1372     The ID int(str_int) must not be of the selected Thing, and must belong to a
1373     Thing with unset "carried" flag. Its "carried" flag will be set on owning.
1374     """
1375     val = integer_test(str_int, 0)
1376     if None != val:
1377         if val == command_tid.id:
1378             print("Ignoring: Thing cannot carry itself.")
1379         elif val in world_db["Things"] \
1380                 and not world_db["Things"][val]["carried"]:
1381             world_db["Things"][command_tid.id]["T_CARRIES"].append(val)
1382             world_db["Things"][val]["carried"] = True
1383         else:
1384             print("Ignoring: Thing not available for carrying.")
1385     # Note that the whole carrying structure is different from the C version:
1386     # Carried-ness is marked by a "carried" flag, not by Things containing
1387     # Things internally.
1388
1389
1390 @test_Thing_id
1391 def command_tmemthing(str_t, str_y, str_x):
1392     """Add (int(str_t), int(str_y), int(str_x)) to selected Thing's T_MEMTHING.
1393
1394     The type must fit to an existing ThingType, and the position into the map.
1395     """
1396     type = integer_test(str_t, 0)
1397     posy = integer_test(str_y, 0, 255)
1398     posx = integer_test(str_x, 0, 255)
1399     if None != type and None != posy and None != posx:
1400         if type not in world_db["ThingTypes"] \
1401            or posy >= world_db["MAP_LENGTH"] or posx >= world_db["MAP_LENGTH"]:
1402             print("Ignoring: Illegal value for thing type or position.")
1403         else:
1404             memthing = (type, posy, posx)
1405             world_db["Things"][command_tid.id]["T_MEMTHING"].append(memthing)
1406
1407
1408 def setter_map(maptype):
1409     """Set selected Thing's map of maptype's int(str_int)-th line to mapline.
1410
1411     If Thing has no map of maptype yet, initialize it with ' ' bytes first.
1412     """
1413     @test_Thing_id
1414     def helper(str_int, mapline):
1415         val = integer_test(str_int, 0, 255)
1416         if None != val:
1417             if val >= world_db["MAP_LENGTH"]:
1418                 print("Illegal value for map line number.")
1419             elif len(mapline) != world_db["MAP_LENGTH"]:
1420                 print("Map line length is unequal map width.")
1421             else:
1422                 length = world_db["MAP_LENGTH"]
1423                 map = None
1424                 if not world_db["Things"][command_tid.id][maptype]:
1425                     map = bytearray(b' ' * (length ** 2))
1426                 else:
1427                     map = world_db["Things"][command_tid.id][maptype]
1428                 map[val * length:(val * length) + length] = mapline.encode()
1429                 world_db["Things"][command_tid.id][maptype] = map
1430     return helper
1431
1432
1433 def setter_tpos(axis):
1434     """Generate setter for T_POSX or  T_POSY of selected Thing.
1435
1436     If world is active, rebuilds animate things' fovmap, player's memory map.
1437     """
1438     @test_Thing_id
1439     def helper(str_int):
1440         val = integer_test(str_int, 0, 255)
1441         if None != val:
1442             if val < world_db["MAP_LENGTH"]:
1443                 world_db["Things"][command_tid.id]["T_POS" + axis] = val
1444                 if world_db["WORLD_ACTIVE"] \
1445                    and world_db["Things"][command_tid.id]["T_LIFEPOINTS"]:
1446                     build_fov_map(world_db["Things"][command_tid.id])
1447                     if 0 == command_tid.id:
1448                         update_map_memory(world_db["Things"][command_tid.id])
1449             else:
1450                 print("Ignoring: Position is outside of map.")
1451     return helper
1452
1453
1454 def command_ttid(id_string):
1455     """Set ID of ThingType to manipulate. ID unused? Create new one.
1456
1457     Default new ThingType's TT_SYMBOL to "?", TT_CORPSE_ID to self, others: 0.
1458     """
1459     id = id_setter(id_string, "ThingTypes", command_ttid)
1460     if None != id:
1461         world_db["ThingTypes"][id] = {
1462             "TT_NAME": "(none)",
1463             "TT_CONSUMABLE": 0,
1464             "TT_LIFEPOINTS": 0,
1465             "TT_PROLIFERATE": 0,
1466             "TT_START_NUMBER": 0,
1467             "TT_SYMBOL": "?",
1468             "TT_CORPSE_ID": id
1469         }
1470
1471
1472 test_ThingType_id = test_for_id_maker(command_ttid, "ThingType")
1473
1474
1475 @test_ThingType_id
1476 def command_ttname(name):
1477     """Set TT_NAME of selected ThingType."""
1478     world_db["ThingTypes"][command_ttid.id]["TT_NAME"] = name
1479
1480
1481 @test_ThingType_id
1482 def command_ttsymbol(char):
1483     """Set TT_SYMBOL of selected ThingType. """
1484     if 1 == len(char):
1485         world_db["ThingTypes"][command_ttid.id]["TT_SYMBOL"] = char
1486     else:
1487         print("Ignoring: Argument must be single character.")
1488
1489
1490 @test_ThingType_id
1491 def command_ttcorpseid(str_int):
1492     """Set TT_CORPSE_ID of selected ThingType."""
1493     val = integer_test(str_int, 0)
1494     if None != val:
1495         if val in world_db["ThingTypes"]:
1496             world_db["ThingTypes"][command_ttid.id]["TT_CORPSE_ID"] = val
1497         else:
1498             print("Ignoring: Corpse ID belongs to no known ThignType.")
1499
1500
1501 def command_taid(id_string):
1502     """Set ID of ThingAction to manipulate. ID unused? Create new one.
1503
1504     Default new ThingAction's TA_EFFORT to 1, its TA_NAME to "wait".
1505     """
1506     id = id_setter(id_string, "ThingActions", command_taid, True)
1507     if None != id:
1508         world_db["ThingActions"][id] = {
1509             "TA_EFFORT": 1,
1510             "TA_NAME": "wait"
1511         }
1512
1513
1514 test_ThingAction_id = test_for_id_maker(command_taid, "ThingAction")
1515
1516
1517 @test_ThingAction_id
1518 def command_taname(name):
1519     """Set TA_NAME of selected ThingAction.
1520
1521     The name must match a valid thing action function. If after the name
1522     setting no ThingAction with name "wait" remains, call set_world_inactive().
1523     """
1524     if name == "wait" or name == "move" or name == "use" or name == "drop" \
1525        or name == "pick_up":
1526         world_db["ThingActions"][command_taid.id]["TA_NAME"] = name
1527         if 1 == world_db["WORLD_ACTIVE"]:
1528             wait_defined = False
1529             for id in world_db["ThingActions"]:
1530                 if "wait" == world_db["ThingActions"][id]["TA_NAME"]:
1531                     wait_defined = True
1532                     break
1533             if not wait_defined:
1534                 set_world_inactive()
1535     else:
1536         print("Ignoring: Invalid action name.")
1537     # In contrast to the original,naming won't map a function to a ThingAction.
1538
1539
1540 def command_ai():
1541     """Call ai() on player Thing, then turn_over()."""
1542     ai(world_db["Things"][0])
1543     turn_over()
1544
1545
1546 """Commands database.
1547
1548 Map command start tokens to ([0]) number of expected command arguments, ([1])
1549 the command's meta-ness (i.e. is it to be written to the record file, is it to
1550 be ignored in replay mode if read from server input file), and ([2]) a function
1551 to be called on it.
1552 """
1553 commands_db = {
1554     "QUIT": (0, True, command_quit),
1555     "PING": (0, True, command_ping),
1556     "THINGS_HERE": (2, True, command_thingshere),
1557     "MAKE_WORLD": (1, False, command_makeworld),
1558     "SEED_MAP": (1, False, command_seedmap),
1559     "SEED_RANDOMNESS": (1, False, command_seedrandomness),
1560     "TURN": (1, False, setter(None, "TURN", 0, 65535)),
1561     "PLAYER_TYPE": (1, False, setter(None, "PLAYER_TYPE", 0)),
1562     "MAP_LENGTH": (1, False, command_maplength),
1563     "WORLD_ACTIVE": (1, False, command_worldactive),
1564     "TA_ID": (1, False, command_taid),
1565     "TA_EFFORT": (1, False, setter("ThingAction", "TA_EFFORT", 0, 255)),
1566     "TA_NAME": (1, False, command_taname),
1567     "TT_ID": (1, False, command_ttid),
1568     "TT_NAME": (1, False, command_ttname),
1569     "TT_SYMBOL": (1, False, command_ttsymbol),
1570     "TT_CORPSE_ID": (1, False, command_ttcorpseid),
1571     "TT_CONSUMABLE": (1, False, setter("ThingType", "TT_CONSUMABLE",
1572                                        0, 65535)),
1573     "TT_START_NUMBER": (1, False, setter("ThingType", "TT_START_NUMBER",
1574                                          0, 255)),
1575     "TT_PROLIFERATE": (1, False, setter("ThingType", "TT_PROLIFERATE",
1576                                         0, 255)),
1577     "TT_LIFEPOINTS": (1, False, setter("ThingType", "TT_LIFEPOINTS", 0, 255)),
1578     "T_ID": (1, False, command_tid),
1579     "T_ARGUMENT": (1, False, setter("Thing", "T_ARGUMENT", 0, 255)),
1580     "T_PROGRESS": (1, False, setter("Thing", "T_PROGRESS", 0, 255)),
1581     "T_LIFEPOINTS": (1, False, setter("Thing", "T_LIFEPOINTS", 0, 255)),
1582     "T_SATIATION": (1, False, setter("Thing", "T_SATIATION", -32768, 32767)),
1583     "T_COMMAND": (1, False, command_tcommand),
1584     "T_TYPE": (1, False, command_ttype),
1585     "T_CARRIES": (1, False, command_tcarries),
1586     "T_MEMMAP": (2, False, setter_map("T_MEMMAP")),
1587     "T_MEMDEPTHMAP": (2, False, setter_map("T_MEMDEPTHMAP")),
1588     "T_MEMTHING": (3, False, command_tmemthing),
1589     "T_POSY": (1, False, setter_tpos("Y")),
1590     "T_POSX": (1, False, setter_tpos("X")),
1591     "wait": (0, False, play_commander("wait")),
1592     "move": (1, False, play_commander("move")),
1593     "pick_up": (0, False, play_commander("pick_up")),
1594     "drop": (1, False, play_commander("drop", True)),
1595     "use": (1, False, play_commander("use", True)),
1596     "ai": (0, False, command_ai)
1597 }
1598
1599
1600 """World state database. With sane default values. (Randomness is in rand.)"""
1601 world_db = {
1602     "TURN": 0,
1603     "MAP_LENGTH": 64,
1604     "SEED_MAP": 0,
1605     "PLAYER_TYPE": 0,
1606     "WORLD_ACTIVE": 0,
1607     "ThingActions": {},
1608     "ThingTypes": {},
1609     "Things": {}
1610 }
1611
1612 """Mapping of direction names to internal direction chars."""
1613 directions_db = {"east": "d", "south-east": "c", "south-west": "x",
1614                  "west": "s", "north-west": "w", "north-east": "e"}
1615
1616 """File IO database."""
1617 io_db = {
1618     "path_save": "save",
1619     "path_record": "record_save",
1620     "path_worldconf": "confserver/world",
1621     "path_server": "server/",
1622     "path_in": "server/in",
1623     "path_out": "server/out",
1624     "path_worldstate": "server/worldstate",
1625     "tmp_suffix": "_tmp",
1626     "kicked_by_rival": False,
1627     "worldstate_updateable": False
1628 }
1629
1630
1631 try:
1632     libpr = prep_library()
1633     rand = RandomnessIO()
1634     opts = parse_command_line_arguments()
1635     if opts.savefile:
1636         io_db["path_save"] = opts.savefile
1637         io_db["path_record"] = "record_" + opts.savefile
1638     setup_server_io()
1639     if opts.verbose:
1640         io_db["verbose"] = True
1641     if None != opts.replay:
1642         replay_game()
1643     else:
1644         play_game()
1645 except SystemExit as exit:
1646     print("ABORTING: " + exit.args[0])
1647 except:
1648     print("SOMETHING WENT WRONG IN UNEXPECTED WAYS")
1649     raise
1650 finally:
1651     cleanup_server_io()