.. _fbf.lib.aliases:

aliases
~~~~~~~

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

CODE
----

    ::

        # fbf/lib/aliases.py
        #
        #
        
        """ global aliases. """
        
.. _fbf.lib.aliases_fbf_imports:

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

    ::

        
        from fbf.lib.datadir import getdatadir
        from fbf.utils.lazydict import LazyDict
        
.. _fbf.lib.aliases_basic_imports:

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

    ::

        
        import os
        import logging
        
.. _fbf.lib.aliases_defines_:

defines
----------

    ::

        
        aliases = LazyDict()
        
.. _fbf.lib.aliases_getaliases_function:

getaliases function
----------------------

    ::

        
        def getaliases(ddir=None, force=True):
            """ return global aliases. """
            global aliases
            if not aliases or force:
                from fbf.lib.persist import Persist
                from fbf.utils.lazydict import LazyDict
                d = ddir or getdatadir()
                p = Persist(d + os.sep + "run" + os.sep + "aliases")
                if not p.data: p.data = LazyDict()
                aliases = p.data
            return aliases
        
        def savealiases(ddir=None):
            """ return global aliases. """
            global aliases
            if aliases:
                logging.warn("saving aliases")
                from fbf.lib.persist import Persist
                from fbf.utils.lazydict import LazyDict
                d = ddir or getdatadir()
                p = Persist(d + os.sep + "run" + os.sep + "aliases")
                p.data = aliases
                p.save()
            return aliases
        
        def aliascheck(ievent):
            """ check if alias is available. """
            if not ievent.execstr: return
            try:
                cmnd = ievent.execstr.split()[0]
                alias = aliases[cmnd]
                ievent.txt = ievent.txt.replace(cmnd, alias, 1)
                ievent.execstr = ievent.execstr.replace(cmnd, alias, 1)
                ievent.alias = alias
                ievent.aliased = cmnd
                ievent.prepare()
            except (IndexError, KeyError): pass
        
        
        def size():
            return len(aliases)
        
        def setalias(first, second):
            global aliases
            aliases[first] = second