build_tools.syllable_walk_web.cli
=================================

.. py:module:: build_tools.syllable_walk_web.cli

.. autoapi-nested-parse::

   Command-line interface for the Pipe-Works Build Tools web application.

   Provides ``python -m build_tools.syllable_walk_web`` entry point.



Classes
-------

.. autoapisummary::

   build_tools.syllable_walk_web.cli.BuildToolsSettings


Functions
---------

.. autoapisummary::

   build_tools.syllable_walk_web.cli.load_build_tools_settings
   build_tools.syllable_walk_web.cli.create_argument_parser
   build_tools.syllable_walk_web.cli.parse_arguments
   build_tools.syllable_walk_web.cli.main


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

.. py:class:: BuildToolsSettings

   Settings loaded from the ``[build_tools]`` INI section.

   .. attribute:: output_base

      Base directory for pipeline run discovery.

   .. attribute:: sessions_dir

      Optional explicit session storage directory.

   .. attribute:: corpus_dir_a

      Directory containing runs to auto-load into Patch A.

   .. attribute:: corpus_dir_b

      Directory containing runs to auto-load into Patch B.

   .. attribute:: port

      Optional explicit port. ``None`` means auto-select.

   .. attribute:: verbose

      Print startup/runtime messages when True.


   .. py:attribute:: output_base
      :type:  pathlib.Path | None
      :value: None



   .. py:attribute:: sessions_dir
      :type:  pathlib.Path | None
      :value: None



   .. py:attribute:: corpus_dir_a
      :type:  str | None
      :value: None



   .. py:attribute:: corpus_dir_b
      :type:  str | None
      :value: None



   .. py:attribute:: port
      :type:  int | None
      :value: None



   .. py:attribute:: verbose
      :type:  bool
      :value: True



.. py:function:: load_build_tools_settings(config_path)

   Load build-tools settings from the ``[build_tools]`` INI section.

   :param config_path: Path to INI file. If missing/None, defaults are used.

   :returns: Parsed ``BuildToolsSettings`` instance.


.. py:function:: create_argument_parser()

   Create and return the argument parser for the web server.

   :returns: Configured ArgumentParser ready to parse command-line arguments.


.. py:function:: parse_arguments(args = None)

   Parse command-line arguments.

   :param args: Argument list (defaults to sys.argv[1:]).

   :returns: Parsed arguments namespace.


.. py:function:: main(args = None)

   CLI entry point.

   :returns: 0 for success, 1 for error, 130 for keyboard interrupt.
   :rtype: Exit code