added possibility to create folder tree

allow user to specify leading slash in url for get_folder_by_server_relative_url

added example how to add folder

Author: beliaev-maksim

examples/sharepoint/folders/create_folders.py

@@ -15,7 +15,7 @@
 
 # create relative folder tree, no execution required
 target_folder = "/Shared Documents/test_folder/20201116/1133/test"
-target_folder = ctx.web.create_folder_tree(target_folder)
+target_folder = ctx.web.ensure_folder_path(target_folder)
 
 
 

office365/sharepoint/webs/web.py

@@ -199,14 +199,14 @@ def get_folder_by_server_relative_url(self, url):
             ResourcePathServiceOperation("getFolderByServerRelativeUrl", [url], self.resource_path)
         )
 
-    def create_folder_tree(self, url):
+    def ensure_folder_path(self, path):
         """
             Function to create folder tree
-            :type url: string
-            :param url: relative server URL
+            :type path: string
+            :param path: relative server URL (path) to a folder
         """
 
-        url_component = os.path.normpath(url).split(os.path.sep)
+        url_component = os.path.normpath(path).split(os.path.sep)
         url_component = [part for part in url_component if part]  # ensure no empty elements
         if not url_component:
             raise NotADirectoryError("Wrong relative URL provided")