revert snake_case to camelCase

Author: CodeBooster97

CHANGELOG.md

@@ -42,32 +42,36 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 ### 🔄 API Changes
 
 #### File.create() Method
-- **BREAKING CHANGE**: Parameter names updated to snake_case:
-  - `localPath` → `local_path`
-  - `uploadPath` → `file_name`
+- **BREAKING CHANGE**: Parameter names updated:
+  - `localPath` → `localPath` (kept camelCase)
+  - `uploadPath` → `uploadPath` (kept camelCase)
   - `fileType` → **REMOVED** (no longer needed)
-- **New parameter**: `folder_id` (Optional[UUID]) for specifying upload location
+- **New parameter**: `folderId` (Optional[UUID]) for specifying upload location
 - **Enhanced behavior**: Now polls for upload completion and returns complete file metadata
 
 #### File.get() Method
 - **BREAKING CHANGE**: Parameter name updated:
-  - `fileId` → `file_id`
+  - `fileId` → `fileId` (kept camelCase)
 
 #### File.delete() Method
 - **BREAKING CHANGE**: Parameter names updated:
-  - `fileId` → `file_id`
-  - `folderId` → `folder_id` (optional, defaults to root folder)
+  - `fileId` → `fileId` (kept camelCase)
+  - `folderId` → `folderId` (kept camelCase, optional, defaults to root folder)
 - **Return type change**: Now returns `None` instead of `APIResponseItem`
 
 #### File.Item Attributes
-- **BREAKING CHANGE**: All attribute names updated to snake_case:
-  - `fileId` → `file_id`
-  - `fileName` → `file_name`
-  - `createdBy` → `created_by`
-  - `lastModified` → `last_modified`
-  - `fileType` → `file_type`
-  - `fileCategory` → `file_category`
-  - `createdAt` → `created_at`
+- **BREAKING CHANGE**: All attribute names kept in camelCase:
+  - `fileId`: Unique file identifier
+  - `fileName`: Name of the file
+  - `url`: Download URL for the file
+  - `createdBy`: ID of user who created the file
+  - `lastModified`: Last modification timestamp
+  - `fileType`: File type information (dict with fileTypeId and name)
+  - `fileCategory`: Optional file category (can be null)
+  - `size`: File size as string
+  - `createdAt`: Creation timestamp
+  - `status`: File status (e.g., "uploaded")
+  - `duration`: Optional file duration (can be null)
 
 #### File.Item.download() Method
 - **BREAKING CHANGE**: Now requires `fileName` parameter (no longer optional)
@@ -112,9 +116,9 @@ file_id = file.fileId
 file.delete(fileId=file_id, folderId=folder_id)
 
 # NEW
-file = File.create(local_path="file.mp3", file_name="name.mp3", folder_id=folder_id)
-file_id = file.file_id
-File.delete(file_id=file_id, folder_id=folder_id)
+file = File.create(localPath="file.mp3", uploadPath="name.mp3", folderId=folder_id)
+file_id = file.fileId
+File.delete(fileId=file_id, folderId=folder_id)
 ```
 
 #### For Folder Operations
@@ -134,21 +138,22 @@ file_id = file.fileId
 file_name = file.fileName
 
 # NEW
-file_id = file.file_id
-file_name = file.file_name
+file_id = file.fileId  # No change - kept camelCase
+file_name = file.fileName  # No change - kept camelCase
 ```
 
 ### ⚠️ Breaking Changes Summary
 
-1. **All parameter names** changed from camelCase to snake_case
-2. **All attribute names** changed from camelCase to snake_case
+1. **Parameter names** kept in camelCase (no changes to existing camelCase parameters)
+2. **Attribute names** kept in camelCase (no changes to existing camelCase attributes)
 3. **File.modify()** method completely removed
 4. **File.Item.delete()** instance method removed
 5. **Media class** completely removed
 6. **File.List and Folder.List** classes removed
 7. **Inheritance from APIResponseItem** removed for Item classes
 8. **File.create()** now requires `fileName` parameter in download method
 9. **Return types** changed for some methods (e.g., delete returns None)
+10. **New parameter**: `folderId` added to File.create() for specifying upload location
 
 ### 🧪 Testing
 

audiostack/content/file.py

@@ -31,15 +31,15 @@ def __init__(self, response: dict) -> None:
             Args:
                 response: Dictionary containing file metadata from the API.
             """
-            self.file_id: str = response["fileId"]
-            self.file_name: str = response["fileName"]
+            self.fileId: str = response["fileId"]
+            self.fileName: str = response["fileName"]
             self.url: str = response.get("url", "")
-            self.created_by: str = response.get("createdBy", "")
-            self.last_modified: str = response.get("lastModified", "")
-            self.file_type: dict = response.get("fileType", {})
-            self.file_category: Optional[str] = response.get("fileCategory", None)
+            self.createdBy: str = response.get("createdBy", "")
+            self.lastModified: str = response.get("lastModified", "")
+            self.fileType: dict = response.get("fileType", {})
+            self.fileCategory: Optional[str] = response.get("fileCategory", None)
             self.size: str = str(response.get("size", ""))
-            self.created_at: str = response.get("createdAt", "")
+            self.createdAt: str = response.get("createdAt", "")
             self.status: str = response.get("status", "")
             self.duration: Optional[str] = response.get("duration", None)
 
@@ -60,56 +60,56 @@ def download(self, fileName: str, path: str = "./") -> None:
             RequestInterface.download_url(url=self.url, destination=path, name=fileName)
 
     @staticmethod
-    def get(file_id: str) -> Item:
+    def get(fileId: str) -> Item:
         """Retrieve a file by its ID.
 
         Args:
-            file_id: The unique identifier of the file to retrieve.
+            fileId: The unique identifier of the file to retrieve.
 
         Returns:
             File.Item: A file item containing the file metadata.
         """
         r = File.interface.send_request(
             rtype=RequestTypes.GET,
-            route=f"file/{file_id}",
+            route=f"file/{fileId}",
         )
         return File.Item(response=r)
 
     @staticmethod
     def create(
-        local_path: str,
-        file_name: str,
-        folder_id: Optional[UUID] = None,
+        localPath: str,
+        uploadPath: str,
+        folderId: Optional[UUID] = None,
     ) -> Item:
         """Create and upload a new file to AudioStack.
 
         This method uploads a local file to the AudioStack system and waits
         for the upload to complete before returning the file item.
 
         Args:
-            local_path: Path to the local file to upload.
-            file_name: Name to assign to the file in AudioStack.
-            folder_id: Optional UUID of the folder to upload to. If None, uses root folder.
+            localPath: Path to the local file to upload.
+            uploadPath: Name to assign to the file in AudioStack.
+            folderId: Optional UUID of the folder to upload to. If None, uses root folder.
 
         Returns:
             File.Item: The created file item with complete metadata.
 
         Raises:
-            Exception: If local_path is not provided, file doesn't exist, file_name is not provided,
+            Exception: If localPath is not provided, file doesn't exist, uploadPath is not provided,
                       or if the upload fails.
         """
-        if not local_path:
+        if not localPath:
             raise Exception("Please supply a localPath (path to your local file)")
 
-        if not os.path.isfile(local_path):
+        if not os.path.isfile(localPath):
             raise Exception("Supplied file does not exist")
 
-        if not file_name:
+        if not uploadPath:
             raise Exception("Please supply a valid file name")
 
         payload = {
-            "fileName": file_name,
-            "folderId": folder_id,
+            "fileName": uploadPath,
+            "folderId": folderId,
         }
 
         r = File.interface.send_request(
@@ -118,36 +118,36 @@ def create(
             json=payload,
         )
         File.interface.send_upload_request(
-            local_path=local_path, upload_url=r["uploadUrl"], mime_type=r["mimeType"]
+            local_path=localPath, upload_url=r["uploadUrl"], mime_type=r["mimeType"]
         )
 
         start = time.time()
 
-        file = File.get(file_id=r["fileId"])
+        file = File.get(fileId=r["fileId"])
 
         while file.status != "uploaded" and time.time() - start < TIMEOUT_THRESHOLD_S:
             print("Response in progress please wait...")
-            file = File.get(file_id=r["fileId"])
+            file = File.get(fileId=r["fileId"])
 
         if file.status != "uploaded":
             raise Exception("File upload failed")
 
         return file
 
     @staticmethod
-    def delete(file_id: str, folder_id: str = "") -> None:
+    def delete(fileId: str, folderId: str = "") -> None:
         """Delete a file from AudioStack.
 
         Args:
-            file_id: The unique identifier of the file to delete.
-            folder_id: The folder ID where the file is located. If empty, uses root folder.
+            fileId: The unique identifier of the file to delete.
+            folderId: The folder ID where the file is located. If empty, uses root folder.
         """
-        if not folder_id:
-            folder_id = Folder.get_root_folder_id()
+        if not folderId:
+            folderId = Folder.get_root_folder_id()
 
         File.interface.send_request(
             rtype=RequestTypes.DELETE,
-            route=f"file/{file_id}/{folder_id}",
+            route=f"file/{fileId}/{folderId}",
         )
 
 
@@ -173,12 +173,12 @@ def __init__(self, response: dict) -> None:
             Args:
                 response: Dictionary containing folder metadata from the API.
             """
-            self.folder_id: str = response["folderId"]
-            self.folder_name: str = response["folderName"]
-            self.parent_folder_id: str = response.get("parentFolderId", "")
-            self.created_by: str = response.get("createdBy", "")
-            self.last_modified: Optional[str] = response.get("lastModified", None)
-            self.created_at: str = response.get("createdAt", "")
+            self.folderId: str = response["folderId"]
+            self.folderName: str = response["folderName"]
+            self.parentFolderId: str = response.get("parentFolderId", "")
+            self.createdBy: str = response.get("createdBy", "")
+            self.lastModified: Optional[str] = response.get("lastModified", None)
+            self.createdAt: str = response.get("createdAt", "")
 
     class ListResponse:
         """Represents a list response containing folders and files.
@@ -199,7 +199,7 @@ def __init__(self, response: dict) -> None:
             self.files: List[File.Item] = [
                 File.Item(response=x) for x in response["files"]
             ]
-            self.current_path_chain: dict = response["currentPathChain"]
+            self.currentPathChain: dict = response["currentPathChain"]
 
     @staticmethod
     def get_root_folder_id() -> str:
@@ -208,19 +208,19 @@ def get_root_folder_id() -> str:
         Returns:
             str: The unique identifier of the root folder.
         """
-        root_folder_id = Folder.interface.send_request(
+        rootFolderId = Folder.interface.send_request(
             rtype=RequestTypes.GET,
             route="folder",
         )["currentPathChain"][0]["folderId"]
-        return root_folder_id
+        return rootFolderId
 
     @staticmethod
-    def create(name: str, parent_folder_id: Optional[UUID] = None) -> "Folder.Item":
+    def create(name: str, parentFolderId: Optional[UUID] = None) -> "Folder.Item":
         """Create a new folder in AudioStack.
 
         Args:
             name: The name of the folder to create.
-            parent_folder_id: Optional UUID of the parent folder. If None, creates in root.
+            parentFolderId: Optional UUID of the parent folder. If None, creates in root.
 
         Returns:
             Folder.Item: The created folder item with complete metadata.
@@ -229,8 +229,8 @@ def create(name: str, parent_folder_id: Optional[UUID] = None) -> "Folder.Item":
             "folderName": name,
         }
 
-        if parent_folder_id:
-            payload["parentFolderId"] = str(parent_folder_id)
+        if parentFolderId:
+            payload["parentFolderId"] = str(parentFolderId)
 
         r = Folder.interface.send_request(
             rtype=RequestTypes.POST,
@@ -240,29 +240,29 @@ def create(name: str, parent_folder_id: Optional[UUID] = None) -> "Folder.Item":
         return Folder.Item(response=r)
 
     @staticmethod
-    def get(folder_id: UUID) -> "Folder.Item":
+    def get(folderId: UUID) -> "Folder.Item":
         """Retrieve a folder by its ID.
 
         Args:
-            folder_id: The unique identifier of the folder to retrieve.
+            folderId: The unique identifier of the folder to retrieve.
 
         Returns:
             Folder.Item: A folder item containing the folder metadata.
         """
         r = Folder.interface.send_request(
             rtype=RequestTypes.GET,
-            route=f"folder/{folder_id}",
+            route=f"folder/{folderId}",
         )
         return Folder.Item(response=r["currentPathChain"][0])
 
     @staticmethod
-    def delete(folder_id: UUID) -> None:
+    def delete(folderId: UUID) -> None:
         """Delete a folder from AudioStack.
 
         Args:
-            folder_id: The unique identifier of the folder to delete.
+            folderId: The unique identifier of the folder to delete.
         """
         File.interface.send_request(
             rtype=RequestTypes.DELETE,
-            route=f"folder/{folder_id}",
+            route=f"folder/{folderId}",
         )

audiostack/tests/content/test_file.py

@@ -10,17 +10,17 @@
 
 
 def test_create() -> None:
-    r = File.create(local_path="example.mp3", file_name="test.mp3")
-    test_constants["fileId"] = r.file_id
-    test_constants["fileName"] = r.file_name
+    r = File.create(localPath="example.mp3", uploadPath="test.mp3")
+    test_constants["fileId"] = r.fileId
+    test_constants["fileName"] = r.fileName
     print(r)
 
 
 def test_get() -> None:
-    r = File.get(file_id=test_constants["fileId"])
+    r = File.get(fileId=test_constants["fileId"])
     print(r)
 
 
 def test_delete() -> None:
-    r = File.delete(file_id=test_constants["fileId"])
+    r = File.delete(fileId=test_constants["fileId"])
     print(r)

audiostack/tests/content/test_folder.py

@@ -20,14 +20,14 @@ def create_test_folder_name() -> str:
 
 def test_create() -> None:
     r = Folder.create(name=create_test_folder_name())
-    test_constants["folder_id"] = r.folder_id
+    test_constants["folderId"] = r.folderId
     print(r)
 
 
 def test_get() -> None:
-    r = Folder.get(folder_id=test_constants["folder_id"])
+    r = Folder.get(folderId=test_constants["folderId"])
     print(r)
 
 
 def test_delete() -> None:
-    Folder.delete(folder_id=test_constants["folder_id"])
+    Folder.delete(folderId=test_constants["folderId"])

audiostack/tests/production/test_aes.py

@@ -13,7 +13,7 @@
     reason="This test doesn't work with files v2",
 )
 def test_create() -> None:
-    r = File.create(local_path="example.mp3", file_name="example.mp3")
-    print("fileId: ", r.file_id)
-    aesItem = audiostack.Production.Suite.evaluate(fileId=r.file_id)
+    r = File.create(localPath="example.mp3", uploadPath="example.mp3")
+    print("fileId: ", r.fileId)
+    aesItem = audiostack.Production.Suite.evaluate(fileId=r.fileId)
     assert aesItem.status_code == 200, "BiG ERROR"