t2d2-sdk 2.6.0__tar.gz → 2.6.2__tar.gz

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/.github/workflows/sphinx.yml

@@ -8,12 +8,6 @@ on:
   # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
 # Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
 # However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
@@ -28,22 +22,28 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.x'
+        # The SDK uses `X | None` annotations (Python >= 3.10). Do not build
+        # docs in the sphinx-action Docker image (Python 3.8): autodoc fails to
+        # import the SDK there and the API reference silently comes out empty.
+        python-version: '3.11'
+        cache: pip
+        cache-dependency-path: docs/requirements.txt
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r docs/requirements.txt    
+        pip install -r docs/requirements.txt
     - name: Build HTML
-      uses: ammaraskar/sphinx-action@master
+      # -W turns warnings (e.g. autodoc import failures) into errors
+      run: sphinx-build -W --keep-going -b html docs/source docs/build/html
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
       with:
         name: html-docs
         path: docs/build/html/
     - name: Deploy
-      uses: peaceiris/actions-gh-pages@v3
+      uses: peaceiris/actions-gh-pages@v4
       if: github.ref == 'refs/heads/main'
       with:
         github_token: ${{ secrets.GITHUB_TOKEN }}

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: t2d2-sdk
-Version: 2.6.0
+Version: 2.6.2
 Summary: T2D2 SDK
 Author-email: Badri Hiriyur <badri@t2d2.ai>
 Project-URL: Homepage, https://t2d2.ai

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/docs/requirements.txt

@@ -1,6 +1,6 @@
+sphinx
 myst-parser
-jinja2==3.1
+jinja2
 requests
 boto3
 sentry-sdk
-sphinx-rtd-theme

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/src/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.6.0'
-__version_tuple__ = version_tuple = (2, 6, 0)
+__version__ = version = '2.6.2'
+__version_tuple__ = version_tuple = (2, 6, 2)
 
-__commit_id__ = commit_id = 'g63d857420'
+__commit_id__ = commit_id = 'g386ace5d5'

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/src/t2d2_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: t2d2-sdk
-Version: 2.6.0
+Version: 2.6.2
 Summary: T2D2 SDK
 Author-email: Badri Hiriyur <badri@t2d2.ai>
 Project-URL: Homepage, https://t2d2.ai

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/src/t2d2_sdk.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ docs/make.bat
 docs/requirements.txt
 docs/source/conf.py
 docs/source/index.rst
+docs/source/_static/.gitkeep
 src/_version.py
 src/condition_report_service.py
 src/t2d2_sdk.py

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/src/t2d2_sdk.egg-info/scm_file_list.json

@@ -8,6 +8,7 @@
     "docs/Makefile",
     "docs/make.bat",
     "docs/requirements.txt",
+    "docs/source/_static/.gitkeep",
     "docs/source/conf.py",
     "docs/source/index.rst",
     "pyproject.toml",

t2d2_sdk-2.6.2/src/t2d2_sdk.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "2.6.2",
+  "distance": 0,
+  "node": "g386ace5d592d33c12ef91fd60996b7dc4bc9bcd3",
+  "dirty": false,
+  "branch": "main",
+  "node_date": "2026-11-13"
+}

{t2d2_sdk-2.6.0 → t2d2_sdk-2.6.2}/src/t2d2_sdk.py

@@ -445,14 +445,35 @@ def ts2date(ts):
     return datetime.fromtimestamp(ts).strftime("%Y-%m-%d %H:%M:%S")
 
 
+def _is_s3_url(url: str) -> bool:
+    """True for s3:// and virtual-hosted Amazon S3 HTTPS URLs."""
+    parsed = urlparse(url)
+    if parsed.scheme == "s3":
+        return True
+    host = (parsed.netloc or "").lower()
+    return host.endswith(".amazonaws.com") and "s3" in host.split(".")
+
+
+def _s3_bucket_and_key(url: str):
+    """Parse bucket and object key from an s3:// or virtual-hosted S3 URL."""
+    parsed = urlparse(url)
+    if parsed.scheme == "s3":
+        return parsed.netloc.split(".")[0], parsed.path.lstrip("/")
+    host = parsed.netloc
+    # bucket.s3.amazonaws.com or bucket.s3.region.amazonaws.com
+    bucket = host.split(".s3")[0]
+    return bucket, parsed.path.lstrip("/")
+
+
 def download_file(url: str, file_path: str):
     """
-    Download a file from an S3 URL to a local path.
-    
-    This function parses the S3 URL to extract bucket and key information,
-    then downloads the file to the specified local path.
+    Download a file from S3 or HTTPS (CloudFront/CDN) to a local path.
+
+    Image records from the T2D2 API typically use CloudFront HTTPS URLs.
+    Those must be fetched over HTTP; treating them as S3 bucket names fails
+    (e.g. ``s3.download_file("dvd30yayquknd", ...)``) and leaves no local file.
     
-    :param url: S3 URL of the file to download
+    :param url: HTTPS, CloudFront, or S3 URL of the file to download
     :type url: str
     :param file_path: Local path where the file should be saved
     :type file_path: str
@@ -460,20 +481,33 @@ def download_file(url: str, file_path: str):
     :return: Dictionary containing success status and message
     :rtype: dict
     
-    :raises Exception: If there is an error during download
-    
     :example:
+        >>> download_file('https://cdn.example.net/projects/1/images/a.jpg', '/tmp/a.jpg')
+        {'success': True, 'message': 'File downloaded'}
         >>> download_file('s3://my-bucket/path/to/file.jpg', '/local/path/file.jpg')
         {'success': True, 'message': 'File downloaded'}
     """
+    bucket = key = None
     try:
+        dest_dir = os.path.dirname(file_path)
+        if dest_dir:
+            os.makedirs(dest_dir, exist_ok=True)
+
+        if not _is_s3_url(url):
+            res = requests.get(url, timeout=TIMEOUT, stream=True)
+            res.raise_for_status()
+            with open(file_path, "wb") as out:
+                for chunk in res.iter_content(chunk_size=1024 * 1024):
+                    if chunk:
+                        out.write(chunk)
+            return {"success": True, "message": "File downloaded"}
+
         s3 = boto3.client("s3")
-        parsed_url = urlparse(url)
-        bucket = parsed_url.netloc.split(".")[0]
-        key = parsed_url.path[1:]
+        bucket, key = _s3_bucket_and_key(url)
         s3.download_file(bucket, key, file_path)
         return {"success": True, "message": "File downloaded"}
     except Exception as e:
+        logger.error("Failed to download %s to %s: %s", url, file_path, e)
         return {
             "success": False,
             "message": f"{str(e)} \n{bucket} \n{key} \n{file_path}",

t2d2_sdk-2.6.0/src/t2d2_sdk.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "2.6.0",
-  "distance": 0,
-  "node": "g63d857420424ebf3ac02c6fa979760aa0d50cea3",
-  "dirty": false,
-  "branch": "main",
-  "node_date": "2026-09-01"
-}