samsara-api 0.0.1__py3-none-any.whl → 0.0.2__py3-none-any.whl

samsara/reports/ifta/vehicle/types/vehicle_get_request_quarter.py

@@ -1,5 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-VehicleGetRequestQuarter = typing.Union[typing.Literal["Q1", "Q2", "Q3", "Q4"], typing.Any]

samsara/reports/vehicles/fuel_energy/types/fuel_energy_get_request_energy_type.py

@@ -1,5 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-FuelEnergyGetRequestEnergyType = typing.Union[typing.Literal["fuel", "hybrid", "electric"], typing.Any]

samsara/types/assets_create_asset_response_body_regulation_mode.py

@@ -1,7 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-AssetsCreateAssetResponseBodyRegulationMode = typing.Union[
-    typing.Literal["mixed", "regulated", "unregulated"], typing.Any
-]

samsara/types/assets_update_asset_response_body_regulation_mode.py

@@ -1,7 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-AssetsUpdateAssetResponseBodyRegulationMode = typing.Union[
-    typing.Literal["mixed", "regulated", "unregulated"], typing.Any
-]

samsara/types/assets_update_asset_response_body_type.py

@@ -1,7 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-AssetsUpdateAssetResponseBodyType = typing.Union[
-    typing.Literal["uncategorized", "trailer", "equipment", "unpowered", "vehicle"], typing.Any
-]

samsara/types/patch_shipping_docs_response_body_response_body.py

@@ -1,93 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-import typing
-
-import pydantic
-import typing_extensions
-from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
-from ..core.serialization import FieldMetadata
-
-
-class PatchShippingDocsResponseBodyResponseBody(UniversalBaseModel):
-    """
-    Response after successfully updating the LogMetaData object.
-    """
-
-    adverse_driving_claimed: typing_extensions.Annotated[
-        typing.Optional[bool], FieldMetadata(alias="adverseDrivingClaimed")
-    ] = pydantic.Field(default=None)
-    """
-    Whether the driver has claimed the [Adverse Driving Exemption](https://kb.samsara.com/hc/en-us/articles/360047336792-Adverse-Driving-Exemption) for this HOS day chart.
-    """
-
-    big_day_claimed: typing_extensions.Annotated[typing.Optional[bool], FieldMetadata(alias="bigDayClaimed")] = (
-        pydantic.Field(default=None)
-    )
-    """
-    Whether the driver has claimed the [Big Day Exemption](https://kb.samsara.com/hc/en-us/articles/360057113891-16-Hour-Short-Haul-Exemption-Big-Day-) for this HOS day chart.
-    """
-
-    carrier_formatted_address: typing_extensions.Annotated[
-        typing.Optional[str], FieldMetadata(alias="carrierFormattedAddress")
-    ] = pydantic.Field(default=None)
-    """
-    The address of the carrier used for this HOS chart.
-    """
-
-    carrier_name: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="carrierName")] = (
-        pydantic.Field(default=None)
-    )
-    """
-    The name of the carrier used for this HOS chart.
-    """
-
-    carrier_us_dot_number: typing_extensions.Annotated[
-        typing.Optional[int], FieldMetadata(alias="carrierUsDotNumber")
-    ] = pydantic.Field(default=None)
-    """
-    The US DOT number of the carrier used for this HOS chart.
-    """
-
-    home_terminal_formatted_address: typing_extensions.Annotated[
-        typing.Optional[str], FieldMetadata(alias="homeTerminalFormattedAddress")
-    ] = pydantic.Field(default=None)
-    """
-    The address of the Home Terminal used for this HOS chart.
-    """
-
-    home_terminal_name: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="homeTerminalName")] = (
-        pydantic.Field(default=None)
-    )
-    """
-    The name of the Home Terminal used for this HOS chart.
-    """
-
-    is_certified: typing_extensions.Annotated[typing.Optional[bool], FieldMetadata(alias="isCertified")] = (
-        pydantic.Field(default=None)
-    )
-    """
-    Whether this HOS day chart was certified by the driver.
-    """
-
-    is_us_short_haul_active: typing_extensions.Annotated[
-        typing.Optional[bool], FieldMetadata(alias="isUsShortHaulActive")
-    ] = pydantic.Field(default=None)
-    """
-    Whether the driver has the 150 air-mile Short Haul Exemption active for this HOS day chart.
-    """
-
-    trailer_names: typing_extensions.Annotated[
-        typing.Optional[typing.List[str]], FieldMetadata(alias="trailerNames")
-    ] = pydantic.Field(default=None)
-    """
-    List of trailer names associated with the driver for the day. If a trailer was associated with a log through the driver app, the trailer name will be the trailer ID.
-    """
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow

samsara_api-0.0.1.dist-info/METADATA

@@ -1,214 +0,0 @@
-Metadata-Version: 2.1
-Name: samsara-api
-Version: 0.0.1
-Summary: 
-License: MIT
-Requires-Python: >=3.8,<4.0
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: OS Independent
-Classifier: Operating System :: POSIX
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Typing :: Typed
-Requires-Dist: httpx (>=0.21.2)
-Requires-Dist: pydantic (>=1.9.2)
-Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
-Requires-Dist: typing_extensions (>=4.0.0)
-Description-Content-Type: text/markdown
-
-# Samsara Python Library
-
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fsamsarahq%2Fsamsara-python-sdk)
-[![pypi](https://img.shields.io/pypi/v/samsara-api)](https://pypi.python.org/pypi/samsara-api)
-
-The Samsara Python library provides convenient access to the Samsara API from Python.
-
-## Installation
-
-```sh
-pip install samsara-api
-```
-
-## Reference
-
-A full reference for this library is available [here](./reference.md).
-
-## Usage
-
-Instantiate and use the client with the following:
-
-```python
-from samsara import CreateAddressRequestGeofence, Samsara
-
-client = Samsara(
-    token="YOUR_TOKEN",
-)
-client.addresses.create(
-    formatted_address="350 Rhode Island St, San Francisco, CA",
-    geofence=CreateAddressRequestGeofence(),
-    name="Samsara HQ",
-)
-```
-
-## Async Client
-
-The SDK also exports an `async` client so that you can make non-blocking calls to our API.
-
-```python
-import asyncio
-
-from samsara import AsyncSamsara, CreateAddressRequestGeofence
-
-client = AsyncSamsara(
-    token="YOUR_TOKEN",
-)
-
-
-async def main() -> None:
-    await client.addresses.create(
-        formatted_address="350 Rhode Island St, San Francisco, CA",
-        geofence=CreateAddressRequestGeofence(),
-        name="Samsara HQ",
-    )
-
-
-asyncio.run(main())
-```
-
-## Exception Handling
-
-When the API returns a non-success status code (4xx or 5xx response), a subclass of the following error
-will be thrown.
-
-```python
-from samsara.core.api_error import ApiError
-
-try:
-    client.addresses.create(...)
-except ApiError as e:
-    print(e.status_code)
-    print(e.body)
-```
-
-## Pagination
-
-Paginated requests will return a `SyncPager` or `AsyncPager`, which can be used as generators for the underlying object.
-
-```python
-from samsara import Samsara
-
-client = Samsara(
-    token="YOUR_TOKEN",
-)
-response = client.addresses.list()
-for item in response:
-    yield item
-# alternatively, you can paginate page-by-page
-for page in response.iter_pages():
-    yield page
-```
-
-## Advanced
-
-### Access Raw Response Data
-
-The SDK provides access to raw response data, including headers, through the `.with_raw_response` property.
-The `.with_raw_response` property returns a "raw" client that can be used to access the `.headers` and `.data` attributes.
-
-```python
-from samsara import Samsara
-
-client = Samsara(
-    ...,
-)
-response = client.addresses.with_raw_response.create(...)
-print(response.headers)  # access the response headers
-print(response.data)  # access the underlying object
-pager = client.addresses.list(...)
-print(pager.response.headers)  # access the response headers for the first page
-for item in pager:
-    print(item)  # access the underlying object(s)
-for page in pager.iter_pages():
-    print(page.response.headers)  # access the response headers for each page
-    for item in page:
-        print(item)  # access the underlying object(s)
-```
-
-### Retries
-
-The SDK is instrumented with automatic retries with exponential backoff. A request will be retried as long
-as the request is deemed retryable and the number of retry attempts has not grown larger than the configured
-retry limit (default: 2).
-
-A request is deemed retryable when any of the following HTTP status codes is returned:
-
-- [408](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/408) (Timeout)
-- [429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) (Too Many Requests)
-- [5XX](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/500) (Internal Server Errors)
-
-Use the `max_retries` request option to configure this behavior.
-
-```python
-client.addresses.create(..., request_options={
-    "max_retries": 1
-})
-```
-
-### Timeouts
-
-The SDK defaults to a 60 second timeout. You can configure this with a timeout option at the client or request level.
-
-```python
-
-from samsara import Samsara
-
-client = Samsara(
-    ...,
-    timeout=20.0,
-)
-
-
-# Override timeout for a specific method
-client.addresses.create(..., request_options={
-    "timeout_in_seconds": 1
-})
-```
-
-### Custom Client
-
-You can override the `httpx` client to customize it for your use-case. Some common use-cases include support for proxies
-and transports.
-
-```python
-import httpx
-from samsara import Samsara
-
-client = Samsara(
-    ...,
-    httpx_client=httpx.Client(
-        proxies="http://my.test.proxy.example.com",
-        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
-    ),
-)
-```
-
-## Contributing
-
-While we value open-source contributions to this SDK, this library is generated programmatically.
-Additions made directly to this library would have to be moved over to our generation code,
-otherwise they would be overwritten upon the next generated release. Feel free to open a PR as
-a proof of concept, but know that we will not be able to merge it as-is. We suggest opening
-an issue first to discuss with us!
-
-On the other hand, contributions to the README are always very welcome!
-