entitysdk 0.4.0__tar.gz → 0.5.0__tar.gz

{entitysdk-0.4.0/src/entitysdk.egg-info → entitysdk-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: entitysdk
-Version: 0.4.0
+Version: 0.5.0
 Summary: Python library for interacting with the entitycore service
 Author-email: Open Brain Institute <info@openbraininstitute.org>
 Maintainer-email: Open Brain Institute <info@openbraininstitute.org>
@@ -66,14 +66,14 @@ client = Client(
         project_id=UUID("your-project-id"),
         virtual_lab_id=UUID("your-lab-id")
     ),
-    environment="staging"
+    environment="staging",
+    token_manager=token
 )
 
 # Search for morphologies
 iterator = client.search_entity(
     entity_type=models.ReconstructionMorphology,
     query={"mtype__pref_label": "L5_TPC:A"},
-    token=token,
     limit=1,
 )
 morphology = next(iterator)
@@ -84,7 +84,6 @@ client.upload_file(
     entity_type=models.ReconstructionMorphology,
     file_path="path/to/file.swc",
     file_content_type="application/swc",
-    token="your-token"
 )
 ```
 

{entitysdk-0.4.0 → entitysdk-0.5.0}/README.md

@@ -45,14 +45,14 @@ client = Client(
         project_id=UUID("your-project-id"),
         virtual_lab_id=UUID("your-lab-id")
     ),
-    environment="staging"
+    environment="staging",
+    token_manager=token
 )
 
 # Search for morphologies
 iterator = client.search_entity(
     entity_type=models.ReconstructionMorphology,
     query={"mtype__pref_label": "L5_TPC:A"},
-    token=token,
     limit=1,
 )
 morphology = next(iterator)
@@ -63,7 +63,6 @@ client.upload_file(
     entity_type=models.ReconstructionMorphology,
     file_path="path/to/file.swc",
     file_content_type="application/swc",
-    token="your-token"
 )
 ```
 

entitysdk-0.5.0/src/entitysdk/downloaders/__init__.py

@@ -0,0 +1 @@
+"""Downloaders module."""

entitysdk-0.5.0/src/entitysdk/downloaders/emodel.py

@@ -0,0 +1,29 @@
+"""Download functions for EModel entities."""
+
+from pathlib import Path
+
+from entitysdk.client import Client
+from entitysdk.models.emodel import EModel
+from entitysdk.utils.filesystem import create_dir
+
+
+def download_hoc(
+    client: Client,
+    emodel: EModel,
+    output_dir: str | Path,
+) -> Path:
+    """Download hoc file.
+
+    Args:
+        client (Client): EntitySDK client
+        emodel (EModel): EModel entitysdk object
+        output_dir (str or Path): directory to save the hoc file
+    """
+    output_dir = create_dir(output_dir)
+    asset = client.download_assets(
+        emodel,
+        selection={"content_type": "application/hoc"},
+        output_path=output_dir,
+    ).one()
+
+    return asset.output_path

entitysdk-0.5.0/src/entitysdk/downloaders/ion_channel_model.py

@@ -0,0 +1,29 @@
+"""Download functions for IonChannelModel entities."""
+
+from pathlib import Path
+
+from entitysdk.client import Client
+from entitysdk.models.ion_channel_model import IonChannelModel
+from entitysdk.utils.filesystem import create_dir
+
+
+def download_ion_channel_mechanism(
+    client: Client,
+    ion_channel_model: IonChannelModel,
+    output_dir: str | Path,
+) -> Path:
+    """Download one mechanism file.
+
+    Args:
+        client (Client): EntitySDK client
+        ion_channel_model (IonChannelModel): IonChannelModel entitysdk object
+        output_dir (str or Pathlib.Path): directory to save the mechanism file
+    """
+    output_dir = create_dir(output_dir)
+    asset = client.download_assets(
+        ion_channel_model,
+        selection={"content_type": "application/neuron-mod"},
+        output_path=output_dir,
+    ).one()
+
+    return asset.output_path

entitysdk-0.5.0/src/entitysdk/downloaders/memodel.py

@@ -0,0 +1,42 @@
+"""Download functions for MEModel entities."""
+
+from pathlib import Path
+from typing import cast
+
+from entitysdk.client import Client
+from entitysdk.downloaders.emodel import download_hoc
+from entitysdk.downloaders.ion_channel_model import download_ion_channel_mechanism
+from entitysdk.downloaders.morphology import download_morphology
+from entitysdk.models.emodel import EModel
+from entitysdk.models.memodel import MEModel
+from entitysdk.schemas.memodel import DownloadedMEModel
+from entitysdk.utils.filesystem import create_dir
+
+
+def download_memodel(client: Client, memodel: MEModel, output_dir=".") -> DownloadedMEModel:
+    """Download all assets needed to run an me-model: hoc, ion channel models, and morphology.
+
+    Args:
+        client (Client): EntitySDK client
+        memodel (MEModel): MEModel entitysdk object
+        output_dir (str): directory to save the downloaded files, defaults to current directory
+    """
+    # we have to get the emodel to get the ion channel models.
+    emodel = cast(
+        EModel,
+        client.get_entity(entity_id=memodel.emodel.id, entity_type=EModel),  # type: ignore
+    )
+
+    hoc_path = download_hoc(client, emodel, Path(output_dir) / "hoc")
+    # only take .asc format for now.
+    # Will take specific format when morphology_format is integrated into MEModel
+    morphology_path = download_morphology(
+        client, memodel.morphology, Path(output_dir) / "morphology", "asc"
+    )
+    mechanisms_dir = create_dir(Path(output_dir) / "mechanisms")
+    for ic in emodel.ion_channel_models or []:
+        download_ion_channel_mechanism(client, ic, mechanisms_dir)
+
+    return DownloadedMEModel(
+        hoc_path=hoc_path, mechanisms_dir=mechanisms_dir, morphology_path=morphology_path
+    )

entitysdk-0.5.0/src/entitysdk/downloaders/morphology.py

@@ -0,0 +1,36 @@
+"""Download functions for Morphology entities."""
+
+import logging
+from pathlib import Path
+
+from entitysdk.client import Client
+from entitysdk.models.morphology import ReconstructionMorphology
+from entitysdk.utils.filesystem import create_dir
+
+logger = logging.getLogger(__name__)
+
+
+def download_morphology(
+    client: Client,
+    morphology: ReconstructionMorphology,
+    output_dir: str | Path,
+    file_type: str,
+) -> Path:
+    """Download morphology file.
+
+    Args:
+        client (Client): EntitySDK client
+        morphology (ReconstructionMorphology): Morphology entitysdk object
+        output_dir (str or Path): directory to save the morphology file
+        file_type (str or None): type of the morphology file ('asc', 'swc' or 'h5').
+            Will take the first one if None.
+    """
+    output_dir = create_dir(output_dir)
+
+    asset = client.download_assets(
+        morphology,
+        selection={"content_type": f"application/{file_type}"},
+        output_path=output_dir,
+    ).one()
+
+    return asset.output_path

entitysdk-0.5.0/src/entitysdk/schemas/memodel.py

@@ -0,0 +1,13 @@
+"""MEModel related schemas."""
+
+from pathlib import Path
+
+from entitysdk.schemas.base import Schema
+
+
+class DownloadedMEModel(Schema):
+    """Downloaded asset."""
+
+    hoc_path: Path
+    mechanisms_dir: Path
+    morphology_path: Path

{entitysdk-0.4.0 → entitysdk-0.5.0}/src/entitysdk/types.py

@@ -1,10 +1,12 @@
 """Types definitions."""
 
+import os
 import uuid
 from enum import StrEnum, auto
 
 ID = uuid.UUID
 Token = str
+StrOrPath = str | os.PathLike[str]
 
 
 class DeploymentEnvironment(StrEnum):

entitysdk-0.5.0/src/entitysdk/utils/filesystem.py

@@ -0,0 +1,12 @@
+"""Utility functions for filesystem operations."""
+
+from pathlib import Path
+
+from entitysdk.types import StrOrPath
+
+
+def create_dir(path: StrOrPath) -> Path:
+    """Create directory and parents if it doesn't already exist."""
+    path = Path(path)
+    path.mkdir(parents=True, exist_ok=True)
+    return path

{entitysdk-0.4.0 → entitysdk-0.5.0/src/entitysdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: entitysdk
-Version: 0.4.0
+Version: 0.5.0
 Summary: Python library for interacting with the entitycore service
 Author-email: Open Brain Institute <info@openbraininstitute.org>
 Maintainer-email: Open Brain Institute <info@openbraininstitute.org>
@@ -66,14 +66,14 @@ client = Client(
         project_id=UUID("your-project-id"),
         virtual_lab_id=UUID("your-lab-id")
     ),
-    environment="staging"
+    environment="staging",
+    token_manager=token
 )
 
 # Search for morphologies
 iterator = client.search_entity(
     entity_type=models.ReconstructionMorphology,
     query={"mtype__pref_label": "L5_TPC:A"},
-    token=token,
     limit=1,
 )
 morphology = next(iterator)
@@ -84,7 +84,6 @@ client.upload_file(
     entity_type=models.ReconstructionMorphology,
     file_path="path/to/file.swc",
     file_content_type="application/swc",
-    token="your-token"
 )
 ```
 

{entitysdk-0.4.0 → entitysdk-0.5.0}/src/entitysdk.egg-info/SOURCES.txt

@@ -30,6 +30,11 @@ src/entitysdk.egg-info/SOURCES.txt
 src/entitysdk.egg-info/dependency_links.txt
 src/entitysdk.egg-info/requires.txt
 src/entitysdk.egg-info/top_level.txt
+src/entitysdk/downloaders/__init__.py
+src/entitysdk/downloaders/emodel.py
+src/entitysdk/downloaders/ion_channel_model.py
+src/entitysdk/downloaders/memodel.py
+src/entitysdk/downloaders/morphology.py
 src/entitysdk/models/__init__.py
 src/entitysdk/models/agent.py
 src/entitysdk/models/asset.py
@@ -59,8 +64,10 @@ src/entitysdk/models/validation_result.py
 src/entitysdk/schemas/__init__.py
 src/entitysdk/schemas/asset.py
 src/entitysdk/schemas/base.py
+src/entitysdk/schemas/memodel.py
 src/entitysdk/utils/__init__.py
 src/entitysdk/utils/asset.py
+src/entitysdk/utils/filesystem.py
 tests/__init__.py
 tests/integration/__init__.py
 tests/integration/conftest.py
@@ -77,6 +84,10 @@ tests/unit/test_serdes.py
 tests/unit/test_token_manager.py
 tests/unit/test_util.py
 tests/unit/util.py
+tests/unit/downloaders/test_emodel.py
+tests/unit/downloaders/test_ion_channel_model.py
+tests/unit/downloaders/test_memodel.py
+tests/unit/downloaders/test_morphology.py
 tests/unit/models/__init__.py
 tests/unit/models/test_agent.py
 tests/unit/models/test_asset.py
@@ -98,4 +109,5 @@ tests/unit/models/data/memodel_calibration_result.json
 tests/unit/models/data/reconstruction_morphology.json
 tests/unit/models/data/simulation_campaign.json
 tests/unit/models/data/validation_result.json
-tests/unit/utils/test_asset.py
+tests/unit/utils/test_asset.py
+tests/unit/utils/test_filesystem.py

entitysdk-0.5.0/tests/unit/downloaders/test_emodel.py

@@ -0,0 +1,70 @@
+import uuid
+
+from entitysdk.downloaders.emodel import download_hoc
+from entitysdk.models.emodel import EModel
+
+
+def _mock_asset_response(asset_id):
+    return {
+        "id": str(asset_id),
+        "path": "foo.hoc",
+        "full_path": "foo.hoc",
+        "is_directory": False,
+        "content_type": "application/hoc",
+        "size": 100,
+        "status": "created",
+        "meta": {},
+        "sha256_digest": "sha256_digest",
+    }
+
+
+def test_download_hoc(
+    tmp_path,
+    client,
+    httpx_mock,
+    api_url,
+    request_headers,
+):
+    """Test downloading a hoc file from an EModel entity."""
+    emodel_id = uuid.uuid4()
+    asset_id = uuid.uuid4()
+    hierarchy_id = uuid.uuid4()
+
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/emodel/{emodel_id}/assets/{asset_id}",
+        match_headers=request_headers,
+        json=_mock_asset_response(asset_id) | {"path": "foo.hoc"},
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/emodel/{emodel_id}/assets/{asset_id}/download",
+        match_headers=request_headers,
+        content="foo",
+    )
+
+    emodel = EModel(
+        id=emodel_id,
+        name="foo",
+        species={"name": "foo", "taxonomy_id": "bar"},
+        brain_region={
+            "name": "foo",
+            "annotation_value": 997,
+            "acronym": "bar",
+            "parent_structure_id": None,
+            "hierarchy_id": str(hierarchy_id),
+            "color_hex_triplet": "#FFFFFF",
+        },
+        iteration="foofoo",
+        score=42,
+        seed=0,
+        assets=[_mock_asset_response(asset_id)],
+    )
+
+    output_path = download_hoc(
+        client=client,
+        emodel=emodel,
+        output_dir=tmp_path,
+    )
+
+    assert output_path.is_file()

entitysdk-0.5.0/tests/unit/downloaders/test_ion_channel_model.py

@@ -0,0 +1,72 @@
+import uuid
+
+from entitysdk.downloaders.ion_channel_model import download_ion_channel_mechanism
+from entitysdk.models.ion_channel_model import IonChannelModel, NeuronBlock
+
+
+def _mock_asset_response(asset_id):
+    return {
+        "id": str(asset_id),
+        "path": "foo.mod",
+        "full_path": "foo.mod",
+        "is_directory": False,
+        "content_type": "application/neuron-mod",
+        "size": 100,
+        "status": "created",
+        "meta": {},
+        "sha256_digest": "sha256_digest",
+    }
+
+
+def test_download_ion_channel_model(
+    tmp_path,
+    client,
+    httpx_mock,
+    api_url,
+    request_headers,
+):
+    """Test downloading an ion channel model file from an EModel entity."""
+    model_id = uuid.uuid4()
+    asset_id = uuid.uuid4()
+    hierarchy_id = uuid.uuid4()
+
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/ion-channel-model/{model_id}/assets/{asset_id}",
+        match_headers=request_headers,
+        json=_mock_asset_response(asset_id) | {"path": "foo.mod"},
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/ion-channel-model/{model_id}/assets/{asset_id}/download",
+        match_headers=request_headers,
+        content="foo",
+    )
+
+    ic_model = IonChannelModel(
+        id=model_id,
+        name="foo",
+        nmodl_suffix="Ca_HVA",
+        description="foo description",
+        species={"name": "foo", "taxonomy_id": "bar"},
+        brain_region={
+            "name": "foo",
+            "annotation_value": 997,
+            "acronym": "bar",
+            "parent_structure_id": None,
+            "hierarchy_id": str(hierarchy_id),
+            "color_hex_triplet": "#FFFFFF",
+        },
+        is_temperature_dependent=False,
+        temperature_celsius=34,
+        neuron_block=NeuronBlock(),
+        assets=[_mock_asset_response(asset_id)],
+    )
+
+    output_path = download_ion_channel_mechanism(
+        client=client,
+        ion_channel_model=ic_model,
+        output_dir=tmp_path,
+    )
+
+    assert output_path.is_file()

entitysdk-0.5.0/tests/unit/downloaders/test_memodel.py

@@ -0,0 +1,199 @@
+import os
+import uuid
+
+from entitysdk.downloaders.memodel import download_memodel
+from entitysdk.models.emodel import EModel
+from entitysdk.models.memodel import MEModel
+from entitysdk.models.morphology import ReconstructionMorphology
+from entitysdk.types import ValidationStatus
+
+
+def _mock_morph_asset_response(asset_id):
+    """Mock response for morphology asset."""
+    return {
+        "id": str(asset_id),
+        "path": "foo.asc",
+        "full_path": "foo.asc",
+        "is_directory": False,
+        "content_type": "application/asc",
+        "size": 100,
+        "status": "created",
+        "meta": {},
+        "sha256_digest": "sha256_digest",
+    }
+
+
+def _mock_ic_asset_response(asset_id):
+    """Mock response for ion channel model asset."""
+    return {
+        "id": str(asset_id),
+        "path": "foo.mod",
+        "full_path": "foo.mod",
+        "is_directory": False,
+        "content_type": "application/neuron-mod",
+        "size": 100,
+        "status": "created",
+        "meta": {},
+        "sha256_digest": "sha256_digest",
+    }
+
+
+def _mock_emodel_asset_response(asset_id):
+    """Mock response for emodel asset."""
+    return {
+        "id": str(asset_id),
+        "path": "foo.hoc",
+        "full_path": "foo.hoc",
+        "is_directory": False,
+        "content_type": "application/hoc",
+        "size": 100,
+        "status": "created",
+        "meta": {},
+        "sha256_digest": "sha256_digest",
+    }
+
+
+def test_download_memodel(
+    tmp_path,
+    client,
+    httpx_mock,
+    api_url,
+    request_headers,
+):
+    """Test downloading all memodel-related files from an MEModel entity."""
+    memodel_id = uuid.uuid4()
+    morph_id = uuid.uuid4()
+    emodel_id = uuid.uuid4()
+    ic_model_id = uuid.uuid4()
+    morph_asset_id = uuid.uuid4()
+    emodel_asset_id = uuid.uuid4()
+    ic_asset_id = uuid.uuid4()
+    hierarchy_id = uuid.uuid4()
+
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/reconstruction-morphology/{morph_id}/assets/{morph_asset_id}",
+        match_headers=request_headers,
+        json=_mock_morph_asset_response(morph_id) | {"path": "foo.asc"},
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/reconstruction-morphology/{morph_id}/assets/{morph_asset_id}/download",
+        match_headers=request_headers,
+        content="foo",
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/emodel/{emodel_id}/assets/{emodel_asset_id}",
+        match_headers=request_headers,
+        json=_mock_emodel_asset_response(emodel_asset_id) | {"path": "foo.hoc"},
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/emodel/{emodel_id}/assets/{emodel_asset_id}/download",
+        match_headers=request_headers,
+        content="foo",
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/ion-channel-model/{ic_model_id}/assets/{ic_asset_id}",
+        match_headers=request_headers,
+        json=_mock_ic_asset_response(ic_asset_id) | {"path": "foo.mod"},
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/ion-channel-model/{ic_model_id}/assets/{ic_asset_id}/download",
+        match_headers=request_headers,
+        content="foo",
+    )
+
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/emodel/{emodel_id}",
+        match_headers=request_headers,
+        json={
+            "id": str(emodel_id),
+            "name": "foo",
+            "species": {"name": "foo", "taxonomy_id": "bar"},
+            "brain_region": {
+                "name": "foo",
+                "annotation_value": 997,
+                "acronym": "bar",
+                "parent_structure_id": None,
+                "hierarchy_id": str(hierarchy_id),
+                "color_hex_triplet": "#FFFFFF",
+            },
+            "iteration": "foofoo",
+            "score": 42,
+            "seed": 0,
+            "ion_channel_models": [
+                {
+                    "id": str(ic_model_id),
+                    "name": "foo",
+                    "nmodl_suffix": "Ca_HVA",
+                    "description": "foo description",
+                    "species": {"name": "foo", "taxonomy_id": "bar"},
+                    "brain_region": {
+                        "name": "foo",
+                        "annotation_value": 997,
+                        "acronym": "bar",
+                        "parent_structure_id": None,
+                        "hierarchy_id": str(hierarchy_id),
+                        "color_hex_triplet": "#FFFFFF",
+                    },
+                    "is_temperature_dependent": False,
+                    "temperature_celsius": 34,
+                    "neuron_block": {},
+                    "assets": [_mock_ic_asset_response(ic_asset_id)],
+                }
+            ],
+            "assets": [_mock_emodel_asset_response(emodel_asset_id)],
+        },
+    )
+
+    memodel = MEModel(
+        id=memodel_id,
+        name="foo",
+        species={"name": "foo", "taxonomy_id": "bar"},
+        brain_region={
+            "name": "foo",
+            "annotation_value": 997,
+            "acronym": "bar",
+            "parent_structure_id": None,
+            "hierarchy_id": str(hierarchy_id),
+            "color_hex_triplet": "#FFFFFF",
+        },
+        validation_status=ValidationStatus.done,
+        morphology=ReconstructionMorphology(
+            id=morph_id, name="foo", assets=[_mock_morph_asset_response(morph_asset_id)]
+        ),
+        emodel=EModel(
+            id=emodel_id,
+            name="foo",
+            species={"name": "foo", "taxonomy_id": "bar"},
+            brain_region={
+                "name": "foo",
+                "annotation_value": 997,
+                "acronym": "bar",
+                "parent_structure_id": None,
+                "hierarchy_id": str(hierarchy_id),
+                "color_hex_triplet": "#FFFFFF",
+            },
+            iteration="foofoo",
+            score=42,
+            seed=0,
+            # assets=[
+            #     _mock_emodel_asset_response(emodel_asset_id)
+            # ]
+        ),
+    )
+
+    downloaded_memodel = download_memodel(
+        client=client,
+        memodel=memodel,
+        output_dir=tmp_path,
+    )
+    assert downloaded_memodel.hoc_path.is_file()
+    assert downloaded_memodel.morphology_path.is_file()
+    assert downloaded_memodel.mechanisms_dir.is_dir()
+    assert len(os.listdir(downloaded_memodel.mechanisms_dir)) == 1

entitysdk-0.5.0/tests/unit/downloaders/test_morphology.py

@@ -0,0 +1,68 @@
+import uuid
+
+import pytest
+
+from entitysdk.downloaders.morphology import download_morphology
+from entitysdk.exception import IteratorResultError
+from entitysdk.models.morphology import ReconstructionMorphology
+
+
+def _mock_asset_response(asset_id):
+    return {
+        "id": str(asset_id),
+        "path": "foo.asc",
+        "full_path": "foo.asc",
+        "is_directory": False,
+        "content_type": "application/asc",
+        "size": 100,
+        "status": "created",
+        "meta": {},
+        "sha256_digest": "sha256_digest",
+    }
+
+
+def test_download_morphology(
+    tmp_path,
+    client,
+    httpx_mock,
+    api_url,
+    request_headers,
+):
+    """Test downloading a morphology file from a Morphology entity."""
+    morph_id = uuid.uuid4()
+    asset_id = uuid.uuid4()
+
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/reconstruction-morphology/{morph_id}/assets/{asset_id}",
+        match_headers=request_headers,
+        json=_mock_asset_response(asset_id) | {"path": "foo.asc"},
+    )
+    httpx_mock.add_response(
+        method="GET",
+        url=f"{api_url}/reconstruction-morphology/{morph_id}/assets/{asset_id}/download",
+        match_headers=request_headers,
+        content="foo",
+    )
+
+    morphology = ReconstructionMorphology(
+        id=morph_id, name="foo", assets=[_mock_asset_response(asset_id)]
+    )
+
+    output_path = download_morphology(
+        client=client,
+        morphology=morphology,
+        output_dir=tmp_path,
+        file_type="asc",
+    )
+
+    assert output_path.is_file()
+
+    # should raise when the file type is not present in the morphology assets
+    with pytest.raises(IteratorResultError, match="Iterable is empty."):
+        output_path = download_morphology(
+            client=client,
+            morphology=morphology,
+            output_dir=tmp_path,
+            file_type="swc",
+        )

entitysdk-0.5.0/tests/unit/utils/test_filesystem.py

@@ -0,0 +1,6 @@
+from entitysdk.utils.filesystem import create_dir
+
+
+def test_create_dir(tmp_path):
+    """Test creating a directory with create_dir function."""
+    assert create_dir(tmp_path / "test_dir").is_dir() is True