Merge pull request #65 from MoseleyBioinformaticsLab/granular

Updates documentation to warn about file lock errors when sub-tracking

Author: erikhuck

src/gpu_tracker/sub_tracker.py

@@ -21,7 +21,7 @@ def __init__(
         """
         :param code_block_name: The name of the code block within a ``Tracker`` context that is being sub-tracked. Defaults to the file path followed by a colon followed by the ``code_block_attribute``.
         :param code_block_attribute: Only used if ``code_block_name`` is ``None``. Defaults to the line number where the SubTracker context is started.
-        :param sub_tracking_file: The path to the file to log the time stamps of the code block being sub-tracked. Defaults to the ID of the process where the SubTracker context is created and in CSV format.
+        :param sub_tracking_file: The path to the file to log the time stamps of the code block being sub-tracked. To avoid file lock errors when a sub-tracking file is created in multiple different processes (i.e. multiple processes attempting to access the same file at the same time), the sub-tracking file of each process must have a unique name. For example, the ID of the process where the SubTracker context is created. Defaults to this process ID as the file name and in CSV format.
         """
         if code_block_name is not None:
             self.code_block_name = code_block_name