recovered version upload_file_from_bytes

Author: phenobarbital

navigator/actions/google/maps.py

@@ -4,10 +4,16 @@
 Interface for interacting with Google Maps API.
 
 Heavy mapping dependencies (``polyline``, ``matplotlib``, ``cartopy``) have
-moved to the ``navigator-api[google]`` extra. They are imported lazily at
-first use via the ``_import_*`` helpers below, which raise a clear,
-actionable :class:`ImportError` when the extra is not installed.
+moved to the ``navigator-api[google]`` extra:
+
+* ``polyline`` is imported at module load. If the extra is not installed,
+  a warning is logged and the module-level ``polyline`` is set to ``None``;
+  calls that depend on it will fail at use time.
+* ``matplotlib`` and ``cartopy`` are imported lazily via the ``_import_*``
+  helpers below, which raise a clear, actionable :class:`ImportError` when
+  the extra is not installed.
 """
+import logging
 import string
 import datetime
 from datetime import timezone
@@ -27,16 +33,14 @@
 )
 
 
-def _import_polyline():
-    """Return :mod:`polyline` (lazy) or raise a helpful ImportError."""
-    try:
-        import polyline  # type: ignore[import-not-found]
-    except ImportError as exc:
-        raise ImportError(
-            f"polyline is required for Google Maps route decoding. "
-            f"{_EXTRA_HINT}"
-        ) from exc
-    return polyline
+try:
+    import polyline  # type: ignore[import-not-found]
+except ImportError:
+    logging.warning(
+        "polyline is required for Google Maps route decoding. %s",
+        _EXTRA_HINT,
+    )
+    polyline = None
 
 
 def _import_matplotlib():
@@ -336,7 +340,6 @@ async def get_route(
             if result['status'] == 'OK':
                 # Extracting route, duration, and distance information
                 route = result['routes'][0]
-                polyline = _import_polyline()
                 encoded_polyline = route['overview_polyline']['points']
                 decoded_polyline = polyline.decode(encoded_polyline)
                 map_url = self.get_google_map(

navigator/utils/file/s3.py

@@ -565,9 +565,45 @@ async def find_files(
         return results
 
     # ------------------------------------------------------------------ #
-    # Backward-compatible web-serving helpers                             #
+    # Backward-compatible helpers                                         #
     # ------------------------------------------------------------------ #
 
+    async def upload_file_from_bytes(
+        self,
+        file_obj: bytes,
+        destination_key: str,
+        content_type: str = "application/octet-stream",
+    ) -> str:
+        """Upload a raw bytes payload to S3 under ``destination_key``.
+
+        Backward-compatible helper preserved from the pre-FEAT-002 API.
+        Applies the manager prefix and uses multipart upload when the payload
+        exceeds ``multipart_threshold``.
+
+        Args:
+            file_obj: Raw bytes to upload.
+            destination_key: Target S3 key (without manager prefix).
+            content_type: MIME type for the object. Defaults to
+                ``"application/octet-stream"``.
+
+        Returns:
+            The ``destination_key`` as provided (unprefixed), matching the
+            original contract.
+        """
+        key = self._prefixed(destination_key)
+        size = len(file_obj)
+        if size >= self.multipart_threshold:
+            await self._multipart_upload_bytes(file_obj, key, content_type)
+        else:
+            async with await self._s3_client() as s3:
+                await s3.put_object(
+                    Bucket=self.bucket_name,
+                    Key=key,
+                    Body=file_obj,
+                    ContentType=content_type,
+                )
+        return destination_key
+
     def setup(self, app, route: str = "/data", base_url: str = None):
         """Set up web-serving for this manager (backward compat).
 

navigator/version.py

@@ -4,7 +4,7 @@
 __description__ = (
     "Navigator Web Framework based on aiohttp, " "with batteries included."
 )
-__version__ = "3.0.0"
+__version__ = "3.0.1"
 __copyright__ = "Copyright (c) 2018-2026 Jesus Lara"
 __author__ = "Jesus Lara"
 __author_email__ = "jesuslarag@gmail.com"