.. _fbf.lib.exit:

exit
~~~~

.. automodule:: fbf.lib.exit
        :show-inheritance:
        :members:
        :undoc-members:

CODE
----

    ::

        # fbf/exit.py
        #
        #
        
        """ fbf's finaliser """
        
.. _fbf.lib.exit_fbf_imports:

fbf imports
--------------

    ::

        
        from fbf.utils.locking import globallocked
        from fbf.utils.exception import handle_exception
        from fbf.utils.trace import whichmodule
        from fbf.memcached import killmcdaemon
        from fbf.lib.persist import cleanup
        from .runner import defaultrunner, cmndrunner, callbackrunner, waitrunner
        
.. _fbf.lib.exit_basic_imports:

basic imports
----------------

    ::

        
        import atexit
        import os
        import time
        import sys
        import logging
        
.. _fbf.lib.exit_functions_:

functions
------------

    ::

        
        @globallocked
        def globalshutdown(exit=True):
            """ shutdown the bot. """
            try:
                try: sys.stdout.write("\n")
                except: pass
                logging.error('shutting down'.upper())
                from .fleet import getfleet
                fleet = getfleet()
                if fleet:
                    logging.warn('shutting down fleet')
                    fleet.exit()
                logging.warn('shutting down plugins')
                from fbf.lib.plugins import plugs
                plugs.exit()
                logging.warn("shutting down runners")
                cmndrunner.stop()
                callbackrunner.stop()
                waitrunner.stop()
                logging.warn("cleaning up any open files")
                while cleanup(): time.sleep(1)
                try: os.remove('fbf.pid')
                except: pass
                killmcdaemon()
                logging.warn('done')
                print("")
                if exit: os._exit(0)
            except Exception as ex:
                print(str(ex))
                if exit: os._exit(1)