samsara-api 4.1.1__py3-none-any.whl → 4.3.0__py3-none-any.whl

samsara/route_events/client.py

@@ -71,12 +71,7 @@ class RouteEventsClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.route_events.get_route_events_stream(
-            after="after",
-            start_time="startTime",
-            limit=1,
-            include_external_ids=True,
-        )
+        client.route_events.get_route_events_stream()
         """
         _response = self._raw_client.get_route_events_stream(
             after=after,
@@ -156,12 +151,7 @@ class AsyncRouteEventsClient:
 
 
         async def main() -> None:
-            await client.route_events.get_route_events_stream(
-                after="after",
-                start_time="startTime",
-                limit=1,
-                include_external_ids=True,
-            )
+            await client.route_events.get_route_events_stream()
 
 
         asyncio.run(main())

samsara/route_events/raw_client.py

@@ -90,9 +90,9 @@ class RawRouteEventsClient:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -101,9 +101,9 @@ class RawRouteEventsClient:
                 raise NotFoundError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -112,9 +112,9 @@ class RawRouteEventsClient:
                 raise MethodNotAllowedError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -123,9 +123,9 @@ class RawRouteEventsClient:
                 raise TooManyRequestsError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -134,9 +134,9 @@ class RawRouteEventsClient:
                 raise InternalServerError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -145,9 +145,9 @@ class RawRouteEventsClient:
                 raise NotImplementedError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -156,9 +156,9 @@ class RawRouteEventsClient:
                 raise BadGatewayError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -167,9 +167,9 @@ class RawRouteEventsClient:
                 raise ServiceUnavailableError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -178,9 +178,9 @@ class RawRouteEventsClient:
                 raise GatewayTimeoutError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -261,9 +261,9 @@ class AsyncRawRouteEventsClient:
                 raise UnauthorizedError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -272,9 +272,9 @@ class AsyncRawRouteEventsClient:
                 raise NotFoundError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -283,9 +283,9 @@ class AsyncRawRouteEventsClient:
                 raise MethodNotAllowedError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -294,9 +294,9 @@ class AsyncRawRouteEventsClient:
                 raise TooManyRequestsError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -305,9 +305,9 @@ class AsyncRawRouteEventsClient:
                 raise InternalServerError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -316,9 +316,9 @@ class AsyncRawRouteEventsClient:
                 raise NotImplementedError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -327,9 +327,9 @@ class AsyncRawRouteEventsClient:
                 raise BadGatewayError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -338,9 +338,9 @@ class AsyncRawRouteEventsClient:
                 raise ServiceUnavailableError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -349,9 +349,9 @@ class AsyncRawRouteEventsClient:
                 raise GatewayTimeoutError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        typing.Optional[typing.Any],
+                        typing.Any,
                         parse_obj_as(
-                            type_=typing.Optional[typing.Any],  # type: ignore
+                            type_=typing.Any,  # type: ignore
                             object_=_response.json(),
                         ),
                     ),

samsara/routes/__init__.py

@@ -2,3 +2,33 @@
 
 # isort: skip_file
 
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import GetRoutesFeedRequestExpand
+_dynamic_imports: typing.Dict[str, str] = {"GetRoutesFeedRequestExpand": ".types"}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = ["GetRoutesFeedRequestExpand"]

samsara/routes/client.py

@@ -15,6 +15,7 @@ from ..types.routes_get_routes_feed_response_body import RoutesGetRoutesFeedResp
 from ..types.routes_patch_route_response_body import RoutesPatchRouteResponseBody
 from ..types.update_routes_stop_request_object_request_body import UpdateRoutesStopRequestObjectRequestBody
 from .raw_client import AsyncRawRoutesClient, RawRoutesClient
+from .types.get_routes_feed_request_expand import GetRoutesFeedRequestExpand
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -86,8 +87,6 @@ class RoutesClient:
         client.routes.fetch_routes(
             start_time="startTime",
             end_time="endTime",
-            limit=1,
-            after="after",
         )
         """
         _response = self._raw_client.fetch_routes(
@@ -185,7 +184,7 @@ class RoutesClient:
         self,
         *,
         after: typing.Optional[str] = None,
-        expand: typing.Optional[typing.Literal["route"]] = None,
+        expand: typing.Optional[GetRoutesFeedRequestExpand] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> RoutesGetRoutesFeedResponseBody:
         """
@@ -205,7 +204,7 @@ class RoutesClient:
         after : typing.Optional[str]
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
-        expand : typing.Optional[typing.Literal["route"]]
+        expand : typing.Optional[GetRoutesFeedRequestExpand]
             Expands the specified value(s) in the response object. Expansion populates additional fields in an object, if supported. Unsupported fields are ignored. To expand multiple fields, input a comma-separated list.
 
             Valid value: `route`  Valid values: `route`
@@ -225,9 +224,7 @@ class RoutesClient:
         client = Samsara(
             token="YOUR_TOKEN",
         )
-        client.routes.get_routes_feed(
-            after="after",
-        )
+        client.routes.get_routes_feed()
         """
         _response = self._raw_client.get_routes_feed(after=after, expand=expand, request_options=request_options)
         return _response.data
@@ -454,8 +451,6 @@ class RoutesClient:
 
         Examples
         --------
-        import datetime
-
         from samsara import Samsara
 
         client = Samsara(
@@ -463,15 +458,6 @@ class RoutesClient:
         )
         client.routes.list_hub_plan_routes(
             plan_id="planId",
-            route_ids="routeIds",
-            start_time=datetime.datetime.fromisoformat(
-                "2024-01-15 09:30:00+00:00",
-            ),
-            end_time=datetime.datetime.fromisoformat(
-                "2024-01-15 09:30:00+00:00",
-            ),
-            after="after",
-            limit=1,
         )
         """
         _response = self._raw_client.list_hub_plan_routes(
@@ -609,8 +595,6 @@ class AsyncRoutesClient:
             await client.routes.fetch_routes(
                 start_time="startTime",
                 end_time="endTime",
-                limit=1,
-                after="after",
             )
 
 
@@ -719,7 +703,7 @@ class AsyncRoutesClient:
         self,
         *,
         after: typing.Optional[str] = None,
-        expand: typing.Optional[typing.Literal["route"]] = None,
+        expand: typing.Optional[GetRoutesFeedRequestExpand] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> RoutesGetRoutesFeedResponseBody:
         """
@@ -739,7 +723,7 @@ class AsyncRoutesClient:
         after : typing.Optional[str]
              If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results.
 
-        expand : typing.Optional[typing.Literal["route"]]
+        expand : typing.Optional[GetRoutesFeedRequestExpand]
             Expands the specified value(s) in the response object. Expansion populates additional fields in an object, if supported. Unsupported fields are ignored. To expand multiple fields, input a comma-separated list.
 
             Valid value: `route`  Valid values: `route`
@@ -764,9 +748,7 @@ class AsyncRoutesClient:
 
 
         async def main() -> None:
-            await client.routes.get_routes_feed(
-                after="after",
-            )
+            await client.routes.get_routes_feed()
 
 
         asyncio.run(main())
@@ -1021,7 +1003,6 @@ class AsyncRoutesClient:
         Examples
         --------
         import asyncio
-        import datetime
 
         from samsara import AsyncSamsara
 
@@ -1033,15 +1014,6 @@ class AsyncRoutesClient:
         async def main() -> None:
             await client.routes.list_hub_plan_routes(
                 plan_id="planId",
-                route_ids="routeIds",
-                start_time=datetime.datetime.fromisoformat(
-                    "2024-01-15 09:30:00+00:00",
-                ),
-                end_time=datetime.datetime.fromisoformat(
-                    "2024-01-15 09:30:00+00:00",
-                ),
-                after="after",
-                limit=1,
             )