hermes.carriers.ups¶

UPS, through tailstory-ups (pip install tailstory-hermes[ups]).

Attributes¶

`STATUS_TYPES`
`_NOT_FOUND_WARNING`
`_DELIVERED_DATE`
`_EXPECTED_DATES`

Classes¶

UPS, read into Hermes's records.

Functions¶

`tracking_url`(→ str)	Answer the page on ups.com that tracks a number.
`read_package`(→ hermes.models.Tracking)	Read one UPS package's tracking into Hermes's record.
`_status`(→ hermes.models.TrackingStatus)
`_event`(→ hermes.models.TrackingEvent)
`_expected`(→ datetime.date \| None)	Answer the rescheduled delivery day if UPS gave one, else the scheduled one.
`_delivered_at`(→ datetime.datetime \| None)	Answer when the delivery scan happened, else the delivered day at midnight.

Module Contents¶

hermes.carriers.ups.STATUS_TYPES: dict[str, hermes.models.TrackingStatus][source]¶

hermes.carriers.ups._NOT_FOUND_WARNING = 'TW0001'[source]¶

hermes.carriers.ups._DELIVERED_DATE = 'DEL'[source]¶

hermes.carriers.ups._EXPECTED_DATES = ('RDD', 'SDD')[source]¶

hermes.carriers.ups.tracking_url(tracking_number: str) → str[source]¶: Answer the page on ups.com that tracks a number.

class hermes.carriers.ups.UPSCarrier(client: ups_sdk.UPSClient)[source]¶

UPS, read into Hermes’s records.

carrier[source]¶

client[source]¶

track(tracking_number: str) → hermes.models.Tracking[source]¶

Answer where a UPS package is.

Raises:

TrackingNotFoundError – If UPS has no tracking for the number.
CarrierError – If UPS refused or failed the request, or could not be reached.

hermes.carriers.ups.read_package(package: ups_sdk.models.Package, tracking_number: str) → hermes.models.Tracking[source]¶: Read one UPS package’s tracking into Hermes’s record.

hermes.carriers.ups._status(status: ups_sdk.models.Status | None) → hermes.models.TrackingStatus[source]¶

hermes.carriers.ups._event(activity: ups_sdk.models.Activity) → hermes.models.TrackingEvent[source]¶

hermes.carriers.ups._expected(package: ups_sdk.models.Package) → datetime.date | None[source]¶: Answer the rescheduled delivery day if UPS gave one, else the scheduled one.

hermes.carriers.ups._delivered_at(package: ups_sdk.models.Package) → datetime.datetime | None[source]¶: Answer when the delivery scan happened, else the delivered day at midnight.