lamindb_setup 1.9.1__py3-none-any.whl → 1.10.0__py3-none-any.whl

lamindb_setup/errors.py

@@ -1,70 +1,80 @@
-"""Errors.
-
-.. autosummary::
-   :toctree: .
-
-   InstanceNotSetupError
-   ModuleWasntConfigured
-   StorageAlreadyManaged
-   StorageNotEmpty
-   InstanceLockedException
-   SettingsEnvFileOutdated
-   CannotSwitchDefaultInstance
-
-"""
-
-from __future__ import annotations
-
-import click
-
-
-class DefaultMessageException(Exception):
-    default_message: str | None = None
-
-    def __init__(self, message: str | None = None):
-        if message is None:
-            message = self.default_message
-        super().__init__(message)
-
-
-class InstanceNotSetupError(DefaultMessageException):
-    default_message = """\
-To use lamindb, you need to connect to an instance.
-
-Connect to an instance: `ln.connect()`. Init an instance: `ln.setup.init()`.
-
-If you used the CLI to set up lamindb in a notebook, restart the Python session.
-"""
-
-
-MODULE_WASNT_CONFIGURED_MESSAGE_TEMPLATE = (
-    "'{}' wasn't configured for this instance -- "
-    "if you want it, go to your instance settings page and add it under 'schema modules' (or ask an admin to do so)"
-)
-
-
-class ModuleWasntConfigured(Exception):
-    pass
-
-
-class StorageAlreadyManaged(Exception):
-    pass
-
-
-class StorageNotEmpty(click.ClickException):
-    def show(self, file=None):
-        pass
-
-
-# raise if a cloud SQLite instance is already locked
-# ignored by unlock_cloud_sqlite_upon_exception
-class InstanceLockedException(Exception):
-    pass
-
-
-class SettingsEnvFileOutdated(Exception):
-    pass
-
-
-class CannotSwitchDefaultInstance(Exception):
-    pass
+"""Errors.
+
+.. autosummary::
+   :toctree: .
+
+   CurrentInstanceNotConfigured
+   InstanceNotSetupError
+   ModuleWasntConfigured
+   StorageAlreadyManaged
+   StorageNotEmpty
+   InstanceLockedException
+   SettingsEnvFileOutdated
+   CannotSwitchDefaultInstance
+
+"""
+
+from __future__ import annotations
+
+import click
+
+
+class DefaultMessageException(Exception):
+    default_message: str | None = None
+
+    def __init__(self, message: str | None = None):
+        if message is None:
+            message = self.default_message
+        super().__init__(message)
+
+
+# TODO: remove this exception sooner or later because we don't have a need for it anymore
+class InstanceNotSetupError(DefaultMessageException):
+    default_message = """\
+To use lamindb, you need to connect to an instance.
+
+Connect to an instance: `ln.connect()`. Init an instance: `ln.setup.init()`.
+
+If you used the CLI to set up lamindb in a notebook, restart the Python session.
+"""
+
+
+class CurrentInstanceNotConfigured(DefaultMessageException):
+    default_message = """\
+No instance is connected! Call
+- CLI:     lamin connect / lamin init
+- Python:  ln.connect()  / ln.setup.init()
+- R:       ln$connect()  / ln$setup$init()"""
+
+
+MODULE_WASNT_CONFIGURED_MESSAGE_TEMPLATE = (
+    "'{}' wasn't configured for this instance -- "
+    "if you want it, go to your instance settings page and add it under 'schema modules' (or ask an admin to do so)"
+)
+
+
+class ModuleWasntConfigured(Exception):
+    pass
+
+
+class StorageAlreadyManaged(Exception):
+    pass
+
+
+class StorageNotEmpty(click.ClickException):
+    def show(self, file=None):
+        pass
+
+
+# raise if a cloud SQLite instance is already locked
+# ignored by unlock_cloud_sqlite_upon_exception
+class InstanceLockedException(Exception):
+    pass
+
+
+class SettingsEnvFileOutdated(Exception):
+    pass
+
+
+class CannotSwitchDefaultInstance(Exception):
+    pass

lamindb_setup/types.py

@@ -1,20 +1,20 @@
-"""Types.
-
-.. autosummary::
-   :toctree: .
-
-   UPathStr
-   StorageType
-"""
-
-from __future__ import annotations
-
-# we need Union here because __future__ annotations doesn't work with TypeAlias
-from pathlib import Path
-from typing import Literal, Union
-
-# UPath is subclass of Path, hence, it's not necessary to list UPath
-# we keep it in the name of the TypeAlias to make it clear to users that
-# cloud paths are allowed / PathStr is often associated with local paths
-UPathStr = Union[str, Path]  # typing.TypeAlias, >3.10 on but already deprecated
-StorageType = Literal["local", "s3", "gs", "hf", "http", "https"]
+"""Types.
+
+.. autosummary::
+   :toctree: .
+
+   UPathStr
+   StorageType
+"""
+
+from __future__ import annotations
+
+# we need Union here because __future__ annotations doesn't work with TypeAlias
+from pathlib import Path
+from typing import Literal, Union
+
+# UPath is subclass of Path, hence, it's not necessary to list UPath
+# we keep it in the name of the TypeAlias to make it clear to users that
+# cloud paths are allowed / PathStr is often associated with local paths
+UPathStr = Union[str, Path]  # typing.TypeAlias, >3.10 on but already deprecated
+StorageType = Literal["local", "s3", "gs", "hf", "http", "https"]

{lamindb_setup-1.9.1.dist-info → lamindb_setup-1.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: lamindb_setup
-Version: 1.9.1
+Version: 1.10.0
 Summary: Setup & configure LaminDB.
 Author-email: Lamin Labs <open-source@lamin.ai>
 Requires-Python: >=3.10
@@ -21,7 +21,7 @@ Requires-Dist: psutil
 Requires-Dist: packaging
 Requires-Dist: urllib3<2 ; extra == "aws"
 Requires-Dist: aiobotocore[boto3]>=2.5.4,<3.0.0 ; extra == "aws"
-Requires-Dist: s3fs>=2023.12.2,<=2025.3.2,!=2024.10.0 ; extra == "aws"
+Requires-Dist: s3fs>=2023.12.2,<=2025.7.0,!=2024.10.0 ; extra == "aws"
 Requires-Dist: line_profiler ; extra == "dev"
 Requires-Dist: psycopg2-binary ; extra == "dev"
 Requires-Dist: python-dotenv ; extra == "dev"
@@ -32,7 +32,7 @@ Requires-Dist: pytest-xdist ; extra == "dev"
 Requires-Dist: nbproject-test>=0.4.3 ; extra == "dev"
 Requires-Dist: pandas ; extra == "dev"
 Requires-Dist: django-schema-graph ; extra == "erdiagram"
-Requires-Dist: gcsfs>=2023.12.2,<=2025.3.2 ; extra == "gcp"
+Requires-Dist: gcsfs>=2023.12.2,<=2025.7.0 ; extra == "gcp"
 Project-URL: Home, https://github.com/laminlabs/lamindb-setup
 Provides-Extra: aws
 Provides-Extra: dev

lamindb_setup-1.10.0.dist-info/RECORD

@@ -0,0 +1,50 @@
+lamindb_setup/__init__.py,sha256=3mcObwaFgQm5wWQp4KSOie5bNf-F8wcGjWh6v6hFYWw,2783
+lamindb_setup/_cache.py,sha256=pGvDNVHGx4HWr_6w5ajqEJOdysmaGc6F221qFnXkT-k,2747
+lamindb_setup/_check.py,sha256=28PcG8Kp6OpjSLSi1r2boL2Ryeh6xkaCL87HFbjs6GA,129
+lamindb_setup/_check_setup.py,sha256=ToKMxsUq8dQBQh8baOrNVlSb1iC8h4zTg5dV8wMu0W4,6760
+lamindb_setup/_connect_instance.py,sha256=wC66-SrdQx4Qeei_-zzEJPYL2RFZGihd8ErfOfEzt1c,16666
+lamindb_setup/_delete.py,sha256=4kS-_nQrV5xMvZE3BGCNEEGCboyGmqqDMXlckF0GxSk,5780
+lamindb_setup/_disconnect.py,sha256=FT8EpCm5XXDdhDH7QtAnkO3KPatq2HqT9VXGNjgJDbk,1232
+lamindb_setup/_django.py,sha256=uIQflpkp8l3axyPaKURlk3kacgpElVP5KOKmFxYSMGk,1454
+lamindb_setup/_entry_points.py,sha256=sKwXPX9xjOotoAjvgkU5LBwjjHLWVkh0ZGdiSsrch9k,522
+lamindb_setup/_exportdb.py,sha256=QLjoH4dEwqa01A12naKaDPglCCzl2_VLKWFfJRE_uSg,2113
+lamindb_setup/_importdb.py,sha256=fKv9ev5OOj_-bmzC8XZ1GxOcjIjI486yrHSHDWQrJeI,1874
+lamindb_setup/_init_instance.py,sha256=0DhUGJ6FERxVg30F4XhCfsXaIy3AP1UecQzyjEm-FLw,14965
+lamindb_setup/_migrate.py,sha256=W-F5vSSs4pB68TdX6k97vMV-VOPgqcf6VOejHjbrQA8,10326
+lamindb_setup/_register_instance.py,sha256=RdUZxZWHLdbvdNZWpF8e0UWROb_T0cStWbzc5yUw34I,1047
+lamindb_setup/_schema.py,sha256=b3uzhhWpV5mQtDwhMINc2MabGCnGLESy51ito3yl6Wc,679
+lamindb_setup/_schema_metadata.py,sha256=yMSuLZc-7iWUV7tETNuKmcDeMW0wtUr5ypKxsKC-m7k,14898
+lamindb_setup/_set_managed_storage.py,sha256=y5YQASsWNYVWUYeLgh3N2YBETYP7mBtbpxe3X_Vgb5I,2699
+lamindb_setup/_setup_user.py,sha256=DapdzT3u0f5LN5W9W9A6PWw-n8ejcJciQtHN9b5lidA,5889
+lamindb_setup/_silence_loggers.py,sha256=AKF_YcHvX32eGXdsYK8MJlxEaZ-Uo2f6QDRzjKFCtws,1568
+lamindb_setup/errors.py,sha256=qZTfSL0rpbY8AIG-Z4-3-_EbLW5zyo2CFEJrVU02-3A,1863
+lamindb_setup/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+lamindb_setup/types.py,sha256=XlXLb4nmbc68uBj5Hp3xpDRezYGJIBZv6jAAqqN0p10,614
+lamindb_setup/core/__init__.py,sha256=5M4A6CVHBO_T5Rr9MeLaPW3WTk4-y00cgRYEgUJVU5U,410
+lamindb_setup/core/_aws_options.py,sha256=UbwnaEX2KcZBDOa2W2NbH62cNrKJQ78Hrn7zcszhQvU,8092
+lamindb_setup/core/_aws_storage.py,sha256=ofPTHXvF97I9eUCHxj5RPpUUqAcNV0VsPWpyKMcshOI,2030
+lamindb_setup/core/_deprecated.py,sha256=HN7iUBdEgahw5e4NHCd1VJooUfieNb6GRzS5x8jU-q8,2549
+lamindb_setup/core/_docs.py,sha256=3k-YY-oVaJd_9UIY-LfBg_u8raKOCNfkZQPA73KsUhs,276
+lamindb_setup/core/_hub_client.py,sha256=Pl3sEG2rasdJp4Rh5HNY0VsPVls-nfY0OxD5QzrYF9A,8678
+lamindb_setup/core/_hub_core.py,sha256=hYjtUaBEcUA5Etn4aPVDX3oSksdwr-8UL7gplIFriVc,25814
+lamindb_setup/core/_hub_crud.py,sha256=Jz0d8wFKM1Pv9B9byyUJPlCIMkIzk56Jd-c3Awpm9Xw,5730
+lamindb_setup/core/_hub_utils.py,sha256=6dyDGyzYFgVfR_lE3VN3CP1jGp98gxPtr-T91PAP05U,2687
+lamindb_setup/core/_private_django_api.py,sha256=By63l3vIEtK1pq246FhHq3tslxsaTJGKm5VakYluWp4,2656
+lamindb_setup/core/_settings.py,sha256=CzOdAABbNHR5sWfPG90SZCpiDaHJw1NI3_JurQUtwV8,13811
+lamindb_setup/core/_settings_instance.py,sha256=_zIfY-6lOBPu6ttE-MgOE5ebHhn1JE47dBUt0A73BUE,22241
+lamindb_setup/core/_settings_load.py,sha256=j20cy3J56ZBHLDfB2A8oKjekNetMNsy0_W3eWD36pWI,5161
+lamindb_setup/core/_settings_save.py,sha256=XZx-vow7BT6y3JpRBB2UOJp2vwc7jOGea4wSgOPqjPU,3262
+lamindb_setup/core/_settings_storage.py,sha256=pyU25hP5rQYjVe0tFPR8P6TzAYzu1NpT-PIbXoxfV18,15348
+lamindb_setup/core/_settings_store.py,sha256=QmeWIGdIyq7UmjfHiEB_0xRD8hY-8-ZR2WntIKfwTKI,2714
+lamindb_setup/core/_settings_user.py,sha256=gFfyMf-738onbh1Mf4wsmLlenQJPtjQfpUgKnOlqc2o,1453
+lamindb_setup/core/_setup_bionty_sources.py,sha256=ox3X-SHiHa2lNPSWjwZhINypbLacX6kGwH6hVVrSFZc,1505
+lamindb_setup/core/cloud_sqlite_locker.py,sha256=H_CTUCjURFXwD1cCtV_Jn0_60iztZTkaesLLXIBgIxc,7204
+lamindb_setup/core/django.py,sha256=Pi2HkvH0F9edziov8gmq4bEES9vYi9e0cHd-R19ocmA,10771
+lamindb_setup/core/exceptions.py,sha256=qjMzqy_uzPA7mCOdnoWnS_fdA6OWbdZGftz-YYplrY0,84
+lamindb_setup/core/hashing.py,sha256=Y8Uc5uSGTfU6L2R_gb5w8DdHhGRog7RnkK-e9FEMjPY,3680
+lamindb_setup/core/types.py,sha256=T7NwspfRHgIIpYsXDcApks8jkOlGeGRW-YbVLB7jNIo,67
+lamindb_setup/core/upath.py,sha256=-Wxct7lYOLVzUGv3ynqq0zLcRSAGWbvs-NqrZL0Aqy4,35579
+lamindb_setup-1.10.0.dist-info/LICENSE,sha256=UOZ1F5fFDe3XXvG4oNnkL1-Ecun7zpHzRxjp-XsMeAo,11324
+lamindb_setup-1.10.0.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
+lamindb_setup-1.10.0.dist-info/METADATA,sha256=jvFAWDjQWtaIldISegSqxJcgy87atWPfbgVMTMC_JXg,1798
+lamindb_setup-1.10.0.dist-info/RECORD,,

lamindb_setup-1.9.1.dist-info/RECORD

@@ -1,50 +0,0 @@
-lamindb_setup/__init__.py,sha256=67s2tV9E7d6XrxoUNepBdL8qqLbg7g-PH3MdeH-D8j8,2889
-lamindb_setup/_cache.py,sha256=fbCQwmpaN9dmNWFXT1P4yDBJBm_5D9a7Bu5yRPa5gSU,2863
-lamindb_setup/_check.py,sha256=28PcG8Kp6OpjSLSi1r2boL2Ryeh6xkaCL87HFbjs6GA,129
-lamindb_setup/_check_setup.py,sha256=ReIdFG-aO43ydt5Mwl0K2LdsbNk81xd-RWCsEjbvb48,5873
-lamindb_setup/_connect_instance.py,sha256=rzDJ798ASfeKgGQPAV-0aJa79sSvSKygX7ajErz6fUs,13130
-lamindb_setup/_delete.py,sha256=sXk7whNnLFPUz7z_u2x6MZn8NGu3FhfuHF8FHokWznA,5817
-lamindb_setup/_disconnect.py,sha256=xzdI0zET115AyYRMCyfCbngRuzjqDKmhOgOu4-Kg6oM,1124
-lamindb_setup/_django.py,sha256=uIQflpkp8l3axyPaKURlk3kacgpElVP5KOKmFxYSMGk,1454
-lamindb_setup/_entry_points.py,sha256=sKwXPX9xjOotoAjvgkU5LBwjjHLWVkh0ZGdiSsrch9k,522
-lamindb_setup/_exportdb.py,sha256=QLjoH4dEwqa01A12naKaDPglCCzl2_VLKWFfJRE_uSg,2113
-lamindb_setup/_importdb.py,sha256=fKv9ev5OOj_-bmzC8XZ1GxOcjIjI486yrHSHDWQrJeI,1874
-lamindb_setup/_init_instance.py,sha256=wrF2MgcKOPPdOlYe4Ba2VmhauTpr4JMKNWGPn7o9qTQ,15760
-lamindb_setup/_migrate.py,sha256=6oZPv6k7zZ5kvVCF0GRMnxRd6MYAga-06Fdk1zjfzjY,10313
-lamindb_setup/_register_instance.py,sha256=9NPl9RQGB5FOLsYoR1sMOuMyMhmX6DGvYUhWMCMme4Q,1250
-lamindb_setup/_schema.py,sha256=b3uzhhWpV5mQtDwhMINc2MabGCnGLESy51ito3yl6Wc,679
-lamindb_setup/_schema_metadata.py,sha256=QIme7wafJEfsfXG2HU3NtCPJPXewYrkCs2Lii7uyXzo,15339
-lamindb_setup/_set_managed_storage.py,sha256=e2Pv4wppxn7GnFdEC2SuUy43J5LPK0Le0ZKfnmf-82k,2831
-lamindb_setup/_setup_user.py,sha256=wnWXKpb-dfhPXeWhDkyAfKiu5b9W2nfaZD9aS6UWEZ0,4628
-lamindb_setup/_silence_loggers.py,sha256=AKF_YcHvX32eGXdsYK8MJlxEaZ-Uo2f6QDRzjKFCtws,1568
-lamindb_setup/errors.py,sha256=ETpyRNUN9jUpU5RP3vcPYpSCUo1C8YIZCO-o2f64h6Y,1563
-lamindb_setup/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-lamindb_setup/types.py,sha256=-55QmE-_b47Cyoj4uj6m2AkAPN6jaN8smyObd74nyH8,634
-lamindb_setup/core/__init__.py,sha256=RT0_vHfzOqau3BqFF2ejaSXGk9lmajEdaaXlabK1BKs,431
-lamindb_setup/core/_aws_options.py,sha256=zSGB23J9lnkah82F0GtR40ePCKWRP7oLFoXwTv2TVVk,8315
-lamindb_setup/core/_aws_storage.py,sha256=nEjeUv4xUVpoV0Lx-zjjmyb9w804bDyaeiM-OqbfwM0,1799
-lamindb_setup/core/_deprecated.py,sha256=HN7iUBdEgahw5e4NHCd1VJooUfieNb6GRzS5x8jU-q8,2549
-lamindb_setup/core/_docs.py,sha256=3k-YY-oVaJd_9UIY-LfBg_u8raKOCNfkZQPA73KsUhs,276
-lamindb_setup/core/_hub_client.py,sha256=_aLJTxiEaENcL1mSuHVaoTqKe5XAQWoZ4z1RyYZhicE,8926
-lamindb_setup/core/_hub_core.py,sha256=9lSmdAMcZmiDGWgVj3tXBxXghuUjBiGZjbjo6s5cgHI,24671
-lamindb_setup/core/_hub_crud.py,sha256=yrvKI86QzFlj7qpPxMWt4z0Uu43kU9-uDSnAkKR-0p0,5957
-lamindb_setup/core/_hub_utils.py,sha256=6dyDGyzYFgVfR_lE3VN3CP1jGp98gxPtr-T91PAP05U,2687
-lamindb_setup/core/_private_django_api.py,sha256=QuQqK2FJRse7jOGD4wWy2XENlLEnjr7HEQ1bK77534c,2739
-lamindb_setup/core/_settings.py,sha256=uXDNKqGcTF4qNKlYmsq2UrjaB2rcZhYKg1EG9JP6Xz4,13841
-lamindb_setup/core/_settings_instance.py,sha256=5AZgbI77kOis954Ed6st9ju2M2C50QGi_Y0MZNKNy-8,22469
-lamindb_setup/core/_settings_load.py,sha256=KhSO0vAEEU8CYWV9W8w7Y2gCAhzYP4jh7XWmYBcj_G4,5317
-lamindb_setup/core/_settings_save.py,sha256=iLxY9Q5pfKj4R4QKhuIwDt5D0p7Z0nTZMtKf4lnBIzY,3357
-lamindb_setup/core/_settings_storage.py,sha256=9G4q3koXgKlX2xBg0pqHZW9YXQCNLw_G7m58MrUzBkc,15907
-lamindb_setup/core/_settings_store.py,sha256=8NTD7mOx_bOX6MR2HtjNWVHmWuNCJP4SZIUVrz8xtsY,2805
-lamindb_setup/core/_settings_user.py,sha256=j5h5gnE_ap2PQga2e_RfYF12N5HKJFMGM_pGXHpmzEo,1508
-lamindb_setup/core/_setup_bionty_sources.py,sha256=ntwBXVRCmamL_zW4qQp5VREkfx8GzS9cTEZS13ChZbM,1549
-lamindb_setup/core/cloud_sqlite_locker.py,sha256=gdQJwdafvkcoK-n7GxQvhY9e9S0SZyasiIBMtuWcs0k,7444
-lamindb_setup/core/django.py,sha256=6jPcGtXzAN_jHM5fKTPGdexPu8LIOmSoobjODb9qWxY,10552
-lamindb_setup/core/exceptions.py,sha256=kvXBCWYjS_GghDrbJ05BYLdBbs0yYIUEiGRFmHacz1I,85
-lamindb_setup/core/hashing.py,sha256=dNsggCJhMLoHyzn_2d6IgZctgQHTU_astwnkpcCfJv0,3814
-lamindb_setup/core/types.py,sha256=A_D-hVsBK-zPHyMsQmXG_ylQJP-sD9qOtCRRYSB_I8Y,68
-lamindb_setup/core/upath.py,sha256=75trIKewqk8mx1CGbAryP7mCrQS0koLraKrBPajm5lc,36592
-lamindb_setup-1.9.1.dist-info/LICENSE,sha256=UOZ1F5fFDe3XXvG4oNnkL1-Ecun7zpHzRxjp-XsMeAo,11324
-lamindb_setup-1.9.1.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
-lamindb_setup-1.9.1.dist-info/METADATA,sha256=woIXBO_TSGW2j23D0idBesjIQrTP824n9XlEI2_w9uo,1797
-lamindb_setup-1.9.1.dist-info/RECORD,,