karrio-easypost 2025.5__py3-none-any.whl

karrio/providers/easypost/utils.py

@@ -0,0 +1,33 @@
+from base64 import b64encode
+import base64
+from karrio.core import Settings as BaseSettings
+from karrio.core.utils.helpers import request
+
+
+class Settings(BaseSettings):
+    """EasyPost connection settings."""
+
+    api_key: str
+    account_country_code: str = None
+    metadata: dict = {}
+    config: dict = {}
+
+    @property
+    def carrier_name(self):
+        return "easypost"
+
+    @property
+    def server_url(self):
+        return "https://api.easypost.com/v2"
+
+    @property
+    def authorization(self):
+        pair = "%s:%s" % (self.api_key, "")
+        return b64encode(pair.encode("utf-8")).decode("ascii")
+
+
+def download_label(file_url: str) -> str:
+    return request(
+        decoder=lambda b: base64.encodebytes(b).decode("utf-8"),
+        url=file_url,
+    )

karrio/schemas/easypost/error_response.py

@@ -0,0 +1,15 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class Error:
+    code: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    errors: typing.Optional[typing.List[typing.Any]] = None
+
+
+@attr.s(auto_attribs=True)
+class ErrorResponse:
+    error: typing.Optional[Error] = jstruct.JStruct[Error]

karrio/schemas/easypost/shipment_purchase.py

@@ -0,0 +1,14 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class Rate:
+    id: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentPurchase:
+    insurance: typing.Optional[float] = None
+    rate: typing.Optional[Rate] = jstruct.JStruct[Rate]

karrio/schemas/easypost/shipment_request.py

@@ -0,0 +1,79 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class Address:
+    mode: typing.Optional[str] = None
+    street1: typing.Optional[str] = None
+    street2: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    zip: typing.Optional[int] = None
+    country: typing.Optional[str] = None
+    residential: typing.Optional[bool] = None
+    carrier_facility: typing.Optional[str] = None
+    name: typing.Optional[str] = None
+    company: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+    federal_tax_id: typing.Optional[str] = None
+    state_tax_id: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomsItem:
+    description: typing.Optional[str] = None
+    hs_tariff_number: typing.Optional[int] = None
+    origin_country: typing.Optional[str] = None
+    quantity: typing.Optional[int] = None
+    value: typing.Optional[float] = None
+    weight: typing.Optional[float] = None
+    code: typing.Optional[str] = None
+    manufacturer: typing.Optional[str] = None
+    currency: typing.Optional[str] = None
+    eccn: typing.Optional[str] = None
+    printed_commodity_identifier: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomsInfo:
+    contents_explanation: typing.Optional[str] = None
+    contents_type: typing.Optional[str] = None
+    customs_certify: typing.Optional[bool] = None
+    customs_signer: typing.Optional[str] = None
+    eel_pfc: typing.Optional[str] = None
+    non_delivery_option: typing.Optional[str] = None
+    restriction_comments: typing.Optional[str] = None
+    restriction_type: typing.Optional[str] = None
+    declaration: typing.Optional[str] = None
+    customs_items: typing.Optional[typing.List[CustomsItem]] = jstruct.JList[CustomsItem]
+
+
+@attr.s(auto_attribs=True)
+class Parcel:
+    length: typing.Optional[float] = None
+    width: typing.Optional[float] = None
+    height: typing.Optional[float] = None
+    predefined_package: typing.Optional[str] = None
+    weight: typing.Optional[float] = None
+
+
+@attr.s(auto_attribs=True)
+class Shipment:
+    reference: typing.Optional[str] = None
+    is_return: typing.Optional[bool] = None
+    to_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    from_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    return_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    buyer_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    parcel: typing.Optional[Parcel] = jstruct.JStruct[Parcel]
+    customs_info: typing.Optional[CustomsInfo] = jstruct.JStruct[CustomsInfo]
+    options: typing.Any = None
+    carrier_accounts: typing.Optional[typing.List[str]] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentRequest:
+    shipment: typing.Optional[Shipment] = jstruct.JStruct[Shipment]

karrio/schemas/easypost/shipments_response.py

@@ -0,0 +1,248 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class Details:
+    longitude: typing.Optional[float] = None
+    latitude: typing.Optional[float] = None
+    time_zone: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Error:
+    suggestion: typing.Optional[str] = None
+    code: typing.Optional[str] = None
+    field: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Delivery:
+    success: typing.Optional[bool] = None
+    errors: typing.Optional[typing.List[Error]] = jstruct.JList[Error]
+    details: typing.Optional[Details] = jstruct.JStruct[Details]
+
+
+@attr.s(auto_attribs=True)
+class Verifications:
+    delivery: typing.Optional[Delivery] = jstruct.JStruct[Delivery]
+
+
+@attr.s(auto_attribs=True)
+class Address:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+    name: typing.Optional[str] = None
+    company: typing.Optional[str] = None
+    street1: typing.Optional[str] = None
+    street2: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    zip: typing.Optional[int] = None
+    country: typing.Optional[str] = None
+    phone: typing.Optional[str] = None
+    email: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    carrier_facility: typing.Optional[str] = None
+    residential: typing.Optional[bool] = None
+    federal_tax_id: typing.Optional[str] = None
+    state_tax_id: typing.Optional[str] = None
+    verifications: typing.Optional[Verifications] = jstruct.JStruct[Verifications]
+
+
+@attr.s(auto_attribs=True)
+class CustomsItem:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+    description: typing.Optional[str] = None
+    hs_tariff_number: typing.Optional[int] = None
+    origin_country: typing.Optional[str] = None
+    quantity: typing.Optional[int] = None
+    value: typing.Optional[float] = None
+    weight: typing.Optional[float] = None
+    code: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    manufacturer: typing.Optional[str] = None
+    currency: typing.Optional[str] = None
+    eccn: typing.Optional[str] = None
+    printed_commodity_identifier: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CustomsInfo:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+    contents_explanation: typing.Optional[str] = None
+    contents_type: typing.Optional[str] = None
+    customs_certify: typing.Optional[bool] = None
+    customs_signer: typing.Optional[str] = None
+    eel_pfc: typing.Optional[str] = None
+    non_delivery_option: typing.Optional[str] = None
+    restriction_comments: typing.Optional[str] = None
+    restriction_type: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    declaration: typing.Optional[str] = None
+    customs_items: typing.Optional[typing.List[CustomsItem]] = jstruct.JList[CustomsItem]
+
+
+@attr.s(auto_attribs=True)
+class Fee:
+    amount: typing.Optional[str] = None
+    charged: typing.Optional[bool] = None
+    object: typing.Optional[str] = None
+    refunded: typing.Optional[bool] = None
+    type: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Form:
+    object: typing.Optional[str] = None
+    id: typing.Optional[str] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    form_type: typing.Optional[str] = None
+    form_url: typing.Optional[str] = None
+    submitted_electronically: typing.Optional[bool] = None
+
+
+@attr.s(auto_attribs=True)
+class Parcel:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    length: typing.Optional[float] = None
+    width: typing.Optional[float] = None
+    height: typing.Optional[float] = None
+    predefined_package: typing.Optional[str] = None
+    weight: typing.Optional[float] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class PostageLabel:
+    created_at: typing.Optional[str] = None
+    id: typing.Optional[str] = None
+    integrated_form: typing.Optional[str] = None
+    label_date: typing.Optional[str] = None
+    label_epl2_url: typing.Optional[str] = None
+    label_file_type: typing.Optional[str] = None
+    label_pdf_url: typing.Optional[str] = None
+    label_resolution: typing.Optional[int] = None
+    label_size: typing.Optional[str] = None
+    label_type: typing.Optional[str] = None
+    label_url: typing.Optional[str] = None
+    label_zpl_url: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Rate:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    carrier_account_id: typing.Optional[str] = None
+    currency: typing.Optional[str] = None
+    service: typing.Optional[str] = None
+    rate: typing.Optional[str] = None
+    carrier: typing.Optional[str] = None
+    shipment_id: typing.Optional[str] = None
+    delivery_days: typing.Optional[int] = None
+    delivery_date: typing.Optional[str] = None
+    delivery_date_guaranteed: typing.Optional[bool] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class SelectedRate:
+    carrier: typing.Optional[str] = None
+    created_at: typing.Optional[str] = None
+    currency: typing.Optional[str] = None
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    rate: typing.Optional[str] = None
+    service: typing.Optional[str] = None
+    shipment_id: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class TrackingLocation:
+    object: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    country: typing.Optional[str] = None
+    zip: typing.Optional[int] = None
+
+
+@attr.s(auto_attribs=True)
+class TrackingDetail:
+    object: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    status: typing.Optional[str] = None
+    tracking_detail_datetime: typing.Optional[str] = None
+    source: typing.Optional[str] = None
+    tracking_location: typing.Optional[TrackingLocation] = jstruct.JStruct[TrackingLocation]
+
+
+@attr.s(auto_attribs=True)
+class Tracker:
+    created_at: typing.Optional[str] = None
+    id: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    shipment_id: typing.Optional[str] = None
+    status: typing.Optional[str] = None
+    tracking_code: typing.Optional[str] = None
+    tracking_details: typing.Optional[typing.List[TrackingDetail]] = jstruct.JList[TrackingDetail]
+    updated_at: typing.Optional[str] = None
+    public_url: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Shipment:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    is_return: typing.Optional[bool] = None
+    batch_id: typing.Optional[str] = None
+    batch_message: typing.Optional[str] = None
+    batch_status: typing.Optional[str] = None
+    to_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    from_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    return_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    buyer_address: typing.Optional[Address] = jstruct.JStruct[Address]
+    parcel: typing.Optional[Parcel] = jstruct.JStruct[Parcel]
+    customs_info: typing.Optional[CustomsInfo] = jstruct.JStruct[CustomsInfo]
+    fees: typing.Optional[typing.List[Fee]] = jstruct.JList[Fee]
+    forms: typing.Optional[typing.List[Form]] = jstruct.JList[Form]
+    options: typing.Any = None
+    rates: typing.Optional[typing.List[Rate]] = jstruct.JList[Rate]
+    reference: typing.Optional[str] = None
+    scan_form: typing.Optional[str] = None
+    refund_status: typing.Optional[str] = None
+    selected_rate: typing.Optional[SelectedRate] = jstruct.JStruct[SelectedRate]
+    status: typing.Optional[str] = None
+    postage_label: typing.Optional[PostageLabel] = jstruct.JStruct[PostageLabel]
+    tracking_code: typing.Optional[str] = None
+    usps_zone: typing.Optional[int] = None
+    tracker: typing.Optional[Tracker] = jstruct.JStruct[Tracker]
+    messages: typing.Optional[typing.List[typing.Any]] = None
+    insurance: typing.Optional[float] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class ShipmentsResponse:
+    has_more: typing.Optional[bool] = None
+    shipments: typing.Optional[typing.List[Shipment]] = jstruct.JList[Shipment]

karrio/schemas/easypost/trackers_response.py

@@ -0,0 +1,79 @@
+import attr
+import jstruct
+import typing
+
+
+@attr.s(auto_attribs=True)
+class TrackingLocation:
+    object: typing.Optional[str] = None
+    city: typing.Optional[str] = None
+    state: typing.Optional[str] = None
+    country: typing.Optional[str] = None
+    zip: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class CarrierDetail:
+    object: typing.Optional[str] = None
+    service: typing.Optional[str] = None
+    container_type: typing.Optional[str] = None
+    est_delivery_date_local: typing.Optional[str] = None
+    est_delivery_time_local: typing.Optional[str] = None
+    origin_location: typing.Optional[str] = None
+    origin_tracking_location: typing.Optional[TrackingLocation] = jstruct.JStruct[TrackingLocation]
+    destination_location: typing.Optional[str] = None
+    destination_tracking_location: typing.Optional[str] = None
+    guaranteed_delivery_date: typing.Optional[str] = None
+    alternate_identifier: typing.Optional[str] = None
+    initial_delivery_attempt: typing.Optional[str] = None
+
+
+@attr.s(auto_attribs=True)
+class Fee:
+    object: typing.Optional[str] = None
+    type: typing.Optional[str] = None
+    amount: typing.Optional[str] = None
+    charged: typing.Optional[bool] = None
+    refunded: typing.Optional[bool] = None
+
+
+@attr.s(auto_attribs=True)
+class TrackingDetail:
+    object: typing.Optional[str] = None
+    message: typing.Optional[str] = None
+    description: typing.Optional[str] = None
+    status: typing.Optional[str] = None
+    status_detail: typing.Optional[str] = None
+    tracking_detail_datetime: typing.Optional[str] = None
+    source: typing.Optional[str] = None
+    carrier_code: typing.Optional[str] = None
+    tracking_location: typing.Optional[TrackingLocation] = jstruct.JStruct[TrackingLocation]
+
+
+@attr.s(auto_attribs=True)
+class Tracker:
+    id: typing.Optional[str] = None
+    object: typing.Optional[str] = None
+    mode: typing.Optional[str] = None
+    tracking_code: typing.Optional[str] = None
+    status: typing.Optional[str] = None
+    status_detail: typing.Optional[str] = None
+    created_at: typing.Optional[str] = None
+    updated_at: typing.Optional[str] = None
+    signed_by: typing.Optional[str] = None
+    weight: typing.Optional[str] = None
+    est_delivery_date: typing.Optional[str] = None
+    shipment_id: typing.Optional[str] = None
+    carrier: typing.Optional[str] = None
+    tracking_details: typing.Optional[typing.List[TrackingDetail]] = jstruct.JList[TrackingDetail]
+    carrier_detail: typing.Optional[CarrierDetail] = jstruct.JStruct[CarrierDetail]
+    finalized: typing.Optional[bool] = None
+    is_return: typing.Optional[bool] = None
+    public_url: typing.Optional[str] = None
+    fees: typing.Optional[typing.List[Fee]] = jstruct.JList[Fee]
+
+
+@attr.s(auto_attribs=True)
+class TrackersResponse:
+    trackers: typing.Optional[typing.List[Tracker]] = jstruct.JList[Tracker]
+    has_more: typing.Optional[bool] = None

karrio_easypost-2025.5.dist-info/METADATA

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: karrio_easypost
+Version: 2025.5
+Summary: Karrio - EasyPost Shipping extension
+Author-email: karrio <hello@karrio.io>
+License-Expression: LGPL-3.0
+Project-URL: Homepage, https://github.com/karrioapi/karrio
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: karrio
+Dynamic: license-file
+
+# karrio.easypost
+
+This package is a easypost extension of the [karrio](https://pypi.org/project/karrio) multi carrier shipping SDK.
+
+## Requirements
+
+`Python 3.7+`
+
+## Installation
+
+```bash
+pip install karrio.easypost
+```
+
+## Usage
+
+```python
+import karrio.sdk as karrio
+from karrio.mappers.easypost.settings import Settings
+
+
+# Initialize a carrier gateway
+easypost = karrio.gateway["easypost"].create(
+    Settings(
+        ...
+    )
+)
+```
+
+Check the [karrio Mutli-carrier SDK docs](https://docs.karrio.io) for Shipping API requests

karrio_easypost-2025.5.dist-info/RECORD

@@ -0,0 +1,26 @@
+karrio/mappers/easypost/__init__.py,sha256=Z1hMDSA21PYGRE8sDcOFzffKeR3_PUprlQL_oWaNOUY,151
+karrio/mappers/easypost/mapper.py,sha256=1p2kff10Za5-QlFR4Gz6Kcnnwi2HSmr3DEke6CMkR7k,2108
+karrio/mappers/easypost/proxy.py,sha256=NhFQbDOlSausNDxzNbPfbV1mdXk5T2qcPimNXsfFWus,3425
+karrio/mappers/easypost/settings.py,sha256=tVxN6QXlpYgjslfMRzc-6uvI1E-vp6H6f_NsDpF65AA,406
+karrio/plugins/easypost/__init__.py,sha256=UwD6JC4LkF47ZodzuHvaq8l__713e_aCLTej3SkEhH4,484
+karrio/providers/easypost/__init__.py,sha256=v89eaMBV-Kn7Za7WzrXpSkKfFG2HSRB0SXByoI2hOec,333
+karrio/providers/easypost/error.py,sha256=GrONkEpEi8ujKNvd4I9Z9xGfqFrc4QE2wOkoMJOFEjk,953
+karrio/providers/easypost/rate.py,sha256=_uJ_9PgB5AM_oMDjAsY_wFd_DUz-zm_zu4qPkSyZHTY,7710
+karrio/providers/easypost/tracking.py,sha256=hWjYA7rKBQgqLcXB2X1gOjRLLrBXk-VateE5UpjbFWg,4245
+karrio/providers/easypost/units.py,sha256=Cw_yhRnBDWejKmQ3qWxq3Jo-RcLYw7kAbsZHRuOkt30,52724
+karrio/providers/easypost/utils.py,sha256=rJ1uxvaOXcwCAbPmiklk0UoJwhbix0sjVc6jV1BWbtQ,774
+karrio/providers/easypost/shipment/__init__.py,sha256=oEO3ToyRIVyE5mcc_exdZRpM6WMu6PMD2UpdkUJrKqI,232
+karrio/providers/easypost/shipment/cancel.py,sha256=QEIkm4aPwzOyFMV4fvx_7b8VErwIhcBGl9ZszQM5nsM,1010
+karrio/providers/easypost/shipment/create.py,sha256=9_gcDFfQwx_LIUsYhk2-1Om_VOGh4ZiHbll5D66-p8k,9338
+karrio/schemas/easypost/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+karrio/schemas/easypost/error_response.py,sha256=LavBjNFcliCXjGYaPFtWKhMLL7wNSWmhzlsh_quWVN8,331
+karrio/schemas/easypost/shipment_purchase.py,sha256=xNQWUKV6aYFFdTn7xLCjjtya0h-oZDyLdvqr8B7ifNk,272
+karrio/schemas/easypost/shipment_request.py,sha256=7HirvgDktcppvHlEeMz49ryK6sPWIBP-c1_1xE3y8ow,2858
+karrio/schemas/easypost/shipments_response.py,sha256=KgWbIoPvI1NoQOGoV30-K3Dl6JFkKdAS3B3yHQfb6R4,8957
+karrio/schemas/easypost/trackers_response.py,sha256=Q0Z74hKZYLDmfKh7lzxM7cfe3x-z-LXve94d7s3r9Kw,2915
+karrio_easypost-2025.5.dist-info/licenses/LICENSE,sha256=qvVLDB3Y1leH0p_1m30RxZrOGOx8F9O5eZIwdyVzcuQ,7651
+karrio_easypost-2025.5.dist-info/METADATA,sha256=E-sOLF9RYBxo9_aBXu1kt8GYhOi3O6lbjrPJj0s9kyQ,1038
+karrio_easypost-2025.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+karrio_easypost-2025.5.dist-info/entry_points.txt,sha256=mArG7sxxZUl07ycYJn7BGzz1uv-hZPVROniK64EbUz4,61
+karrio_easypost-2025.5.dist-info/top_level.txt,sha256=FZCY8Nwft8oEGHdl--xku8P3TrnOxu5dETEU_fWpRSM,20
+karrio_easypost-2025.5.dist-info/RECORD,,

karrio_easypost-2025.5.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

karrio_easypost-2025.5.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[karrio.plugins]
+easypost = karrio.plugins.easypost:METADATA