Files.com 1.4.126__tar.gz → 1.4.128__tar.gz

{Files.com-1.4.126 → Files.com-1.4.128}/Files.com.egg-info/PKG-INFO

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

{Files.com-1.4.126 → Files.com-1.4.128}/PKG-INFO

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

{Files.com-1.4.126 → Files.com-1.4.128}/README.md

@@ -13,6 +13,8 @@ Every function in the Files.com application is available via Python.  Nothing is
 
 This package is officially supported by Files.com for Python 3.8+.  Prior versions of Python are considered end-of-life by the Python Software Foundation and Files.com only supports environments that are still supported by their vendor.  With that said, we believe that this package works in Python 3.5-3.7 as well.
 
+The Python package uses the Files.com RESTful APIs via the HTTPS protocol (port 443) to securely communicate and transfer files so no firewall changes should be required in order to allow connectivity to Files.com.
+
 ### Installation
 
 Use `pip` to install the latest version of the `Files.com` package.
@@ -23,9 +25,9 @@ pip3 install Files.com
 
 Files.com automatically pushes a new release to PIP every time a commit is made to the `master` branch on GitHub, so there is no benefit in directly linking the package from GitHub.
 
-### Files.com Is Committed To Python
+### Files.com is Committed to Python
 
-Python is the most commonly used langauge for custom integrations to Files.com.  Our Files.com Desktop v6 application (that we publish) is also written in Python, using this exact same package.
+Python is the most commonly used language for custom integrations to Files.com.  Our Files.com Desktop v6 application (that we publish) is also written in Python, using this exact same package.
 
 Explore the [files-sdk-python](https://github.com/Files-com/files-sdk-python) code on GitHub.
 
@@ -71,7 +73,7 @@ session times out, simply create a new session and resume where you left off. Th
 automatically handled by SDKs because we do not want to store password information in memory without
 your explicit consent.
 
-#### Logging in
+#### Logging In
 
 To create a session, the `create` method is called on the `files_sdk` object with the user's username and
 password.
@@ -82,7 +84,7 @@ This returns a session object that can be used to authenticate SDK method calls.
 session = files_sdk.session.create({ "username": "motor", "password": "vroom" })
 ```
 
-#### Using a session
+#### Using a Session
 
 Once a session has been created, you can store the session globally, use the session per object, or use the session per request to authenticate SDK operations.
 
@@ -97,7 +99,7 @@ user = files_sdk.user.User(params, {"session_id": session.id})
 files_sdk.user.find(id, params, {"session_id": session.id})
 ```
 
-#### Logging out
+#### Logging Out
 
 User sessions can be ended calling the `destroy` method on the `session` object.
 
@@ -107,7 +109,7 @@ session.destroy()
 
 ## Configuration
 
-### Configuration options
+### Configuration Options
 
 #### Base URL
 
@@ -118,7 +120,7 @@ This can also be set to use a mock server in development or CI.
 files_sdk.base_url = "https://SUBDOMAIN.files.com"
 ```
 
-#### Log level
+#### Log Level
 
 This SDK utilizes the standard Python logging framework. It will respect the global log level
 and you can set the module specific log level and other logging settings by getting the logger
@@ -129,7 +131,7 @@ import logging
 logging.getLogger("files_sdk")
 ```
 
-#### Console log level
+#### Console Log Level
 
 Enables printing of messages to stderr in addition to normal logging.
 
@@ -143,7 +145,7 @@ Allowed values are:
 files_sdk.console_log_level = "info"
 ```
 
-#### Open timeout
+#### Open Timeout
 
 Open timeout in seconds. The default value is 30.
 
@@ -151,7 +153,7 @@ Open timeout in seconds. The default value is 30.
 files_sdk.open_timeout = 60
 ```
 
-#### Read timeout
+#### Read Timeout
 
 Read timeout in seconds. The default value is 80.
 
@@ -159,7 +161,7 @@ Read timeout in seconds. The default value is 80.
 files_sdk.read_timeout = 90
 ```
 
-#### Initial network retry delay
+#### Initial Network Retry Delay
 
 Initial retry delay in seconds. The default value is 0.5.
 
@@ -167,7 +169,7 @@ Initial retry delay in seconds. The default value is 0.5.
 files_sdk.initial_network_retry_delay = 1
 ```
 
-#### Maximum retry delay
+#### Maximum Retry Delay
 
 Maximum network retry delay in seconds. The default value is 2.
 
@@ -175,7 +177,7 @@ Maximum network retry delay in seconds. The default value is 2.
 files_sdk.max_network_retry_delay = 5
 ```
 
-#### Maximum network retries
+#### Maximum Network Retries
 
 Maximum number of retries. The default value is 3.
 
@@ -444,35 +446,35 @@ If the parent directories do not already exist, they can be automatically create
 files_sdk.file.upload_file("local.txt", "/uploads/remote.txt", params={"mkdir_parents": True})
 ```
 
-#### List root folder
+#### List Root Folder
 
 ```python
 for f in files_sdk.folder.list_for("/").auto_paging_iter():
     print(f.type, f.path)
 ```
 
-#### Writing a file example (string)
+#### Writing a File Example (string)
 
 ```python
 with files_sdk.file.open("foo.txt", 'w') as f:
     f.write("contents")
 ```
 
-#### Writing a file example (binary)
+#### Writing a File Example (binary)
 
 ```python
 with files_sdk.file.open("foo.txt", 'wb') as f:
     f.write(b"contents")
 ```
 
-#### Reading a file example (string)
+#### Reading a File Example (string)
 
 ```python
 with files_sdk.open("foo.txt", 'r') as f:
     print(f.read())
 ```
 
-#### Reading a file example (binary)
+#### Reading a File Example (binary)
 
 ```python
 with files_sdk.open("foo.txt", 'rb') as f:
@@ -486,7 +488,7 @@ which contains a single page of records. It has a built-in `auto_paging_iter`
 method to iterate through the pages, making the additional API calls
 as needed.
 
-#### Iterating with with auto_paging_iter
+#### Iterating with auto_paging_iter
 
 ```python
 list_obj = files_sdk.folder.list_for('/')
@@ -495,7 +497,7 @@ for f in list_obj.auto_paging_iter():
     print(f.type, f.path)
 ```
 
-#### Iterating manually
+#### Iterating Manually
 
 ```python
 list_obj = files_sdk.folder.list_for('/')
@@ -509,7 +511,7 @@ while list_obj.has_next_page:
         print(f.type, f.path)
 ```
 
-### Comparing Case insensitive files and paths
+### Comparing Case-Insensitive Files and Paths
 
 For related documentation see [Case Sensitivity Documentation](https://www.files.com/docs/files-and-folders/file-system-semantics/case-sensitivity).
 

{Files.com-1.4.126 → Files.com-1.4.128}/files_sdk/__init__.py

@@ -204,7 +204,7 @@ session_id = None
 source_ip = None
 base_url = "https://app.files.com"
 base_path = "api/rest/v1"
-version = "1.4.126"
+version = "1.4.128"
 
 __version__ = version