starbash 0.1.9__tar.gz → 0.1.11__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starbash
-Version: 0.1.9
+Version: 0.1.11
 Summary: A tool for automating/standardizing/sharing astrophotography workflows.
 License-File: LICENSE
 Author: Kevin Hester
@@ -33,6 +33,7 @@ A tool for automating/standardizing/sharing astrophotography workflows.
 * Automatic - with sensible defaults, that you can change as needed.
 * Easy - provides a 'seestar like' starting-point for autoprocessing all your sessions (by default).
 * Fast - even with large image repositories.  Automatic master bias and flat generation and reasonable defaults
+* Multi-session - by default.  So your workflows can stack from multiple nights (and still use the correct flats etc...)
 * Sharable - you can share/use recipes for image preprocessing flows.
 
 (This project is currently 'alpha' and missing recipes for some workflows, but adding new recipes is easy and we're happy to help.  Please file a github issue if your images are not auto-processed and we'll work out a fix.)
@@ -89,7 +90,7 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 
 ### Repository Management
 - `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 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)
 
@@ -113,6 +114,7 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 - `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
+- `sb info master [KIND]` - List all precalculated master images (darks, biases, flats). Optional KIND argument to filter by image type (e.g., BIAS, DARK, FLAT)
 
 ## Not yet supported commands
 
@@ -142,4 +144,4 @@ Project members can access crash reports [here](https://geeksville.sentry.io/ins
 ## License
 
 Copyright 2025 Kevin Hester, kevinh@geeksville.com.
-Licensed under the (GPL v3)[LICENSE]
+Licensed under the [GPL v3](LICENSE)

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

@@ -11,6 +11,7 @@ A tool for automating/standardizing/sharing astrophotography workflows.
 * Automatic - with sensible defaults, that you can change as needed.
 * Easy - provides a 'seestar like' starting-point for autoprocessing all your sessions (by default).
 * Fast - even with large image repositories.  Automatic master bias and flat generation and reasonable defaults
+* Multi-session - by default.  So your workflows can stack from multiple nights (and still use the correct flats etc...)
 * Sharable - you can share/use recipes for image preprocessing flows.
 
 (This project is currently 'alpha' and missing recipes for some workflows, but adding new recipes is easy and we're happy to help.  Please file a github issue if your images are not auto-processed and we'll work out a fix.)
@@ -67,7 +68,7 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 
 ### Repository Management
 - `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 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)
 
@@ -91,6 +92,7 @@ FIXME - add getting started instructions (possibly with a screenshare video)
 - `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
+- `sb info master [KIND]` - List all precalculated master images (darks, biases, flats). Optional KIND argument to filter by image type (e.g., BIAS, DARK, FLAT)
 
 ## Not yet supported commands
 
@@ -120,4 +122,4 @@ Project members can access crash reports [here](https://geeksville.sentry.io/ins
 ## License
 
 Copyright 2025 Kevin Hester, kevinh@geeksville.com.
-Licensed under the (GPL v3)[LICENSE]
+Licensed under the [GPL v3](LICENSE)

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "starbash"
-version = "0.1.9"
+version = "0.1.11"
 description = "A tool for automating/standardizing/sharing astrophotography workflows."
 authors = ["Kevin Hester <kevinh@geeksville.com>"]
 readme = "README.md"

starbash-0.1.11/src/starbash/aliases.py

@@ -0,0 +1,100 @@
+import string
+
+
+_translator = str.maketrans("", "", string.punctuation + string.whitespace)
+
+
+def normalize_target_name(name: str | None) -> str | None:
+    """Converts a target name to an any filesystem-safe format by removing spaces"""
+    if name is None:
+        return None
+    return name.replace(" ", "").lower()
+
+
+def pre_normalize(name: str) -> str:
+    """Pre-normalize a name by removing all whitespace and punctuation, and converting to lowercase.
+
+    Args:
+        name: The name to pre-normalize.
+
+    Returns:
+        Normalized string with only alphanumeric characters in lowercase.
+    """
+    # Create translation table that removes all punctuation and whitespace
+    return name.lower().translate(_translator)
+
+
+class UnrecognizedAliasError(ValueError):
+    """Exception raised when an unrecognized alias is encountered during normalization."""
+
+    pass
+
+
+class Aliases:
+    def __init__(self, alias_dict: dict[str, list[str]]):
+        """Initialize the Aliases object with a dictionary mapping keys to their alias lists.
+
+        The alias_dict structure follows the TOML format:
+        - Keys are reference names used in code (e.g., "dark", "flat", "bias", "fits", "SiiOiii", "HaOiii")
+        - Values are lists of aliases where the FIRST item is the canonical/preferred name
+        - The dictionary key may or may not match the canonical name
+
+        Example from TOML:
+            [aliases]
+            dark = ["dark", "darks"]           # key "dark" -> canonical "dark"
+            flat = ["flat", "flats"]           # key "flat" -> canonical "flat"
+            SiiOiii = ["SiiOiii", "SII-OIII", "S2-O3"]  # key "SiiOiii" -> canonical "SiiOiii"
+        """
+        self.alias_dict = alias_dict
+        self.reverse_dict = {}
+
+        # Build reverse lookup: any alias variant maps to canonical name
+        for _key, aliases in alias_dict.items():
+            if not aliases:
+                continue
+            # The first item in the list is ALWAYS the canonical/preferred form
+            canonical = aliases[0]
+            for alias in aliases:
+                # Map each alias (case-insensitive) to the canonical form (first in list)
+                # Also remove spaces, hypens and underscores when matching for normalization
+                self.reverse_dict[pre_normalize(alias)] = canonical
+
+    def get(self, name: str) -> list[str] | None:
+        """Get the list of aliases for a given key name.
+
+        Args:
+            name: The key name to look up (as used in code/TOML)
+
+        Returns:
+            List of all aliases for this key, or None if not found.
+            The first item in the returned list is the canonical form.
+        """
+        return self.alias_dict.get(name)
+
+    def normalize(self, name: str) -> str:
+        """Normalize a name to its canonical form using aliases.
+
+        This performs case-insensitive matching to find the canonical form.
+        The canonical form is the first item in the alias list from the TOML.
+
+        Args:
+            name: The name to normalize (e.g., "darks", "FLAT", "HA-OIII")
+
+        Returns:
+            The canonical/preferred form (e.g., "dark", "flat", "HaOiii"), or None if not found
+
+        Examples:
+            normalize("darks") -> "dark"
+            normalize("FLAT") -> "flat"
+            normalize("HA-OIII") -> "HaOiii"
+        """
+        result = self.reverse_dict.get(pre_normalize(name))
+        if not result:
+            raise UnrecognizedAliasError(f"'{name}' not found in aliases.")
+        return result
+
+    def equals(self, name1: str, name2: str) -> bool:
+        """Check if two names are equivalent based on aliases."""
+        norm1 = self.normalize(name1.strip())
+        norm2 = self.normalize(name2.strip())
+        return norm1 == norm2