Pysdksls 01 saved locations (#115)

* Introduce Saved_Locations support.
Deprecate OAUTH, & Accounts

* Minor version bump

---------

Co-authored-by: Paul Duncan <[email protected]>

Author: PaulDDD

README.md

@@ -35,14 +35,15 @@ If you are migrating to version 5.0.0 or above from an earlier version, please c
 
 We support all the endpoints available in our API.
 
-* `oauth2`
-* `accounts`
+* `oauth2` (deprecated, use `access_token` instead)
+* `accounts` (deprecated)
 * `broadcasts`
 * `events`
 * `features`
 * `places`
 * `radius`
 * `beam`
+* `saved_locations`
 
 Please refer to our [API Documentation](https://docs.predicthq.com/) for a description of each endpoint.
 
@@ -316,6 +317,27 @@ for event in phq.events.search(config={"verify_ssl": False}):
 ```
 
 
+### Saved_Locations endpoints
+
+Additional examples are available in [usecases/saved_locations.py](https://github.com/predicthq/sdk-py/tree/master/usecases/places.py) file.
+
+The following example searches for the saved_locations according to the parameters defined:
+
+```Python
+from predicthq import Client
+
+phq = Client(access_token="abc123")
+
+
+for saved_location in phq.saved_locations.search(
+        labels=["test", "retail"],
+        q="London", 
+        sort="-created",
+    ):
+        print(saved_location.location_id, saved_location.create_dt, saved_location.status)
+```
+
+
 ## Running Tests
 
 ```Shell

predicthq/client.py

@@ -36,6 +36,7 @@ def initialize_endpoints(self):
         self.places = endpoints.PlacesEndpoint(proxy(self))
         self.radius = endpoints.SuggestedRadiusEndpoint(proxy(self))
         self.beam = endpoints.BeamEndpoint(proxy(self))
+        self.saved_locations = endpoints.SavedLocationsEndpoint(proxy(self))
 
     def get_headers(self, headers):
         _headers = {

predicthq/config.py

@@ -12,7 +12,6 @@
 
 
 class Config(object):
-
     _config_sections = (
         "endpoint",
         "oauth2",

predicthq/endpoints/__init__.py

@@ -6,6 +6,7 @@
 from .v1.places import PlacesEndpoint
 from .v1.radius import SuggestedRadiusEndpoint
 from .v1.beam import BeamEndpoint
+from .v1.saved_locations import SavedLocationsEndpoint
 
 
 __all__ = [
@@ -17,4 +18,5 @@
     "PlacesEndpoint",
     "SuggestedRadiusEndpoint",
     "BeamEndpoint",
+    "SavedLocationsEndpoint",
 ]

predicthq/endpoints/base.py

@@ -3,7 +3,7 @@ def __new__(mcs, name, bases, data):
         if "Meta" not in data:
 
             class Meta:
-                """ Used by decorators when overriding schema classes """
+                """Used by decorators when overriding schema classes"""
 
                 pass
 

predicthq/endpoints/oauth2/endpoint.py

@@ -2,9 +2,17 @@
 from predicthq.endpoints.decorators import accepts, returns
 from .decorators import preload_config_defaults
 from .schemas import AccessToken
+from deprecated import deprecated
 
 
 class OAuth2Endpoint(BaseEndpoint):
+    @deprecated(
+        reason=(
+            "OAuth2 endpoints in the SDK are deprecated and will be removed in future releases. "
+            "Use TokenAuth (API Access Token) with Client(..., access_token=...)."
+        ),
+        category=FutureWarning,
+    )
     @accepts()
     @preload_config_defaults(["client_id", "client_secret", "scope", "grant_type"])
     @returns(AccessToken)
@@ -22,6 +30,13 @@ def get_token(self, client_id, client_secret, scope, grant_type, **kwargs):
             verify=verify_ssl,
         )
 
+    @deprecated(
+        reason=(
+            "OAuth2 endpoints in the SDK are deprecated and will be removed in future releases. "
+            "Use TokenAuth (API Access Token) with Client(..., access_token=...)."
+        ),
+        category=FutureWarning,
+    )
     @accepts()
     @preload_config_defaults(["client_id", "client_secret", "token_type_hint"])
     def revoke_token(self, client_id, client_secret, token, token_type_hint, **kwargs):

predicthq/endpoints/v1/accounts/endpoint.py

@@ -1,9 +1,17 @@
 from predicthq.endpoints.base import BaseEndpoint
 from predicthq.endpoints.decorators import returns
 from .schemas import Account
+from deprecated import deprecated
 
 
 class AccountsEndpoint(BaseEndpoint):
+    @deprecated(
+        reason=(
+            "The Accounts endpoint in the SDK is deprecated and will be removed in future releases. "
+            "Account information can be managed via the PredictHQ dashboard."
+        ),
+        category=FutureWarning,
+    )
     @returns(Account)
     def self(self):
         return self.client.get(self.build_url("v1", "accounts/self"))

predicthq/endpoints/v1/beam/endpoint.py

@@ -9,7 +9,7 @@
     AnalysisGroup,
     AnalysisGroupResultSet,
     GeoJson,
-    Place
+    Place,
 )
 from predicthq.endpoints.decorators import accepts, returns
 from typing import overload, List, Optional, TextIO, Union
@@ -185,8 +185,8 @@ def upload_demand(
             self,
             analysis_id: str,
             json: Optional[Union[str, TextIO]] = None,
-            ndjson:  Optional[Union[str, TextIO]] = None,
-            csv:  Optional[Union[str, TextIO]] = None,
+            ndjson: Optional[Union[str, TextIO]] = None,
+            csv: Optional[Union[str, TextIO]] = None,
             **params,
         ): ...
         def upload_demand(self, analysis_id: str, **params):

predicthq/endpoints/v1/beam/schemas.py

@@ -1,10 +1,11 @@
 from pydantic import BaseModel, Field, ConfigDict
 from datetime import datetime
 from predicthq.endpoints.schemas import ArgKwargResultSet
-from typing import Optional, List
+from typing import Optional, List, Union
 
 # Python < 3.11 does not have StrEnum in the enum module
 import sys
+
 if sys.version_info < (3, 11):
     import enum
 
@@ -38,7 +39,6 @@ def get_next(self):
         return self._more(**self._kwargs)
 
 
-
 class CreateAnalysisResponse(BaseModel):
     model_config: ConfigDict = ConfigDict(extra="allow")
 
@@ -55,10 +55,11 @@ class GeoPoint(BaseModel):
 class Location(BaseModel):
     model_config: ConfigDict = ConfigDict(extra="allow")
 
-    geopoint: GeoPoint
-    radius: float
-    unit: str
+    geopoint: Optional[GeoPoint] = None
+    radius: Optional[float] = None
+    unit: Optional[str] = None
     google_place_id: Optional[str] = None
+    saved_location_id: Optional[str] = None
 
 
 class RankLevel(BaseModel):

predicthq/endpoints/v1/features/endpoint.py

@@ -19,9 +19,7 @@ class FeaturesEndpoint(UserBaseEndpoint):
     def mutate_bool_to_default_for_type(cls, user_request_spec):
         for key, val in user_request_spec.items():
             if any(key.startswith(x) for x in cls.FIELDS_TO_MUTATE):
-                user_request_spec[key] = [
-                    cls.BASE_FEATURE_CRITERIA if isinstance(v, bool) else v for v in val
-                ]
+                user_request_spec[key] = [cls.BASE_FEATURE_CRITERIA if isinstance(v, bool) else v for v in val]
 
     @accepts(query_string=False)
     @returns(FeatureResultSet)