Metadata-Version: 1.1
Name: xmppcat
Version: 0.1.1
Summary: CLI application that works like cat but sends its output through xmpp
Home-page: http://github.com/mtorromeo/xmppcat
Author: Massimiliano Torromeo
Author-email: massimiliano.torromeo@gmail.com
License: BSD License
Download-URL: http://github.com/mtorromeo/xmppcat/tarball/v0.1.1
Description: xmppcat
        =======
        
        A unix command line program that works like *cat* but sends its output through XMPP.
        
        Help
        ----
        
        ::
        
        	usage: xmppcat [-h] [-V] [-c CONFIG] [-H HOST] [-P PORT] [-u USER] [-p PWD]
        	               [-q] [-d] [-v]
        	               recipient [file]
        
        	CLI application that works like cat but sends its output through xmpp
        
        	positional arguments:
        	recipient             The XMPP jid to send the message to
        	file                  The file to read. If not specified it will be read
        	                      from STDIN
        
        	optional arguments:
        	-h, --help            show this help message and exit
        	-V, --version         show program's version number and exit
        	-c CONFIG, --config CONFIG
        	                      Use a different configuration file
        	-H HOST, --host HOST  XMPP host (xmppcat will try to auto detect it with DNS
        	                      or JID parsing)
        	-P PORT, --port PORT  XMPP port
        	-u USER, --user USER  XMPP username (JID)
        	-p PWD, --pass PWD    XMPP password
        
        	output arguments:
        	-q, --quiet           Suppress any non-error output
        	-d, --debug           Enable debugging output
        	-v, --verbose         Show additional connection informations
        
        Configuration file
        ------------------
        
        The program requires several arguments to be specified in order to be able to connect and authenticate to a XMPP server.
        To simplify this process you can save this options in a configuration file, either globally in */etc/xmppcat.conf* or locally in *$HOME/.xmppcat.conf*.
        
        This is an example of a configuration file for xmppcat::
        
        	[DEFAULT]
        	user = myuser@jabber.org/xmppcat
        	pass = mypassword
        	host = jabber.org # can be autodetected by dnspython
        	port = 5222 # also autodetectable
        
        Example usage
        -------------
        
        ::
        
        	echo "Hello world!" | xmppcat recipient@jabber.org
        	xmppcat recipient@jabber.org file.txt
        
        LICENSE
        -------
        Copyright (c) 2012 Massimiliano Torromeo
        
        xmppcat is free software released under the terms of the BSD license.
        
        See the LICENSE file provided with the source distribution for full details.
        
        Contacts
        --------
        
        * Massimiliano Torromeo <massimiliano.torromeo@gmail.com>
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: POSIX :: BSD
Classifier: Natural Language :: English
