tooluniverse 1.0.6__py3-none-any.whl → 1.0.7__py3-none-any.whl

tooluniverse/tools/get_webpage_title.py

@@ -0,0 +1,49 @@
+"""
+get_webpage_title
+
+Fetch a webpage and return the content of its <title> tag.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def get_webpage_title(
+    url: str,
+    timeout: int,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> Any:
+    """
+    Fetch a webpage and return the content of its <title> tag.
+
+    Parameters
+    ----------
+    url : str
+        HTTP or HTTPS URL to fetch (e.g. https://www.example.com)
+    timeout : int
+        Request timeout in seconds
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    Any
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "get_webpage_title", "arguments": {"url": url, "timeout": timeout}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["get_webpage_title"]

tooluniverse/tools/get_xarray_info.py

@@ -0,0 +1,44 @@
+"""
+get_xarray_info
+
+Get information about the xarray package. N-D labeled arrays and datasets in Python
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def get_xarray_info(
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> Any:
+    """
+    Get information about the xarray package. N-D labeled arrays and datasets in Python
+
+    Parameters
+    ----------
+    No parameters
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    Any
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "get_xarray_info", "arguments": {}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["get_xarray_info"]

tooluniverse/tools/get_xesmf_info.py

@@ -0,0 +1,44 @@
+"""
+get_xesmf_info
+
+Get information about the xesmf package. Universal regridder for geospatial data
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def get_xesmf_info(
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> Any:
+    """
+    Get information about the xesmf package. Universal regridder for geospatial data
+
+    Parameters
+    ----------
+    No parameters
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    Any
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "get_xesmf_info", "arguments": {}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["get_xesmf_info"]

tooluniverse/tools/get_xgboost_info.py

@@ -0,0 +1,44 @@
+"""
+get_xgboost_info
+
+Get information about the xgboost package. Optimized gradient boosting framework
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def get_xgboost_info(
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> Any:
+    """
+    Get information about the xgboost package. Optimized gradient boosting framework
+
+    Parameters
+    ----------
+    No parameters
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    Any
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "get_xgboost_info", "arguments": {}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["get_xgboost_info"]

tooluniverse/tools/get_zarr_info.py

@@ -0,0 +1,44 @@
+"""
+get_zarr_info
+
+Get information about the zarr package. Chunked, compressed, N-dimensional arrays
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def get_zarr_info(
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> Any:
+    """
+    Get information about the zarr package. Chunked, compressed, N-dimensional arrays
+
+    Parameters
+    ----------
+    No parameters
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    Any
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "get_zarr_info", "arguments": {}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["get_zarr_info"]

tooluniverse/tools/gwas_get_association_by_id.py

@@ -0,0 +1,49 @@
+"""
+gwas_get_association_by_id
+
+Get a specific GWAS association by its unique identifier.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_association_by_id(
+    association_id: str,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get a specific GWAS association by its unique identifier.
+
+    Parameters
+    ----------
+    association_id : str
+        GWAS association identifier
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {
+            "name": "gwas_get_association_by_id",
+            "arguments": {"association_id": association_id},
+        },
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_association_by_id"]

tooluniverse/tools/gwas_get_associations_for_snp.py

@@ -0,0 +1,67 @@
+"""
+gwas_get_associations_for_snp
+
+Get all associations for a specific SNP with optional sorting.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_associations_for_snp(
+    rs_id: str,
+    sort: Optional[str] = None,
+    direction: Optional[str] = None,
+    size: Optional[int] = None,
+    page: Optional[int] = None,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get all associations for a specific SNP with optional sorting.
+
+    Parameters
+    ----------
+    rs_id : str
+        dbSNP rs identifier
+    sort : str
+        Sort field (e.g., 'p_value', 'or_value')
+    direction : str
+        Sort direction ('asc' or 'desc')
+    size : int
+        Number of results to return per page
+    page : int
+        Page number for pagination
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {
+            "name": "gwas_get_associations_for_snp",
+            "arguments": {
+                "rs_id": rs_id,
+                "sort": sort,
+                "direction": direction,
+                "size": size,
+                "page": page,
+            },
+        },
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_associations_for_snp"]

tooluniverse/tools/gwas_get_associations_for_study.py

@@ -0,0 +1,55 @@
+"""
+gwas_get_associations_for_study
+
+Get all associations for a specific study, sorted by p-value.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_associations_for_study(
+    accession_id: str,
+    size: Optional[int] = None,
+    page: Optional[int] = None,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get all associations for a specific study, sorted by p-value.
+
+    Parameters
+    ----------
+    accession_id : str
+        Study accession identifier
+    size : int
+        Number of results to return per page
+    page : int
+        Page number for pagination
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {
+            "name": "gwas_get_associations_for_study",
+            "arguments": {"accession_id": accession_id, "size": size, "page": page},
+        },
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_associations_for_study"]

tooluniverse/tools/gwas_get_associations_for_trait.py

@@ -0,0 +1,55 @@
+"""
+gwas_get_associations_for_trait
+
+Get all associations for a specific trait, sorted by p-value (most significant first).
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_associations_for_trait(
+    efo_trait: str,
+    size: Optional[int] = None,
+    page: Optional[int] = None,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get all associations for a specific trait, sorted by p-value (most significant first).
+
+    Parameters
+    ----------
+    efo_trait : str
+        EFO trait identifier or name
+    size : int
+        Number of results to return per page
+    page : int
+        Page number for pagination
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {
+            "name": "gwas_get_associations_for_trait",
+            "arguments": {"efo_trait": efo_trait, "size": size, "page": page},
+        },
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_associations_for_trait"]

tooluniverse/tools/gwas_get_snp_by_id.py

@@ -0,0 +1,46 @@
+"""
+gwas_get_snp_by_id
+
+Get a specific GWAS SNP by its rs ID.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_snp_by_id(
+    rs_id: str,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get a specific GWAS SNP by its rs ID.
+
+    Parameters
+    ----------
+    rs_id : str
+        dbSNP rs identifier
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "gwas_get_snp_by_id", "arguments": {"rs_id": rs_id}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_snp_by_id"]

tooluniverse/tools/gwas_get_snps_for_gene.py

@@ -0,0 +1,55 @@
+"""
+gwas_get_snps_for_gene
+
+Get all SNPs mapped to a specific gene.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_snps_for_gene(
+    mapped_gene: str,
+    size: Optional[int] = None,
+    page: Optional[int] = None,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get all SNPs mapped to a specific gene.
+
+    Parameters
+    ----------
+    mapped_gene : str
+        Gene name or symbol
+    size : int
+        Number of results to return per page
+    page : int
+        Page number for pagination
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {
+            "name": "gwas_get_snps_for_gene",
+            "arguments": {"mapped_gene": mapped_gene, "size": size, "page": page},
+        },
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_snps_for_gene"]

tooluniverse/tools/gwas_get_studies_for_trait.py

@@ -0,0 +1,75 @@
+"""
+gwas_get_studies_for_trait
+
+Get studies for a specific trait with optional filters for cohort, GxE interactions, and summary ...
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_studies_for_trait(
+    efo_trait: Optional[str] = None,
+    disease_trait: Optional[str] = None,
+    cohort: Optional[str] = None,
+    gxe: Optional[bool] = None,
+    full_pvalue_set: Optional[bool] = None,
+    size: Optional[int] = None,
+    page: Optional[int] = None,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get studies for a specific trait with optional filters for cohort, GxE interactions, and summary ...
+
+    Parameters
+    ----------
+    efo_trait : str
+        EFO trait identifier or name
+    disease_trait : str
+        Disease trait name
+    cohort : str
+        Cohort name (e.g., 'UKB' for UK Biobank)
+    gxe : bool
+        Filter for Gene-by-Environment interaction studies
+    full_pvalue_set : bool
+        Filter for studies with full summary statistics
+    size : int
+        Number of results to return per page
+    page : int
+        Page number for pagination
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {
+            "name": "gwas_get_studies_for_trait",
+            "arguments": {
+                "efo_trait": efo_trait,
+                "disease_trait": disease_trait,
+                "cohort": cohort,
+                "gxe": gxe,
+                "full_pvalue_set": full_pvalue_set,
+                "size": size,
+                "page": page,
+            },
+        },
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_studies_for_trait"]

tooluniverse/tools/gwas_get_study_by_id.py

@@ -0,0 +1,46 @@
+"""
+gwas_get_study_by_id
+
+Get a specific GWAS study by its unique identifier.
+"""
+
+from typing import Any, Optional, Callable
+from ._shared_client import get_shared_client
+
+
+def gwas_get_study_by_id(
+    study_id: str,
+    *,
+    stream_callback: Optional[Callable[[str], None]] = None,
+    use_cache: bool = False,
+    validate: bool = True,
+) -> dict[str, Any]:
+    """
+    Get a specific GWAS study by its unique identifier.
+
+    Parameters
+    ----------
+    study_id : str
+        GWAS study identifier
+    stream_callback : Callable, optional
+        Callback for streaming output
+    use_cache : bool, default False
+        Enable caching
+    validate : bool, default True
+        Validate parameters
+
+    Returns
+    -------
+    dict[str, Any]
+    """
+    # Handle mutable defaults to avoid B006 linting error
+
+    return get_shared_client().run_one_function(
+        {"name": "gwas_get_study_by_id", "arguments": {"study_id": study_id}},
+        stream_callback=stream_callback,
+        use_cache=use_cache,
+        validate=validate,
+    )
+
+
+__all__ = ["gwas_get_study_by_id"]