fleche.__main__
===============

.. py:module:: fleche.__main__

.. autoapi-nested-parse::

   ``python -m fleche <command> ...`` dispatcher.

   Currently the only subcommand is ``remote``, which runs the cache RPC
   server :class:`fleche.remote.SshCache` connects to.  Register additional
   subcommands by adding a parser in :func:`_build_parser` and a branch in
   :func:`_main`.

   The CLI deliberately lives here rather than inside ``fleche.remote``:
   the package's ``__init__`` transitively imports ``fleche.remote`` (e.g.
   through :mod:`fleche.config`), so invoking the server as
   ``python -m fleche.remote`` would load ``remote.py`` twice — once as the
   submodule and once as ``__main__`` — and emit the ``runpy`` "found in
   sys.modules ... prior to execution" warning, with two separate copies of
   every class and exception in the file.  ``__main__.py`` is never imported
   as a submodule, so routing through it avoids the duplicate.



Functions
---------

.. autoapisummary::

   fleche.__main__._build_parser
   fleche.__main__._main


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

.. py:function:: _build_parser() -> argparse.ArgumentParser

.. py:function:: _main(argv: list[str]) -> int