casanovoutils.main
==================

.. py:module:: casanovoutils.main

.. autoapi-nested-parse::

   Top-level CLI entry point for casanovoutils.

   Builds a nested command dict from each submodule's COMMANDS constant and
   exposes them as a single ``casanovoutils`` CLI via ``fire``.

   Submodules are auto-detected: any module with a ``COMMANDS`` constant is
   included. The CLI key is taken from a ``CLI_NAME`` constant if present,
   otherwise the module name with a trailing ``utils`` suffix stripped.



Functions
---------

.. autoapisummary::

   casanovoutils.main.main


Module Contents
---------------

.. py:function:: main() -> None

   Entry point for the ``casanovoutils`` CLI.

   Scans all submodules of this package for a ``COMMANDS`` constant and
   builds a nested command dict to pass to ``fire.Fire``.  The top-level
   key for each submodule is taken from its ``CLI_NAME`` constant if one
   exists, otherwise the bare module name is used.

   To expose a new group of commands, add a ``COMMANDS`` dict to any
   submodule.