starbash 0.1.7__tar.gz → 0.1.9__tar.gz

{starbash-0.1.7 → starbash-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starbash
-Version: 0.1.7
+Version: 0.1.9
 Summary: A tool for automating/standardizing/sharing astrophotography workflows.
 License-File: LICENSE
 Author: Kevin Hester
@@ -20,7 +20,7 @@ Requires-Dist: tomlkit (>=0.13.3,<0.14.0)
 Requires-Dist: typer (>=0.20.0,<0.21.0)
 Description-Content-Type: text/markdown
 
-# Starbash
+# [Starbash](https://github.com/geeksville/starbash)
 
 <img src="https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/img/icon.png" alt="Starbash: Astrophotography workflows simplified" width="30%" align="right" style="margin-bottom: 20px;">
 
@@ -67,7 +67,7 @@ See the current [TODO](TODO.md) file for work items.  I'll be looking for pre-al
 
 Currently the easiest way to install this command-line based tool is to install is via [pipx](https://pipx.pypa.io/stable/).  If you don't already have pipx and you have python installed, you can auto install it by running "pip install --user pipx."  If you don't have python installed see the pipx link for pipx installers for any OS.
 
-Once pipx is installed just run the following **two** commands (the sb --install-completion will make TAB auto-complete automatically complete sb options (for most platforms)):
+Once pipx is installed just run the following **two** commands (the sb --install-completion will make TAB auto-complete automatically complete sb options (for most platforms)).  Installing auto-complete is **highly** recommended because it makes entering starbash commands fast - by pressing the TAB key:
 
 ```
 ➜ pipx install starbash
@@ -88,10 +88,10 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 ## Supported commands
 
 ### Repository Management
-- `sb repo [--verbose]` - List installed repos (use `-v` for details)
-- `sb repo add <filepath|URL>` - Add a repository
-- `sb repo remove <REPONUM>` - Remove the indicated repo from the repo list
-- `sb repo reindex [--force] [REPONUM]` - Reindex the specified repo (or all repos if none specified)
+- `sb repo list [--verbose]` - List installed repos (use `-v` for details)
+- `sb repo add [--master] <filepath|URL>` - Add a repository, optionally specifying the type
+- `sb repo remove <REPOURL>` - Remove the indicated repo from the repo list
+- `sb repo reindex [--force] <REPOURL>` - Reindex the specified repo (or all repos if none specified)
 
 ### User Preferences
 - `sb user name "Your Name"` - Set name for attribution in generated images
@@ -108,18 +108,18 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 - `sb select date <after|before|between> <DATE> [DATE]` - Limit to sessions in the specified date range
 - `sb select export SESSIONNUM DESTDIR` - Export the images for indicated session number into the specified directory (or current directory if not specified).  If possible symbolic links are used, if not the files are copied.
 
-## Not yet supported commands
-
-### Setup & Configuration
+### Selection information
 - `sb info` - Show user preferences location and other app info
 - `sb info target` - List targets (filtered based on the current selection)
 - `sb info telescope` - List instruments (filtered based on the current selection)
 - `sb info filter` - List all filters found in current selection
 
+## Not yet supported commands
+
 ### Export & Processing
-- `sb process siril` - Generate Siril directory tree and run Siril GUI
-- `sb process auto` - Automatic processing
-- `sb process masters` - Generate master flats, darks, and biases from available raw frames
+- `sb process siril [--run] SESSIONNUM DESTDIR` - Generate Siril directory tree and optionally run Siril GUI
+- `sb process auto [SESSIONNUM]` - Automatic processing.  If session # is specified process only that session, otherwise all selected sessions will be processed
+- `sb process masters` - Generate master flats, darks, and biases from available raw frames in the current selection
 
 ## Supported tools (now)
 
@@ -138,3 +138,8 @@ We try to make this project useful and friendly.  If you find problems please fi
 We accept pull-requests and enjoy discussing possible new development directions via github issues.  If you might want to work on this, just describe what your interests are and we can talk about how to get it merged.
 
 Project members can access crash reports [here](https://geeksville.sentry.io/insights/projects/starbash/?project=4510264204132352).
+
+## License
+
+Copyright 2025 Kevin Hester, kevinh@geeksville.com.
+Licensed under the (GPL v3)[LICENSE]

{starbash-0.1.7 → starbash-0.1.9}/README.md

@@ -1,4 +1,4 @@
-# Starbash
+# [Starbash](https://github.com/geeksville/starbash)
 
 <img src="https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/img/icon.png" alt="Starbash: Astrophotography workflows simplified" width="30%" align="right" style="margin-bottom: 20px;">
 
@@ -45,7 +45,7 @@ See the current [TODO](TODO.md) file for work items.  I'll be looking for pre-al
 
 Currently the easiest way to install this command-line based tool is to install is via [pipx](https://pipx.pypa.io/stable/).  If you don't already have pipx and you have python installed, you can auto install it by running "pip install --user pipx."  If you don't have python installed see the pipx link for pipx installers for any OS.
 
-Once pipx is installed just run the following **two** commands (the sb --install-completion will make TAB auto-complete automatically complete sb options (for most platforms)):
+Once pipx is installed just run the following **two** commands (the sb --install-completion will make TAB auto-complete automatically complete sb options (for most platforms)).  Installing auto-complete is **highly** recommended because it makes entering starbash commands fast - by pressing the TAB key:
 
 ```
 ➜ pipx install starbash
@@ -66,10 +66,10 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 ## Supported commands
 
 ### Repository Management
-- `sb repo [--verbose]` - List installed repos (use `-v` for details)
-- `sb repo add <filepath|URL>` - Add a repository
-- `sb repo remove <REPONUM>` - Remove the indicated repo from the repo list
-- `sb repo reindex [--force] [REPONUM]` - Reindex the specified repo (or all repos if none specified)
+- `sb repo list [--verbose]` - List installed repos (use `-v` for details)
+- `sb repo add [--master] <filepath|URL>` - Add a repository, optionally specifying the type
+- `sb repo remove <REPOURL>` - Remove the indicated repo from the repo list
+- `sb repo reindex [--force] <REPOURL>` - Reindex the specified repo (or all repos if none specified)
 
 ### User Preferences
 - `sb user name "Your Name"` - Set name for attribution in generated images
@@ -86,18 +86,18 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 - `sb select date <after|before|between> <DATE> [DATE]` - Limit to sessions in the specified date range
 - `sb select export SESSIONNUM DESTDIR` - Export the images for indicated session number into the specified directory (or current directory if not specified).  If possible symbolic links are used, if not the files are copied.
 
-## Not yet supported commands
-
-### Setup & Configuration
+### Selection information
 - `sb info` - Show user preferences location and other app info
 - `sb info target` - List targets (filtered based on the current selection)
 - `sb info telescope` - List instruments (filtered based on the current selection)
 - `sb info filter` - List all filters found in current selection
 
+## Not yet supported commands
+
 ### Export & Processing
-- `sb process siril` - Generate Siril directory tree and run Siril GUI
-- `sb process auto` - Automatic processing
-- `sb process masters` - Generate master flats, darks, and biases from available raw frames
+- `sb process siril [--run] SESSIONNUM DESTDIR` - Generate Siril directory tree and optionally run Siril GUI
+- `sb process auto [SESSIONNUM]` - Automatic processing.  If session # is specified process only that session, otherwise all selected sessions will be processed
+- `sb process masters` - Generate master flats, darks, and biases from available raw frames in the current selection
 
 ## Supported tools (now)
 
@@ -115,4 +115,9 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 We try to make this project useful and friendly.  If you find problems please file a github issue.
 We accept pull-requests and enjoy discussing possible new development directions via github issues.  If you might want to work on this, just describe what your interests are and we can talk about how to get it merged.
 
-Project members can access crash reports [here](https://geeksville.sentry.io/insights/projects/starbash/?project=4510264204132352).
+Project members can access crash reports [here](https://geeksville.sentry.io/insights/projects/starbash/?project=4510264204132352).
+
+## License
+
+Copyright 2025 Kevin Hester, kevinh@geeksville.com.
+Licensed under the (GPL v3)[LICENSE]

{starbash-0.1.7 → starbash-0.1.9}/pyproject.toml

@@ -1,10 +1,13 @@
 [tool.poetry]
 name = "starbash"
-version = "0.1.7"
+version = "0.1.9"
 description = "A tool for automating/standardizing/sharing astrophotography workflows."
 authors = ["Kevin Hester <kevinh@geeksville.com>"]
 readme = "README.md"
-packages = [{ include = "starbash", from = "src" }]
+packages = [
+    { include = "starbash", from = "src" },
+    { include = "repo", from = "src" },
+]
 
 [tool.poetry.dependencies]
 python = ">=3.12,<3.15"         # RestrictedPython doesn't yet work on 3.15

starbash-0.1.9/src/repo/__init__.py

@@ -0,0 +1,8 @@
+"""
+The repo package handles finding, loading and searching starbash repositories.
+"""
+
+from .manager import RepoManager
+from .repo import Repo, repo_suffix, REPO_REF
+
+__all__ = ["RepoManager", "Repo", "repo_suffix", "REPO_REF"]

starbash-0.1.9/src/repo/manager.py

@@ -0,0 +1,144 @@
+"""
+Manages the repository of processing recipes and configurations.
+"""
+
+from __future__ import annotations
+import logging
+from pathlib import Path
+from importlib import resources
+from typing import Any
+
+import tomlkit
+from tomlkit.toml_file import TOMLFile
+from tomlkit.items import AoT
+from multidict import MultiDict
+from repo.repo import Repo
+
+
+class RepoManager:
+    """
+    Manages the collection of starbash repositories.
+
+    This class is responsible for finding, loading, and providing an API
+    for searching through known repositories defined in TOML configuration
+    files (like appdefaults.sb.toml).
+    """
+
+    def __init__(self):
+        """
+        Initializes the RepoManager by loading the application default repos.
+        """
+        self.repos = []
+
+        # We expose the app default preferences as a special root repo with a private URL
+        # root_repo = Repo(self, "pkg://starbash-defaults", config=app_defaults)
+        # self.repos.append(root_repo)
+
+        # Most users will just want to read from merged
+        self.merged = MultiDict()
+
+    @property
+    def regular_repos(self) -> list[Repo]:
+        "We exclude certain repo types (preferences, recipe) from the list of repos users care about."
+        return [
+            r
+            for r in self.repos
+            if r.kind() not in ("preferences") and not r.is_scheme("pkg")
+        ]
+
+    def add_repo(self, url: str) -> Repo:
+        logging.debug(f"Adding repo: {url}")
+        r = Repo(self, url)
+        self.repos.append(r)
+
+        # FIXME, generate the merged dict lazily
+        self._add_merged(r)
+
+        # if this new repo has sub-repos, add them too
+        r.add_by_repo_refs()
+
+        return r
+
+    def get_repo_by_url(self, url: str) -> Repo | None:
+        """
+        Retrieves a repository by its URL.
+
+        Args:
+            url: The URL of the repository to retrieve.
+
+        Returns:
+            The Repo instance with the matching URL, or None if not found.
+        """
+        for repo in self.repos:
+            if repo.url == url:
+                return repo
+        return None
+
+    def get_repo_by_kind(self, kind: str) -> Repo | None:
+        """
+        Retrieves the first repository matching the specified kind.
+
+        Args:
+            kind: The kind of repository to search for (e.g., "recipe", "preferences").
+
+        Returns:
+            The first Repo instance matching the kind, or None if not found.
+        """
+        for repo in self.repos:
+            if repo.kind() == kind:
+                return repo
+        return None
+
+    def get(self, key: str, default=None):
+        """
+        Searches for a key across all repositories and returns the first value found.
+        The search is performed in reverse order of repository loading, so the
+        most recently added repositories have precedence.
+
+        Args:
+            key: The dot-separated key to search for (e.g., "repo.kind").
+            default: The value to return if the key is not found in any repo.
+
+        Returns:
+            The found value or the default.
+        """
+        # Iterate in reverse to give precedence to later-loaded repos
+        for repo in reversed(self.repos):
+            value = repo.get(key)
+            if value is not None:
+                return value
+
+        return default
+
+    def dump(self):
+        """
+        Prints a detailed, multi-line description of the combined top-level keys
+        and values from all repositories, using a MultiDict for aggregation.
+        This is useful for debugging and inspecting the consolidated configuration.
+        """
+
+        combined_config = self.merged
+        logging.info("RepoManager Dump")
+        for key, value in combined_config.items():
+            # tomlkit.items() can return complex types (e.g., ArrayOfTables, Table)
+            # For a debug dump, a simple string representation is usually sufficient.
+            logging.info(f"  %s: %s", key, value)
+
+    def _add_merged(self, repo: Repo) -> None:
+        for key, value in repo.config.items():
+            # if the toml object is an AoT type, monkey patch each element in the array instead
+            if isinstance(value, AoT):
+                for v in value:
+                    setattr(v, "source", repo)
+                else:
+                    # We monkey patch source into any object that came from a repo, so that users can
+                    # find the source repo (for attribution, URL relative resolution, whatever...)
+                    setattr(value, "source", repo)
+
+            self.merged.add(key, value)
+
+    def __str__(self):
+        lines = [f"RepoManager with {len(self.repos)} repositories:"]
+        for i, repo in enumerate(self.repos):
+            lines.append(f"  [{i}] {repo.url}")
+        return "\n".join(lines)

starbash-0.1.9/src/repo/repo.py

@@ -0,0 +1,294 @@
+from __future__ import annotations
+import logging
+from pathlib import Path
+from importlib import resources
+from typing import Any, TYPE_CHECKING
+
+import tomlkit
+from tomlkit.toml_file import TOMLFile
+from tomlkit.items import AoT
+from multidict import MultiDict
+
+if TYPE_CHECKING:
+    from repo.manager import RepoManager
+
+repo_suffix = "starbash.toml"
+
+REPO_REF = "repo-ref"
+
+
+class Repo:
+    """
+    Represents a single starbash repository."""
+
+    def __init__(self, manager: RepoManager, url: str):
+        """
+        Initializes a Repo instance.
+
+        Args:
+            url: The URL to the repository (file or general http/https urls are acceptable).
+        """
+        self.manager = manager
+        self.url = url
+        self.config = self._load_config()
+
+    def __str__(self) -> str:
+        """Return a concise one-line description of this repo.
+
+        Example: "Repo(kind=recipe, local=True, url=file:///path/to/repo)"
+        """
+        return f"Repo(kind={self.kind()}, url={self.url})"
+
+    __repr__ = __str__
+
+    def kind(self, unknown_kind: str = "unknown") -> str:
+        """
+        Read-only attribute for the repository kind (e.g., "recipe", "data", etc.).
+
+        Returns:
+            The kind of the repository as a string.
+        """
+        c = self.get("repo.kind", unknown_kind)
+        return str(c)
+
+    def add_repo_ref(self, dir: Path) -> Repo | None:
+        """
+        Adds a new repo-ref to this repository's configuration.
+        if new returns the newly added Repo object, if already exists returns None"""
+
+        # if dir is not absolute, we need to resolve it relative to the cwd
+        if not dir.is_absolute():
+            dir = (Path.cwd() / dir).resolve()
+
+        # Add the ref to this repo
+        aot = self.config.get(REPO_REF, None)
+        if aot is None:
+            aot = tomlkit.aot()
+            self.config[REPO_REF] = aot  # add an empty AoT at the end of the file
+
+        if type(aot) is not AoT:
+            raise ValueError(f"repo-ref in {self.url} is not an array")
+
+        for t in aot:
+            if "dir" in t and t["dir"] == str(dir):
+                logging.warning(f"Repo ref {dir} already exists - ignoring.")
+                return None  # already exists
+
+        ref = {"dir": str(dir)}
+        aot.append(ref)
+
+        # Also add the repo to the manager
+        return self.add_from_ref(ref)
+
+    def write_config(self) -> None:
+        """
+        Writes the current (possibly modified) configuration back to the repository's config file.
+
+        Raises:
+            ValueError: If the repository is not a local file repository.
+        """
+        base_path = self.get_path()
+        if base_path is None:
+            raise ValueError("Cannot resolve path for non-local repository")
+
+        config_path = base_path / repo_suffix
+        # FIXME, be more careful to write the file atomically (by writing to a temp file and renaming)
+        TOMLFile(config_path).write(self.config)
+        logging.debug(f"Wrote config to {config_path}")
+
+    def is_scheme(self, scheme: str = "file") -> bool:
+        """
+        Read-only attribute indicating whether the repository URL points to a
+        local file system path (file:// scheme).
+
+        Returns:
+            bool: True if the URL is a local file path, False otherwise.
+        """
+        return self.url.startswith(f"{scheme}://")
+
+    def get_path(self) -> Path | None:
+        """
+        Resolves the URL to a local file system path if it's a file URI.
+
+        Args:
+            url: The repository URL.
+
+        Returns:
+            A Path object if the URL is a local file, otherwise None.
+        """
+        if self.is_scheme("file"):
+            return Path(self.url[len("file://") :])
+
+        return None
+
+    def add_from_ref(self, ref: dict) -> Repo:
+        """
+        Adds a repository based on a repo-ref dictionary.
+        """
+        if "url" in ref:
+            url = ref["url"]
+        elif "dir" in ref:
+            # FIXME don't allow ~ or .. in file paths for security reasons?
+            if self.is_scheme("file"):
+                path = Path(ref["dir"])
+                base_path = self.get_path()
+
+                if base_path and not path.is_absolute():
+                    # Resolve relative to the current TOML file's directory
+                    path = (base_path / path).resolve()
+                else:
+                    # Expand ~ and resolve from CWD
+                    path = path.expanduser().resolve()
+                url = f"file://{path}"
+            else:
+                # construct an URL relative to this repo's URL
+                url = self.url.rstrip("/") + "/" + ref["dir"].lstrip("/")
+        else:
+            raise ValueError(f"Invalid repo reference: {ref}")
+        return self.manager.add_repo(url)
+
+    def add_by_repo_refs(self) -> None:
+        """Add all repos mentioned by repo-refs in this repo's config."""
+        repo_refs = self.config.get(REPO_REF, [])
+
+        for ref in repo_refs:
+            self.add_from_ref(ref)
+
+    def resolve_path(self, filepath: str) -> Path:
+        """
+        Resolve a filepath relative to the base of this repo.
+
+        Args:
+            filepath: The path to the file, relative to the repository root.
+
+        Returns:
+            The resolved Path object.
+        """
+        base_path = self.get_path()
+        if base_path is None:
+            raise ValueError("Cannot resolve filepaths for non-local repositories")
+        target_path = (base_path / filepath).resolve()
+
+        # Security check to prevent accessing files outside the repo directory.
+        # FIXME SECURITY - temporarily disabled because I want to let file urls say things like ~/foo.
+        # it would false trigger if user homedir path has a symlink in it (such as /home -> /var/home)
+        #   base_path = PosixPath('/home/kevinh/.config/starbash')                   │                                                                                          │
+        #   filepath = 'starbash.toml'                                              │                                                                                          │
+        #   self = <repr-error 'maximum recursion depth exceeded'>              │                                                                                          │
+        #   target_path = PosixPath('/var/home/kevinh/.config/starbash/starbash.toml')
+        #
+        # if base_path not in target_path.parents and target_path != base_path:
+        #    raise PermissionError("Attempted to access file outside of repository")
+
+        return target_path
+
+    def _read_file(self, filepath: str) -> str:
+        """
+        Read a filepath relative to the base of this repo. Return the contents in a string.
+
+        Args:
+            filepath: The path to the file, relative to the repository root.
+
+        Returns:
+            The content of the file as a string.
+        """
+        target_path = self.resolve_path(filepath)
+
+        return target_path.read_text()
+
+    def _read_resource(self, filepath: str) -> str:
+        """
+        Read a resource from the installed starbash package using a pkg:// URL.
+
+        Assumptions (simplified per project constraints):
+        - All pkg URLs point somewhere inside the already-imported 'starbash' package.
+        - The URL is treated as a path relative to the starbash package root.
+
+        Examples:
+            url: pkg://defaults   + filepath: "starbash.toml"
+              -> reads starbash/defaults/starbash.toml
+
+        Args:
+            filepath: Path within the base resource directory for this repo.
+
+        Returns:
+            The content of the resource as a string (UTF-8).
+        """
+        # Path portion after pkg://, interpreted relative to the 'starbash' package
+        subpath = self.url[len("pkg://") :].strip("/")
+
+        res = resources.files("starbash").joinpath(subpath).joinpath(filepath)
+        return res.read_text()
+
+    def _load_config(self) -> tomlkit.TOMLDocument:
+        """
+        Loads the repository's configuration file (e.g., repo.sb.toml).
+
+        If the config file does not exist, it logs a warning and returns an empty dict.
+
+        Returns:
+            A dictionary containing the parsed configuration.
+        """
+        try:
+            if self.is_scheme("file"):
+                config_content = self._read_file(repo_suffix)
+            elif self.is_scheme("pkg"):
+                config_content = self._read_resource(repo_suffix)
+            else:
+                raise ValueError(f"Unsupported URL scheme for repo: {self.url}")
+            logging.debug(f"Loading repo config from {repo_suffix}")
+            return tomlkit.parse(config_content)
+        except FileNotFoundError:
+            logging.debug(
+                f"No {repo_suffix} found"
+            )  # we currently make it optional to have the config file at root
+            return tomlkit.TOMLDocument()  # empty placeholder
+
+    def get(self, key: str, default: Any | None = None) -> Any | None:
+        """
+        Gets a value from this repo's config for a given key.
+        The key can be a dot-separated string for nested values.
+
+        Args:
+            key: The dot-separated key to search for (e.g., "repo.kind").
+            default: The value to return if the key is not found.
+
+        Returns:
+            The found value or the default.
+        """
+        value = self.config
+        for k in key.split("."):
+            if not isinstance(value, dict):
+                return default
+            value = value.get(k)
+        return value if value is not None else default
+
+    def set(self, key: str, value: Any) -> None:
+        """
+        Sets a value in this repo's config for a given key.
+        The key can be a dot-separated string for nested values.
+        Creates nested Table structures as needed.
+
+        Args:
+            key: The dot-separated key to set (e.g., "repo.kind").
+            value: The value to set.
+
+        Example:
+            repo.set("repo.kind", "preferences")
+            repo.set("user.name", "John Doe")
+        """
+        keys = key.split(".")
+        current: Any = self.config
+
+        # Navigate/create nested structure for all keys except the last
+        for k in keys[:-1]:
+            if k not in current:
+                # Create a new nested table
+                current[k] = tomlkit.table()
+            elif not isinstance(current[k], dict):
+                # Overwrite non-dict value with a table
+                current[k] = tomlkit.table()
+            current = current[k]
+
+        # Set the final value
+        current[keys[-1]] = value

{starbash-0.1.7 → starbash-0.1.9}/src/starbash/__init__.py

@@ -1,5 +1,7 @@
+import datetime
 import logging
 import os
+from datetime import datetime
 
 from .database import Database  # re-export for convenience
 from rich.console import Console
@@ -15,4 +17,22 @@ console = Console(
 # Global variable for log filter level (can be changed via --debug flag)
 log_filter_level = logging.INFO
 
+
+def to_shortdate(date_iso: str) -> str:
+    """Convert ISO UTC datetime string to local short date string (YYYY-MM-DD).
+
+    Args:
+        date_iso: ISO format datetime string (e.g., "2023-10-15T14:30:00Z")
+
+    Returns:
+        Short date string in YYYY-MM-DD format
+    """
+    try:
+        dt_utc = datetime.fromisoformat(date_iso)
+        dt_local = dt_utc.astimezone()
+        return dt_local.strftime("%Y-%m-%d")
+    except (ValueError, TypeError):
+        return date_iso
+
+
 __all__ = ["Database"]

{starbash-0.1.7 → starbash-0.1.9}/src/starbash/analytics.py

@@ -4,6 +4,7 @@ import os
 import starbash
 from starbash import console, _is_test_env
 import starbash.url as url
+from sentry_sdk.integrations.excepthook import ExcepthookIntegration
 
 # Default to no analytics/auto crash reports
 analytics_allowed = False
@@ -25,6 +26,9 @@ def analytics_setup(allowed: bool = False, user_email: str | None = None) -> Non
             send_default_pii=True,
             enable_logs=True,
             traces_sample_rate=1.0,
+            disabled_integrations=[
+                ExcepthookIntegration()
+            ],  # This line removes the aggressive unhandled exception catcher
             integrations=[
                 LoggingIntegration(
                     level=starbash.log_filter_level,  # Capture INFO and above as breadcrumbs