vessel-api-python 2.1.1__py3-none-any.whl → 2.1.2__py3-none-any.whl

vessel_api_python/_constants.py

@@ -1,6 +1,6 @@
 """Constants for the Vessel API Python SDK."""
 
-VERSION = "2.1.1"
+VERSION = "2.1.2"
 DEFAULT_BASE_URL = "https://api.vesselapi.com/v1"
 DEFAULT_USER_AGENT = f"vesselapi-python/{VERSION}"
 DEFAULT_MAX_RETRIES = 3

vessel_api_python/_errors.py

@@ -54,8 +54,12 @@ class VesselAPIError(Exception):
         """True if the error is a 402 Payment Required response.
 
         Returned when a satellite-backed call is made with no satellite credits
-        left. Retry without ``filter_sat`` to serve stored data instead, or top
-        up the balance.
+        left. Retry without ``filter_sat`` to serve stored data instead.
+
+        .. deprecated::
+            The satellite fallback is withdrawn in its current form. From the
+            cutoff date ``filter_sat`` is ignored and no satellite request
+            returns 402.
         """
         return self.status_code == 402
 
@@ -75,7 +79,12 @@ class VesselAuthError(VesselAPIError):
 
 
 class VesselPaymentRequiredError(VesselAPIError):
-    """Raised on 402 Payment Required responses (satellite credits exhausted)."""
+    """Raised on 402 Payment Required responses (satellite credits exhausted).
+
+    .. deprecated::
+        The satellite fallback is withdrawn in its current form. From the cutoff
+        date ``filter_sat`` is ignored and no satellite request returns 402.
+    """
 
 
 class VesselForbiddenError(VesselAPIError):

vessel_api_python/_services.py

@@ -109,6 +109,13 @@ class VesselsService:
         sets how old a satellite fix may be and still be returned.
         ``filter_sat_max_age_minutes`` (15 to 4800, default 60, paid plans only) sets how
         old a stored position may be before a satellite lookup is made.
+
+        .. deprecated::
+            ``filter_sat``, ``filter_sat_lookback_minutes`` and
+            ``filter_sat_max_age_minutes`` are deprecated. The satellite fallback
+            is withdrawn in its current form. From the cutoff date in the
+            ``Sunset`` header they are accepted and ignored and no credit is
+            charged.
         """
         r = self._client.get(
             f"/vessel/{vessel_id}/position",
@@ -1593,6 +1600,13 @@ class AsyncVesselsService:
         sets how old a satellite fix may be and still be returned.
         ``filter_sat_max_age_minutes`` (15 to 4800, default 60, paid plans only) sets how
         old a stored position may be before a satellite lookup is made.
+
+        .. deprecated::
+            ``filter_sat``, ``filter_sat_lookback_minutes`` and
+            ``filter_sat_max_age_minutes`` are deprecated. The satellite fallback
+            is withdrawn in its current form. From the cutoff date in the
+            ``Sunset`` header they are accepted and ignored and no credit is
+            charged.
         """
         r = await self._client.get(
             f"/vessel/{vessel_id}/position",

{vessel_api_python-2.1.1.dist-info → vessel_api_python-2.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: vessel-api-python
-Version: 2.1.1
+Version: 2.1.2
 Summary: Python client for the Vessel Tracking API: maritime vessel tracking, port events, emissions, and nautical infrastructure.
 Project-URL: Documentation, https://vesselapi.com/docs
 Project-URL: Repository, https://github.com/vessel-api/vesselapi-python
@@ -131,9 +131,7 @@ print(f"{vessel.vessel.name} ({vessel.vessel.vessel_type})")
 pos = client.vessels.position("232003239", filter_id_type="mmsi")
 print(f"Position: {pos.vessel_position.latitude}, {pos.vessel_position.longitude}")
 
-# filter_sat=True falls back to satellite AIS when no recent terrestrial position is stored.
-# ⚠️ Satellite lookups draw on a prepaid balance and are charged per call.
-# Omit it unless you need that fallback.
+# filter_sat is deprecated: the satellite fallback is withdrawn in its current form.
 
 # Find vessels with an AIS position within 10 km of Rotterdam in the last 2 hours
 # (the default time window, at most 4 hours).
@@ -142,6 +140,8 @@ for v in nearby.vessels or []:
     print(f"{v.vessel_name} at {v.latitude}, {v.longitude}")
 ```
 
+> **Deprecated.** The satellite fallback is withdrawn in its current form. Requests with `filter.sat=true` keep working for existing credit holders until the cutoff date and carry Deprecation and Sunset headers. From the cutoff date the parameter is accepted and ignored, the response carries a Warning header, and no credit is charged. Credit packs are no longer on sale; unspent credits are refunded on request to support@vesselapi.com. The cutoff date is given in the `Sunset` header.
+
 ## Search
 
 `search.vessels` accepts `q`, a unified search across IMO, MMSI, ENI, callsign and

vessel_api_python-2.1.2.dist-info/RECORD

@@ -0,0 +1,13 @@
+vessel_api_python/__init__.py,sha256=hUlZdyZGgArdYr8XJ30yQibkXXkQPqx3Y9zmVKvi6fc,3200
+vessel_api_python/_client.py,sha256=L7qkzUiATDpPlxWViEKicNpNx7D90gCohas56uCimgA,4919
+vessel_api_python/_constants.py,sha256=hQeGOGb1DbBATjUZlvglGx3THDLyuIArIGOPA4rfdpE,244
+vessel_api_python/_errors.py,sha256=56Xh4AfzNw7K6LrIeRrpkTYXO-ox0pLSX_B_quSvAV0,6770
+vessel_api_python/_iterator.py,sha256=SkgsGSdxLrKtw-ad8fSUPaEDDJCamAKK0PrG_P8HX-4,3198
+vessel_api_python/_models.py,sha256=bvvd0yrK4Sa8rZ9ZTWRW2E9VedyInNDQm1NxdOCrbi0,21355
+vessel_api_python/_services.py,sha256=eZA2Rj3OFpU-ULGHuB_Z8cOfB0ICXoUfkgnjeoaOQxE,110385
+vessel_api_python/_transport.py,sha256=pfRaJwkq_GYpA5Ev8wH7tBdlzN2ykgy29Ag1L3F5K4Y,6956
+vessel_api_python/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vessel_api_python-2.1.2.dist-info/METADATA,sha256=mL0c5Tjc65ppQlApZZroYjJ_FS1SGjFOaihdU8ZmgvI,10514
+vessel_api_python-2.1.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+vessel_api_python-2.1.2.dist-info/licenses/LICENSE,sha256=zoj_abq99mj8cz-Bz71XCnwB-Qv3kU1VzVXeKEntuQU,1067
+vessel_api_python-2.1.2.dist-info/RECORD,,

{vessel_api_python-2.1.1.dist-info → vessel_api_python-2.1.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.32.4
+Generator: hatchling 1.33.0
 Root-Is-Purelib: true
 Tag: py3-none-any

vessel_api_python-2.1.1.dist-info/RECORD

@@ -1,13 +0,0 @@
-vessel_api_python/__init__.py,sha256=hUlZdyZGgArdYr8XJ30yQibkXXkQPqx3Y9zmVKvi6fc,3200
-vessel_api_python/_client.py,sha256=L7qkzUiATDpPlxWViEKicNpNx7D90gCohas56uCimgA,4919
-vessel_api_python/_constants.py,sha256=uYgcJuAHCdK1VA7SCknrl41TrRblNCsyXkTOwIAu3fY,244
-vessel_api_python/_errors.py,sha256=DaiyCjYKJZTo6-6sOqAcJBdOeFaIYgWHE48nsHWGeGA,6414
-vessel_api_python/_iterator.py,sha256=SkgsGSdxLrKtw-ad8fSUPaEDDJCamAKK0PrG_P8HX-4,3198
-vessel_api_python/_models.py,sha256=bvvd0yrK4Sa8rZ9ZTWRW2E9VedyInNDQm1NxdOCrbi0,21355
-vessel_api_python/_services.py,sha256=UOGpajcZAYrt03DfkG86nIR8zyCGwokq_qB4ZYit7BY,109699
-vessel_api_python/_transport.py,sha256=pfRaJwkq_GYpA5Ev8wH7tBdlzN2ykgy29Ag1L3F5K4Y,6956
-vessel_api_python/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-vessel_api_python-2.1.1.dist-info/METADATA,sha256=-TbomFF0ihDCKicRL34-iCsPG9EUyuKuW6YX0G4cqp0,10153
-vessel_api_python-2.1.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-vessel_api_python-2.1.1.dist-info/licenses/LICENSE,sha256=zoj_abq99mj8cz-Bz71XCnwB-Qv3kU1VzVXeKEntuQU,1067
-vessel_api_python-2.1.1.dist-info/RECORD,,