datamint 1.9.2__py3-none-any.whl → 2.0.0__py3-none-any.whl

datamint/exceptions.py

@@ -2,4 +2,30 @@ class DatamintException(Exception):
     """
     Base class for exceptions in this module.
     """
-    pass
+    pass
+
+class ResourceNotFoundError(DatamintException):
+    """
+    Exception raised when a resource is not found. 
+    For instance, when trying to get a resource by a non-existing id.
+    """
+
+    def __init__(self,
+                 resource_type: str,
+                 params: dict):
+        """ Constructor.
+
+        Args:
+            resource_type (str): A resource type.
+            params (dict): Dict of params identifying the sought resource.
+        """
+        super().__init__()
+        self.resource_type = resource_type
+        self.params = params
+
+    def set_params(self, resource_type: str, params: dict):
+        self.resource_type = resource_type
+        self.params = params
+
+    def __str__(self):
+        return f"Resource '{self.resource_type}' not found for parameters: {self.params}"

datamint/logging.yaml

@@ -7,7 +7,7 @@ handlers:
     level: WARNING
     show_time: False
   console_user:
-    class: datamint.utils.logging_utils.ConditionalRichHandler
+    class: datamint.utils.logging_utils.ConsoleWrapperHandler
     level: INFO
     show_path: False
     show_time: False

datamint/utils/logging_utils.py

@@ -1,3 +1,8 @@
+from rich.theme import Theme
+from logging import Logger, DEBUG, INFO, WARNING, ERROR, CRITICAL
+from rich.console import Console
+import platform
+import os
 import logging
 import logging.config
 from rich.console import ConsoleRenderable
@@ -53,3 +58,73 @@ def load_cmdline_logging_config():
         print(f"Warning: Error loading logging configuration file: {e}")
         _LOGGER.exception(e)
         logging.basicConfig(level=logging.INFO)
+
+
+LEVELS_MAPPING = {
+    DEBUG: None,
+    INFO: None,
+    WARNING: "warning",
+    ERROR: "error",
+    CRITICAL: "error"
+}
+
+
+def _create_console_theme() -> Theme:
+    """Create a custom Rich theme optimized for cross-platform terminals."""
+    # Detect if we're likely on PowerShell (Windows + PowerShell)
+    is_powershell = (
+        platform.system() == "Windows" and
+        os.environ.get("PSModulePath") is not None
+    )
+
+    if is_powershell:
+        # PowerShell blue background - use high contrast colors
+        return Theme({
+            "warning": "bright_yellow",
+            "error": "bright_red on white",
+            "success": "bright_green",
+            "key": "bright_cyan",
+            "accent": "bright_cyan",
+            "title": "bold"
+        })
+    else:
+        # Linux/Unix terminals - standard colors
+        return Theme({
+            "warning": "yellow",
+            "error": "red",
+            "success": "green",
+            "key": "cyan",
+            "accent": "bright_blue",
+            "title": "bold"
+        })
+
+
+class ConsoleWrapperHandler(ConditionalRichHandler):
+    """
+    A logging handler that uses a rich.console.Console to print log messages.
+    """
+    def __init__(self, *args, console: Console | None = None, **kwargs):
+        """
+        Initializes the ConsoleWrapperHandler.
+
+        Args:
+            console (Console | None): A rich Console instance. If None, a new one is created.
+        """
+        super().__init__(*args, **kwargs)
+        if console is None:
+            console = Console(theme=_create_console_theme())
+        self.console = console
+
+    def emit(self, record: logging.LogRecord) -> None:
+        """
+        Emits a log record.
+
+        Args:
+            record (logging.LogRecord): The log record to emit.
+        """
+        try:
+            msg = self.format(record)
+            style = LEVELS_MAPPING.get(record.levelno)
+            self.console.print(msg, style=style)
+        except Exception:
+            self.handleError(record)

{datamint-1.9.2.dist-info → datamint-2.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: datamint
-Version: 1.9.2
+Version: 2.0.0
 Summary: A library for interacting with the Datamint API, designed for efficient data management, processing and Deep Learning workflows.
 Requires-Python: >=3.10
 Classifier: Programming Language :: Python :: 3
@@ -8,6 +8,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Provides-Extra: dev
 Provides-Extra: docs
 Requires-Dist: Deprecated (>=1.2.0)
@@ -19,13 +20,14 @@ Requires-Dist: humanize (>=4.0.0,<5.0.0)
 Requires-Dist: lazy-loader (>=0.3.0)
 Requires-Dist: lightning
 Requires-Dist: matplotlib
-Requires-Dist: medimgkit (>=0.5.0)
+Requires-Dist: medimgkit (>=0.6.0)
 Requires-Dist: nest-asyncio (>=1.0.0,<2.0.0)
 Requires-Dist: nibabel (>=4.0.0)
 Requires-Dist: numpy
 Requires-Dist: opencv-python (>=4.0.0)
 Requires-Dist: pandas (>=2.0.0)
 Requires-Dist: platformdirs (>=4.0.0,<5.0.0)
+Requires-Dist: pydantic (>=2.6.4)
 Requires-Dist: pydicom (>=3.0.0,<4.0.0)
 Requires-Dist: pylibjpeg (>=2.0.0,<3.0.0)
 Requires-Dist: pylibjpeg-libjpeg (>=2.0.0,<3.0.0)
@@ -42,6 +44,7 @@ Requires-Dist: sphinx_rtd_theme (>=2.0.0) ; extra == "docs"
 Requires-Dist: torch (>=1.2.0,!=2.3.0)
 Requires-Dist: torchvision (>=0.18.0)
 Requires-Dist: tqdm (>=4.0.0,<5.0.0)
+Requires-Dist: typing_extensions (>=4.0.0)
 Description-Content-Type: text/markdown
 
 
@@ -91,13 +94,13 @@ import os
 os.environ["DATAMINT_API_KEY"] = "my_api_key"
 ```
 
-### Method 3: APIHandler constructor
+### Method 3: Api constructor
 
-Specify API key in the |APIHandlerClass| constructor:
+Specify API key in the Api constructor:
 
 ```python
-from datamint import APIHandler
-api = APIHandler(api_key='my_api_key')
+from datamint import Api
+api = Api(api_key='my_api_key')
 ```
 
 ## Tutorials
@@ -110,8 +113,9 @@ You can find example notebooks in the `notebooks` folder:
 
 and example scripts in [examples](examples) folder:
 
-- [Running an experiment for classification](examples/experiment_traintest_classifier.py)
-- [Running an experiment for segmentation](examples/experiment_traintest_segmentation.py)
+- [API usage examples](examples/api_usage.ipynb)
+- [Project and entity usage](examples/project_entity_usage.ipynb)
+- [Channels example](examples/channels_example.ipynb)
 
 ## Full documentation
 

datamint-2.0.0.dist-info/RECORD

@@ -0,0 +1,50 @@
+datamint/__init__.py,sha256=ucsnxrYClh6pdy7psRJXWam_9rjAQB4NXzvy7xLovmo,824
+datamint/api/__init__.py,sha256=7QYkmDBXbKh8-zchV7k6Lpolaw6h-IK6ezfXROIWh2A,43
+datamint/api/base_api.py,sha256=MIq1sQA4mD9_SWxAEDjxtxm3Q-tj6kZ05KRnNoLPM7E,16576
+datamint/api/client.py,sha256=1XTZUlbAISe0jwug1rrANgWJToXxYeXx8_HD-ZWJurU,3354
+datamint/api/dto/__init__.py,sha256=KOSNl1axDDE5eBt68MmsgkyE0Ds_1DDzWUg73iyoWvc,281
+datamint/api/endpoints/__init__.py,sha256=S46nVAlXgGe8wNcBEhW8ffGJjGNAmhhRTDTsvG9fWBE,402
+datamint/api/endpoints/annotations_api.py,sha256=zzCiL2z7czB1ojU3CCM5QgeOuDoNB_2D3Fc8NPc41HM,46240
+datamint/api/endpoints/channels_api.py,sha256=oQqxSw9DJzAqtVQI7-tc1llTdnsm-URx8jwtXNXnhio,867
+datamint/api/endpoints/datasetsinfo_api.py,sha256=WdzrUzK63w9gvAP6U--P65FbD-3X-jm9TPCcYnRNjas,597
+datamint/api/endpoints/projects_api.py,sha256=9tYIQsnMFOGTXrsoizweoWNqNue5907nbI6G9PAcYcA,7784
+datamint/api/endpoints/resources_api.py,sha256=jlap40_wpzz8L8a-sX9tNGxsgPgP2_hv8kdb3g75-NU,48455
+datamint/api/endpoints/users_api.py,sha256=pnkuTZ1B9Y0FtwwvXO8J64e02RSkRxnBmTl9UGSuC5I,1186
+datamint/api/entity_base_api.py,sha256=gPE28bwv7B6JngMk9szD2XwaVhB8OwB1HJjaMYD354k,12935
+datamint/apihandler/annotation_api_handler.py,sha256=W3vV4z3BqX1OQe1r7zr8dI-IVu4zUDxED4QttdiWV-E,57098
+datamint/apihandler/api_handler.py,sha256=mL0gMaWePYa7zwkw92E-VMK2WjpcPt7au0KqnmsWSYw,439
+datamint/apihandler/base_api_handler.py,sha256=Hqt3oUvXfEqF25DJkk0WOWAtNLnKaZRGtnCchKFA1ag,11669
+datamint/apihandler/dto/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datamint/apihandler/dto/annotation_dto.py,sha256=KUeHbxLYols16q-ANNxC48eH4EA8Tc-nKmW_8xrqhy4,7119
+datamint/apihandler/exp_api_handler.py,sha256=hFUgUgBc5rL7odK7gTW3MnrvMY1pVfJUpUdzRNobMQE,6226
+datamint/apihandler/root_api_handler.py,sha256=jBof_XPTeq4o41CW-l-I5GHQKVa76kaX75RovS_qAM4,63384
+datamint/client_cmd_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+datamint/client_cmd_tools/datamint_config.py,sha256=5S9sgS64F141ZcvvjCHEEgfNKwhGt4g2oJQaJqeiugA,7228
+datamint/client_cmd_tools/datamint_upload.py,sha256=jPzvlNeBZfOOxuG6ryswJ8OG4jXuTrPtArUetoKVGj0,36073
+datamint/configs.py,sha256=Bdp6NydYwyCJ2dk19_gf_o3M2ZyQOmMHpLi8wEWNHUk,1426
+datamint/dataset/__init__.py,sha256=4PlUKSvVhdfQvvuq8jQXrkdqnot-iTTizM3aM1vgSwg,47
+datamint/dataset/annotation.py,sha256=qN1IMjdfLD2ceQ6va3l76jOXA8Vb_c-eBk1oWQu6hW0,7994
+datamint/dataset/base_dataset.py,sha256=ghVfy_WB3sZD29J5rWQhccEi1DD_qsif5B4gcPlhepU,49285
+datamint/dataset/dataset.py,sha256=It-HOTi83ls4ww2qCAvFYU0_OLLrFclj0QQapMYgDAE,27333
+datamint/entities/__init__.py,sha256=tbHE7rZb0R9Hm-Dc8VWEq3PlRl7BYOzffumrV0ZdsMs,444
+datamint/entities/annotation.py,sha256=ochAEh_JqxAe_FyYTNUfPT47KiIAG7CkBTim52bu7M8,6636
+datamint/entities/base_entity.py,sha256=DniakCgJ-gV7Hz8VKQA_dRYTp4DU5rcjLBVOuD1aZuA,1902
+datamint/entities/channel.py,sha256=9fl22eSx_ng98NosfQGs18cdaRdbeC3wXL61KhSg4Zo,1601
+datamint/entities/datasetinfo.py,sha256=O73Aq0tLflQomFzseful8a_cXqKdO9w2yP0p3zBcA-s,489
+datamint/entities/project.py,sha256=cK03qfVBVUTFJF0IZQCGfjX-ivzDytySakKoVbjfnz0,2588
+datamint/entities/resource.py,sha256=7YCVihswd-bH-2AH4aMPIddt5ejwRqRFQAszI_sTWaU,4882
+datamint/entities/user.py,sha256=MREHDOsV9NOBEbXqiQ2ww6DmetN07CELId-ZQVpZCb8,620
+datamint/examples/__init__.py,sha256=zcYnd5nLVme9GCTPYH-1JpGo8xXK2WEYvhzcy_2alZc,39
+datamint/examples/example_projects.py,sha256=sU-Gxy7PPqA0WUfN-ZmXV-0YnwrnzpJ79lMXTJp2DzU,2804
+datamint/exceptions.py,sha256=jjtoc5EUbGZhAhaoIbnRrolV7O8jRerYdjzeFwx1fmA,909
+datamint/experiment/__init__.py,sha256=5qQOMzoG17DEd1YnTF-vS0qiM-DGdbNh42EUo91CRhQ,34
+datamint/experiment/_patcher.py,sha256=ZgbezoevAYhJsbiJTvWPALGTcUiMT371xddcTllt3H4,23296
+datamint/experiment/experiment.py,sha256=aHK9dRFdQTi569xgUg1KqlCZLHZpDmSH3g3ndPIZvXw,44546
+datamint/logging.yaml,sha256=tOMxtc2UmwlIMTK6ljtnBwTco1PNrPeq3mx2iMuSbiw,482
+datamint/utils/logging_utils.py,sha256=9pRoaPrWu2jOdDCiAoUsjEdP5ZwaealWL3hjUqFvx9g,4022
+datamint/utils/torchmetrics.py,sha256=lwU0nOtsSWfebyp7dvjlAggaqXtj5ohSEUXOg3L0hJE,2837
+datamint/utils/visualization.py,sha256=yaUVAOHar59VrGUjpAWv5eVvQSfztFG0eP9p5Vt3l-M,4470
+datamint-2.0.0.dist-info/METADATA,sha256=38a-ojBv46DcXTJx8IQiE_DgOyWjela2l1S-ikBHHgs,4182
+datamint-2.0.0.dist-info/WHEEL,sha256=M5asmiAlL6HEcOq52Yi5mmk9KmTVjY2RDPtO4p9DMrc,88
+datamint-2.0.0.dist-info/entry_points.txt,sha256=mn5H6jPjO-rY0W0CAZ6Z_KKWhMLvyVaSpoqk77jlTI4,145
+datamint-2.0.0.dist-info/RECORD,,

{datamint-1.9.2.dist-info → datamint-2.0.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.1.3
+Generator: poetry-core 2.2.0
 Root-Is-Purelib: true
 Tag: py3-none-any

datamint-1.9.2.dist-info/RECORD

@@ -1,29 +0,0 @@
-datamint/__init__.py,sha256=7rKCCsaa4RBRTIfuHB708rai1xwDHLtkFNFJGKYG5D4,757
-datamint/apihandler/annotation_api_handler.py,sha256=ZJJD_Op8eDtGcpDZOS1DRjqyDUdD3UxvtuNJK9FaPOk,57063
-datamint/apihandler/api_handler.py,sha256=cdVSddrFCKlF_BJ81LO1aJ0OP49rssjpNEFzJ6Q7YyY,384
-datamint/apihandler/base_api_handler.py,sha256=An9chkUcq_v2_Tkr9TbwI_lnsXCyNYgugxK9nRu4oG8,12126
-datamint/apihandler/dto/annotation_dto.py,sha256=qId1RK1VO7dXrvGJ7dqJ31jBQB7Z8yy5x0tLSiMxTB4,7105
-datamint/apihandler/exp_api_handler.py,sha256=hFUgUgBc5rL7odK7gTW3MnrvMY1pVfJUpUdzRNobMQE,6226
-datamint/apihandler/root_api_handler.py,sha256=8kanwP89ubRZjhXy1ZOUAeW67oyiEEsImjTecixuPNA,62413
-datamint/client_cmd_tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-datamint/client_cmd_tools/datamint_config.py,sha256=pNmczVexsSPO8DKBGEPLuMOp3jIQwVkcPsm8KqFldjw,8164
-datamint/client_cmd_tools/datamint_upload.py,sha256=pWsF7QdjZ3qWbxCQG-oJqUoosFD8UgBg08UiuZEE01c,34393
-datamint/configs.py,sha256=Bdp6NydYwyCJ2dk19_gf_o3M2ZyQOmMHpLi8wEWNHUk,1426
-datamint/dataset/__init__.py,sha256=4PlUKSvVhdfQvvuq8jQXrkdqnot-iTTizM3aM1vgSwg,47
-datamint/dataset/annotation.py,sha256=qN1IMjdfLD2ceQ6va3l76jOXA8Vb_c-eBk1oWQu6hW0,7994
-datamint/dataset/base_dataset.py,sha256=S0pboog2yB2LCBGOocBIlOU8to7Wgov3gXTOJ9gbvz0,49697
-datamint/dataset/dataset.py,sha256=8e0MFgINgbw6_UJh7pNQIREp2XxstIVCupyduW05Nfw,27321
-datamint/examples/__init__.py,sha256=zcYnd5nLVme9GCTPYH-1JpGo8xXK2WEYvhzcy_2alZc,39
-datamint/examples/example_projects.py,sha256=7Nb_EaIdzJTQa9zopqc-WhTBQWQJSoQZ_KjRS4PB4FI,2931
-datamint/exceptions.py,sha256=AdpAC528xrml7LfWt04zQK8pONoDBx8WmXSvzRGi52o,106
-datamint/experiment/__init__.py,sha256=5qQOMzoG17DEd1YnTF-vS0qiM-DGdbNh42EUo91CRhQ,34
-datamint/experiment/_patcher.py,sha256=ZgbezoevAYhJsbiJTvWPALGTcUiMT371xddcTllt3H4,23296
-datamint/experiment/experiment.py,sha256=aHK9dRFdQTi569xgUg1KqlCZLHZpDmSH3g3ndPIZvXw,44546
-datamint/logging.yaml,sha256=a5dsATpul7QHeUHB2TjABFjWaPXBMbO--dgn8GlRqwk,483
-datamint/utils/logging_utils.py,sha256=DvoA35ATYG3JTwfXEXYawDyKRfHeCrH0a9czfkmz8kM,1851
-datamint/utils/torchmetrics.py,sha256=lwU0nOtsSWfebyp7dvjlAggaqXtj5ohSEUXOg3L0hJE,2837
-datamint/utils/visualization.py,sha256=yaUVAOHar59VrGUjpAWv5eVvQSfztFG0eP9p5Vt3l-M,4470
-datamint-1.9.2.dist-info/METADATA,sha256=2Zx8udYytzc3cZiQmjG5LWquRESp9c_9KmV-YptaeUU,4100
-datamint-1.9.2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-datamint-1.9.2.dist-info/entry_points.txt,sha256=mn5H6jPjO-rY0W0CAZ6Z_KKWhMLvyVaSpoqk77jlTI4,145
-datamint-1.9.2.dist-info/RECORD,,