Files.com 1.4.227__tar.gz → 1.4.229__tar.gz

{Files.com-1.4.227 → Files.com-1.4.229}/Files.com.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.2
 Name: Files.com
-Version: 1.4.227
+Version: 1.4.229
 Summary: Python bindings for the Files.com API
 Home-page: UNKNOWN
 License: MIT

{Files.com-1.4.227 → Files.com-1.4.229}/Files.com.egg-info/SOURCES.txt

@@ -102,6 +102,7 @@ files_sdk/models/sso_strategy.py
 files_sdk/models/status.py
 files_sdk/models/style.py
 files_sdk/models/sync_log.py
+files_sdk/models/usage_by_top_level_dir.py
 files_sdk/models/usage_daily_snapshot.py
 files_sdk/models/usage_snapshot.py
 files_sdk/models/user.py

{Files.com-1.4.227 → Files.com-1.4.229}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.2
 Name: Files.com
-Version: 1.4.227
+Version: 1.4.229
 Summary: Python bindings for the Files.com API
 Home-page: UNKNOWN
 License: MIT

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/__init__.py

@@ -87,6 +87,7 @@ import files_sdk.models.sso_strategy as sso_strategy
 import files_sdk.models.status as status
 import files_sdk.models.style as style
 import files_sdk.models.sync_log as sync_log
+import files_sdk.models.usage_by_top_level_dir as usage_by_top_level_dir
 import files_sdk.models.usage_daily_snapshot as usage_daily_snapshot
 import files_sdk.models.usage_snapshot as usage_snapshot
 import files_sdk.models.user as user
@@ -190,6 +191,7 @@ from files_sdk.models.sso_strategy import SsoStrategy
 from files_sdk.models.status import Status
 from files_sdk.models.style import Style
 from files_sdk.models.sync_log import SyncLog
+from files_sdk.models.usage_by_top_level_dir import UsageByTopLevelDir
 from files_sdk.models.usage_daily_snapshot import UsageDailySnapshot
 from files_sdk.models.usage_snapshot import UsageSnapshot
 from files_sdk.models.user import User
@@ -208,7 +210,7 @@ session_id = None
 source_ip = None
 base_url = "https://app.files.com"
 base_path = "api/rest/v1"
-version = "1.4.227"
+version = "1.4.229"
 
 __version__ = version
 

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/models/__init__.py

@@ -92,6 +92,7 @@ from files_sdk.models.sso_strategy import SsoStrategy
 from files_sdk.models.status import Status
 from files_sdk.models.style import Style
 from files_sdk.models.sync_log import SyncLog
+from files_sdk.models.usage_by_top_level_dir import UsageByTopLevelDir
 from files_sdk.models.usage_daily_snapshot import UsageDailySnapshot
 from files_sdk.models.usage_snapshot import UsageSnapshot
 from files_sdk.models.user import User

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/models/automation.py

@@ -11,7 +11,7 @@ from files_sdk.error import (  # noqa: F401
 class Automation:
     default_attributes = {
         "id": None,  # int64 - Automation ID
-        "always_overwrite_size_matching_files": None,  # boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+        "always_overwrite_size_matching_files": None,  # boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
         "automation": None,  # string - Automation type
         "deleted": None,  # boolean - Indicates if the automation has been deleted.
         "description": None,  # string - Description for the this Automation.
@@ -28,7 +28,7 @@ class Automation:
         "last_modified_at": None,  # date-time - Time when automation was last modified. Does not change for name or description updates.
         "legacy_folder_matching": None,  # boolean - If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
         "name": None,  # string - Name for this automation.
-        "overwrite_files": None,  # boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+        "overwrite_files": None,  # boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
         "path": None,  # string - Path on which this Automation runs.  Supports globs, except on remote mounts. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
         "path_time_zone": None,  # string - Timezone to use when rendering timestamps in paths.
         "recurring_day": None,  # int64 - If trigger type is `daily`, this specifies a day number to run in one of the supported intervals: `week`, `month`, `quarter`, `year`.
@@ -101,7 +101,7 @@ class Automation:
     #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
     #   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
     #   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-    #   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+    #   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
     #   description - string - Description for the this Automation.
     #   disabled - boolean - If true, this automation will not run.
     #   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -110,7 +110,7 @@ class Automation:
     #   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
     #   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
     #   name - string - Name for this automation.
-    #   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+    #   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
     #   path_time_zone - string - Timezone to use when rendering timestamps in paths.
     #   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
     #   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.
@@ -367,7 +367,7 @@ def get(id, params=None, options=None):
 #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
 #   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
 #   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-#   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+#   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
 #   description - string - Description for the this Automation.
 #   disabled - boolean - If true, this automation will not run.
 #   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -376,7 +376,7 @@ def get(id, params=None, options=None):
 #   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
 #   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
 #   name - string - Name for this automation.
-#   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+#   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 #   path_time_zone - string - Timezone to use when rendering timestamps in paths.
 #   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
 #   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.
@@ -532,7 +532,7 @@ def manual_run(id, params=None, options=None):
 #   schedule_days_of_week - array(int64) - If trigger is `custom_schedule`. A list of days of the week to run this automation. 0 is Sunday, 1 is Monday, etc.
 #   schedule_times_of_day - array(string) - If trigger is `custom_schedule`. A list of times of day to run this automation. 24-hour time format.
 #   schedule_time_zone - string - If trigger is `custom_schedule`. Time zone for the schedule.
-#   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.
+#   always_overwrite_size_matching_files - boolean - Ordinarily, files with identical size in the source and destination will be skipped from copy operations to prevent wasted transfer.  If this flag is `true` we will overwrite the destination file always.  Note that this may cause large amounts of wasted transfer usage.  This setting has no effect unless `overwrite_files` is also set to `true`.
 #   description - string - Description for the this Automation.
 #   disabled - boolean - If true, this automation will not run.
 #   exclude_pattern - string - If set, this glob pattern will exclude files from the automation. Supports globs, except on remote mounts.
@@ -541,7 +541,7 @@ def manual_run(id, params=None, options=None):
 #   ignore_locked_folders - boolean - If true, the Lock Folders behavior will be disregarded for automated actions.
 #   legacy_folder_matching - boolean - DEPRECATED: If `true`, use the legacy behavior for this automation, where it can operate on folders in addition to just files.  This behavior no longer works and should not be used.
 #   name - string - Name for this automation.
-#   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `:always_overwrite_size_matching_files` option to override this.
+#   overwrite_files - boolean - If true, existing files will be overwritten with new files on Move/Copy automations.  Note: by default files will not be overwritten if they appear to be the same file size as the newly incoming file.  Use the `always_overwrite_size_matching_files` option in conjunction with `overwrite_files` to override this behavior and overwrite files no matter what.
 #   path_time_zone - string - Timezone to use when rendering timestamps in paths.
 #   retry_on_failure_interval_in_minutes - int64 - If the Automation fails, retry at this interval (in minutes).  Acceptable values are 5 through 1440 (one day).  Set to null to disable.
 #   retry_on_failure_number_of_attempts - int64 - If the Automation fails, retry at most this many times.  Maximum allowed value: 10.  Set to null to disable.

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/models/automation_run.py

@@ -14,7 +14,7 @@ class AutomationRun:
         "automation_id": None,  # int64 - ID of the associated Automation.
         "completed_at": None,  # date-time - Automation run completion/failure date/time.
         "created_at": None,  # date-time - Automation run start date/time.
-        "retry_at": None,  # string - If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
+        "retry_at": None,  # date-time - If set, this automation will be retried at this date/time due to `failure` or `partial_failure`.
         "retried_at": None,  # date-time - If set, this Automation run was retried due to `failure` or `partial_failure`.
         "retried_in_run_id": None,  # int64 - ID of the run that is or will be retrying this run.
         "retry_of_run_id": None,  # int64 - ID of the original run that this run is retrying.

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/models/request.py

@@ -14,7 +14,7 @@ class Request:
         "path": None,  # string - Folder path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
         "source": None,  # string - Source filename, if applicable
         "destination": None,  # string - Destination filename
-        "automation_id": None,  # string - ID of automation that created request
+        "automation_id": None,  # int64 - ID of automation that created request
         "user_display_name": None,  # string - User making the request (if applicable)
         "user_ids": None,  # string - A list of user IDs to request the file from. If sent as a string, it should be comma-delimited.
         "group_ids": None,  # string - A list of group IDs to request the file from. If sent as a string, it should be comma-delimited.

Files.com-1.4.229/files_sdk/models/usage_by_top_level_dir.py

@@ -0,0 +1,41 @@
+import builtins  # noqa: F401
+from files_sdk.api import Api  # noqa: F401
+from files_sdk.error import (  # noqa: F401
+    InvalidParameterError,
+    MissingParameterError,
+    NotImplementedError,
+)
+
+
+class UsageByTopLevelDir:
+    default_attributes = {
+        "dir": None,  # string - Directory name
+        "size": None,  # int64 - Usage
+        "count": None,  # int64 - File count
+    }
+
+    def __init__(self, attributes=None, options=None):
+        if not isinstance(attributes, dict):
+            attributes = {}
+        if not isinstance(options, dict):
+            options = {}
+        self.set_attributes(attributes)
+        self.options = options
+
+    def set_attributes(self, attributes):
+        for (
+            attribute,
+            default_value,
+        ) in UsageByTopLevelDir.default_attributes.items():
+            setattr(self, attribute, attributes.get(attribute, default_value))
+
+    def get_attributes(self):
+        return {
+            k: getattr(self, k, None)
+            for k in UsageByTopLevelDir.default_attributes
+            if getattr(self, k, None) is not None
+        }
+
+
+def new(*args, **kwargs):
+    return UsageByTopLevelDir(*args, **kwargs)

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/models/usage_daily_snapshot.py

@@ -16,11 +16,11 @@ class UsageDailySnapshot:
         "read_api_usage": None,  # int64 - Read API Calls used on this day. Note: only updated for days before the current day.
         "write_api_usage": None,  # int64 - Write API Calls used on this day. Note: only updated for days before the current day.
         "user_count": None,  # int64 - Number of billable users as of this day.
-        "current_storage": None,  # int64 - GB of Files Native Storage used on this day.
-        "deleted_files_storage": None,  # int64 - GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
-        "deleted_files_counted_in_minimum": None,  # int64 - GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
-        "root_storage": None,  # int64 - GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
-        "usage_by_top_level_dir": None,  # object - Usage broken down by each top-level folder
+        "current_storage": None,  # double - GB of Files Native Storage used on this day.
+        "deleted_files_storage": None,  # double - GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
+        "deleted_files_counted_in_minimum": None,  # double - GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
+        "root_storage": None,  # double - GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
+        "usage_by_top_level_dir": None,  # array(object) - Usage broken down by each top-level folder
     }
 
     def __init__(self, attributes=None, options=None):

{Files.com-1.4.227 → Files.com-1.4.229}/files_sdk/models/usage_snapshot.py

@@ -13,10 +13,9 @@ class UsageSnapshot:
         "id": None,  # int64 - Usage snapshot ID
         "start_at": None,  # date-time - Usage snapshot start date/time
         "end_at": None,  # date-time - Usage snapshot end date/time
-        "high_water_user_count": None,  # double - Highest user count number in time period
+        "high_water_user_count": None,  # int64 - Highest user count number in time period
         "current_storage": None,  # double - Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)
         "high_water_storage": None,  # double - Highest Storage Usage GB recorded in time period (used for billing)
-        "usage_by_top_level_dir": None,  # object - Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
         "root_storage": None,  # double - Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
         "deleted_files_counted_in_minimum": None,  # double - Storage Usage for files that are deleted but uploaded within last 30 days as of end date (not necessarily high water mark, which is used for billing)
         "deleted_files_storage": None,  # double - Storage Usage for files that are deleted but retained as backups as of end date (not necessarily high water mark, which is used for billing)
@@ -25,6 +24,7 @@ class UsageSnapshot:
         "bytes_sent": None,  # double - Transfer Usage for period - Outbound GB from Files Native Storage
         "sync_bytes_received": None,  # double - Transfer Usage for period - Inbound GB to Remote Servers (Sync/Mount)
         "sync_bytes_sent": None,  # double - Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)
+        "usage_by_top_level_dir": None,  # array(object) - Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
     }
 
     def __init__(self, attributes=None, options=None):