improves updatepaths documentation and minor code (ParadiseSS13#23123)

Author: S34NW

tools/UpdatePaths/Update_Paths.bat tools/UpdatePaths/Update Paths.bat

@@ -1,5 +1,8 @@
 # A script and syntax for applying path updates to maps.
-import re, os, sys, argparse
+import re
+import os
+import sys
+import argparse
 from mapmerge2 import frontend
 from mapmerge2.dmm import *
 
@@ -10,6 +13,7 @@
     /turf/open/floor/iron/warningline : /obj/effect/turf_decal {@OLD} , /obj/thing {icon_state = @OLD:name; name = "meme"}
     /turf/open/floor/iron/warningline{dir=2} : /obj/thing
     /obj/effect/landmark/start/virologist : @DELETE
+    /mob/living{resize = @ANY} : /mob/living{@OLD; resize = @SKIP}
 Syntax for subtypes also exist, to update a path's type but maintain subtypes:
     /obj/structure/closet/crate/@SUBTYPES : /obj/structure/new_box/@SUBTYPES {@OLD}
 New paths properties:
@@ -22,6 +26,7 @@
 Old paths properties:
     Will be used as a filter.
     property = @UNSET - will apply the rule only if the property is not mapedited
+    property = @ANY - will apply the rule when the property is mapedited, regardless of its value.
 """
 
 default_map_directory = "../../_maps"
@@ -88,7 +93,9 @@ def replace_def(match):
                 else:
                     return [match.group(0)]
             else:
-                if old_props[filter_prop] != old_path_props[filter_prop] or old_path_props[filter_prop] == "@UNSET":
+                if old_path_props[filter_prop] == "@ANY":
+                   continue
+                elif old_props[filter_prop] != old_path_props[filter_prop] or old_path_props[filter_prop] == "@UNSET":
                     return [match.group(0)] #does not match current filter, skip the change.
         if verbose:
             print("Found match : {0}".format(match.group(0)))
@@ -107,7 +114,8 @@ def replace_def(match):
                 out = new_path
 
             out_props = dict()
-            for prop_name, prop_value in new_props.items():
+            for prop_name, prop_text in new_props.items():
+                prop_value = str(prop_text)
                 if prop_name == "@OLD":
                     out_props = dict(old_props)
                     continue
@@ -116,8 +124,7 @@ def replace_def(match):
                     continue
                 if prop_value.startswith("@OLD"):
                     params = prop_value.split(":")
-                    if prop_name in old_props:
-                        out_props[prop_name] = old_props[params[1]] if len(params) > 1 else old_props[prop_name]
+                    out_props[prop_name] = old_props[params[1]] if len(params) > 1 else old_props[prop_name]
                     continue
                 out_props[prop_name] = prop_value
             if out_props:
@@ -184,7 +191,7 @@ def main(args):
 if __name__ == "__main__":
     prog = __spec__.name.replace('.__main__', '')
     if os.name == 'nt' and len(sys.argv) <= 1:
-        print("usage: drag-and-drop a path script .txt onto `Update_Paths.bat`\n  or")
+        print("usage: drag-and-drop a path script .txt onto `Update Paths.bat`\n  or")
 
     parser = argparse.ArgumentParser(prog=prog, description=desc, formatter_class=argparse.RawTextHelpFormatter)
     parser.add_argument("update_source", help="update file path / line of update notation")