docs: def read_index(self):
          """
          Reads the index and populates the directory tree
          """
          if not isinstance(self.tree, dict):
              self.tree = dict()
  
          self.tree.clear()
  
          for path, metadata in self.read_index_iter():
              self.tree[path] = metadata