hamyar_paygah.main
==================

.. py:module:: hamyar_paygah.main

.. autoapi-nested-parse::

   Application entry point for Hamyar Paygah.

   This module contains the startup routine for the application. It ensures
   that the EMS server address is loaded from disk or provided by the user
   before launching the main Qt window.



Attributes
----------

.. autoapisummary::

   hamyar_paygah.main.main_app


Functions
---------

.. autoapisummary::

   hamyar_paygah.main.main


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

.. py:function:: main(app)
   :async:


   Asynchronous entry point for the Qt application.

   This function integrates Qt's application lifecycle with Python's
   asyncio event loop. It establishes a synchronization mechanism that
   allows asynchronous tasks to detect when the Qt application is
   about to shut down and perform a graceful cleanup.

   The function is designed to run inside an asyncio-compatible
   event loop (e.g., ``qasync.QEventLoop``), enabling seamless
   cooperation between Qt's event-driven architecture and asyncio's
   coroutine-based concurrency model.

   :param app: The active Qt application instance whose
               lifecycle is monitored for shutdown events.
   :type app: PySide6.QtWidgets.QApplication


.. py:data:: main_app