xlwings-utils 25.0.7.post1__tar.gz → 25.0.9__tar.gz

{xlwings_utils-25.0.7.post1 → xlwings_utils-25.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xlwings_utils
-Version: 25.0.7.post1
+Version: 25.0.9
 Summary: xlwings_utils
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/xlwings_utils
@@ -51,7 +51,9 @@ The xlwings lite system does not provide access to the local file system. With t
 
 Currently, it is only possible to use full-access Dropbox apps.
 
-The easiest way to use the Dropbox functionality is to add the credentials to the environment variables. Add REFRESH_TOKEN, APP_KEY and APP_SECRET with their corresponding values to the environment variables. Instructions on how to get these variables can be found here.
+The easiest way to use the Dropbox functionality is to add the credentials to the environment variables. Add DROPBOX.REFRESH_TOKEN,
+DROPBOX.APP_KEY and DROPBOX.APP_SECRET with their corresponding values to the environment variables.
+Instructions on how to get these variables can be found here.
 
 In order to make a Dropbox app, and get the required environment variables, just execute this line from the command line (shell).
 
@@ -59,8 +61,10 @@ In order to make a Dropbox app, and get the required environment variables, just
 python -c "exec(__import__('requests').get('https://salabim.org/dropbox setup.py').text)"
 ```
 
+The file `dropbox setup.py` can also be found in the repo of xlwings_lite .
+
 Then, it is possible to list all files in a specified folder using the list_dropbox function.
-It is also possible to get the folders and to access all underlying folders.
+It is also possible to get at all folders and to access all underlying folders.
 
 The `read_dropbox` function can be used to read the contents (bytes) of a Dropbox file. As reading from Dropbox under pyodide is rather unreliable, xlwings_utils automatically retries several times (by default 100 times). The actual number of retries can be found with `read_dropbox.retries`.
 

{xlwings_utils-25.0.7.post1 → xlwings_utils-25.0.9}/README.md

@@ -38,7 +38,9 @@ The xlwings lite system does not provide access to the local file system. With t
 
 Currently, it is only possible to use full-access Dropbox apps.
 
-The easiest way to use the Dropbox functionality is to add the credentials to the environment variables. Add REFRESH_TOKEN, APP_KEY and APP_SECRET with their corresponding values to the environment variables. Instructions on how to get these variables can be found here.
+The easiest way to use the Dropbox functionality is to add the credentials to the environment variables. Add DROPBOX.REFRESH_TOKEN,
+DROPBOX.APP_KEY and DROPBOX.APP_SECRET with their corresponding values to the environment variables.
+Instructions on how to get these variables can be found here.
 
 In order to make a Dropbox app, and get the required environment variables, just execute this line from the command line (shell).
 
@@ -46,8 +48,10 @@ In order to make a Dropbox app, and get the required environment variables, just
 python -c "exec(__import__('requests').get('https://salabim.org/dropbox setup.py').text)"
 ```
 
+The file `dropbox setup.py` can also be found in the repo of xlwings_lite .
+
 Then, it is possible to list all files in a specified folder using the list_dropbox function.
-It is also possible to get the folders and to access all underlying folders.
+It is also possible to get at all folders and to access all underlying folders.
 
 The `read_dropbox` function can be used to read the contents (bytes) of a Dropbox file. As reading from Dropbox under pyodide is rather unreliable, xlwings_utils automatically retries several times (by default 100 times). The actual number of retries can be found with `read_dropbox.retries`.
 

{xlwings_utils-25.0.7.post1 → xlwings_utils-25.0.9}/pyproject.toml

@@ -10,7 +10,7 @@ authors = [
     { name = "Ruud van der Ham", email = "rt.van.der.ham@gmail.com" },
 ]
 description = "xlwings_utils"
-version = "25.0.7.post1"
+version = "25.0.9"
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [

{xlwings_utils-25.0.7.post1 → xlwings_utils-25.0.9}/xlwings_utils/xlwings_utils.py

@@ -5,7 +5,7 @@
 #  /_/\_\|_|  \_/\_/  |_||_| |_| \__, ||___/ _____  \__,_| \__||_||_||___/
 #                                |___/      |_____|
 
-__version__ = "25.0.7"
+__version__ = "25.0.9"
 
 
 import dropbox
@@ -20,6 +20,8 @@ Pythonista = sys.platform == "ios"
 try:
     import xlwings
 
+    xlwings = True
+
 except ImportError:
     xlwings = False
 
@@ -32,8 +34,8 @@ def dropbox_init(refresh_token=missing, app_key=missing, app_secret=missing, **k
 
     This function may to be called prior to using any dropbox function
     to specify the request token, app key and app secret.
-    If these are specified as REFRESH_TOKEN, APP_KEY and APP_SECRET
-    environment variables, it is no necessary to call dropbox_init().
+    If these are specified as DROPBOX.REFRESH_TOKEN, DROPBOX.APP_KEY and DROPBOX.APP_SECRET
+    environment variables, it is not necessary to call dropbox_init().
 
     Parameters
     ----------
@@ -55,47 +57,38 @@ def dropbox_init(refresh_token=missing, app_key=missing, app_secret=missing, **k
 
     Returns
     -------
-    -
+    dropbox object
     """
     global dbx
 
-    if Pythonista:
-        # under Pythonista, the environ is updated from the .environ.toml file, if present
-        environ_file = Path(os.environ["HOME"]) / "Documents" / ".environ.toml"
-
-        if environ_file.is_file():
-            with open(environ_file, "r") as f:
-                import toml
-
-                d = toml.load(f)
-                os.environ.update(d)
-
     if refresh_token is missing:
-        if "REFRESH_TOKEN" in os.environ:
-            refresh_token = os.environ["REFRESH_TOKEN"]
+        if "DROPBOX.REFRESH_TOKEN" in os.environ:
+            refresh_token = os.environ["DROPBOX.REFRESH_TOKEN"]
         else:
-            raise ValueError("no REFRESH_TOKEN found in environment.")
+            raise ValueError("no DROPBOX.REFRESH_TOKEN found in environment.")
     if app_key is missing:
-        if "APP_KEY" in os.environ:
-            app_key = os.environ["APP_KEY"]
+        if "DROPBOX.APP_KEY" in os.environ:
+            app_key = os.environ["DROPBOX.APP_KEY"]
         else:
-            raise ValueError("no APP_KEY found in environment.")
+            raise ValueError("no DROPBOX.APP_KEY found in environment.")
     if app_secret is missing:
-        if "APP_SECRET" in os.environ:
-            app_secret = os.environ["APP_SECRET"]
+        if "DROPBOX.APP_SECRET" in os.environ:
+            app_secret = os.environ["DROPBOX.APP_SECRET"]
         else:
-            raise ValueError("no APP_SECRET found in environment.")
+            raise ValueError("no DROPBOX.APP_SECRET found in environment.")
 
-    dbx = dropbox.Dropbox(oauth2_refresh_token=refresh_token, app_key=app_key, app_secret=app_secret, **kwargs)
+    _dbx = dropbox.Dropbox(oauth2_refresh_token=refresh_token, app_key=app_key, app_secret=app_secret, **kwargs)
     try:
-        dbx.files_list_folder(path="")  # just to test proper credentials
+        _dbx.files_list_folder(path="")  # just to test proper credentials
     except dropbox.exceptions.AuthError:
         raise ValueError("invalid dropbox credentials")
+    return _dbx
 
 
 def _login_dbx():
+    global dbx
     if dbx is None:
-        dropbox_init()  # use environment
+        dbx = dropbox_init()  # use environment
 
 
 def list_dropbox(path="", recursive=False, show_files=True, show_folders=False):
@@ -110,7 +103,7 @@ def list_dropbox(path="", recursive=False, show_files=True, show_folders=False):
         path from which to list all files (default: '')
 
     recursive : bool
-        if True, recursively list files. if False (default) no recursion
+        if True, recursively list files and folders. if False (default) no recursion
 
     show_files : bool
         if True (default), show file entries
@@ -124,10 +117,6 @@ def list_dropbox(path="", recursive=False, show_files=True, show_folders=False):
     -------
     files : list
 
-    Note
-    ----
-    Directory entries are never returned
-
     Note
     ----
     If REFRESH_TOKEN, APP_KEY and APP_SECRET environment variables are specified,
@@ -290,7 +279,7 @@ class block:
         self.number_of_rows = number_of_rows
         self.number_of_columns = number_of_columns
 
-    def __eq__(self,other):
+    def __eq__(self, other):
         if isinstance(other, block):
             return self.value == other.value
         return False
@@ -469,8 +458,8 @@ class block:
         if column < 1 or column > self.number_of_columns:
             raise IndexError(f"column must be between 1 and {self.number_of_columns} not {column}")
         if value is None:
-            if (row,column) in self.dict:
-                del self.dict[row,column]
+            if (row, column) in self.dict:
+                del self.dict[row, column]
         else:
             self.dict[row, column] = value
 
@@ -812,12 +801,12 @@ class block:
     def decode_to_files(self):
         """
         decode the block with encoded file(s) to individual pyoidide file(s)
-        
+
         Returns
         -------
         count : int
             number of files decoded
-        
+
         Note
         ----
         if the block does not contain an encode file, the method just returns 0

{xlwings_utils-25.0.7.post1 → xlwings_utils-25.0.9}/xlwings_utils.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xlwings_utils
-Version: 25.0.7.post1
+Version: 25.0.9
 Summary: xlwings_utils
 Author-email: Ruud van der Ham <rt.van.der.ham@gmail.com>
 Project-URL: Homepage, https://github.com/salabim/xlwings_utils
@@ -51,7 +51,9 @@ The xlwings lite system does not provide access to the local file system. With t
 
 Currently, it is only possible to use full-access Dropbox apps.
 
-The easiest way to use the Dropbox functionality is to add the credentials to the environment variables. Add REFRESH_TOKEN, APP_KEY and APP_SECRET with their corresponding values to the environment variables. Instructions on how to get these variables can be found here.
+The easiest way to use the Dropbox functionality is to add the credentials to the environment variables. Add DROPBOX.REFRESH_TOKEN,
+DROPBOX.APP_KEY and DROPBOX.APP_SECRET with their corresponding values to the environment variables.
+Instructions on how to get these variables can be found here.
 
 In order to make a Dropbox app, and get the required environment variables, just execute this line from the command line (shell).
 
@@ -59,8 +61,10 @@ In order to make a Dropbox app, and get the required environment variables, just
 python -c "exec(__import__('requests').get('https://salabim.org/dropbox setup.py').text)"
 ```
 
+The file `dropbox setup.py` can also be found in the repo of xlwings_lite .
+
 Then, it is possible to list all files in a specified folder using the list_dropbox function.
-It is also possible to get the folders and to access all underlying folders.
+It is also possible to get at all folders and to access all underlying folders.
 
 The `read_dropbox` function can be used to read the contents (bytes) of a Dropbox file. As reading from Dropbox under pyodide is rather unreliable, xlwings_utils automatically retries several times (by default 100 times). The actual number of retries can be found with `read_dropbox.retries`.