starbash 0.1.0__py3-none-any.whl → 0.1.3__py3-none-any.whl

starbash/selection.py

@@ -0,0 +1,251 @@
+"""Selection state management for filtering sessions and targets."""
+
+from __future__ import annotations
+
+import json
+import logging
+from pathlib import Path
+from typing import Any, Optional
+from datetime import datetime
+
+
+class Selection:
+    """Manages the current selection state for filtering sessions and targets.
+
+    This class maintains persistent state about what the user has selected:
+    - Target names
+    - Date ranges
+    - Filters
+    - Image types
+    - Telescope names
+
+    The selection state is saved to disk and can be used to build database queries.
+    """
+
+    def __init__(self, state_file: Path):
+        """Initialize the Selection with a state file path.
+
+        Args:
+            state_file: Path to the JSON file where selection state is persisted
+        """
+        self.state_file = state_file
+        self.targets: list[str] = []
+        self.date_start: Optional[str] = None
+        self.date_end: Optional[str] = None
+        self.filters: list[str] = []
+        self.image_types: list[str] = []
+        self.telescopes: list[str] = []
+
+        # Load existing state if it exists
+        self._load()
+
+    def _load(self) -> None:
+        """Load selection state from disk."""
+        if self.state_file.exists():
+            try:
+                with open(self.state_file, "r") as f:
+                    data = json.load(f)
+                    self.targets = data.get("targets", [])
+                    self.date_start = data.get("date_start")
+                    self.date_end = data.get("date_end")
+                    self.filters = data.get("filters", [])
+                    self.image_types = data.get("image_types", [])
+                    self.telescopes = data.get("telescopes", [])
+                logging.debug(f"Loaded selection state from {self.state_file}")
+            except Exception as e:
+                logging.warning(f"Failed to load selection state: {e}")
+
+    def _save(self) -> None:
+        """Save selection state to disk."""
+        try:
+            # Ensure parent directory exists
+            self.state_file.parent.mkdir(parents=True, exist_ok=True)
+
+            data = {
+                "targets": self.targets,
+                "date_start": self.date_start,
+                "date_end": self.date_end,
+                "filters": self.filters,
+                "image_types": self.image_types,
+                "telescopes": self.telescopes,
+            }
+
+            with open(self.state_file, "w") as f:
+                json.dump(data, f, indent=2)
+            logging.debug(f"Saved selection state to {self.state_file}")
+        except Exception as e:
+            logging.error(f"Failed to save selection state: {e}")
+
+    def clear(self) -> None:
+        """Clear all selection criteria (select everything)."""
+        self.targets = []
+        self.date_start = None
+        self.date_end = None
+        self.filters = []
+        self.image_types = []
+        self.telescopes = []
+        self._save()
+
+    def add_target(self, target: str) -> None:
+        """Add a target to the selection.
+
+        Args:
+            target: Target name to add to the selection
+        """
+        if target not in self.targets:
+            self.targets.append(target)
+            self._save()
+
+    def remove_target(self, target: str) -> None:
+        """Remove a target from the selection.
+
+        Args:
+            target: Target name to remove from the selection
+        """
+        if target in self.targets:
+            self.targets.remove(target)
+            self._save()
+
+    def add_telescope(self, telescope: str) -> None:
+        """Add a telescope to the selection.
+
+        Args:
+            telescope: Telescope name to add to the selection
+        """
+        if telescope not in self.telescopes:
+            self.telescopes.append(telescope)
+            self._save()
+
+    def remove_telescope(self, telescope: str) -> None:
+        """Remove a telescope from the selection.
+
+        Args:
+            telescope: Telescope name to remove from the selection
+        """
+        if telescope in self.telescopes:
+            self.telescopes.remove(telescope)
+            self._save()
+
+    def set_date_range(
+        self, start: Optional[str] = None, end: Optional[str] = None
+    ) -> None:
+        """Set the date range for the selection.
+
+        Args:
+            start: ISO format date string for start of range (inclusive)
+            end: ISO format date string for end of range (inclusive)
+        """
+        self.date_start = start
+        self.date_end = end
+        self._save()
+
+    def add_filter(self, filter_name: str) -> None:
+        """Add a filter to the selection.
+
+        Args:
+            filter_name: Filter name to add to the selection
+        """
+        if filter_name not in self.filters:
+            self.filters.append(filter_name)
+            self._save()
+
+    def remove_filter(self, filter_name: str) -> None:
+        """Remove a filter from the selection.
+
+        Args:
+            filter_name: Filter name to remove from the selection
+        """
+        if filter_name in self.filters:
+            self.filters.remove(filter_name)
+            self._save()
+
+    def is_empty(self) -> bool:
+        """Check if the selection has any criteria set.
+
+        Returns:
+            True if no selection criteria are active (selecting everything)
+        """
+        return (
+            not self.targets
+            and self.date_start is None
+            and self.date_end is None
+            and not self.filters
+            and not self.image_types
+            and not self.telescopes
+        )
+
+    def get_query_conditions(self) -> dict[str, Any]:
+        """Build query conditions based on the current selection.
+
+        Returns:
+            Dictionary of query conditions that can be used with Database methods.
+            Special keys:
+            - 'date_start': ISO date string for start of range
+            - 'date_end': ISO date string for end of range
+        """
+        conditions = {}
+
+        # Note: This returns a simplified conditions dict.
+        # The actual query building will be enhanced later to support
+        # complex queries with date ranges, multiple targets, etc.
+
+        if self.targets:
+            # For now, just use the first target
+            # TODO: Support multiple targets in queries
+            conditions["OBJECT"] = self.targets[0] if len(self.targets) == 1 else None
+
+        if self.filters:
+            # For now, just use the first filter
+            # TODO: Support multiple filters in queries
+            conditions["FILTER"] = self.filters[0] if len(self.filters) == 1 else None
+
+        if self.telescopes:
+            # For now, just use the first telescope
+            # TODO: Support multiple telescopes in queries
+            conditions["TELESCOP"] = (
+                self.telescopes[0] if len(self.telescopes) == 1 else None
+            )
+
+        # Add date range conditions
+        if self.date_start:
+            conditions["date_start"] = self.date_start
+        if self.date_end:
+            conditions["date_end"] = self.date_end
+
+        return conditions
+
+    def summary(self) -> dict[str, Any]:
+        """Get a summary of the current selection state.
+
+        Returns:
+            Dictionary with human-readable summary of selection criteria
+        """
+        if self.is_empty():
+            return {
+                "status": "all",
+                "message": "No filters active - selecting all sessions",
+            }
+
+        summary = {"status": "filtered", "criteria": []}
+
+        if self.targets:
+            summary["criteria"].append(f"Targets: {', '.join(self.targets)}")
+
+        if self.telescopes:
+            summary["criteria"].append(f"Telescopes: {', '.join(self.telescopes)}")
+
+        if self.date_start or self.date_end:
+            date_range = []
+            if self.date_start:
+                date_range.append(f"from {self.date_start}")
+            if self.date_end:
+                date_range.append(f"to {self.date_end}")
+            summary["criteria"].append(f"Date: {' '.join(date_range)}")
+
+        if self.filters:
+            summary["criteria"].append(f"Filters: {', '.join(self.filters)}")
+
+        if self.image_types:
+            summary["criteria"].append(f"Image types: {', '.join(self.image_types)}")
+
+        return summary

starbash/templates/userconfig.toml

@@ -0,0 +1,53 @@
+# This is your Starbash user configuration file.  It can be used to provide default settings
+# to workflows.
+
+# (or wherever is appropriate for the user's platform).
+
+[repo]
+kind = "preferences"
+
+[analytics]
+# enabled = true # default is true - change to false if you don't want any analytics/crash-reports
+# include_user = false # default is false - change to true if you'd like your email added to crash reports/analytics
+
+[user]
+# default author info
+# name = "Your Name"
+# email = "youremail@somedomain.com"
+# website = "https://yourwebsite"
+# license = "FIXME eventually applied as the default license for generated images Creative commons etc..."
+
+
+# [config]
+# Filters fits fields should we store in our DB cache.  By default we store all fits headers.
+#fits-whitelist = [
+#    "INSTRUME",
+#    "FILTER",
+#    "TELESCOP",
+#    "IMAGETYP",
+#    "DATE-OBS",
+#    "DATE-LOC",
+#    "DATE",
+#    "EXPTIME",  # Use use this instead of EXPOSURE because it seems like not all apps use EXPOSURE (Siril)
+#    "FWHEEL",
+#    "OBJECT",
+#    "RA",       # we ignore the text version OBJCTRA / OBJCTDEC
+#    "DEC",
+#    "OBJCTROT",
+#    "FOCPOS",
+#    "SITELAT",
+#    "SITELON",
+#    "SITEELEV",
+#    "NAXIS1",
+#    "NAXIS2",
+#    "SWCREATE",
+#    "XBINNING",
+#    "YBINNING",
+#    "GAIN",
+#    "CCD-TEMP",
+#    "SET-TEMP",
+#    "AMBTEMP",
+#]
+
+# DO NOT edit below this line, they are managed automatically via
+# the "sb repo add" etc... commands.

starbash/url.py

@@ -0,0 +1,9 @@
+project = "https://github.com/geeksville/starbash"
+analytics_docs = f"{project}/blob/main/doc/analytics.md"
+
+
+def new_issue(report_id: str | None = None) -> str:
+    if report_id:
+        return f"{project}/issues/new?body=Please%20describe%20the%20problem%2C%20but%20include%20this%3A%0ACrash%20ID%20{report_id}"
+    else:
+        return f"{project}/issues/new?body=Please%20describe%20the%20problem"

starbash-0.1.3.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,24 @@
+starbash/__init__.py,sha256=co39eIssQlFxWfO3cDhp52reRy6qEyJX5u5K8OsxiDk,138
+starbash/analytics.py,sha256=0TfiZthKRMqW38Jg1VJDjpykZXBrK33tNKuhQibkCK0,3579
+starbash/app.py,sha256=7GdznZHSxpsQ5ZrW0nPgvSEGAwgijfpbw2rINNU1hcU,16228
+starbash/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+starbash/commands/repo.py,sha256=UyfAD6A0fP8DV1uMRJz_NydDkP0UiHbxtceZ25_g7r8,4641
+starbash/commands/selection.py,sha256=gI6LSvs8CW5t2pW0peCLL5O87WqLkS9LDuaK2gI1NeM,4600
+starbash/commands/user.py,sha256=JpwYa9cYxm2gkekcxrj7CsbJO7fgbGwRxmjvpua0BOY,1598
+starbash/database.py,sha256=59u78srp3G4Ya0HOIP2qOokp2osQPFgUQM_8TbfIjPg,17936
+starbash/defaults/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+starbash/defaults/starbash.toml,sha256=WWM7igZ-GXk4bM7qSFtjHaVh7beqisCkeVBjs7c2G6I,1774
+starbash/main.py,sha256=8D4Xa0WwM3TDW-HkaQUTo79Uh8hAXgOJYyEEkUgC7HQ,5391
+starbash/paths.py,sha256=BKKnSXt3tOh16o7ljDcQLtWKIiepEmud9JFtzRwDHtg,1317
+starbash/repo/__init__.py,sha256=TqspuLjPSNnO38tvCGa0fJvvasgecHl6fE7m0-Lj8ho,148
+starbash/repo/manager.py,sha256=NRMGmDWt8KV8OdsrgPiuQ91EPi8xlSbVtOWGgSePuOk,10944
+starbash/selection.py,sha256=DPzUlls3n-sBqkwTUns2ZNaPi61PGnh7Z_ZQOC1jXYc,8347
+starbash/templates/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+starbash/templates/userconfig.toml,sha256=eaBMgac4RCdvlGV6cKPqRuVyF_ijfkvEF-c3LJ6_euw,1440
+starbash/tool.py,sha256=S1kOTbeHTrA0meqwftgL0SA4VhJdZWWx2h1Wtwu1Izg,8749
+starbash/url.py,sha256=lorxQJ27jSfzsKCb0QvpcvLiPZG55Dkd_c1JPFbni4I,402
+starbash-0.1.3.dist-info/METADATA,sha256=zdFUMvEJQ8Aq28LTkcQDtvY_uu6G7Efy5w2FTH4IH_E,5295
+starbash-0.1.3.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+starbash-0.1.3.dist-info/entry_points.txt,sha256=REQyWs8e5TJsNK7JVVWowKVoytMmKlUwuFHLTmSX4hc,67
+starbash-0.1.3.dist-info/licenses/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
+starbash-0.1.3.dist-info/RECORD,,

{starbash-0.1.0.dist-info → starbash-0.1.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.2.1
 Root-Is-Purelib: true
 Tag: py3-none-any

starbash-0.1.0.dist-info/METADATA

@@ -1,82 +0,0 @@
-Metadata-Version: 2.1
-Name: starbash
-Version: 0.1.0
-Summary: 
-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
-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: tinydb (>=4.8.2,<5.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
-![app icon](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 my personal [TODO](TODO.md) file.  I'll be looking for pre-alpha testers/feedback soon.
-
-## features
-
-* Automatically recognizes and auto-parses the default NINA, Asiair and Seestar raw file repo layouts (adding support for other layouts is easy)
-* Automatically performs preprocessing on OSC (broadband, narrowband or dual Duo filter), Mono (LRGB, SHO) data
-* Multisession support by default (including auto selection of correct flats, biases and dark frames)
-* Generates a per target report/config file which can be customized if the detected defaults are not what you want
-* 'Recipes' provide repeatable/human-readable/sharable descriptions of all processing steps
-* 'Repos' can contain raw files, generated masters, preprocessed files, or recipes.
-* Repos can be on the local disk or shared via HTTPS/github/etc.  This is particularly useful for recipe repos
-
-## Supported commands
-
-* setup - configure for you via a brief guided process
-* info - show user preferences location and other app info
-
-* repo add file/path|URL
-* repo remove REPONAME|REPONUM
-* repo list
-* repo reindex REPONAME|REPONUM|all
-
-* target list
-* target select TARGETNAME
-
-* reset - remove any filters on targets, sessions, etc...
-
-* session list
-* session date after DATE
-* session date before DATE
-
-* instrument list
-
-* export dirs|BIAS|LIGHT|DARK|FLAT [DIRLOC]
-
-* process auto
-
-## Supported tools
-
-* Siril
-* Graxpert
-
-# Future status
-
-## Supported tools
-
-* Pixinsight?
-* Autostakkert?
-
-## Features
-
-* 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
-

starbash-0.1.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-starbash/__init__.py,sha256=co39eIssQlFxWfO3cDhp52reRy6qEyJX5u5K8OsxiDk,138
-starbash/app.py,sha256=8f1OSJPlgSMri8kMFrQ6nac5M1gAgPl-FRnuXeOWMAQ,8754
-starbash/appdefaults.sb.toml,sha256=YTUwTqg2DcDFs9VDB1gqchNqk-hg_cGlpaa134hLOJU,2606
-starbash/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-starbash/commands/repo.py,sha256=Xg9aaaURrv45bJF5w4rsD2X5_FdeM4dp9d9xbGaG4Ds,985
-starbash/database.py,sha256=HFJI0CAQIFfKGx3yTS7anREAcvjiNZhObwyAbD5WD48,2254
-starbash/main.py,sha256=VNV2y8pz_NMbGXjIDuFIDbbS0Q0B5GMqKTXitFf1tb4,579
-starbash/repo/__init__.py,sha256=TqspuLjPSNnO38tvCGa0fJvvasgecHl6fE7m0-Lj8ho,148
-starbash/repo/manager.py,sha256=jOhN-Rx60rtueLsHLoVdvcyWTDOqfUGZN6nbbJzRntI,8586
-starbash/tool.py,sha256=S1kOTbeHTrA0meqwftgL0SA4VhJdZWWx2h1Wtwu1Izg,8749
-starbash-0.1.0.dist-info/LICENSE,sha256=ixuiBLtpoK3iv89l7ylKkg9rs2GzF9ukPH7ynZYzK5s,35148
-starbash-0.1.0.dist-info/METADATA,sha256=N1fSGzjmBFEWL5V7uxbwcGbS3X_UExpxja4cZjA3KIE,2564
-starbash-0.1.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-starbash-0.1.0.dist-info/entry_points.txt,sha256=REQyWs8e5TJsNK7JVVWowKVoytMmKlUwuFHLTmSX4hc,67
-starbash-0.1.0.dist-info/RECORD,,