Merge pull request #271 from uploadcare/feature/261-deprecate_group_s…

…tore

Add deprecation warnings for GroupsAPI.storage and FileGroup.datetime_stored, fixes #261

HISTORY.md

@@ -6,6 +6,16 @@ The format is based on [Keep a
 Changelog](https://keepachangelog.com/en/1.0.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.2.3](https://github.com/uploadcare/pyuploadcare/compare/v4.2.2...v4.2.3) - unreleased
+
+### Deprecated
+
+- For `FileGroup`:
+  - Added a deprecation warning when accessing `datetime_stored` property, as it has been deprecated in the REST API. This field does not exist in REST API v0.7.x.
+
+- For `GroupsAPI`:
+  - Added a deprecation warning when calling `store` method, as it has been deprecated in the REST API. This API endpoint does not exist in REST API v0.7.x.
+
 ## [4.2.2](https://github.com/uploadcare/pyuploadcare/compare/v4.2.1...v4.2.2) - 2023-11-20
 
 ### Added

pyuploadcare/api/api.py

@@ -1,6 +1,7 @@
 import hashlib
 import hmac
 import logging
+import warnings
 from json import JSONDecodeError
 from time import time
 from typing import Any, Dict, Iterable, List, Optional, Type, Union, cast
@@ -122,6 +123,11 @@ class GroupsAPI(API, ListCountMixin, RetrieveMixin, DeleteMixin):
     }
 
     def store(self, file_uuid: Union[UUID, str]) -> Dict[str, Any]:
+        warnings.warn(
+            "/groups/:uuid/storage/ endpoint has been removed from REST API v0.7"
+            "https://uploadcare.com/api-refs/rest-api/v0.7.0/#tag/Changelog",
+            DeprecationWarning,
+        )
         url = self._build_url(file_uuid, suffix="storage")
         return self._client.put(url).json()
 

pyuploadcare/resources/file_group.py

@@ -1,4 +1,5 @@
 import re
+import warnings
 from datetime import datetime
 from typing import TYPE_CHECKING, Any, Dict, Iterable, Iterator, Optional
 
@@ -152,6 +153,10 @@ def update_info(self):
     @property
     def datetime_stored(self):
         """Returns file group's store aware *datetime* in UTC format."""
+        warnings.warn(
+            "datetime_stored has been removed from REST API v0.7",
+            DeprecationWarning,
+        )
         datetime_ = self.info.get("datetime_stored")
         if isinstance(datetime_, str):
             return dateutil.parser.parse(datetime_)