Merge pull request #127 from appwrite/dev

feat: Python SDK update for version 14.0.0

Author: abnegate

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 14.1.0
+
+* Added ability to create columns and indexes synchronously while creating a table
+
 ## 14.0.0
 
 * Rename `VCSDeploymentType` enum to `VCSReferenceType`

appwrite/client.py

@@ -15,11 +15,11 @@ def __init__(self):
         self._endpoint = 'https://cloud.appwrite.io/v1'
         self._global_headers = {
             'content-type': '',
-            'user-agent' : f'AppwritePythonSDK/14.0.0 ({platform.uname().system}; {platform.uname().version}; {platform.uname().machine})',
+            'user-agent' : f'AppwritePythonSDK/14.1.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': '14.0.0',
+            'x-sdk-version': '14.1.0',
             'X-Appwrite-Response-Format' : '1.8.0',
         }
 

appwrite/services/databases.py

@@ -456,7 +456,7 @@ def list_collections(self, database_id: str, queries: Optional[List[str]] = None
         }, api_params)
 
     @deprecated("This API has been deprecated since 1.8.0. Please use `tablesDB.create_table` instead.")
-    def create_collection(self, database_id: str, collection_id: str, name: str, permissions: Optional[List[str]] = None, document_security: Optional[bool] = None, enabled: Optional[bool] = None) -> Dict[str, Any]:
+    def create_collection(self, database_id: str, collection_id: str, name: str, permissions: Optional[List[str]] = None, document_security: Optional[bool] = None, enabled: Optional[bool] = None, attributes: Optional[List[dict]] = None, indexes: Optional[List[dict]] = None) -> Dict[str, Any]:
         """
         Create a new Collection. Before using this route, you should create a new database resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
 
@@ -476,6 +476,10 @@ def create_collection(self, database_id: str, collection_id: str, name: str, per
             Enables configuring permissions for individual documents. A user needs one of document or collection level permissions to access a document. [Learn more about permissions](https://appwrite.io/docs/permissions).
         enabled : Optional[bool]
             Is collection enabled? When set to 'disabled', users cannot access the collection but Server SDKs with and API key can still read and write to the collection. No data is lost when this is toggled.
+        attributes : Optional[List[dict]]
+            Array of attribute definitions to create. Each attribute should contain: key (string), type (string: string, integer, float, boolean, datetime), size (integer, required for string type), required (boolean, optional), default (mixed, optional), array (boolean, optional), and type-specific options.
+        indexes : Optional[List[dict]]
+            Array of index definitions to create. Each index should contain: key (string), type (string: key, fulltext, unique, spatial), attributes (array of attribute keys), orders (array of ASC/DESC, optional), and lengths (array of integers, optional).
         
         Returns
         -------
@@ -508,6 +512,10 @@ def create_collection(self, database_id: str, collection_id: str, name: str, per
             api_params['documentSecurity'] = document_security
         if enabled is not None:
             api_params['enabled'] = enabled
+        if attributes is not None:
+            api_params['attributes'] = attributes
+        if indexes is not None:
+            api_params['indexes'] = indexes
 
         return self.client.call('post', api_path, {
             'content-type': 'application/json',

appwrite/services/tables_db.py

@@ -437,7 +437,7 @@ def list_tables(self, database_id: str, queries: Optional[List[str]] = None, sea
         return self.client.call('get', api_path, {
         }, api_params)
 
-    def create_table(self, database_id: str, table_id: str, name: str, permissions: Optional[List[str]] = None, row_security: Optional[bool] = None, enabled: Optional[bool] = None) -> Dict[str, Any]:
+    def create_table(self, database_id: str, table_id: str, name: str, permissions: Optional[List[str]] = None, row_security: Optional[bool] = None, enabled: Optional[bool] = None, columns: Optional[List[dict]] = None, indexes: Optional[List[dict]] = None) -> Dict[str, Any]:
         """
         Create a new Table. Before using this route, you should create a new database resource using either a [server integration](https://appwrite.io/docs/references/cloud/server-dart/tablesDB#createTable) API or directly from your database console.
 
@@ -455,6 +455,10 @@ def create_table(self, database_id: str, table_id: str, name: str, permissions:
             Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a row. [Learn more about permissions](https://appwrite.io/docs/permissions).
         enabled : Optional[bool]
             Is table enabled? When set to 'disabled', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.
+        columns : Optional[List[dict]]
+            Array of column definitions to create. Each column should contain: key (string), type (string: string, integer, float, boolean, datetime, relationship), size (integer, required for string type), required (boolean, optional), default (mixed, optional), array (boolean, optional), and type-specific options.
+        indexes : Optional[List[dict]]
+            Array of index definitions to create. Each index should contain: key (string), type (string: key, fulltext, unique, spatial), attributes (array of column keys), orders (array of ASC/DESC, optional), and lengths (array of integers, optional).
         
         Returns
         -------
@@ -487,6 +491,10 @@ def create_table(self, database_id: str, table_id: str, name: str, permissions:
             api_params['rowSecurity'] = row_security
         if enabled is not None:
             api_params['enabled'] = enabled
+        if columns is not None:
+            api_params['columns'] = columns
+        if indexes is not None:
+            api_params['indexes'] = indexes
 
         return self.client.call('post', api_path, {
             'content-type': 'application/json',

docs/examples/account/create-anonymous-session.md

@@ -4,6 +4,7 @@ from appwrite.services.account import Account
 client = Client()
 client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
 client.set_project('<YOUR_PROJECT_ID>') # Your project ID
+client.set_session('') # The user session to authenticate with
 
 account = Account(client)
 

docs/examples/account/create-email-password-session.md

@@ -4,6 +4,7 @@ from appwrite.services.account import Account
 client = Client()
 client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
 client.set_project('<YOUR_PROJECT_ID>') # Your project ID
+client.set_session('') # The user session to authenticate with
 
 account = Account(client)
 

docs/examples/account/create-email-token.md

@@ -4,6 +4,7 @@ from appwrite.services.account import Account
 client = Client()
 client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
 client.set_project('<YOUR_PROJECT_ID>') # Your project ID
+client.set_session('') # The user session to authenticate with
 
 account = Account(client)
 

docs/examples/account/create-jwt.md

@@ -4,6 +4,7 @@ from appwrite.services.account import Account
 client = Client()
 client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
 client.set_project('<YOUR_PROJECT_ID>') # Your project ID
+client.set_session('') # The user session to authenticate with
 
 account = Account(client)
 

docs/examples/account/create-magic-url-token.md

@@ -4,6 +4,7 @@ from appwrite.services.account import Account
 client = Client()
 client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
 client.set_project('<YOUR_PROJECT_ID>') # Your project ID
+client.set_session('') # The user session to authenticate with
 
 account = Account(client)
 

docs/examples/account/create-mfa-challenge.md

@@ -5,6 +5,7 @@ from appwrite.enums import AuthenticationFactor
 client = Client()
 client.set_endpoint('https://<REGION>.cloud.appwrite.io/v1') # Your API Endpoint
 client.set_project('<YOUR_PROJECT_ID>') # Your project ID
+client.set_session('') # The user session to authenticate with
 
 account = Account(client)