pyreduce-astro 0.7a2__tar.gz → 0.7a4__tar.gz

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Changelog
 
 
+## [0.7a4] - 2025-12-23
+
+### Added
+- `reduce examples --run` flag to download and execute examples directly
+- PEP 723 inline metadata in examples for `uv run` compatibility
+
+## [0.7a3] - 2025-12-23
+
+### Added
+- `reduce examples` command to list/download examples from GitHub matching installed version
+
+### Changed
+- CLI startup 12x faster via lazy imports (1.2s -> 0.1s)
+
 ## [0.7a2] - 2025-12-23
 
 ### Added

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyreduce-astro
-Version: 0.7a2
+Version: 0.7a4
 Summary: A data reduction package for echelle spectrographs
 Project-URL: Homepage, https://github.com/ivh/PyReduce
 Project-URL: Documentation, https://pyreduce-astro.readthedocs.io

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/aj_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 AJ instrument example: Fiber bundle tracing with direct function calls.
 

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/crires_plus_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a CRIRES+ dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/custom_instrument_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a sample UVES dataset, and runs the full extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/harpn_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a HARPS-N dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/harps_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a sample HARPS dataset, and runs the full extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/harps_gridsearch.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 import os.path
 
 import matplotlib.pyplot as plt

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/just_one_swath.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 import matplotlib.pyplot as plt
 import numpy as np
 from astropy.io import fits

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/jwst_miri_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a JWST MIRI dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/jwst_niriss_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a sample JWST NIRISS dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/lick_apf_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a Lick APF dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/mcdonald_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a McDonald Observatory dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/metis_ifu_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a simulated METIS dataset, and runs the full extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/metis_lss_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a simulated METIS dataset, and runs the full extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/micado_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a ScopeSim simulated MICADO dataset (with updated spectral layout and updated line lists), and runs the full extraction.

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/neid_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a NEID dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/nirspec_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a sample NIRSPEC dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/toes_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 import numpy as np
 
 from pyreduce.configuration import get_configuration_for_instrument

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/uves_callfunc.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Example showing direct function calls for each step.
 

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/uves_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a sample UVES dataset, and runs the full extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/examples/xshooter_example.py

@@ -1,3 +1,7 @@
+# /// script
+# requires-python = ">=3.13"
+# dependencies = ["pyreduce-astro>=0.7"]
+# ///
 """
 Simple usage example for PyReduce
 Loads a sample XSHOOTER dataset, and runs the extraction

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pyreduce-astro"
-version = "0.7a2"
+version = "0.7a4"
 requires-python = ">=3.11"
 description = "A data reduction package for echelle spectrographs"
 readme = "README.md"

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/pyreduce/__main__.py

@@ -11,11 +11,6 @@ Usage:
 
 import click
 
-from . import datasets
-from .configuration import get_configuration_for_instrument
-from .reduce import main as reduce_main
-from .tools.combine import combine as tools_combine
-
 ALL_STEPS = (
     "bias",
     "flat",
@@ -89,6 +84,9 @@ def run(
     INSTRUMENT: Name of the instrument (e.g., UVES, HARPS, XSHOOTER)
     TARGET: Target star name or regex pattern
     """
+    from .configuration import get_configuration_for_instrument
+    from .reduce import main as reduce_main
+
     # Parse steps
     if steps:
         steps = tuple(s.strip() for s in steps.split(","))
@@ -128,6 +126,8 @@ def combine(files, output, plot):
 
     FILES: Input .final.fits files to combine
     """
+    from .tools.combine import combine as tools_combine
+
     tools_combine(list(files), output, plot=plot)
 
 
@@ -138,6 +138,8 @@ def download(instrument):
 
     INSTRUMENT: Name of the instrument (e.g., UVES, HARPS)
     """
+    from . import datasets
+
     instrument = instrument.upper()
     dataset_func = getattr(datasets, instrument, None)
     if dataset_func is None:
@@ -153,6 +155,117 @@ def download(instrument):
     click.echo(f"Dataset downloaded to: {path}")
 
 
+@cli.command()
+@click.argument("filename", required=False)
+@click.option(
+    "--list", "-l", "list_examples", is_flag=True, help="List available examples"
+)
+@click.option("--all", "-a", "download_all", is_flag=True, help="Download all examples")
+@click.option("--run", "-r", is_flag=True, help="Run the example after downloading")
+@click.option("--output", "-o", default=".", help="Output directory")
+def examples(filename, list_examples, download_all, run, output):
+    """List, download, or run example scripts from GitHub.
+
+    Downloads examples matching your installed PyReduce version.
+
+    \b
+    Examples:
+        reduce examples                     # List available examples
+        reduce examples uves_example.py     # Download to current dir
+        reduce examples -r uves_example.py  # Download and run
+        reduce examples --all -o ~/scripts  # Download all to ~/scripts
+    """
+    import json
+    import os
+    import subprocess
+    import sys
+    import tempfile
+    import urllib.request
+    from urllib.error import HTTPError
+
+    from pyreduce import __version__
+
+    version = __version__.split("+")[0]
+    if version == "unknown":
+        raise click.ClickException(
+            "Cannot determine package version. Install from PyPI or a tagged release."
+        )
+
+    github_api = (
+        f"https://api.github.com/repos/ivh/PyReduce/contents/examples?ref=v{version}"
+    )
+    github_raw = f"https://raw.githubusercontent.com/ivh/PyReduce/v{version}/examples"
+
+    # Fetch list of examples from GitHub API
+    try:
+        with urllib.request.urlopen(github_api) as resp:
+            contents = json.loads(resp.read().decode())
+    except HTTPError as e:
+        if e.code == 404:
+            raise click.ClickException(
+                f"Tag v{version} not found on GitHub. "
+                "Try installing a released version."
+            ) from None
+        raise click.ClickException(f"GitHub API error: {e}") from None
+
+    example_files = sorted(f["name"] for f in contents if f["name"].endswith(".py"))
+
+    # List mode
+    if list_examples or (not filename and not download_all):
+        click.echo(f"Available examples for v{version}:")
+        for name in example_files:
+            click.echo(f"  {name}")
+        return
+
+    if run and download_all:
+        raise click.ClickException("Cannot use --run with --all")
+
+    # Run mode: download to temp and execute
+    if run:
+        if filename not in example_files:
+            raise click.ClickException(
+                f"Unknown example '{filename}'. Use 'reduce examples --list' to see available."
+            )
+        url = f"{github_raw}/{filename}"
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".py", delete=False) as f:
+            try:
+                with urllib.request.urlopen(url) as resp:
+                    f.write(resp.read().decode())
+                temp_path = f.name
+            except HTTPError as e:
+                raise click.ClickException(
+                    f"Failed to download {filename}: {e}"
+                ) from None
+        try:
+            click.echo(f"Running {filename}...")
+            result = subprocess.run([sys.executable, temp_path], check=False)
+            sys.exit(result.returncode)
+        finally:
+            os.unlink(temp_path)
+
+    # Ensure output directory exists
+    os.makedirs(output, exist_ok=True)
+
+    def download_file(name):
+        url = f"{github_raw}/{name}"
+        dest = os.path.join(output, name)
+        try:
+            urllib.request.urlretrieve(url, dest)
+            click.echo(f"Downloaded: {dest}")
+        except HTTPError as e:
+            click.echo(f"Failed to download {name}: {e}", err=True)
+
+    if download_all:
+        for name in example_files:
+            download_file(name)
+    else:
+        if filename not in example_files:
+            raise click.ClickException(
+                f"Unknown example '{filename}'. Use 'reduce examples --list' to see available."
+            )
+        download_file(filename)
+
+
 @cli.command("list-steps")
 def list_steps():
     """List all available reduction steps."""
@@ -174,6 +287,9 @@ def make_step_command(step_name):
     @click.option("--output-dir", "-o", default="reduced", help="Output directory")
     @click.option("--plot", "-p", default=0, help="Plot level")
     def cmd(instrument, target, night, arm, base_dir, input_dir, output_dir, plot):
+        from .configuration import get_configuration_for_instrument
+        from .reduce import main as reduce_main
+
         config = get_configuration_for_instrument(instrument)
         reduce_main(
             instrument=instrument,

{pyreduce_astro-0.7a2 → pyreduce_astro-0.7a4}/uv.lock

@@ -1456,7 +1456,7 @@ wheels = [
 
 [[package]]
 name = "pyreduce-astro"
-version = "0.7.0a2"
+version = "0.7a4"
 source = { editable = "." }
 dependencies = [
     { name = "astropy" },