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