chore: add warning about data loss/corruption with JSONStorage access_mode options

msiemens · msiemens · commit d0416e909e76 · 2023-02-18T22:20:20.000+01:00
Closes: msiemens#506
diff --git a/tinydb/storages.py b/tinydb/storages.py
@@ -84,10 +84,14 @@ def __init__(self, path: str, create_dirs=False, encoding=None, access_mode='r+'
         """
         Create a new instance.
 
-        Also creates the storage file, if it doesn't exist and the access mode is appropriate for writing.
+        Also creates the storage file, if it doesn't exist and the access mode
+        is appropriate for writing.
+
+        Note: Using an access mode other than `r` or `r+` will probably lead to
+        data loss or data corruption!
 
         :param path: Where to store the JSON data.
-        :param access_mode: mode in which the file is opened (r, r+, w, a, x, b, t, +, U)
+        :param access_mode: mode in which the file is opened (r, r+)
         :type access_mode: str
         """
 
