lsurf 1.0.0__py3-none-any.whl

lsurf/cli/main.py

@@ -0,0 +1,81 @@
+# The Clear BSD License
+#
+# Copyright (c) 2026 Tobias Heibges
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted (subject to the limitations in the disclaimer
+# below) provided that the following conditions are met:
+#
+#      * Redistributions of source code must retain the above copyright notice,
+#      this list of conditions and the following disclaimer.
+#
+#      * Redistributions in binary form must reproduce the above copyright
+#      notice, this list of conditions and the following disclaimer in the
+#      documentation and/or other materials provided with the distribution.
+#
+#      * Neither the name of the copyright holder nor the names of its
+#      contributors may be used to endorse or promote products derived from this
+#      software without specific prior written permission.
+#
+# NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE GRANTED BY
+# THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
+# CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
+# IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+"""L-SURF CLI main entry point.
+
+This module defines the Click CLI group and registers all commands.
+"""
+
+import click
+
+from . import __version__
+from .build import build
+from .gui_cmd import gui
+from .run import run
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="lsurf")
+@click.option("-v", "--verbose", is_flag=True, help="Enable verbose output.")
+@click.pass_context
+def cli(ctx: click.Context, verbose: bool) -> None:
+    """L-SURF: GPU-accelerated ray tracing simulation toolkit.
+
+    Build geometry configurations and run ray tracing simulations
+    from the command line.
+
+    \b
+    Examples:
+        # Build a configuration interactively
+        lsurf build -o simulation.yaml
+
+        # Build from a template
+        lsurf build --template ocean -o ocean_sim.yaml
+
+        # Run a simulation
+        lsurf run simulation.yaml --progress
+
+        # Validate a configuration
+        lsurf run simulation.yaml --dry-run
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["verbose"] = verbose
+
+
+cli.add_command(build)
+cli.add_command(gui)
+cli.add_command(run)
+
+
+if __name__ == "__main__":
+    cli()