starbash 0.3.3__tar.gz → 0.3.5__tar.gz

{starbash-0.3.3 → starbash-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starbash
-Version: 0.3.3
+Version: 0.3.5
 Summary: A tool for automating/standardizing/sharing astrophotography workflows.
 License-File: LICENSE
 Author: Kevin Hester
@@ -12,10 +12,10 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: astropy (>=7.1.1)
 Requires-Dist: doit (>=0.36.0)
-Requires-Dist: graxpert[cpuonly] (>=3.2.0a2,<4.0.0)
+Requires-Dist: graxpert[cpuonly] (>=3.2.0a3,<4.0.0)
 Requires-Dist: jinja2 (>=3.1,<4.0)
 Requires-Dist: keyring (>=25.6)
-Requires-Dist: numpy (==2.2.6)
+Requires-Dist: numpy (>=2.2.6)
 Requires-Dist: platformdirs (>=4.5.0,<5.0.0)
 Requires-Dist: pygal (>=3.0,<4.0)
 Requires-Dist: pyqt6 (>=6.10.1,<7.0.0)
@@ -79,7 +79,12 @@ This project is still very young - but making good progress 😊!
 
 If you are interested in alpha-testing we ❤️ you.  This README should have enough instructions to get you going, but if you encounter **any** problems please file a github issue and we'll work together to fix them.
 
-![Sample session movie](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/doc/vhs/sample-session.gif)
+(new!) We now have a full GUI (click the video to play)...
+
+<video src="https://github.com/user-attachments/assets/0791c47f-f8fa-4279-be06-f869d7212d8c" autoplay controls loop muted playsinline width="100%"></video>
+
+We have a CLI interface also...
+![CLI sample session](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/doc/vhs/sample-session.gif)
 
 ## Current features
 
@@ -108,6 +113,7 @@ If you are interested in alpha-testing we ❤️ you.  This README should have e
 
 ## Features coming soon
 
+* Fixed SHO/HOO auto post processing pipeline for dual narrowband OSC filters.  Currently everything after pallete recomposition looks bad for those workflows (prior stage outputs are all good though)
 * Recipe 'writers guide' documentation.  Currently iterating based on usage reports 😄
 * Support for mono-camera workflows (this alpha only includes osc recipes).
 * The target report can be used to auto-generate a human-friendly 'postable/shareable' report about that image.
@@ -147,7 +153,37 @@ Completion will take effect once you restart the terminal
 
 ```
 
-## Use
+## Supported telescope software
+
+* N.I.N.A. - tested, seems fairly okay.
+* Asiair - tested, seems fairly okay.
+* Seestar - tested, seems fairly okay.
+* Dwarf3 - tested but young and possibly buggy, please report bugs if you find them.
+* Ekos/Kstars - not tested; please try it and file a GitHub issue if you see any problems.
+
+## Supported tools (now)
+Starbash is a tool agnostic workflow manager.  But it wouldn't be possible without the folling great tools.
+
+* [Siril](https://siril.org/)
+* [Graxpert](https://graxpert.com/) - for background and noise elimination
+* [blur exterminator / noise exterminator](https://www.rc-astro.com/stand-alone-rc-astro-tools/)
+* [starnet](https://starnetastro.com/cli-tools/) - for star removal
+* [Python](https://www.python.org/) (you can add Python code to recipes if necessary)
+
+## Desktop GUI
+
+Prefer clicking to typing? Starbash ships a desktop app that
+covers the same ground as the CLI — browse sessions and preview frames, edit the
+selection, run the pipeline and watch every stage live, tweak per-target stage
+exclusions, manage repositories, and build the report site.
+
+```bash
+sb
+```
+
+## CLI
+
+** Warning: The following instructions are written wrt to the CLI.  The newer GUI can do all the same things - but easier/prettier.  So most users should use the GUI first **
 
 ### Initial setup
 
@@ -224,22 +260,6 @@ sb publish github               # Publish to github
 See the [GitHub publishing guide](doc/publish/github.md) for prerequisites,
 preview instructions, authentication, and troubleshooting.
 
-### Desktop GUI
-
-Prefer clicking to typing? Starbash ships a desktop app (built on PySide6) that
-covers the same ground as the CLI — browse sessions and preview frames, edit the
-selection, run the pipeline and watch every stage live, tweak per-target stage
-exclusions, manage repositories, and build the report site.
-
-```bash
-sb gui
-```
-
-PySide6 is installed with Starbash, so there is nothing extra to add. The GUI is
-optional in the sense that you can ignore it completely and keep driving Starbash
-from the command line: both front ends share the same selection, config and
-database, so you can mix them freely.
-
 ## Supported commands
 
 ### Repository Management
@@ -275,23 +295,6 @@ database, so you can mix them freely.
 - `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 telescope software
-
-* N.I.N.A. - tested, seems fairly okay.
-* Asiair - tested, seems fairly okay.
-* Seestar - tested, seems fairly okay.
-* Dwarf3 - tested but young and possibly buggy, please report bugs if you find them.
-* Ekos/Kstars - not tested; please try it and file a GitHub issue if you see any problems.
-
-## Supported tools (now)
-Starbash is a tool agnostic workflow manager.  But it wouldn't be possible without the folling great tools.
-
-* [Siril](https://siril.org/)
-* [Graxpert](https://graxpert.com/) - for background and noise elimination
-* [blur exterminator / noise exterminator](https://www.rc-astro.com/stand-alone-rc-astro-tools/)
-* [starnet](https://starnetastro.com/cli-tools/) - for star removal
-* [Python](https://www.python.org/) (you can add Python code to recipes if necessary)
-
 ## Credits
 * Various reddit users who submitted anonymous crash reports from alpha 1
 * [@codegistics](https://github.com/codegistics) for kindly donating Dwarf3 test data and invaluable debugging assistance.
@@ -319,5 +322,6 @@ However, in some of my other open-source projects, I've seen the current hell PR
 
 ## License
 
-Copyright 2025 Kevin Hester, kevinh@geeksville.com.
+Copyright 2025, 2026 Kevin Hester, kevinh@geeksville.com.
 Licensed under the [GPL v3](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/LICENSE)
+

{starbash-0.3.3 → starbash-0.3.5}/README.md

@@ -46,7 +46,12 @@ This project is still very young - but making good progress 😊!
 
 If you are interested in alpha-testing we ❤️ you.  This README should have enough instructions to get you going, but if you encounter **any** problems please file a github issue and we'll work together to fix them.
 
-![Sample session movie](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/doc/vhs/sample-session.gif)
+(new!) We now have a full GUI (click the video to play)...
+
+<video src="https://github.com/user-attachments/assets/0791c47f-f8fa-4279-be06-f869d7212d8c" autoplay controls loop muted playsinline width="100%"></video>
+
+We have a CLI interface also...
+![CLI sample session](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/doc/vhs/sample-session.gif)
 
 ## Current features
 
@@ -75,6 +80,7 @@ If you are interested in alpha-testing we ❤️ you.  This README should have e
 
 ## Features coming soon
 
+* Fixed SHO/HOO auto post processing pipeline for dual narrowband OSC filters.  Currently everything after pallete recomposition looks bad for those workflows (prior stage outputs are all good though)
 * Recipe 'writers guide' documentation.  Currently iterating based on usage reports 😄
 * Support for mono-camera workflows (this alpha only includes osc recipes).
 * The target report can be used to auto-generate a human-friendly 'postable/shareable' report about that image.
@@ -114,7 +120,37 @@ Completion will take effect once you restart the terminal
 
 ```
 
-## Use
+## Supported telescope software
+
+* N.I.N.A. - tested, seems fairly okay.
+* Asiair - tested, seems fairly okay.
+* Seestar - tested, seems fairly okay.
+* Dwarf3 - tested but young and possibly buggy, please report bugs if you find them.
+* Ekos/Kstars - not tested; please try it and file a GitHub issue if you see any problems.
+
+## Supported tools (now)
+Starbash is a tool agnostic workflow manager.  But it wouldn't be possible without the folling great tools.
+
+* [Siril](https://siril.org/)
+* [Graxpert](https://graxpert.com/) - for background and noise elimination
+* [blur exterminator / noise exterminator](https://www.rc-astro.com/stand-alone-rc-astro-tools/)
+* [starnet](https://starnetastro.com/cli-tools/) - for star removal
+* [Python](https://www.python.org/) (you can add Python code to recipes if necessary)
+
+## Desktop GUI
+
+Prefer clicking to typing? Starbash ships a desktop app that
+covers the same ground as the CLI — browse sessions and preview frames, edit the
+selection, run the pipeline and watch every stage live, tweak per-target stage
+exclusions, manage repositories, and build the report site.
+
+```bash
+sb
+```
+
+## CLI
+
+** Warning: The following instructions are written wrt to the CLI.  The newer GUI can do all the same things - but easier/prettier.  So most users should use the GUI first **
 
 ### Initial setup
 
@@ -191,22 +227,6 @@ sb publish github               # Publish to github
 See the [GitHub publishing guide](doc/publish/github.md) for prerequisites,
 preview instructions, authentication, and troubleshooting.
 
-### Desktop GUI
-
-Prefer clicking to typing? Starbash ships a desktop app (built on PySide6) that
-covers the same ground as the CLI — browse sessions and preview frames, edit the
-selection, run the pipeline and watch every stage live, tweak per-target stage
-exclusions, manage repositories, and build the report site.
-
-```bash
-sb gui
-```
-
-PySide6 is installed with Starbash, so there is nothing extra to add. The GUI is
-optional in the sense that you can ignore it completely and keep driving Starbash
-from the command line: both front ends share the same selection, config and
-database, so you can mix them freely.
-
 ## Supported commands
 
 ### Repository Management
@@ -242,23 +262,6 @@ database, so you can mix them freely.
 - `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 telescope software
-
-* N.I.N.A. - tested, seems fairly okay.
-* Asiair - tested, seems fairly okay.
-* Seestar - tested, seems fairly okay.
-* Dwarf3 - tested but young and possibly buggy, please report bugs if you find them.
-* Ekos/Kstars - not tested; please try it and file a GitHub issue if you see any problems.
-
-## Supported tools (now)
-Starbash is a tool agnostic workflow manager.  But it wouldn't be possible without the folling great tools.
-
-* [Siril](https://siril.org/)
-* [Graxpert](https://graxpert.com/) - for background and noise elimination
-* [blur exterminator / noise exterminator](https://www.rc-astro.com/stand-alone-rc-astro-tools/)
-* [starnet](https://starnetastro.com/cli-tools/) - for star removal
-* [Python](https://www.python.org/) (you can add Python code to recipes if necessary)
-
 ## Credits
 * Various reddit users who submitted anonymous crash reports from alpha 1
 * [@codegistics](https://github.com/codegistics) for kindly donating Dwarf3 test data and invaluable debugging assistance.
@@ -286,5 +289,5 @@ However, in some of my other open-source projects, I've seen the current hell PR
 
 ## License
 
-Copyright 2025 Kevin Hester, kevinh@geeksville.com.
-Licensed under the [GPL v3](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/LICENSE)
+Copyright 2025, 2026 Kevin Hester, kevinh@geeksville.com.
+Licensed under the [GPL v3](https://raw.githubusercontent.com/geeksville/starbash/refs/heads/main/LICENSE)

{starbash-0.3.3 → starbash-0.3.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "starbash"
-version = "0.3.3"
+version = "0.3.5"
 description = "A tool for automating/standardizing/sharing astrophotography workflows."
 authors = ["Kevin Hester <kevinh@geeksville.com>"]
 readme = "README.md"
@@ -32,13 +32,13 @@ toml-repo = "^0.1.7"
 
 # Note: to use graxpert from the local tree rather than pypi use:
 # graxpert = {path = "GraXpert", extras = ["cpuonly"], develop = true}
-graxpert = {version = "^3.2.0a2", extras = ["cpuonly"]}
+graxpert = {version = "^3.2.0a3", extras = ["cpuonly"]}
 
 # The following two libs are only needed for the (temporary) experiment of running siril scripts directly...
 # experimenting with siril-scripts/processing/VeraLux_HyperMetric_Stretch.py
 # pyqt6 is used *only* by those out-of-process siril scripts; Starbash itself never imports it,
 # so it can safely coexist with PySide6 (which the GUI *does* import).
-numpy = "2.2.6"
+numpy = ">=2.2.6"
 pyqt6 = "^6.10.1"
 # The desktop GUI (`sb gui`) binding. A normal dependency: the GUI is a first-class
 # way to drive Starbash. "Optional" only means users may keep using the CLI instead.
@@ -61,6 +61,10 @@ doit-graph = ">=0.3.0"
 # harlequin = "^2.4.1"
 library-skills = "^0.0.19"
 semble = {version = "^0.6.0", extras = ["mcp"]}
+imageio-ffmpeg = "^0.6.0"
+
+[tool.poetry.group.packaging.dependencies]
+pyinstaller = ">=6.17.0,<7.0.0"
 
 [tool.poetry.scripts]
 starbash = "starbash.main:app"
@@ -71,6 +75,7 @@ markers = [
     "slow: marks tests as slow (deselect with '-m \"not slow\"')",
     "integration: marks tests as integration tests requiring /test-data (deselect with '-m \"not integration\"')",
     "gui: marks tests that build real Qt widgets (offscreen; deselect with '-m \"not gui\"')",
+    "gui_integration: marks the scripted gui_integration movie runs (needs ffmpeg + /test-data; deselect with '-m \"not gui_integration\"')",
 ]
 # -n auto enables parallel test execution plugin
 # By default we exclude only slow and integration tests. GUI tests DO run: PySide6
@@ -80,7 +85,12 @@ markers = [
 # --tb=short shows shorter tracebacks
 # -rfE shows summary of failed and error test outcomes at end (not passed)
 # --ignore excludes third-party test directories
-addopts = "-m 'not slow and not integration' -n auto --tb=short -rfE --ignore=GraXpert --ignore=starbash-recipes"
+addopts = "-m 'not slow and not integration and not gui_integration' -n auto --tb=short -rfE --ignore=GraXpert --ignore=starbash-recipes"
+
+# Note: the `gui_integration` movies are deselected by default on purpose: they drive a
+# whole user journey (setup wizard -> reindex -> processing run) and take minutes, so they
+# run on demand - `just test-integration-gui`, or `pytest -m gui_integration -n 0`.
+# The marker name uses an underscore so it is usable as `pytest.mark.gui_integration`.
 
 # Note: To limit captured output further, you can:
 # 1. Use --tb=line for minimal tracebacks

{starbash-0.3.3 → starbash-0.3.5}/src/starbash/app.py

@@ -34,6 +34,7 @@ from starbash.check_version import check_version
 from starbash.database import (
     Database,
     ImageRow,
+    RepoRemoval,
     SearchCondition,
     SessionRow,
     get_column_name,
@@ -691,13 +692,21 @@ class Starbash:
         """
         return self._find_user_repo_ref(url) is not None
 
-    def remove_repo_ref(self, url: str) -> None:
+    def remove_repo_ref(self, url: str) -> RepoRemoval:
         """
         Remove a repository reference from the user configuration.
 
+        Also drops everything the repository contributed to the index: its image
+        rows, and the sessions those images built.  A session never spans
+        repositories, so all of its frames go with the repo and there is nothing
+        left for it to describe.
+
         Args:
             url: The repository URL to remove (e.g., 'file:///path/to/repo')
 
+        Returns:
+            A :class:`~starbash.database.RepoRemoval` describing what was dropped.
+
         Raises:
             UserHandledError: If the repository URL is not found in user configuration
         """
@@ -708,12 +717,21 @@ class Starbash:
             # indexed rows would only force a pointless re-index later.
             raise UserHandledError(f"Repository '{url}' not found in user configuration.")
 
-        self.db.remove_repo(url)
+        removal = self.db.remove_repo(url)
         self.user_repo.config.get("repo-ref", []).remove(ref)
 
+        # Drop it from the in-memory manager too: everything that lists repos
+        # (``sb repo list``, the GUI's Repositories page) reads it, so without
+        # this the removed repository keeps showing until the app is restarted.
+        repo = self.repo_manager.get_repo_by_url(url)
+        if repo is not None:
+            self.repo_manager.repos.remove(repo)
+
         # Write the updated config
         self.user_repo.write_config()
 
+        return removal
+
     def _extend_image_header(self, headers: dict[str, Any], full_image_path: Path) -> bool:
         """Given a FITS header dictionary, possibly extend it with additional computed fields.
         Returns True if the header is invalid and should be skipped."""
@@ -810,7 +828,9 @@ class Starbash:
             # (otherwise invariants will get messed up)
             self._add_session(headers)
 
-    def reindex_repo(self, repo: Repo, subdir: str | None = None) -> None:
+    def reindex_repo(
+        self, repo: Repo, subdir: str | None = None, clean: bool = False
+    ) -> RepoRemoval:
         """Scan one repo's files into the database.
 
         Progress is *reported*, never drawn: the scan publishes
@@ -825,17 +845,30 @@ class Starbash:
         Args:
             repo: the repo to scan.
             subdir: scan only this subdirectory of the repo (for debugging).
+            clean: drop the repo's indexed images and sessions before scanning, so
+                every frame counts as a first scan and its session is (re)built.
+
+        Returns:
+            What ``clean`` dropped from the index -- empty when not cleaning.
         """
 
         # make sure this new repo is listed in the repos table
         self.repo_db_update()  # not really ideal, a more optimal version would just add the new repo
 
+        dropped = RepoRemoval()
         path = repo.get_path()
 
         repo_kind = repo.kind()
         if path and repo.is_scheme("file") and repo_kind != "recipe":
             logging.debug("Reindexing %s...", repo.url)
 
+            if clean:
+                # Wiping the repo's rows first is what makes the scan below a
+                # *full* re-read: it skips any frame already indexed, and only
+                # builds a session for one it meets for the first time.
+                dropped = self.db.reset_repo(repo.url)
+                logging.debug("Cleared the index for %s: %s", repo.url, dropped.summary())
+
             if subdir:
                 path = path / subdir
                 # used to debug
@@ -876,15 +909,25 @@ class Starbash:
                 {"repo": repo.url, "indexed": total_files},
             )
 
-    def reindex_repos(self) -> None:
+        return dropped
+
+    def reindex_repos(self, clean: bool = False) -> RepoRemoval:
         """Reindex all repositories managed by the RepoManager.
 
         Reports progress through the event bus only -- see :meth:`reindex_repo`.
+
+        Args:
+            clean: drop each repo's indexed images and sessions before scanning it.
+
+        Returns:
+            What ``clean`` dropped from the index across all repos.
         """
         logging.debug("Reindexing all repositories...")
 
+        dropped = RepoRemoval()
         for repo in self.repo_manager.repos:
-            self.reindex_repo(repo)
+            dropped += self.reindex_repo(repo, clean=clean)
+        return dropped
 
     def get_recipes(self) -> list[Repo]:
         """Get all recipe repos available, sorted by priority (lower number first).

{starbash-0.3.3 → starbash-0.3.5}/src/starbash/commands/repo.py

@@ -9,6 +9,7 @@ from toml_repo import Repo
 import starbash
 from starbash import console
 from starbash.app import Starbash
+from starbash.database import RepoRemoval
 from starbash.paths import get_user_documents_dir
 from starbash.ui.cli import ReindexView
 
@@ -175,9 +176,12 @@ def remove(
             raise typer.Exit(code=1)
         repo_url = repo_to_remove.url
 
-        # Remove the repo reference from user config
-        sb.remove_repo_ref(repo_url)
+        # Remove the repo reference from user config.  That also drops everything
+        # the repo contributed to the index: its frames, and the sessions those
+        # frames built.
+        removal = sb.remove_repo_ref(repo_url)
         console.print(f"[green]Removed repository: {repo_url}[/green]")
+        console.print(removal.summary())
 
 
 @app.command()
@@ -189,6 +193,12 @@ def reindex(
             autocompletion=complete_repo_by_url,
         ),
     ] = None,
+    clean: bool = typer.Option(
+        False,
+        "--clean",
+        help="First drop the repo's indexed images and sessions, so every frame is "
+        "re-read from disk and its sessions are rebuilt.",
+    ),
 ) -> None:
     """
     Reindex a repository by number.
@@ -200,15 +210,20 @@ def reindex(
         # one in this file is the placeholder from starbash.__init__).  The view
         # must draw on the console the scan's own logging goes to.
         repo_to_reindex = repo_url_to_repo(sb, repo_url)
+        dropped = RepoRemoval()
 
         if repo_to_reindex is None:
             with ReindexView.for_console("Re-indexing repositories", starbash.console):
-                sb.reindex_repos()
+                dropped = sb.reindex_repos(clean=clean)
+            if clean:
+                console.print(f"Cleared the index before scanning: {dropped.summary()}")
         else:
             # Get the repo to reindex
             console.print(f"Reindexing repository: {repo_to_reindex.url}")
             with ReindexView.for_console(f"Re-indexing {repo_to_reindex.url}", starbash.console):
-                sb.reindex_repo(repo_to_reindex)
+                dropped = sb.reindex_repo(repo_to_reindex, clean=clean)
+            if clean:
+                console.print(f"Cleared the index before scanning: {dropped.summary()}")
             console.print(f"[green]Successfully reindexed repository {repo_to_reindex}[/green]")
 
 

{starbash-0.3.3 → starbash-0.3.5}/src/starbash/database.py

@@ -16,6 +16,7 @@ type ImageRow = dict[str, Any]
 
 __all__ = [
     "Database",
+    "RepoRemoval",
     "SearchCondition",
     "SessionRow",
     "ImageRow",
@@ -68,6 +69,37 @@ def metadata_to_camera_id(metadata: dict[str, Any]) -> str | None:
     return camera_id
 
 
+@dataclass(frozen=True)
+class RepoRemoval:
+    """What :meth:`Database.remove_repo` dropped from the index.
+
+    Args:
+        images: image rows deleted along with the repository.
+        sessions: sessions deleted, because every frame they held came from it.
+    """
+
+    images: int = 0
+    sessions: int = 0
+
+    def __add__(self, other: RepoRemoval) -> RepoRemoval:
+        """Total two removals, so a multi-repo pass can report one number."""
+        return RepoRemoval(
+            images=self.images + other.images, sessions=self.sessions + other.sessions
+        )
+
+    def summary(self) -> str:
+        """Return a one-line, human readable description of what changed."""
+        dropped: list[str] = []
+        if self.images:
+            dropped.append(f"{self.images} indexed image(s)")
+        if self.sessions:
+            dropped.append(f"{self.sessions} session(s)")
+
+        if not dropped:
+            return "No indexed files or sessions were affected."
+        return "Removed " + " and ".join(dropped) + "."
+
+
 class Database:
     """SQLite-backed application database.
 
@@ -244,21 +276,19 @@ class Database:
         self._db.commit()
 
     # --- Convenience helpers for common repo operations ---
-    def remove_repo(self, url: str) -> None:
-        """Remove a repo record by URL.
+    def _drop_repo_index(self, cursor: sqlite3.Cursor, url: str) -> RepoRemoval:
+        """Delete a repo's images and the sessions those images built.
 
-        This will cascade delete all images belonging to this repo, and all sessions
-        that reference those images via image_doc_id.
-
-        The relationship is: repos -> images (via repo_id) -> sessions (via image_doc_id).
-        Sessions have an image_doc_id field that points to a representative image.
-        We delete sessions whose representative image belongs to the repo being deleted.
+        Shared by :meth:`remove_repo` (which then drops the repo row too) and
+        :meth:`reset_repo` (which keeps it, so the next scan starts clean).
 
         Args:
+            cursor: an open cursor on the application database.
             url: The repository URL (e.g., 'file:///path/to/repo')
-        """
-        cursor = self._db.cursor()
 
+        Returns:
+            A :class:`RepoRemoval` counting the rows that were dropped.
+        """
         # Use a 3-way join to find and delete sessions that reference images from this repo
         # repo_url -> repo_id -> images.id -> sessions.image_doc_id
         cursor.execute(
@@ -274,6 +304,7 @@ class Database:
             """,
             (url,),
         )
+        sessions = cursor.rowcount
 
         # Delete all images from this repo (using repo_id from URL)
         cursor.execute(
@@ -283,12 +314,57 @@ class Database:
             """,
             (url,),
         )
+        return RepoRemoval(images=cursor.rowcount, sessions=sessions)
+
+    def reset_repo(self, url: str) -> RepoRemoval:
+        """
+        Drop everything a repository contributed to the index, keeping the repo.
+
+        Used before a re-scan (``sb repo reindex --clean``): with the image rows
+        gone, every frame the scan meets is a *first* scan, which is the only time
+        :meth:`Starbash.add_image_and_session` builds a session for it.  A plain
+        re-index only refreshes the rows it finds, and never touches the sessions.
+
+        Args:
+            url: The repository URL (e.g., 'file:///path/to/repo')
+
+        Returns:
+            A :class:`RepoRemoval` counting the rows that were dropped.
+        """
+        cursor = self._db.cursor()
+        removal = self._drop_repo_index(cursor, url)
+
+        self._db.commit()
+
+        return removal
+
+    def remove_repo(self, url: str) -> RepoRemoval:
+        """Remove a repo record by URL, along with everything it contributed.
+
+        This cascades to every image belonging to the repo, and to the sessions
+        those images built: a session is only ever fed by one repository, so once
+        its frames are gone there is nothing left for it to describe.
+
+        The relationship is: repos -> images (via repo_id) -> sessions (via
+        image_doc_id, the representative image a session was built from).
+
+        Args:
+            url: The repository URL (e.g., 'file:///path/to/repo')
+
+        Returns:
+            A :class:`RepoRemoval` counting the rows that were dropped.
+        """
+        cursor = self._db.cursor()
+
+        removal = self._drop_repo_index(cursor, url)
 
         # Finally delete the repo itself
         cursor.execute(f"DELETE FROM {self.REPOS_TABLE} WHERE url = ?", (url,))
 
         self._db.commit()
 
+        return removal
+
     def upsert_repo(self, url: str) -> int:
         """Insert or update a repo record by unique URL.
 

{starbash-0.3.3 → starbash-0.3.5}/src/starbash/doit.py

@@ -359,19 +359,19 @@ class ToolAction(BaseAction):
         if input_files:
             desc = f"({len(input_files)} input files)"
 
-        # Some tools might want us to pre merge all the input frames (siril merge command doesn't nicely work with images
-        # of different sizes etc).
-        stage_input: dict[Any, FileInfo] = context["stage_input"]
-        for fi in stage_input.values():
-            perhaps_merge_to(fi)
+        logging.info(f"Running {self.tool.name} for {self.task.name} {desc}")
+        try:
+            # Some tools might want us to pre merge all the input frames (siril merge command doesn't nicely work with images
+            # of different sizes etc).
+            stage_input: dict[Any, FileInfo] = context["stage_input"]
+            for fi in stage_input.values():
+                perhaps_merge_to(fi)
 
-        from starbash.processed_target import ProcessedTarget
+            from starbash.processed_target import ProcessedTarget
 
-        pt: ProcessedTarget = self.task.meta["processed_target"]
-        logfile_path = pt.log_path
+            pt: ProcessedTarget = self.task.meta["processed_target"]
+            logfile_path = pt.log_path
 
-        logging.info(f"Running {self.tool.name} for {self.task.name} {desc}")
-        try:
             with open(logfile_path, "a", encoding="utf-8") as logfile:
                 self.result = self.tool.run(
                     self.commands, context=context, cwd=self.cwd, log_out=logfile, **self.parameters

{starbash-0.3.3 → starbash-0.3.5}/src/starbash/exception.py

@@ -31,7 +31,7 @@ class FilesystemUnavailableError(UserHandledError):
     def __init__(self, operation: str, cause: OSError) -> None:
         super().__init__(
             f"The filesystem became unavailable while {operation}. "
-            "Check that the drive or network mount is connected, then retry."
+            "Check that the drive is connected (and it is not out of space), then retry."
         )
         self.cause = cause