starbash 0.1.9__py3-none-any.whl → 0.1.15__py3-none-any.whl

starbash/main.py

@@ -1,13 +1,24 @@
 import logging
+import warnings
+from typing import Annotated
+
 import typer
-from typing_extensions import Annotated
 
-import starbash.url as url
 import starbash
+import starbash.url as url
 
-from .app import Starbash, get_user_config_path, setup_logging
-from .commands import info, process, repo, select, user
 from . import console
+from .analytics import is_development_environment
+from .app import Starbash
+from .commands import info, process, repo, select, user
+from .paths import get_user_config_path
+
+# Suppress deprecation warnings in production mode to provide a cleaner user experience.
+# In development mode (VS Code, devcontainer, or SENTRY_ENVIRONMENT=development),
+# all warnings are shown to help developers identify potential issues.
+# See: is_development_environment() in analytics.py for detection logic.
+if not is_development_environment():
+    warnings.filterwarnings("ignore", category=DeprecationWarning)
 
 app = typer.Typer(
     rich_markup_mode="rich",
@@ -17,9 +28,7 @@ app.add_typer(user.app, name="user", help="Manage user settings.")
 app.add_typer(repo.app, name="repo", help="Manage Starbash repositories.")
 app.add_typer(select.app, name="select", help="Manage session and target selection.")
 app.add_typer(info.app, name="info", help="Display system and data information.")
-app.add_typer(
-    process.app, name="process", help="Process images using automated workflows."
-)
+app.add_typer(process.app, name="process", help="Process images using automated workflows.")
 
 
 @app.callback(invoke_without_command=True)
@@ -32,11 +41,24 @@ def main_callback(
             help="Enable debug logging output.",
         ),
     ] = False,
+    force: bool = typer.Option(
+        default=False,
+        help="Force reindexing/output file regeneration - even if unchanged.",
+    ),
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        help="When providing responses, include all entries.  Normally long responses are truncated.",
+    ),
 ):
     """Main callback for the Starbash application."""
     # Set the log level based on --debug flag
     if debug:
         starbash.log_filter_level = logging.DEBUG
+    if force:
+        starbash.force_regen = True
+    if verbose:
+        starbash.verbose_output = True
 
     if ctx.invoked_subcommand is None:
         if not get_user_config_path().exists():

starbash/paths.py

@@ -1,5 +1,6 @@
 import os
 from pathlib import Path
+
 from platformdirs import PlatformDirs
 
 app_name = "starbash"
@@ -7,32 +8,61 @@ app_author = "geeksville"
 dirs = PlatformDirs(app_name, app_author)
 config_dir = Path(dirs.user_config_dir)
 data_dir = Path(dirs.user_data_dir)
+cache_dir = Path(dirs.user_cache_dir)
+documents_dir = Path(dirs.user_documents_dir) / "starbash"
 
 # These can be overridden for testing
 _override_config_dir: Path | None = None
 _override_data_dir: Path | None = None
+_override_cache_dir: Path | None = None
+_override_documents_dir: Path | None = None
 
 
 def set_test_directories(
-    config_dir_override: Path | None = None, data_dir_override: Path | None = None
+    config_dir_override: Path | None = None,
+    data_dir_override: Path | None = None,
+    cache_dir_override: Path | None = None,
+    documents_dir_override: Path | None = None,
 ) -> None:
     """Set override directories for testing. Used by test fixtures to isolate test data."""
-    global _override_config_dir, _override_data_dir
+    global _override_config_dir, _override_data_dir, _override_cache_dir, _override_documents_dir
     _override_config_dir = config_dir_override
     _override_data_dir = data_dir_override
+    _override_cache_dir = cache_dir_override
+    _override_documents_dir = documents_dir_override
 
 
 def get_user_config_dir() -> Path:
     """Get the user config directory. Returns test override if set, otherwise the real user directory."""
-    dir_to_use = (
-        _override_config_dir if _override_config_dir is not None else config_dir
-    )
+    dir_to_use = _override_config_dir if _override_config_dir is not None else config_dir
     os.makedirs(dir_to_use, exist_ok=True)
     return dir_to_use
 
 
+def get_user_config_path() -> Path:
+    """Returns the path to the user config file (starbash.toml)."""
+    from repo import repo_suffix  # Lazy import to avoid circular dependency
+
+    config_dir = get_user_config_dir()
+    return config_dir / repo_suffix
+
+
 def get_user_data_dir() -> Path:
     """Get the user data directory. Returns test override if set, otherwise the real user directory."""
     dir_to_use = _override_data_dir if _override_data_dir is not None else data_dir
     os.makedirs(dir_to_use, exist_ok=True)
     return dir_to_use
+
+
+def get_user_cache_dir() -> Path:
+    """Get the user cache directory. Returns test override if set, otherwise the real user directory."""
+    dir_to_use = _override_cache_dir if _override_cache_dir is not None else cache_dir
+    os.makedirs(dir_to_use, exist_ok=True)
+    return dir_to_use
+
+
+def get_user_documents_dir() -> Path:
+    """Get the user documents directory. Returns test override if set, otherwise the real user directory."""
+    dir_to_use = _override_documents_dir if _override_documents_dir is not None else documents_dir
+    os.makedirs(dir_to_use, exist_ok=True)
+    return dir_to_use