Merge pull request #140 from appwrite/dev

feat: Python SDK update for version 18.0.0

Author: abnegate

CHANGELOG.md

@@ -1,5 +1,24 @@
 # Change Log
 
+## 18.0.0
+
+* [BREAKING] Renamed Webhook model fields: `security` → `tls`, `httpUser` → `authUsername`, `httpPass` → `authPassword`, `signatureKey` → `secret`
+* [BREAKING] Renamed Webhook service parameters to match: `security` → `tls`, `httpUser` → `authUsername`, `httpPass` → `authPassword`
+* [BREAKING] Renamed `Webhooks.update_signature()` to `Webhooks.update_secret()` with new optional `secret` parameter
+* Added `Client.get_headers()` method to retrieve request headers
+* Added `secret` parameter to Webhook create and update methods
+* Added `x` OAuth provider to `OAuthProvider` enum
+* Added `userType` field to `Log` model
+* Added `purge` parameter to `update_collection` and `update_table` for cache invalidation
+* Added Project service: platform CRUD, key CRUD, protocol/service status management
+* Added new models: `Key`, `KeyList`, `Project`, `DevKey`, `MockNumber`, `AuthProvider`, `PlatformAndroid`, `PlatformApple`, `PlatformLinux`, `PlatformList`, `PlatformWeb`, `PlatformWindows`, `BillingLimits`, `Block`
+* Added new enums: `PlatformType`, `ProtocolId`, `ServiceId`
+* Updated `BuildRuntime`, `Runtime` enums with `dart-3.11` and `flutter-3.41`
+* Updated `Scopes` enum with `keys_read`, `keys_write`, `platforms_read`, `platforms_write`
+* Updated `X-Appwrite-Response-Format` header to `1.9.1`
+* Updated TTL description for list caching in Databases and TablesDB
+* Simplified `_parse_response()` by removing `union_models` parameter
+
 ## 17.0.0
 
 * [BREAKING] Changed `$sequence` type from `float` to `str` for `Row` and `Document` models

README.md

@@ -1,7 +1,7 @@
 # Appwrite Python SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-python.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.9.0-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.9.1-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)

appwrite/client.py

@@ -15,12 +15,12 @@ def __init__(self):
         self._endpoint = 'https://cloud.appwrite.io/v1'
         self._global_headers = {
             'content-type': '',
-            'user-agent' : f'AppwritePythonSDK/17.0.0 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
+            'user-agent' : f'AppwritePythonSDK/18.0.0 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
             'x-sdk-name': 'Python',
             'x-sdk-platform': 'server',
             'x-sdk-language': 'python',
-            'x-sdk-version': '17.0.0',
-            'X-Appwrite-Response-Format' : '1.9.0',
+            'x-sdk-version': '18.0.0',
+            'X-Appwrite-Response-Format' : '1.9.1',
         }
 
     def set_self_signed(self, status=True):
@@ -38,6 +38,9 @@ def add_header(self, key, value):
         self._global_headers[key.lower()] = value
         return self
 
+    def get_headers(self):
+        return dict(self._global_headers)
+
     def set_project(self, value):
         """Your project ID"""
 

appwrite/encoders/value_class_encoder.py

@@ -24,6 +24,8 @@
 from ..enums.name import Name
 from ..enums.message_priority import MessagePriority
 from ..enums.smtp_encryption import SmtpEncryption
+from ..enums.protocol_id import ProtocolId
+from ..enums.service_id import ServiceId
 from ..enums.framework import Framework
 from ..enums.build_runtime import BuildRuntime
 from ..enums.adapter import Adapter
@@ -39,6 +41,7 @@
 from ..enums.deployment_status import DeploymentStatus
 from ..enums.execution_trigger import ExecutionTrigger
 from ..enums.execution_status import ExecutionStatus
+from ..enums.platform_type import PlatformType
 from ..enums.health_antivirus_status import HealthAntivirusStatus
 from ..enums.health_check_status import HealthCheckStatus
 from ..enums.message_status import MessageStatus
@@ -120,6 +123,12 @@ def default(self, o):
         if isinstance(o, SmtpEncryption):
             return o.value
 
+        if isinstance(o, ProtocolId):
+            return o.value
+
+        if isinstance(o, ServiceId):
+            return o.value
+
         if isinstance(o, Framework):
             return o.value
 
@@ -165,6 +174,9 @@ def default(self, o):
         if isinstance(o, ExecutionStatus):
             return o.value
 
+        if isinstance(o, PlatformType):
+            return o.value
+
         if isinstance(o, HealthAntivirusStatus):
             return o.value
 

appwrite/enums/build_runtime.py

@@ -49,6 +49,7 @@ class BuildRuntime(Enum):
     DART_3_8 = "dart-3.8"
     DART_3_9 = "dart-3.9"
     DART_3_10 = "dart-3.10"
+    DART_3_11 = "dart-3.11"
     DOTNET_6_0 = "dotnet-6.0"
     DOTNET_7_0 = "dotnet-7.0"
     DOTNET_8_0 = "dotnet-8.0"
@@ -87,3 +88,4 @@ class BuildRuntime(Enum):
     FLUTTER_3_32 = "flutter-3.32"
     FLUTTER_3_35 = "flutter-3.35"
     FLUTTER_3_38 = "flutter-3.38"
+    FLUTTER_3_41 = "flutter-3.41"

appwrite/enums/o_auth_provider.py

@@ -35,6 +35,7 @@ class OAuthProvider(Enum):
     TRADESHIFTBOX = "tradeshiftBox"
     TWITCH = "twitch"
     WORDPRESS = "wordpress"
+    X = "x"
     YAHOO = "yahoo"
     YAMMER = "yammer"
     YANDEX = "yandex"

appwrite/enums/platform_type.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+class PlatformType(Enum):
+    WINDOWS = "windows"
+    APPLE = "apple"
+    ANDROID = "android"
+    LINUX = "linux"
+    WEB = "web"

appwrite/enums/protocol_id.py

@@ -0,0 +1,6 @@
+from enum import Enum
+
+class ProtocolId(Enum):
+    REST = "rest"
+    GRAPHQL = "graphql"
+    WEBSOCKET = "websocket"

appwrite/enums/runtime.py

@@ -49,6 +49,7 @@ class Runtime(Enum):
     DART_3_8 = "dart-3.8"
     DART_3_9 = "dart-3.9"
     DART_3_10 = "dart-3.10"
+    DART_3_11 = "dart-3.11"
     DOTNET_6_0 = "dotnet-6.0"
     DOTNET_7_0 = "dotnet-7.0"
     DOTNET_8_0 = "dotnet-8.0"
@@ -87,3 +88,4 @@ class Runtime(Enum):
     FLUTTER_3_32 = "flutter-3.32"
     FLUTTER_3_35 = "flutter-3.35"
     FLUTTER_3_38 = "flutter-3.38"
+    FLUTTER_3_41 = "flutter-3.41"

appwrite/enums/scopes.py

@@ -62,6 +62,10 @@ class Scopes(Enum):
     WEBHOOKS_WRITE = "webhooks.write"
     PROJECT_READ = "project.read"
     PROJECT_WRITE = "project.write"
+    KEYS_READ = "keys.read"
+    KEYS_WRITE = "keys.write"
+    PLATFORMS_READ = "platforms.read"
+    PLATFORMS_WRITE = "platforms.write"
     POLICIES_WRITE = "policies.write"
     POLICIES_READ = "policies.read"
     ARCHIVES_READ = "archives.read"