hirundo 0.1.16__py3-none-any.whl → 0.1.18__py3-none-any.whl

hirundo/__init__.py

@@ -1,11 +1,9 @@
 from .dataset_enum import (
     DatasetMetadataType,
     LabelingType,
+    StorageTypes,
 )
 from .dataset_optimization import (
-    COCO,
-    YOLO,
-    HirundoCSV,
     HirundoError,
     OptimizationDataset,
     RunArgs,
@@ -13,26 +11,40 @@ from .dataset_optimization import (
 )
 from .dataset_optimization_results import DatasetOptimizationResults
 from .git import GitPlainAuth, GitRepo, GitSSHAuth
+from .labeling import (
+    COCO,
+    YOLO,
+    HirundoCSV,
+    KeylabsAuth,
+    KeylabsObjDetImages,
+    KeylabsObjDetVideo,
+    KeylabsObjSegImages,
+    KeylabsObjSegVideo,
+)
 from .storage import (
     StorageConfig,
     StorageGCP,
     # StorageAzure,  TODO: Azure storage is coming soon
     StorageGit,
     StorageS3,
-    StorageTypes,
 )
 from .unzip import load_df, load_from_zip
 
 __all__ = [
     "COCO",
     "YOLO",
-    "HirundoCSV",
     "HirundoError",
+    "HirundoCSV",
+    "KeylabsAuth",
+    "KeylabsObjDetImages",
+    "KeylabsObjDetVideo",
+    "KeylabsObjSegImages",
+    "KeylabsObjSegVideo",
     "OptimizationDataset",
     "RunArgs",
     "VisionRunArgs",
-    "LabelingType",
     "DatasetMetadataType",
+    "LabelingType",
     "GitPlainAuth",
     "GitRepo",
     "GitSSHAuth",
@@ -47,4 +59,4 @@ __all__ = [
     "load_from_zip",
 ]
 
-__version__ = "0.1.16"
+__version__ = "0.1.18"

hirundo/_constraints.py

@@ -1,53 +1,164 @@
-from typing import Annotated
-
-from pydantic import StringConstraints, UrlConstraints
-from pydantic_core import Url
-
-S3BucketUrl = Annotated[
-    str,
-    StringConstraints(
-        min_length=8,
-        max_length=1023,
-        pattern=r"s3?://[a-z0-9.-]{3,64}[/]?",  # Only allow real S3 bucket URLs
-    ),
-]
-
-StorageConfigName = Annotated[
-    str,
-    StringConstraints(
-        min_length=1,
-        max_length=255,
-        pattern=r"^[a-zA-Z0-9-_]+$",
-    ),
-]
-
-S3_MIN_LENGTH = 8
-S3_MAX_LENGTH = 1023
-S3_PATTERN = r"s3://[a-zA-Z0-9.-]{3,64}/[a-zA-Z0-9.-/]+"
-GCP_MIN_LENGTH = 8
-GCP_MAX_LENGTH = 1023
-GCP_PATTERN = r"gs://[a-zA-Z0-9.-]{3,64}/[a-zA-Z0-9.-/]+"
-
-RepoUrl = Annotated[
-    Url,
-    UrlConstraints(
-        allowed_schemes=[
-            "ssh",
-            "https",
-            "http",
-        ]
-    ),
-]
-HirundoUrl = Annotated[
-    Url,
-    UrlConstraints(
-        allowed_schemes=[
-            "file",
-            "https",
-            "http",
-            "s3",
-            "gs",
-            "ssh",
-        ]
-    ),
-]
+import re
+import typing
+from typing import TYPE_CHECKING
+
+from hirundo._urls import (
+    LENGTH_CONSTRAINTS,
+    STORAGE_PATTERNS,
+)
+from hirundo.dataset_enum import DatasetMetadataType, LabelingType, StorageTypes
+from hirundo.labeling import COCO, YOLO, HirundoCSV, Keylabs
+
+if TYPE_CHECKING:
+    from hirundo._urls import HirundoUrl
+    from hirundo.dataset_optimization import LabelingInfo
+    from hirundo.storage import (
+        ResponseStorageConfig,
+        StorageConfig,
+        StorageGCP,
+        StorageGCPOut,
+        StorageS3,
+        StorageS3Out,
+    )
+
+LABELING_TYPES_TO_DATASET_METADATA_TYPES = {
+    LabelingType.SINGLE_LABEL_CLASSIFICATION: [
+        DatasetMetadataType.HIRUNDO_CSV,
+    ],
+    LabelingType.OBJECT_DETECTION: [
+        DatasetMetadataType.HIRUNDO_CSV,
+        DatasetMetadataType.COCO,
+        DatasetMetadataType.YOLO,
+        DatasetMetadataType.KeylabsObjDetImages,
+        DatasetMetadataType.KeylabsObjDetVideo,
+    ],
+    LabelingType.OBJECT_SEGMENTATION: [
+        DatasetMetadataType.HIRUNDO_CSV,
+        DatasetMetadataType.KeylabsObjSegImages,
+        DatasetMetadataType.KeylabsObjSegVideo,
+    ],
+    LabelingType.SEMANTIC_SEGMENTATION: [
+        DatasetMetadataType.HIRUNDO_CSV,
+    ],
+    LabelingType.PANOPTIC_SEGMENTATION: [
+        DatasetMetadataType.HIRUNDO_CSV,
+    ],
+    LabelingType.SPEECH_TO_TEXT: [
+        DatasetMetadataType.HIRUNDO_CSV,
+    ],
+}
+
+
+def validate_s3_url(str_url: str, s3_config: "StorageS3 | StorageS3Out"):
+    if (
+        len(str_url) < LENGTH_CONSTRAINTS[StorageTypes.S3]["min_length"]
+        or len(str_url) > LENGTH_CONSTRAINTS[StorageTypes.S3]["max_length"]
+    ):
+        raise ValueError("S3 URL must be between 8 and 1023 characters")
+    elif not re.match(STORAGE_PATTERNS[StorageTypes.S3], str_url):
+        raise ValueError(
+            f"Invalid S3 URL. Pattern must match: {STORAGE_PATTERNS[StorageTypes.S3]}"
+        )
+    elif not str_url.startswith(f"{s3_config.bucket_url}/"):
+        raise ValueError(f"S3 URL must start with {s3_config.bucket_url}/")
+
+
+def validate_gcp_url(str_url: str, gcp_config: "StorageGCP | StorageGCPOut"):
+    matches = re.match(STORAGE_PATTERNS[StorageTypes.GCP], str_url)
+    if (
+        len(str_url) < LENGTH_CONSTRAINTS[StorageTypes.GCP]["min_length"]
+        or len(str_url) > LENGTH_CONSTRAINTS[StorageTypes.GCP]["max_length"]
+    ):
+        raise ValueError(
+            f"GCP URL must be between {LENGTH_CONSTRAINTS[StorageTypes.GCP]['min_length']}"
+            + f" and {LENGTH_CONSTRAINTS[StorageTypes.GCP]['max_length']} characters"
+        )
+    elif not matches:
+        raise ValueError(
+            f"Invalid GCP URL. Pattern must match: {STORAGE_PATTERNS[StorageTypes.GCP]}"
+        )
+    elif (
+        matches
+        and len(matches.group(1))
+        > LENGTH_CONSTRAINTS[StorageTypes.GCP]["bucket_max_length"]
+    ):
+        raise ValueError(
+            f"GCP bucket name must be between {LENGTH_CONSTRAINTS[StorageTypes.GCP]['bucket_min_length']} "
+            + f"and {LENGTH_CONSTRAINTS[StorageTypes.GCP]['bucket_max_length']} characters"
+        )
+    elif not str_url.startswith(f"gs://{gcp_config.bucket_name}/"):
+        raise ValueError(f"GCP URL must start with gs://{gcp_config.bucket_name}")
+
+
+def validate_url(
+    url: "HirundoUrl",
+    storage_config: "StorageConfig | ResponseStorageConfig",
+) -> "HirundoUrl":
+    s3_config = storage_config.s3
+    gcp_config = storage_config.gcp
+    git_config = storage_config.git
+    str_url = str(url)
+
+    if s3_config is not None:
+        validate_s3_url(str_url, s3_config)
+    elif gcp_config is not None:
+        validate_gcp_url(str_url, gcp_config)
+    elif (
+        git_config is not None
+        and not str_url.startswith("https://")
+        and not str_url.startswith("ssh://")
+    ):
+        raise ValueError("Git URL must start with https:// or ssh://")
+    elif storage_config.type == StorageTypes.LOCAL and not str_url.startswith(
+        "file:///datasets/"
+    ):
+        raise ValueError("Local URL must start with file:///datasets/")
+    return url
+
+
+def validate_labeling_type(
+    labeling_type: "LabelingType", labeling_info: "LabelingInfo"
+) -> None:
+    """
+    Validate that the labeling type is compatible with the labeling info
+
+    Args:
+        labeling_type: The type of labeling that will be performed
+        labeling_info: The labeling info to validate
+    """
+    dataset_metadata_types = LABELING_TYPES_TO_DATASET_METADATA_TYPES[labeling_type]
+    if labeling_info.type not in dataset_metadata_types:
+        raise ValueError(
+            f"Cannot use {labeling_info.type.name} labeling info with {labeling_type.name} datasets"
+        )
+
+
+def validate_labeling_info(
+    labeling_type: "LabelingType",
+    labeling_info: "typing.Union[LabelingInfo, list[LabelingInfo]]",
+    storage_config: "typing.Union[StorageConfig, ResponseStorageConfig]",
+) -> None:
+    """
+    Validate the labeling info for a dataset
+
+    Args:
+        labeling_type: The type of labeling that will be performed
+        labeling_info: The labeling info to validate
+        storage_config: The storage configuration for the dataset.
+            StorageConfig is used to validate the URLs in the labeling info
+    """
+    if isinstance(labeling_info, list):
+        for labeling in labeling_info:
+            validate_labeling_info(labeling_type, labeling, storage_config)
+        return
+    elif isinstance(labeling_info, HirundoCSV):
+        validate_url(labeling_info.csv_url, storage_config)
+    elif isinstance(labeling_info, COCO):
+        validate_url(labeling_info.json_url, storage_config)
+    elif isinstance(labeling_info, YOLO):
+        validate_url(labeling_info.labels_dir_url, storage_config)
+        if labeling_info.data_yaml_url is not None:
+            validate_url(labeling_info.data_yaml_url, storage_config)
+    elif isinstance(labeling_info, Keylabs):
+        validate_url(labeling_info.labels_dir_url, storage_config)
+    validate_labeling_type(labeling_type, labeling_info)

hirundo/_urls.py

@@ -0,0 +1,59 @@
+from typing import Annotated
+
+from pydantic import StringConstraints, UrlConstraints
+from pydantic_core import Url
+
+from hirundo.dataset_enum import StorageTypes
+
+S3BucketUrl = Annotated[
+    str,
+    StringConstraints(
+        min_length=8,
+        max_length=1023,
+        pattern=r"s3?://[a-z0-9.-]{3,64}[/]?",  # Only allow real S3 bucket URLs
+    ),
+]
+
+StorageConfigName = Annotated[
+    str,
+    StringConstraints(
+        min_length=1,
+        max_length=255,
+        pattern=r"^[a-zA-Z0-9-_]+$",
+    ),
+]
+
+STORAGE_PATTERNS: dict[StorageTypes, str] = {
+    StorageTypes.S3: r"^s3:\/\/[a-z0-9\.\-]{3,63}/[a-zA-Z0-9!\-\/_\.\*'\(\)]+$",
+    StorageTypes.GCP: r"^gs:\/\/([a-z0-9][a-z0-9_-]{1,61}[a-z0-9](\.[a-z0-9][a-z0-9_-]{1,61}[a-z0-9])*)\/[^\x00-\x1F\x7F-\x9F\r\n]*$",
+}
+
+
+LENGTH_CONSTRAINTS: dict[StorageTypes, dict] = {
+    StorageTypes.S3: {"min_length": 8, "max_length": 1023, "bucket_max_length": None},
+    StorageTypes.GCP: {"min_length": 8, "max_length": 1023, "bucket_max_length": 222},
+}
+
+RepoUrl = Annotated[
+    Url,
+    UrlConstraints(
+        allowed_schemes=[
+            "ssh",
+            "https",
+            "http",
+        ]
+    ),
+]
+HirundoUrl = Annotated[
+    Url,
+    UrlConstraints(
+        allowed_schemes=[
+            "file",
+            "https",
+            "http",
+            "s3",
+            "gs",
+            "ssh",
+        ]
+    ),
+]

hirundo/dataset_enum.py

@@ -10,6 +10,9 @@ class LabelingType(str, Enum):
     SINGLE_LABEL_CLASSIFICATION = "SingleLabelClassification"
     OBJECT_DETECTION = "ObjectDetection"
     SPEECH_TO_TEXT = "SpeechToText"
+    OBJECT_SEGMENTATION = "ObjectSegmentation"
+    SEMANTIC_SEGMENTATION = "SemanticSegmentation"
+    PANOPTIC_SEGMENTATION = "PanopticSegmentation"
 
 
 class DatasetMetadataType(str, Enum):
@@ -21,3 +24,23 @@ class DatasetMetadataType(str, Enum):
     HIRUNDO_CSV = "HirundoCSV"
     COCO = "COCO"
     YOLO = "YOLO"
+    KeylabsObjDetImages = "KeylabsObjDetImages"
+    KeylabsObjDetVideo = "KeylabsObjDetVideo"
+    KeylabsObjSegImages = "KeylabsObjSegImages"
+    KeylabsObjSegVideo = "KeylabsObjSegVideo"
+
+
+class StorageTypes(str, Enum):
+    """
+    Enum for the different types of storage configs.
+    Supported types are:
+    """
+
+    S3 = "S3"
+    GCP = "GCP"
+    # AZURE = "Azure"  TODO: Azure storage config is coming soon
+    GIT = "Git"
+    LOCAL = "Local"
+    """
+    Local storage config is only supported for on-premises installations.
+    """

hirundo/dataset_optimization.py

@@ -1,7 +1,6 @@
 import datetime
 import json
 import typing
-from abc import ABC, abstractmethod
 from collections.abc import AsyncGenerator, Generator
 from enum import Enum
 from typing import overload
@@ -12,14 +11,16 @@ from pydantic import BaseModel, Field, model_validator
 from tqdm import tqdm
 from tqdm.contrib.logging import logging_redirect_tqdm
 
-from hirundo._constraints import HirundoUrl
+from hirundo._constraints import validate_labeling_info, validate_url
 from hirundo._env import API_HOST
 from hirundo._headers import get_headers
 from hirundo._http import raise_for_status_with_reason
 from hirundo._iter_sse_retrying import aiter_sse_retrying, iter_sse_retrying
 from hirundo._timeouts import MODIFY_TIMEOUT, READ_TIMEOUT
+from hirundo._urls import HirundoUrl
 from hirundo.dataset_enum import DatasetMetadataType, LabelingType
 from hirundo.dataset_optimization_results import DatasetOptimizationResults
+from hirundo.labeling import YOLO, LabelingInfo
 from hirundo.logger import get_logger
 from hirundo.storage import ResponseStorageConfig, StorageConfig
 from hirundo.unzip import download_and_extract_zip
@@ -71,72 +72,6 @@ STATUS_TO_PROGRESS_MAP = {
 }
 
 
-class Metadata(BaseModel, ABC):
-    type: DatasetMetadataType
-
-    @property
-    @abstractmethod
-    def metadata_url(self) -> HirundoUrl:
-        raise NotImplementedError()
-
-
-class HirundoCSV(Metadata):
-    """
-    A dataset metadata file in the Hirundo CSV format
-    """
-
-    type: DatasetMetadataType = DatasetMetadataType.HIRUNDO_CSV
-    csv_url: HirundoUrl
-    """
-    The URL to access the dataset metadata CSV file.
-    e.g. `s3://my-bucket-name/my-folder/my-metadata.csv`, `gs://my-bucket-name/my-folder/my-metadata.csv`,
-    or `ssh://my-username@my-repo-name/my-folder/my-metadata.csv`
-    (or `file:///datasets/my-folder/my-metadata.csv` if using LOCAL storage type with on-premises installation)
-    """
-
-    @property
-    def metadata_url(self) -> HirundoUrl:
-        return self.csv_url
-
-
-class COCO(Metadata):
-    """
-    A dataset metadata file in the COCO format
-    """
-
-    type: DatasetMetadataType = DatasetMetadataType.COCO
-    json_url: HirundoUrl
-    """
-    The URL to access the dataset metadata JSON file.
-    e.g. `s3://my-bucket-name/my-folder/my-metadata.json`, `gs://my-bucket-name/my-folder/my-metadata.json`,
-    or `ssh://my-username@my-repo-name/my-folder/my-metadata.json`
-    (or `file:///datasets/my-folder/my-metadata.json` if using LOCAL storage type with on-premises installation)
-    """
-
-    @property
-    def metadata_url(self) -> HirundoUrl:
-        return self.json_url
-
-
-class YOLO(Metadata):
-    type: DatasetMetadataType = DatasetMetadataType.YOLO
-    data_yaml_url: typing.Optional[HirundoUrl] = None
-    labels_dir_url: HirundoUrl
-
-    @property
-    def metadata_url(self) -> HirundoUrl:
-        return self.labels_dir_url
-
-
-LabelingInfo = typing.Union[HirundoCSV, COCO, YOLO]
-"""
-The dataset labeling info. The dataset labeling info can be one of the following:
-- `DatasetMetadataType.HirundoCSV`: Indicates that the dataset metadata file is a CSV file with the Hirundo format
-
-Currently no other formats are supported. Future versions of `hirundo` may support additional formats.
-"""
-
-
 class VisionRunArgs(BaseModel):
     upsample: bool = False
     """
@@ -228,7 +163,7 @@ class OptimizationDataset(BaseModel):
     A full list of possible classes used in classification / object detection.
     It is currently required for clarity and performance.
     """
-    labeling_info: LabelingInfo
+    labeling_info: typing.Union[LabelingInfo, list[LabelingInfo]]
 
     augmentations: typing.Optional[list[AugmentationName]] = None
     """
@@ -267,16 +202,30 @@ class OptimizationDataset(BaseModel):
         ):
             raise ValueError("Language is only allowed for Speech-to-Text datasets.")
         if (
-            self.labeling_info.type == DatasetMetadataType.YOLO
+            not isinstance(self.labeling_info, list)
+            and self.labeling_info.type == DatasetMetadataType.YOLO
             and isinstance(self.labeling_info, YOLO)
             and (
                 self.labeling_info.data_yaml_url is not None
                 and self.classes is not None
             )
+        ) or (
+            isinstance(self.labeling_info, list)
+            and self.classes is not None
+            and any(
+                isinstance(info, YOLO) and info.data_yaml_url is not None
+                for info in self.labeling_info
+            )
         ):
             raise ValueError(
                 "Only one of `classes` or `labeling_info.data_yaml_url` should be provided for YOLO datasets"
             )
+        if self.storage_config:
+            validate_labeling_info(
+                self.labeling_type, self.labeling_info, self.storage_config
+            )
+        if self.data_root_url and self.storage_config:
+            validate_url(self.data_root_url, self.storage_config)
         return self
 
     @staticmethod
@@ -595,6 +544,17 @@ class OptimizationDataset(BaseModel):
         if not last_event or last_event["data"]["state"] == RunStatus.PENDING.value:
             OptimizationDataset._check_run_by_id(run_id, retry + 1)
 
+    @staticmethod
+    def _handle_failure(iteration: dict):
+        if iteration["result"]:
+            raise HirundoError(
+                f"Optimization run failed with error: {iteration['result']}"
+            )
+        else:
+            raise HirundoError(
+                "Optimization run failed with an unknown error in _handle_failure"
+            )
+
     @staticmethod
     @overload
     def check_run_by_id(
@@ -644,9 +604,11 @@ class OptimizationDataset(BaseModel):
                         RunStatus.REJECTED.value,
                         RunStatus.REVOKED.value,
                     ]:
-                        raise HirundoError(
-                            f"Optimization run failed with error: {iteration['result']}"
+                        logger.error(
+                            "State is failure, rejected, or revoked: %s",
+                            iteration["state"],
                         )
+                        OptimizationDataset._handle_failure(iteration)
                     elif iteration["state"] == RunStatus.SUCCESS.value:
                         t.close()
                         zip_temporary_url = iteration["result"]
@@ -690,7 +652,9 @@ class OptimizationDataset(BaseModel):
                         t.n = current_progress_percentage
                         logger.debug("Setting progress to %s", t.n)
                         t.refresh()
-        raise HirundoError("Optimization run failed with an unknown error")
+        raise HirundoError(
+            "Optimization run failed with an unknown error in check_run_by_id"
+        )
 
     @overload
     def check_run(
@@ -790,8 +754,6 @@ class OptimizationDataset(BaseModel):
         Args:
             run_id: The ID of the run to cancel
         """
-        if not run_id:
-            raise ValueError("No run has been started")
         logger.info("Cancelling run with ID: %s", run_id)
         response = requests.delete(
             f"{API_HOST}/dataset-optimization/run/{run_id}",
@@ -808,6 +770,30 @@ class OptimizationDataset(BaseModel):
             raise ValueError("No run has been started")
         self.cancel_by_id(self.run_id)
 
+    @staticmethod
+    def archive_run_by_id(run_id: str) -> None:
+        """
+        Archive the dataset optimization run for the given `run_id`.
+
+        Args:
+            run_id: The ID of the run to archive
+        """
+        logger.info("Archiving run with ID: %s", run_id)
+        response = requests.patch(
+            f"{API_HOST}/dataset-optimization/run/archive/{run_id}",
+            headers=get_headers(),
+            timeout=MODIFY_TIMEOUT,
+        )
+        raise_for_status_with_reason(response)
+
+    def archive(self) -> None:
+        """
+        Archive the current active instance's run.
+        """
+        if not self.run_id:
+            raise ValueError("No run has been started")
+        self.archive_run_by_id(self.run_id)
+
 
 class DataOptimizationDatasetOut(BaseModel):
     id: int
@@ -820,7 +806,7 @@ class DataOptimizationDatasetOut(BaseModel):
     data_root_url: HirundoUrl
 
     classes: typing.Optional[list[str]] = None
-    labeling_info: LabelingInfo
+    labeling_info: typing.Union[LabelingInfo, list[LabelingInfo]]
 
     organization_id: typing.Optional[int]
     creator_id: typing.Optional[int]

hirundo/git.py

@@ -7,11 +7,11 @@ import requests
 from pydantic import BaseModel, field_validator
 from pydantic_core import Url
 
-from hirundo._constraints import RepoUrl
 from hirundo._env import API_HOST
 from hirundo._headers import get_headers
 from hirundo._http import raise_for_status_with_reason
 from hirundo._timeouts import MODIFY_TIMEOUT, READ_TIMEOUT
+from hirundo._urls import RepoUrl
 from hirundo.logger import get_logger
 
 logger = get_logger(__name__)

hirundo/labeling.py

@@ -0,0 +1,140 @@
+import typing
+from abc import ABC
+
+from pydantic import BaseModel, Field
+
+from hirundo.dataset_enum import DatasetMetadataType
+
+if typing.TYPE_CHECKING:
+    from hirundo._urls import HirundoUrl
+
+
+class Metadata(BaseModel, ABC, frozen=True):
+    type: DatasetMetadataType
+
+
+class HirundoCSV(Metadata, frozen=True):
+    """
+    A dataset metadata file in the Hirundo CSV format
+    """
+
+    type: typing.Literal[DatasetMetadataType.HIRUNDO_CSV] = (
+        DatasetMetadataType.HIRUNDO_CSV
+    )
+    csv_url: "HirundoUrl"
+    """
+    The URL to access the dataset metadata CSV file.
+    e.g. `s3://my-bucket-name/my-folder/my-metadata.csv`, `gs://my-bucket-name/my-folder/my-metadata.csv`,
+    or `ssh://my-username@my-repo-name/my-folder/my-metadata.csv`
+    (or `file:///datasets/my-folder/my-metadata.csv` if using LOCAL storage type with on-premises installation)
+    """
+
+
+class COCO(Metadata, frozen=True):
+    """
+    A dataset metadata file in the COCO format
+    """
+
+    type: typing.Literal[DatasetMetadataType.COCO] = DatasetMetadataType.COCO
+    json_url: "HirundoUrl"
+    """
+    The URL to access the dataset metadata JSON file.
+    e.g. `s3://my-bucket-name/my-folder/my-metadata.json`, `gs://my-bucket-name/my-folder/my-metadata.json`,
+    or `ssh://my-username@my-repo-name/my-folder/my-metadata.json`
+    (or `file:///datasets/my-folder/my-metadata.json` if using LOCAL storage type with on-premises installation)
+    """
+
+
+class YOLO(Metadata, frozen=True):
+    type: typing.Literal[DatasetMetadataType.YOLO] = DatasetMetadataType.YOLO
+    data_yaml_url: "typing.Optional[HirundoUrl]" = None
+    labels_dir_url: "HirundoUrl"
+
+
+class KeylabsAuth(BaseModel):
+    username: str
+    password: str
+    instance: str
+
+
+class Keylabs(Metadata, frozen=True):
+    project_id: str
+    """
+    Keylabs project ID.
+    """
+
+    labels_dir_url: "HirundoUrl"
+    """
+    URL to the directory containing the Keylabs labels.
+    """
+
+    with_attributes: bool = True
+    """
+    Whether to include attributes in the class name.
+    """
+
+    project_name: typing.Optional[str] = None
+    """
+    Keylabs project name (optional; added to output CSV if provided).
+    """
+    keylabs_auth: typing.Optional[KeylabsAuth] = None
+    """
+    Keylabs authentication credentials (optional; if provided, used to provide links to each sample).
+    """
+
+
+class KeylabsObjDetImages(Keylabs, frozen=True):
+    type: typing.Literal[DatasetMetadataType.KeylabsObjDetImages] = (
+        DatasetMetadataType.KeylabsObjDetImages
+    )
+
+
+class KeylabsObjDetVideo(Keylabs, frozen=True):
+    type: typing.Literal[DatasetMetadataType.KeylabsObjDetVideo] = (
+        DatasetMetadataType.KeylabsObjDetVideo
+    )
+
+
+class KeylabsObjSegImages(Keylabs, frozen=True):
+    type: typing.Literal[DatasetMetadataType.KeylabsObjSegImages] = (
+        DatasetMetadataType.KeylabsObjSegImages
+    )
+
+
+class KeylabsObjSegVideo(Keylabs, frozen=True):
+    type: typing.Literal[DatasetMetadataType.KeylabsObjSegVideo] = (
+        DatasetMetadataType.KeylabsObjSegVideo
+    )
+
+
+KeylabsInfo = typing.Union[
+    KeylabsObjDetImages, KeylabsObjDetVideo, KeylabsObjSegImages, KeylabsObjSegVideo
+]
+"""
+The dataset labeling info for Keylabs. The dataset labeling info can be one of the following:
+- `DatasetMetadataType.KeylabsObjDetImages`: Indicates that the dataset metadata file is in the Keylabs object detection image format
+- `DatasetMetadataType.KeylabsObjDetVideo`: Indicates that the dataset metadata file is in the Keylabs object detection video format
+- `DatasetMetadataType.KeylabsObjSegImages`: Indicates that the dataset metadata file is in the Keylabs object segmentation image format
+- `DatasetMetadataType.KeylabsObjSegVideo`: Indicates that the dataset metadata file is in the Keylabs object segmentation video format
+"""
+LabelingInfo = typing.Annotated[
+    typing.Union[
+        HirundoCSV,
+        COCO,
+        YOLO,
+        KeylabsInfo,
+    ],
+    Field(discriminator="type"),
+]
+"""
+The dataset labeling info. The dataset labeling info can be one of the following:
+- `DatasetMetadataType.HirundoCSV`: Indicates that the dataset metadata file is a CSV file with the Hirundo format
+- `DatasetMetadataType.COCO`: Indicates that the dataset metadata file is a JSON file with the COCO format
+- `DatasetMetadataType.YOLO`: Indicates that the dataset metadata file is in the YOLO format
+- `DatasetMetadataType.KeylabsObjDetImages`: Indicates that the dataset metadata file is in the Keylabs object detection image format
+- `DatasetMetadataType.KeylabsObjDetVideo`: Indicates that the dataset metadata file is in the Keylabs object detection video format
+- `DatasetMetadataType.KeylabsObjSegImages`: Indicates that the dataset metadata file is in the Keylabs object segmentation image format
+- `DatasetMetadataType.KeylabsObjSegVideo`: Indicates that the dataset metadata file is in the Keylabs object segmentation video format
+
+Currently no other formats are supported. Future versions of `hirundo` may support additional formats.
+"""

hirundo/storage.py

@@ -1,5 +1,4 @@
 import typing
-from enum import Enum
 from pathlib import Path
 
 import pydantic
@@ -7,11 +6,12 @@ import requests
 from pydantic import BaseModel, model_validator
 from pydantic_core import Url
 
-from hirundo._constraints import S3BucketUrl, StorageConfigName
 from hirundo._env import API_HOST
 from hirundo._headers import get_headers
 from hirundo._http import raise_for_status_with_reason
 from hirundo._timeouts import MODIFY_TIMEOUT, READ_TIMEOUT
+from hirundo._urls import S3BucketUrl, StorageConfigName
+from hirundo.dataset_enum import StorageTypes
 from hirundo.git import GitRepo, GitRepoOut
 from hirundo.logger import get_logger
 
@@ -34,11 +34,11 @@ class StorageS3Base(BaseModel):
         Chains the bucket URL with the path, ensuring that the path is formatted correctly
 
         Args:
-            path: The path to the file in the S3 bucket, e.g. `my-file.txt` or `/my-folder/my-file.txt`
+            path: The path to the file in the S3 bucket, e.g. :file:`my-file.txt` or :file:`/my-folder/my-file.txt`
 
         Returns:
-            The full URL to the file in the S3 bucket, e.g. `s3://my-bucket/my-file.txt` or `s3://my-bucket/my-folder/my-file.txt`,
-            where `s3://my-bucket` is the bucket URL provided in the S3 storage config
+            The full URL to the file in the S3 bucket, e.g. :file:`s3://my-bucket/my-file.txt` or :file:`s3://my-bucket/my-folder/my-file.txt`,
+            where :file:`s3://my-bucket` is the bucket URL provided in the S3 storage config
         """
         return Url(
             f"{S3_PREFIX}{self.bucket_url.removeprefix(S3_PREFIX).removesuffix('/')}/{str(path).removeprefix('/')}"
@@ -64,11 +64,11 @@ class StorageGCPBase(BaseModel):
         Chains the bucket URL with the path, ensuring that the path is formatted correctly
 
         Args:
-            path: The path to the file in the GCP bucket, e.g. `my-file.txt` or `/my-folder/my-file.txt`
+            path: The path to the file in the GCP bucket, e.g. :file:`my-file.txt` or :file:`/my-folder/my-file.txt`
 
         Returns:
-            The full URL to the file in the GCP bucket, e.g. `gs://my-bucket/my-file.txt` or `gs://my-bucket/my-folder/my-file.txt`,
-            where `my-bucket` is the bucket name provided in the GCP storage config
+            The full URL to the file in the GCP bucket, e.g. :file:`gs://my-bucket/my-file.txt` or :file:`gs://my-bucket/my-folder/my-file.txt`,
+            where :file:`my-bucket` is the bucket name provided in the GCP storage config
         """
         return Url(f"gs://{self.bucket_name}/{str(path).removeprefix('/')}")
 
@@ -94,7 +94,7 @@ class StorageGCPOut(StorageGCPBase):
 #         Chains the container URL with the path, ensuring that the path is formatted correctly
 
 #         Args:
-#             path: The path to the file in the Azure container, e.g. `my-file.txt` or `/my-folder/my-file.txt`
+#             path: The path to the file in the Azure container, e.g. :file:`my-file.txt` or :file:`/my-folder/my-file.txt`
 
 #         Returns:
 #             The full URL to the file in the Azure container
@@ -114,11 +114,11 @@ def get_git_repo_url(
     Chains the repository URL with the path, ensuring that the path is formatted correctly
 
     Args:
-        repo_url: The URL of the git repository, e.g. `https://my-git-repository.com`
-        path: The path to the file in the git repository, e.g. `my-file.txt` or `/my-folder/my-file.txt`
+        repo_url: The URL of the git repository, e.g. :file:`https://my-git-repository.com`
+        path: The path to the file in the git repository, e.g. :file:`my-file.txt` or :file:`/my-folder/my-file.txt`
 
     Returns:
-        The full URL to the file in the git repository, e.g. `https://my-git-repository.com/my-file.txt` or `https://my-git-repository.com/my-folder/my-file.txt`
+        The full URL to the file in the git repository, e.g. :file:`https://my-git-repository.com/my-file.txt` or :file:`https://my-git-repository.com/my-folder/my-file.txt`
     """
     if not isinstance(repo_url, Url):
         repo_url = Url(repo_url)
@@ -131,12 +131,12 @@ class StorageGit(BaseModel):
     repo_id: typing.Optional[int] = None
     """
     The ID of the Git repository in the Hirundo system.
-    Either `repo_id` or `repo` must be provided.
+    Either :code:`repo_id` or :code:`repo` must be provided.
     """
     repo: typing.Optional[GitRepo] = None
     """
     The Git repository to link to.
-    Either `repo_id` or `repo` must be provided.
+    Either :code:`repo_id` or :code:`repo` must be provided.
     """
     branch: str
     """
@@ -156,11 +156,11 @@ class StorageGit(BaseModel):
         Chains the repository URL with the path, ensuring that the path is formatted correctly
 
         Args:
-            path: The path to the file in the git repository, e.g. `my-file.txt` or `/my-folder/my-file.txt`
+            path: The path to the file in the git repository, e.g. :file:`my-file.txt` or :file:`/my-folder/my-file.txt`
 
         Returns:
-            The full URL to the file in the git repository, e.g. `https://my-git-repository.com/my-file.txt` or `https://my-git-repository.com/my-folder/my-file.txt`,
-            where `https://my-git-repository.com` is the repository URL provided in the git storage config's git repo
+            The full URL to the file in the git repository, e.g. :file:`https://my-git-repository.com/my-file.txt` or :file:`https://my-git-repository.com/my-folder/my-file.txt`,
+            where :file:`https://my-git-repository.com` is the repository URL provided in the git storage config's git repo
         """
         if not self.repo:
             raise ValueError("Repo must be provided to use `get_url`")
@@ -179,47 +179,31 @@ class StorageGitOut(BaseModel):
         Chains the repository URL with the path, ensuring that the path is formatted correctly
 
         Args:
-            path: The path to the file in the git repository, e.g. `my-file.txt` or `/my-folder/my-file.txt`
+            path: The path to the file in the git repository, e.g. :file:`my-file.txt` or :file:`/my-folder/my-file.txt`
 
         Returns:
-            The full URL to the file in the git repository, e.g. `https://my-git-repository.com/my-file.txt` or `https://my-git-repository.com/my-folder/my-file.txt`,
-            where `https://my-git-repository.com` is the repository URL provided in the git storage config's git repo
+            The full URL to the file in the git repository, e.g. :file:`https://my-git-repository.com/my-file.txt` or :file:`https://my-git-repository.com/my-folder/my-file.txt`,
+            where :file:`https://my-git-repository.com` is the repository URL provided in the git storage config's git repo
         """
         repo_url = self.repo.repository_url
         return get_git_repo_url(repo_url, path)
 
 
-class StorageTypes(str, Enum):
-    """
-    Enum for the different types of storage configs.
-    Supported types are:
-    """
-
-    S3 = "S3"
-    GCP = "GCP"
-    # AZURE = "Azure"  TODO: Azure storage config is coming soon
-    GIT = "Git"
-    LOCAL = "Local"
-    """
-    Local storage config is only supported for on-premises installations.
-    """
-
-
 class StorageConfig(BaseModel):
     id: typing.Optional[int] = None
     """
-    The ID of the `StorageConfig` in the Hirundo system.
+    The ID of the :code:`StorageConfig` in the Hirundo system.
     """
 
     organization_id: typing.Optional[int] = None
     """
-    The ID of the organization that the `StorageConfig` belongs to.
+    The ID of the organization that the :code:`StorageConfig` belongs to.
     If not provided, it will be assigned to your default organization.
     """
 
     name: StorageConfigName
     """
-    A name to identify the `StorageConfig` in the Hirundo system.
+    A name to identify the :code:`StorageConfig` in the Hirundo system.
     """
     type: typing.Optional[StorageTypes] = pydantic.Field(
         examples=[
@@ -230,12 +214,12 @@ class StorageConfig(BaseModel):
         ]
     )
     """
-    The type of the `StorageConfig`.
+    The type of the :code:`StorageConfig`.
     Supported types are:
-    - `S3`
-    - `GCP`
-    - `Azure` (coming soon)
-    - `Git`
+    - :code:`S3`
+    - :code:`GCP`
+    - :code:`Azure` (coming soon)
+    - :code:`Git`
     """
     s3: typing.Optional[StorageS3] = pydantic.Field(
         default=None,
@@ -323,10 +307,10 @@ class StorageConfig(BaseModel):
     @staticmethod
     def get_by_id(storage_config_id: int) -> "ResponseStorageConfig":
         """
-        Retrieves a `StorageConfig` instance from the server by its ID
+        Retrieves a :code:`StorageConfig` instance from the server by its ID
 
         Args:
-            storage_config_id: The ID of the `StorageConfig` to retrieve
+            storage_config_id: The ID of the :code:`StorageConfig` to retrieve
         """
         storage_config = requests.get(
             f"{API_HOST}/storage-config/{storage_config_id}",
@@ -339,11 +323,11 @@ class StorageConfig(BaseModel):
     @staticmethod
     def get_by_name(name: str, storage_type: StorageTypes) -> "ResponseStorageConfig":
         """
-        Retrieves a `StorageConfig` instance from the server by its name
+        Retrieves a :code:`StorageConfig` instance from the server by its name
 
         Args:
-            name: The name of the `StorageConfig` to retrieve
-            storage_type: The type of the `StorageConfig` to retrieve
+            name: The name of the :code:`StorageConfig` to retrieve
+            storage_type: The type of the :code:`StorageConfig` to retrieve
 
             Note: The type is required because the name is not unique across different storage types
         """
@@ -360,12 +344,12 @@ class StorageConfig(BaseModel):
         organization_id: typing.Optional[int] = None,
     ) -> list["ResponseStorageConfig"]:
         """
-        Lists all the `StorageConfig`'s created by user's default organization
-        Note: The return type is `list[dict]` and not `list[StorageConfig]`
+        Lists all the :code:`StorageConfig`'s created by user's default organization
+        Note: The return type is :code:`list[dict]` and not :code:`list[StorageConfig]`
 
         Args:
-            organization_id: The ID of the organization to list `StorageConfig`'s for.
-            If not provided, it will list `StorageConfig`'s for the default organization.
+            organization_id: The ID of the organization to list :code:`StorageConfig`'s for.
+            If not provided, it will list :code:`StorageConfig`'s for the default organization.
         """
         storage_configs = requests.get(
             f"{API_HOST}/storage-config/",
@@ -379,10 +363,10 @@ class StorageConfig(BaseModel):
     @staticmethod
     def delete_by_id(storage_config_id) -> None:
         """
-        Deletes a `StorageConfig` instance from the server by its ID
+        Deletes a :code:`StorageConfig` instance from the server by its ID
 
         Args:
-            storage_config_id: The ID of the `StorageConfig` to delete
+            storage_config_id: The ID of the :code:`StorageConfig` to delete
         """
         storage_config = requests.delete(
             f"{API_HOST}/storage-config/{storage_config_id}",
@@ -394,7 +378,7 @@ class StorageConfig(BaseModel):
 
     def delete(self) -> None:
         """
-        Deletes the `StorageConfig` instance from the server
+        Deletes the :code:`StorageConfig` instance from the server
         """
         if not self.id:
             raise ValueError("No StorageConfig has been created")
@@ -402,10 +386,10 @@ class StorageConfig(BaseModel):
 
     def create(self, replace_if_exists: bool = False) -> int:
         """
-        Create a `StorageConfig` instance on the server
+        Create a :code:`StorageConfig` instance on the server
 
         Args:
-            replace_if_exists: If a `StorageConfig` with the same name and type already exists, replace it.
+            replace_if_exists: If a :code:`StorageConfig` with the same name and type already exists, replace it.
         """
         if self.git and self.git.repo:
             self.git.repo_id = self.git.repo.create(replace_if_exists=replace_if_exists)

{hirundo-0.1.16.dist-info → hirundo-0.1.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hirundo
-Version: 0.1.16
+Version: 0.1.18
 Summary: This package is used to interface with Hirundo's platform. It provides a simple API to optimize your ML datasets.
 Author-email: Hirundo <dev@hirundo.io>
 License: MIT License
@@ -55,7 +55,7 @@ Requires-Dist: platformdirs>=4.3.6; extra == "dev"
 Requires-Dist: safety>=3.2.13; extra == "dev"
 Provides-Extra: docs
 Requires-Dist: sphinx>=7.4.7; extra == "docs"
-Requires-Dist: sphinx-autobuild>=2024.4.16; extra == "docs"
+Requires-Dist: sphinx-autobuild>=2024.9.3; extra == "docs"
 Requires-Dist: sphinx-click>=5.0.1; extra == "docs"
 Requires-Dist: autodoc_pydantic>=2.2.0; extra == "docs"
 Requires-Dist: furo; extra == "docs"
@@ -64,7 +64,7 @@ Requires-Dist: esbonio; extra == "docs"
 Requires-Dist: starlette>0.40.0; extra == "docs"
 Requires-Dist: markupsafe>=3.0.2; extra == "docs"
 Provides-Extra: pandas
-Requires-Dist: pandas>=2.2.2; extra == "pandas"
+Requires-Dist: pandas>=2.2.3; extra == "pandas"
 Provides-Extra: polars
 Requires-Dist: polars>=1.0.0; extra == "polars"
 Dynamic: license-file
@@ -75,40 +75,62 @@ This package exposes access to Hirundo APIs for dataset optimization for Machine
 
 Dataset optimization is currently available for datasets labelled for classification and object detection.
 
-
 Support dataset storage configs include:
-   - Google Cloud (GCP) Storage
-   - Amazon Web Services (AWS) S3
-   - Git LFS (Large File Storage) repositories (e.g. GitHub or HuggingFace)
+
+- Google Cloud (GCP) Storage
+- Amazon Web Services (AWS) S3
+- Git LFS (Large File Storage) repositories (e.g. GitHub or HuggingFace)
+
+Note: This Python package must be used alongside a Hirundo server, either the SaaS platform, a custom VPC deployment or an on-premises installation.
 
 Optimizing a classification dataset
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Currently ``hirundo`` requires a CSV file with the following columns (all columns are required):
-   - ``image_path``: The location of the image within the dataset ``root``
-   - ``label``: The label of the image, i.e. which the class that was annotated for this image
+Currently `hirundo` requires a CSV file with the following columns (all columns are required):
+
+- `image_path`: The location of the image within the dataset `data_root_url`
+- `class_name`: The semantic label, i.e. the class name of the class that the image was annotated as belonging to
+
+And outputs two Pandas DataFrames with the dataset columns as well as:
+
+Suspect DataFrame (filename: `mislabel_suspects.csv`) columns:
 
-And outputs a CSV with the same columns and:
-   - ``suspect_level``: mislabel suspect level
-   - ``suggested_label``: suggested label
-   - ``suggested_label_conf``: suggested label confidence
+- ``suspect_score``: mislabel suspect score
+- ``suspect_level``: mislabel suspect level
+- ``suspect_rank``: mislabel suspect ranking
+- ``suggested_class_name``: suggested semantic label
+- ``suggested_class_conf``: suggested semantic label confidence
+
+Errors and warnings DataFrame (filename: `invalid_data.csv`) columns:
+
+   - ``status``: status message (one of ``NO_LABELS`` / ``MISSING_IMAGE`` / ``INVALID_IMAGE``)
 
 Optimizing an object detection (OD) dataset
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Currently ``hirundo`` requires a CSV file with the following columns (all columns are required):
-   - ``image_path``: The location of the image within the dataset ``root``
-   - ``bbox_id``: The index of the bounding box within the dataset. Used to indicate label suspects
-   - ``label``: The label of the image, i.e. which the class that was annotated for this image
-   - ``x1``, ``y1``, ``x2``, ``y2``: The bounding box coordinates of the object within the image
 
-And outputs a CSV with the same columns and:
-   - ``suspect_level``: object mislabel suspect level
-   - ``suggested_label``: suggested object label
-   - ``suggested_label_conf``: suggested object label confidence
+- ``image_path``: The location of the image within the dataset ``data_root_url``
+- ``object_id``: The ID of the bounding box within the dataset. Used to indicate object suspects
+- ``class_name``: Object semantic label, i.e. the class name of the object that was annotated
+- ``xmin``: leftmost horizontal pixel coordinate of the object's bounding box
+- ``ymin``: uppermost vertical pixel coordinate of the object's bounding box
+- ``xmax``: rightmost horizontal pixel coordinate of the object's bounding box
+- ``ymax``: lowermost vertical pixel coordinate of the object's bounding box
 
-Note: This Python package must be used alongside a Hirundo server, either the SaaS platform, a custom VPC deployment or an on-premises installation.
 
+And outputs two Pandas DataFrames with the dataset columns as well as:
+
+Suspect DataFrame (filename: `mislabel_suspects.csv`) columns:
+
+- ``suspect_score``: object mislabel suspect score
+- ``suspect_level``: object mislabel suspect level
+- ``suspect_rank``: object mislabel suspect ranking
+- ``suggested_class_name``: suggested object semantic label
+- ``suggested_class_conf``: suggested object semantic label confidence
+
+Errors and warnings DataFrame (filename: `invalid_data.csv`) columns:
+   - ``status``: status message (one of ``NO_LABELS`` / ``MISSING_IMAGE`` / ``INVALID_IMAGE`` / ``INVALID_BBOX`` / ``INVALID_BBOX_SIZE``)
 
 ## Installation
 
@@ -117,6 +139,7 @@ You can install the codebase with a simple `pip install hirundo` to install the
 ## Usage
 
 Classification example:
+
 ```python
 from hirundo import (
     HirundoCSV,
@@ -152,7 +175,6 @@ results = test_dataset.check_run()
 print(results)
 ```
 
-
 Object detection example:
 
 ```python
@@ -187,21 +209,6 @@ test_dataset = OptimizationDataset(
             path="/BDD100K Val from Hirundo.zip/bdd100k/bdd100k.csv"
         ),
     ),
-    classes=[
-        "traffic light",
-        "traffic sign",
-        "car",
-        "pedestrian",
-        "bus",
-        "truck",
-        "rider",
-        "bicycle",
-        "motorcycle",
-        "train",
-        "other vehicle",
-        "other person",
-        "trailer",
-    ],
 )
 
 test_dataset.run_optimization()
@@ -209,8 +216,8 @@ results = test_dataset.check_run()
 print(results)
 ```
 
-Note: Currently we only support the main CPython release 3.9, 3.10 and 3.11. PyPy support may be introduced in the future.
+Note: Currently we only support the main CPython release 3.9, 3.10, 3.11, 3.12 & 3.13. PyPy support may be introduced in the future.
 
 ## Further documentation
 
-To learn more about how to use this library, please visit the [http://docs.hirundo.io/](documentation) or see the Google Colab examples.
+To learn more about how to use this library, please visit the [http://docs.hirundo.io/](documentation) or see the [Google Colab examples](https://github.com/Hirundo-io/hirundo-client/tree/main/notebooks).

hirundo-0.1.18.dist-info/RECORD

@@ -0,0 +1,25 @@
+hirundo/__init__.py,sha256=1Uy9UZhaZPQQSMfAOJ0A_Of70tM8_MDq-HHdhrmpO6g,1301
+hirundo/__main__.py,sha256=wcCrL4PjG51r5wVKqJhcoJPTLfHW0wNbD31DrUN0MWI,28
+hirundo/_constraints.py,sha256=tgJfvp7ydyXilT8ViNk837rNRlpOVXLLeCSMt_YUUYA,6013
+hirundo/_dataframe.py,sha256=sXEEbCNcLi83wyU9ii884YikCzfASo_3nnrDxhuCv7U,758
+hirundo/_env.py,sha256=efX2sjvYlHkFr2Lcstelei67YSTFpVGT0l08ZsfiMuE,622
+hirundo/_headers.py,sha256=3hybpD_X4SODv3cFZPt9AjGY2vvZaag5OKT3z1SHSjA,521
+hirundo/_http.py,sha256=izlnuxStyPugjTAbD8Lo30tA4lZJ5d3kOENNduqrbX4,573
+hirundo/_iter_sse_retrying.py,sha256=U331_wZRIbVzi-jnMqo8bp9jBC8MtFBLEs-X0ZvhSDw,4634
+hirundo/_timeouts.py,sha256=gE58NU0t2e4KgKq2sk5rZcezDJAkgvRIbM5AVYFY6Ho,86
+hirundo/_urls.py,sha256=0C85EbL0T-Bj25vJwjNs_obUG8ROSADpmbFdTAyhzlw,1375
+hirundo/cli.py,sha256=5Tn0eXZGG92BR9HJYUaYozjFbS1t6UTw_I2R0tZBE04,7824
+hirundo/dataset_enum.py,sha256=QnS3fy1OF4wvUtiIAHubKRhc611idS8huopEEolgqEM,1217
+hirundo/dataset_optimization.py,sha256=fXi8MeI0PWwSyc5NuOzCrkgXT_mz24NV-dGOHDPkBR0,31256
+hirundo/dataset_optimization_results.py,sha256=A9YyF5zaZXVtzeDE08I_05v90dhZQADpSjDcS_6eLMc,1129
+hirundo/git.py,sha256=8LVnF4WCjZsxMHoRaVxbLiDAKpGCBEwlcZp7a30n9Zo,6573
+hirundo/labeling.py,sha256=zXQCaqfdaLIG4qbzFGbb94L3FDdRMpdzHwbrDJE07Yk,5006
+hirundo/logger.py,sha256=MUqrYp0fBlxWFhGl6P5t19_uqO7T_PNhrLN5bqY3i7s,275
+hirundo/storage.py,sha256=y7cr_dngkfZq0gKnwWxrSqUXb1SycGpwFRVmS9Cn3h8,15942
+hirundo/unzip.py,sha256=XJqvt2m5pWR-G-fnzgW75VOdd-K4_Rw2r4wiEhZgKZA,8245
+hirundo-0.1.18.dist-info/licenses/LICENSE,sha256=fusGGjqT2RGlU6kbkaOk7d-gDnsjk17wq67AO0mwBZI,1065
+hirundo-0.1.18.dist-info/METADATA,sha256=F_F0-EfUxVVCcgFue_hwCtxfIfmqBlwnpvzELuhMkAc,9302
+hirundo-0.1.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hirundo-0.1.18.dist-info/entry_points.txt,sha256=4ZtnA_Nl1Af8fLnHp3lwjbGDEGU1S6ujb_JwtuQ7ZPM,44
+hirundo-0.1.18.dist-info/top_level.txt,sha256=cmyNqrNZOAYxnywJGFI1AJBLe4SkH8HGsfFx6ncdrbI,8
+hirundo-0.1.18.dist-info/RECORD,,

{hirundo-0.1.16.dist-info → hirundo-0.1.18.dist-info}/WHEEL

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

hirundo-0.1.16.dist-info/RECORD

@@ -1,23 +0,0 @@
-hirundo/__init__.py,sha256=qKC89bNReZSjGtmf7l3PZD2JoptyVphpsD0Kf2PNXvY,1035
-hirundo/__main__.py,sha256=wcCrL4PjG51r5wVKqJhcoJPTLfHW0wNbD31DrUN0MWI,28
-hirundo/_constraints.py,sha256=gRv7fXwtjPGqYWIhkVYxu1B__3PdlYRqFyDkTpa9f74,1032
-hirundo/_dataframe.py,sha256=sXEEbCNcLi83wyU9ii884YikCzfASo_3nnrDxhuCv7U,758
-hirundo/_env.py,sha256=efX2sjvYlHkFr2Lcstelei67YSTFpVGT0l08ZsfiMuE,622
-hirundo/_headers.py,sha256=3hybpD_X4SODv3cFZPt9AjGY2vvZaag5OKT3z1SHSjA,521
-hirundo/_http.py,sha256=izlnuxStyPugjTAbD8Lo30tA4lZJ5d3kOENNduqrbX4,573
-hirundo/_iter_sse_retrying.py,sha256=U331_wZRIbVzi-jnMqo8bp9jBC8MtFBLEs-X0ZvhSDw,4634
-hirundo/_timeouts.py,sha256=gE58NU0t2e4KgKq2sk5rZcezDJAkgvRIbM5AVYFY6Ho,86
-hirundo/cli.py,sha256=5Tn0eXZGG92BR9HJYUaYozjFbS1t6UTw_I2R0tZBE04,7824
-hirundo/dataset_enum.py,sha256=ZEYBP-lrlVqfNWptlmw7JgLNhCyDirtWWPtoMvtg2AE,531
-hirundo/dataset_optimization.py,sha256=jR4ZOlKKl05jrA4cq9L1IQuKVPJ3ytXkhOJEg6efFqI,31390
-hirundo/dataset_optimization_results.py,sha256=A9YyF5zaZXVtzeDE08I_05v90dhZQADpSjDcS_6eLMc,1129
-hirundo/git.py,sha256=6h1hFPlw5FfYMGWXPCitnTqGICmBKmQtb5qKGe3Icmk,6580
-hirundo/logger.py,sha256=MUqrYp0fBlxWFhGl6P5t19_uqO7T_PNhrLN5bqY3i7s,275
-hirundo/storage.py,sha256=kO-LWlQAM3qTnALEl8s79AiFMYqCG9Sem4MIFQcyvAg,15950
-hirundo/unzip.py,sha256=XJqvt2m5pWR-G-fnzgW75VOdd-K4_Rw2r4wiEhZgKZA,8245
-hirundo-0.1.16.dist-info/licenses/LICENSE,sha256=fusGGjqT2RGlU6kbkaOk7d-gDnsjk17wq67AO0mwBZI,1065
-hirundo-0.1.16.dist-info/METADATA,sha256=CxdCbzafRuVRf1BGsS_tgjodO0g745uuNBl7y4UFMj8,8501
-hirundo-0.1.16.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
-hirundo-0.1.16.dist-info/entry_points.txt,sha256=4ZtnA_Nl1Af8fLnHp3lwjbGDEGU1S6ujb_JwtuQ7ZPM,44
-hirundo-0.1.16.dist-info/top_level.txt,sha256=cmyNqrNZOAYxnywJGFI1AJBLe4SkH8HGsfFx6ncdrbI,8
-hirundo-0.1.16.dist-info/RECORD,,