starbash 0.1.1__tar.gz → 0.1.3__tar.gz

starbash-0.1.3/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: starbash
+Version: 0.1.3
+Summary: 
+License-File: LICENSE
+Author: Kevin Hester
+Author-email: kevinh@geeksville.com
+Requires-Python: >=3.12,<3.15
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: astropy (>=7.1.1,<8.0.0)
+Requires-Dist: multidict (>=6.7.0,<7.0.0)
+Requires-Dist: platformdirs (>=4.5.0,<5.0.0)
+Requires-Dist: restrictedpython (>=8.1,<9.0)
+Requires-Dist: rich (>=14.2.0,<15.0.0)
+Requires-Dist: sentry-sdk (>=2.42.1,<3.0.0)
+Requires-Dist: tomlkit (>=0.13.3,<0.14.0)
+Requires-Dist: typer (>=0.20.0,<0.21.0)
+Description-Content-Type: text/markdown
+
+# Starbash
+
+![PyPI - Version](https://img.shields.io/pypi/v/starbash)
+![GitHub branch check runs](https://img.shields.io/github/check-runs/geeksville/starbash/main)
+
+ ![app icon](https://github.com/geeksville/starbash/blob/main/img/icon.png "Starbash: Astrophotography workflows simplified")
+
+A tool for automating/standardizing/sharing astrophotography workflows.
+
+# Current status
+
+Not quite ready 😊.  But making good progress.
+
+See the current [TODO](TODO.md) file for work items.  I'll be looking for pre-alpha testers/feedback soon.
+
+## Current features
+
+* Automatically recognizes and auto-parses the default NINA, Asiair and Seestar raw file repos (adding support for other layouts is easy)
+* Multisession support by default (including automatic selection of correct flats, biases and dark frames)
+* 'Repos' can contain raw files, generated masters, preprocessed files, or recipes.
+
+## Features coming soon
+
+* Automatically performs **complete** preprocessing on OSC (broadband, narrowband or dual Duo filter), Mono (LRGB, SHO) data.  i.e. give you 'seestar level' auto-preprocessing, so you only need to do the (optional) custom post-processing.
+* Generates a per target report/config file which can be customized if the detected defaults or preprocessing are not what you want
+* 'Recipes' provide repeatable/human-readable/sharable descriptions of all processing steps
+* Repos can be on the local disk or shared via HTTPS/github/etc.  This is particularly useful for recipe repos
+* Uses Siril and Graxpert for its pre-processing operations (support for Pixinsight based recipies will probably be coming at some point...)
+* The target report can be used to auto generate a human friendly 'postable/sharable' report about that image
+* Target reports are sharable so that you can request comments by others and others can rerender with different settings
+
+## Installing
+
+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:
+
+```
+pipx install starbash
+```
+
+## Supported commands
+
+### Setup & Configuration
+- `sb setup` - Configure starbash via a brief guided process
+- `sb info` - Show user preferences location and other app info
+
+### 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)
+
+### User Preferences
+- `sb user name "Your Name"` - Set name for attribution in generated images
+- `sb user email "foo@example.com"` - Set email for attribution in generated images
+- `sb user analytics <on|off>` - Turn analytics collection on/off
+
+### Selection & Filtering
+- `sb selection` - Show information about the current selection
+- `sb selection any` - Remove all filters (select everything)
+- `sb selection target <TARGETNAME>` - Limit selection to the named target
+- `sb selection telescope <TELESCOPENAME>` - Limit selection to the named telescope
+- `sb selection date <after|before|between> <DATE> [DATE]` - Limit to sessions in the specified date range
+
+### Viewing Data
+- `sb session` - List sessions (filtered based on the current selection)
+- `sb target` - List targets (filtered based on the current selection)
+- `sb instrument` - List instruments (filtered based on the current selection)
+- `sb filter` - List all filters found in current selection
+
+### Export & Processing
+- `sb export <dirs|BIAS|LIGHT|DARK|FLAT> [DIRLOC]` - Export data
+- `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
+
+## Supported tools (now)
+
+* Siril
+* Graxpert
+* Python (you can add python code to recipies if necessary)
+
+## Supported tools (future?)
+
+* Pixinsight?
+* Autostakkert?
+
+## Developing
+
+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.

starbash-0.1.3/README.md

@@ -0,0 +1,92 @@
+# Starbash
+
+![PyPI - Version](https://img.shields.io/pypi/v/starbash)
+![GitHub branch check runs](https://img.shields.io/github/check-runs/geeksville/starbash/main)
+
+ ![app icon](https://github.com/geeksville/starbash/blob/main/img/icon.png "Starbash: Astrophotography workflows simplified")
+
+A tool for automating/standardizing/sharing astrophotography workflows.
+
+# Current status
+
+Not quite ready 😊.  But making good progress.
+
+See the current [TODO](TODO.md) file for work items.  I'll be looking for pre-alpha testers/feedback soon.
+
+## Current features
+
+* Automatically recognizes and auto-parses the default NINA, Asiair and Seestar raw file repos (adding support for other layouts is easy)
+* Multisession support by default (including automatic selection of correct flats, biases and dark frames)
+* 'Repos' can contain raw files, generated masters, preprocessed files, or recipes.
+
+## Features coming soon
+
+* Automatically performs **complete** preprocessing on OSC (broadband, narrowband or dual Duo filter), Mono (LRGB, SHO) data.  i.e. give you 'seestar level' auto-preprocessing, so you only need to do the (optional) custom post-processing.
+* Generates a per target report/config file which can be customized if the detected defaults or preprocessing are not what you want
+* 'Recipes' provide repeatable/human-readable/sharable descriptions of all processing steps
+* Repos can be on the local disk or shared via HTTPS/github/etc.  This is particularly useful for recipe repos
+* Uses Siril and Graxpert for its pre-processing operations (support for Pixinsight based recipies will probably be coming at some point...)
+* The target report can be used to auto generate a human friendly 'postable/sharable' report about that image
+* Target reports are sharable so that you can request comments by others and others can rerender with different settings
+
+## Installing
+
+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:
+
+```
+pipx install starbash
+```
+
+## Supported commands
+
+### Setup & Configuration
+- `sb setup` - Configure starbash via a brief guided process
+- `sb info` - Show user preferences location and other app info
+
+### 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)
+
+### User Preferences
+- `sb user name "Your Name"` - Set name for attribution in generated images
+- `sb user email "foo@example.com"` - Set email for attribution in generated images
+- `sb user analytics <on|off>` - Turn analytics collection on/off
+
+### Selection & Filtering
+- `sb selection` - Show information about the current selection
+- `sb selection any` - Remove all filters (select everything)
+- `sb selection target <TARGETNAME>` - Limit selection to the named target
+- `sb selection telescope <TELESCOPENAME>` - Limit selection to the named telescope
+- `sb selection date <after|before|between> <DATE> [DATE]` - Limit to sessions in the specified date range
+
+### Viewing Data
+- `sb session` - List sessions (filtered based on the current selection)
+- `sb target` - List targets (filtered based on the current selection)
+- `sb instrument` - List instruments (filtered based on the current selection)
+- `sb filter` - List all filters found in current selection
+
+### Export & Processing
+- `sb export <dirs|BIAS|LIGHT|DARK|FLAT> [DIRLOC]` - Export data
+- `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
+
+## Supported tools (now)
+
+* Siril
+* Graxpert
+* Python (you can add python code to recipies if necessary)
+
+## Supported tools (future?)
+
+* Pixinsight?
+* Autostakkert?
+
+## Developing
+
+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.

{starbash-0.1.1 → starbash-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "starbash"
-version = "0.1.1"
+version = "0.1.3"
 description = ""
 authors = ["Kevin Hester <kevinh@geeksville.com>"]
 readme = "README.md"

{starbash-0.1.1 → starbash-0.1.3}/src/starbash/app.py

@@ -1,7 +1,7 @@
 import logging
 from importlib import resources
 from pathlib import Path
-
+import typer
 import tomlkit
 from tomlkit.toml_file import TOMLFile
 import glob
@@ -10,6 +10,7 @@ from astropy.io import fits
 import itertools
 from rich.progress import track
 from rich.logging import RichHandler
+
 from starbash.database import Database
 from starbash.repo.manager import Repo
 from starbash.tool import Tool
@@ -117,7 +118,8 @@ class Starbash:
 
     def __exit__(self, exc_type, exc, tb) -> bool:
         handled = False
-        if exc:
+        # Don't suppress typer.Exit - it's used for controlled exit codes
+        if exc and not isinstance(exc, typer.Exit):
             handled = analytics_exception(exc)
         self.close()
         return handled
@@ -128,11 +130,12 @@ class Starbash:
         date = header.get(Database.DATE_OBS_KEY)
         if not date or not image_type:
             logging.warning(
-                "Image %s missing critical FITS header, please submit image at https://github.com/geeksville/starbash/issues/new",
+                "Image %s missing either DATE-OBS or IMAGETYP FITS header, skipping...",
                 f,
             )
         else:
             exptime = header.get(Database.EXPTIME_KEY, 0)
+            telescop = header.get(Database.TELESCOP_KEY, "unspecified")
             new = {
                 Database.FILTER_KEY: filter,
                 Database.START_KEY: date,
@@ -142,6 +145,7 @@ class Starbash:
                 Database.NUM_IMAGES_KEY: 1,
                 Database.EXPTIME_TOTAL_KEY: exptime,
                 Database.OBJECT_KEY: header.get(Database.OBJECT_KEY, "unspecified"),
+                Database.TELESCOP_KEY: telescop,
             }
             session = self.db.get_session(new)
             self.db.upsert_session(new, existing=session)
@@ -156,16 +160,86 @@ class Starbash:
             conditions = self.selection.get_query_conditions()
             return self.db.search_session(conditions)
 
+    def get_session_images(self, session_id: int) -> list[dict[str, Any]]:
+        """
+        Get all images belonging to a specific session.
+
+        Sessions are defined by a unique combination of filter, imagetyp (image type),
+        object (target name), telescope, and date range. This method queries the images
+        table for all images matching the session's criteria in a single database query.
+
+        Args:
+            session_id: The database ID of the session
+
+        Returns:
+            List of image records (dictionaries with path, metadata, etc.)
+            Returns empty list if session not found or has no images.
+
+        Raises:
+            ValueError: If session_id is not found in the database
+        """
+        # First get the session details
+        session = self.db.get_session_by_id(session_id)
+        if session is None:
+            raise ValueError(f"Session with id {session_id} not found")
+
+        # Query images that match ALL session criteria including date range
+        conditions = {
+            Database.FILTER_KEY: session[Database.FILTER_KEY],
+            Database.IMAGETYP_KEY: session[Database.IMAGETYP_KEY],
+            Database.OBJECT_KEY: session[Database.OBJECT_KEY],
+            Database.TELESCOP_KEY: session[Database.TELESCOP_KEY],
+            "date_start": session[Database.START_KEY],
+            "date_end": session[Database.END_KEY],
+        }
+
+        # Single query with all conditions
+        images = self.db.search_image(conditions)
+        return images if images else []
+
+    def remove_repo_ref(self, url: str) -> None:
+        """
+        Remove a repository reference from the user configuration.
+
+        Args:
+            url: The repository URL to remove (e.g., 'file:///path/to/repo')
+
+        Raises:
+            ValueError: If the repository URL is not found in user configuration
+        """
+        # Get the repo-ref list from user config
+        repo_refs = self.user_repo.config.get("repo-ref")
+
+        if not repo_refs:
+            raise ValueError(f"No repository references found in user configuration.")
+
+        # Find and remove the matching repo-ref
+        found = False
+        refs_copy = [r for r in repo_refs]  # Make a copy to iterate
+        for ref in refs_copy:
+            ref_dir = ref.get("dir", "")
+            # Match by converting to file:// URL format if needed
+            if ref_dir == url or f"file://{ref_dir}" == url:
+                repo_refs.remove(ref)
+                found = True
+                break
+
+        if not found:
+            raise ValueError(f"Repository '{url}' not found in user configuration.")
+
+        # Write the updated config
+        self.user_repo.write_config()
+
     def reindex_repo(self, repo: Repo, force: bool = False):
         """Reindex all repositories managed by the RepoManager."""
         # FIXME, add a method to get just the repos that contain images
         if repo.is_scheme("file") and repo.kind != "recipe":
             logging.debug("Reindexing %s...", repo.url)
 
+            whitelist = None
             config = self.repo_manager.merged.get("config")
-            if not config:
-                raise ValueError(f"App config not found.")
-            whitelist = config["fits-whitelist"]
+            if config:
+                whitelist = config.get("fits-whitelist", None)
 
             path = repo.get_path()
             if not path:
@@ -191,7 +265,7 @@ class Starbash:
                             items = header.items()
                             headers = {}
                             for key, value in items:
-                                if key in whitelist:
+                                if (not whitelist) or (key in whitelist):
                                     headers[key] = value
                             logging.debug("Headers for %s: %s", f, headers)
                             headers["path"] = str(f)
@@ -207,7 +281,7 @@ class Starbash:
 
     def reindex_repos(self, force: bool = False):
         """Reindex all repositories managed by the RepoManager."""
-        logging.info("Reindexing all repositories...")
+        logging.debug("Reindexing all repositories...")
 
         for repo in track(self.repo_manager.repos, description="Reindexing repos..."):
             self.reindex_repo(repo, force=force)

starbash-0.1.3/src/starbash/commands/repo.py

@@ -0,0 +1,133 @@
+import typer
+from typing_extensions import Annotated
+
+from starbash.app import Starbash
+from starbash import console
+
+app = typer.Typer(invoke_without_command=True)
+
+
+@app.callback()
+def main(
+    ctx: typer.Context,
+    verbose: bool = typer.Option(
+        False, "--verbose", "-v", help="Show all repos including system repos"
+    ),
+):
+    """
+    Manage repositories.
+
+    When called without a subcommand, lists all repositories.
+    Use --verbose to show all repos including system/recipe repos.
+    """
+    # If no subcommand is invoked, run the list behavior
+    if ctx.invoked_subcommand is None:
+        with Starbash("repo-list") as sb:
+            repos = sb.repo_manager.repos if verbose else sb.repo_manager.regular_repos
+            for i, repo in enumerate(repos):
+                if verbose:
+                    # No numbers for verbose mode (system repos can't be removed)
+                    console.print(f"{ repo.url } (kind={ repo.kind})")
+                else:
+                    # Show numbers for user repos (can be removed later)
+                    console.print(f"{ i + 1:2}: { repo.url } (kind={ repo.kind})")
+
+
+@app.command()
+def add(path: str):
+    """
+    Add a repository. path is either a local path or a remote URL.
+    """
+    with Starbash("repo-add") as sb:
+        sb.user_repo.add_repo_ref(path)
+        # we don't yet write default config files at roots of repos, but it would be easy to add here
+        # r.write_config()
+        sb.user_repo.write_config()
+        # FIXME, we also need to index the newly added repo!!!
+        console.print(f"Added repository: {path}")
+
+
+@app.command()
+def remove(reponum: str):
+    """
+    Remove a repository by number (from list).
+    Use 'starbash repo' to see the repository numbers.
+    """
+    with Starbash("repo-remove") as sb:
+        try:
+            # Parse the repo number (1-indexed)
+            repo_index = int(reponum) - 1
+
+            # Get only the regular (user-visible) repos
+            regular_repos = sb.repo_manager.regular_repos
+
+            if repo_index < 0 or repo_index >= len(regular_repos):
+                console.print(
+                    f"[red]Error: Repository number {reponum} is out of range. Valid range: 1-{len(regular_repos)}[/red]"
+                )
+                raise typer.Exit(code=1)
+
+            # Get the repo to remove
+            repo_to_remove = regular_repos[repo_index]
+            repo_url = repo_to_remove.url
+
+            # Remove the repo reference from user config
+            sb.remove_repo_ref(repo_url)
+            console.print(f"[green]Removed repository: {repo_url}[/green]")
+
+        except ValueError:
+            console.print(
+                f"[red]Error: '{reponum}' is not a valid repository number. Please use a number from 'repo list'.[/red]"
+            )
+            raise typer.Exit(code=1)
+
+
+@app.command()
+def reindex(
+    reponum: Annotated[
+        str | None,
+        typer.Argument(help="The repository number, if not specified reindex all."),
+    ] = None,
+    force: bool = typer.Option(
+        default=False, help="Reread FITS headers, even if they are already indexed."
+    ),
+):
+    """
+    Reindex a repository by number.
+    If no number is given, reindex all repositories.
+    Use 'starbash repo' to see the repository numbers.
+    """
+    with Starbash("repo-reindex") as sb:
+        if reponum is None:
+            sb.reindex_repos(force=force)
+        else:
+            try:
+                # Parse the repo number (1-indexed)
+                repo_index = int(reponum) - 1
+
+                # Get only the regular (user-visible) repos
+                regular_repos = sb.repo_manager.regular_repos
+
+                if repo_index < 0 or repo_index >= len(regular_repos):
+                    console.print(
+                        f"[red]Error: Repository number {reponum} is out of range. Valid range: 1-{len(regular_repos)}[/red]"
+                    )
+                    raise typer.Exit(code=1)
+
+                # Get the repo to reindex
+                repo_to_reindex = regular_repos[repo_index]
+                console.print(f"Reindexing repository: {repo_to_reindex.url}")
+                sb.reindex_repo(repo_to_reindex, force=force)
+                console.print(
+                    f"[green]Successfully reindexed repository {reponum}[/green]"
+                )
+
+            except ValueError:
+                console.print(
+                    f"[red]Error: '{reponum}' is not a valid repository number. Please use a number from 'starbash repo'.[/red]"
+                )
+                raise typer.Exit(code=1)
+
+
+if __name__ == "__main__":
+    app()

{starbash-0.1.1 → starbash-0.1.3}/src/starbash/commands/selection.py

@@ -31,11 +31,31 @@ def target(
     with Starbash("selection-target") as sb:
         # For now, replace existing targets with this one
         # In the future, we could support adding multiple targets
-        sb.selection.clear()
+        sb.selection.targets = []
         sb.selection.add_target(target_name)
         console.print(f"[green]Selection limited to target: {target_name}[/green]")
 
 
+@app.command()
+def telescope(
+    telescope_name: Annotated[
+        str,
+        typer.Argument(
+            help="Telescope name to add to the selection (e.g., 'Vespera', 'EdgeHD 8')"
+        ),
+    ],
+):
+    """Limit the current selection to only the named telescope."""
+    with Starbash("selection-telescope") as sb:
+        # For now, replace existing telescopes with this one
+        # In the future, we could support adding multiple telescopes
+        sb.selection.telescopes = []
+        sb.selection.add_telescope(telescope_name)
+        console.print(
+            f"[green]Selection limited to telescope: {telescope_name}[/green]"
+        )
+
+
 @app.command()
 def date(
     operation: Annotated[