parseur.server
==============

.. py:module:: parseur.server


Attributes
----------

.. autoapisummary::

   parseur.server.LOCAL_PORT


Functions
---------

.. autoapisummary::

   parseur.server.start_flask
   parseur.server.start_localtunnel
   parseur.server.check_localtunnel
   parseur.server.create_app
   parseur.server.run_listener


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

.. py:data:: LOCAL_PORT
   :value: 31313


.. py:function:: start_flask(app)

   Run Flask silently (no dev warning, no werkzeug logs).


.. py:function:: start_localtunnel()

   Start localtunnel via npx and parse 'your url is:' output.


.. py:function:: check_localtunnel()

   Verify that `npx` and `localtunnel` are installed.


.. py:function:: create_app(redirect_url=None, silent=False)

   Create and configure a Flask app that:
   - Logs incoming webhook events
   - Optionally forwards them to redirect_url


.. py:function:: run_listener(event, mailbox_id, table_field_id, headers, name, redirect_url=None, silent=False)

   - Check localtunnel installation
   - Start Flask server
   - Start localtunnel and get public URL
   - Create webhook in Parseur with provided options
   - Print and forward live events