.. _fbf.plugs.core.tail:

tail
~~~~

.. automodule:: fbf.plugs.core.tail
        :show-inheritance:
        :members:
        :undoc-members:

CODE
----

    ::

        # fbf/plugs/core/tail.py
        #
        #
        
        """ tail bot results. """
        
.. _fbf.plugs.core.tail_fbf_imports:

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

    ::

        
        from fbf.utils.generic import waitforqueue
        from fbf.lib.commands import cmnds
        from fbf.lib.examples import examples
        
.. _fbf.plugs.core.tail_basic_imports:

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

    ::

        
        import time
        
.. _fbf.plugs.core.tail_tail_command:

tail command
---------------

    ::

        
        def handle_tail(bot, ievent):
            """ no arguments - show last <nr> elements, use this command in a pipeline. """
            try: nr = int(ievent.args[0])
            except (ValueError, IndexError): nr = 3
            if not ievent.inqueue: time.sleep(0.5)
            ievent.reply('results: ', list(ievent.inqueue)[-nr:])
            
        cmnds.add('tail', handle_tail, ['OPER', 'USER', 'GUEST'])
        examples.add('tail', 'show last <nr> lines of pipeline output', 'list ! tail 5')