Metadata-Version: 2.1
Name: cs.x
Version: 20180726
Summary: X(), for low level debugging
Home-page: https://bitbucket.org/cameron_simpson/css/commits/all
Author: Cameron Simpson
Author-email: cs@cskk.id.au
License: UNKNOWN
Description: X() is my function for low level ad hoc debug messages.
        It takes a message and optional format arguments for use with `%`.
        It is presented here in its own module for reuse.
        
        It normally writes directly to `sys.stderr` but accepts an optional
        keyword argument `file` to specify a different filelike object.
        If `file` is not specified, its behaviour is further tweaked with
        the globals `X_logger` or `X_via_tty`:
        if X_logger then log a warning to that logger;
        otherwise, if X_via_tty then open /dev/tty and write the message to it;
        otherwise, write the message to sys.stderr.
        
        ## Function `X(msg, *args, **kw)`
        
        Unconditionally write the message `msg`.
        
        * `args`: if not empty, format `msg` using %-expansion with `args`.
        * `file`: optional keyword argument specifying the output file.
        
        If `file` is not None, write to it unconditionally;
        otherwise, if X_logger then log a warning to that logger;
        otherwise, if X_via_tty then open /dev/tty and write the message to it;
        otherwise write the message to sys.stderr.
Keywords: python2,python3
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Description-Content-Type: text/markdown
