operations/files.put: fix files.put(mode=True)

Fixes pyinfra-dev#1337 which occurs due a type mismatch between the
local file mode returned by get_path_permissions_mode() in api/util.py (str),
and the mode data type from the remote file fact (int).

Make the change in api/util.py to return an int so the behavior both matches the
function's docstring and the implied semantics within put() in
operations/files.py.

Author: vram0gh2

pyinfra/api/util.py

@@ -425,7 +425,7 @@ def get_path_permissions_mode(pathname: str):
     """
 
     mode_octal = oct(stat(pathname).st_mode)
-    return mode_octal[-3:]
+    return int(mode_octal[-3:])
 
 
 def raise_if_bad_type(

tests/operations/files.put/no_change_same_mode_as_local.json

@@ -0,0 +1,29 @@
+{
+    "args": ["somefile.txt", "/home/somefile.txt"],
+    "kwargs": {
+        "mode": true
+    },
+    "local_files": {
+        "files": {
+            "somefile.txt": {
+                "mode": 644
+            }
+        },
+        "dirs": {}
+    },
+    "facts": {
+        "files.File": {
+            "path=/home/somefile.txt": {
+                "mode": 644
+            }
+        },
+        "files.Directory": {
+            "path=/home": true
+        },
+        "files.Sha1File": {
+            "path=/home/somefile.txt": "ac2cd59a622114712b5b21081763c54bf0caacb8"
+        }
+    },
+    "commands": [],
+    "noop_description": "file /home/somefile.txt is already uploaded"
+}