169 lines
6.1 KiB
Python
Executable file
169 lines
6.1 KiB
Python
Executable file
#!/usr/bin/env python3
|
|
|
|
# Slixmpp: The Slick XMPP Library
|
|
# Copyright (C) 2010 Nathanael C. Fritz
|
|
# This file is part of Slixmpp.
|
|
# See the file LICENSE for copying permission.
|
|
|
|
import logging
|
|
from getpass import getpass
|
|
from argparse import ArgumentParser
|
|
|
|
import slixmpp
|
|
|
|
|
|
class CommandBot(slixmpp.ClientXMPP):
|
|
|
|
"""
|
|
A simple Slixmpp bot that provides a basic
|
|
adhoc command.
|
|
"""
|
|
|
|
def __init__(self, jid, password):
|
|
slixmpp.ClientXMPP.__init__(self, jid, password)
|
|
|
|
# The session_start event will be triggered when
|
|
# the bot establishes its connection with the server
|
|
# and the XML streams are ready for use. We want to
|
|
# listen for this event so that we we can initialize
|
|
# our roster.
|
|
self.add_event_handler("session_start", self.start)
|
|
|
|
async def start(self, event):
|
|
"""
|
|
Process the session_start event.
|
|
|
|
Typical actions for the session_start event are
|
|
requesting the roster and broadcasting an initial
|
|
presence stanza.
|
|
|
|
Arguments:
|
|
event -- An empty dictionary. The session_start
|
|
event does not provide any additional
|
|
data.
|
|
"""
|
|
self.send_presence()
|
|
await self.get_roster()
|
|
|
|
# We add the command after session_start has fired
|
|
# to ensure that the correct full JID is used.
|
|
|
|
# If using a component, may also pass jid keyword parameter.
|
|
|
|
self['xep_0050'].add_command(node='greeting',
|
|
name='Greeting',
|
|
handler=self._handle_command)
|
|
|
|
def _handle_command(self, iq, session):
|
|
"""
|
|
Respond to the initial request for a command.
|
|
|
|
Arguments:
|
|
iq -- The iq stanza containing the command request.
|
|
session -- A dictionary of data relevant to the command
|
|
session. Additional, custom data may be saved
|
|
here to persist across handler callbacks.
|
|
"""
|
|
form = self['xep_0004'].make_form('form', 'Greeting')
|
|
form['instructions'] = 'Send a custom greeting to a JID'
|
|
form.addField(var='greeting',
|
|
ftype='text-single',
|
|
label='Your greeting')
|
|
|
|
session['payload'] = form
|
|
session['next'] = self._handle_command_complete
|
|
session['has_next'] = False
|
|
|
|
# Other useful session values:
|
|
# session['to'] -- The JID that received the
|
|
# command request.
|
|
# session['from'] -- The JID that sent the
|
|
# command request.
|
|
# session['has_next'] = True -- There are more steps to complete
|
|
# session['allow_complete'] = True -- Allow user to finish immediately
|
|
# and possibly skip steps
|
|
# session['cancel'] = handler -- Assign a handler for if the user
|
|
# cancels the command.
|
|
# session['notes'] = [ -- Add informative notes about the
|
|
# ('info', 'Info message'), command's results.
|
|
# ('warning', 'Warning message'),
|
|
# ('error', 'Error message')]
|
|
|
|
return session
|
|
|
|
def _handle_command_complete(self, payload, session):
|
|
"""
|
|
Process a command result from the user.
|
|
|
|
Arguments:
|
|
payload -- Either a single item, such as a form, or a list
|
|
of items or forms if more than one form was
|
|
provided to the user. The payload may be any
|
|
stanza, such as jabber:x:oob for out of band
|
|
data, or jabber:x:data for typical data forms.
|
|
session -- A dictionary of data relevant to the command
|
|
session. Additional, custom data may be saved
|
|
here to persist across handler callbacks.
|
|
"""
|
|
|
|
# In this case (as is typical), the payload is a form
|
|
form = payload
|
|
|
|
greeting = form['values']['greeting']
|
|
|
|
self.send_message(mto=session['from'],
|
|
mbody="%s, World!" % greeting,
|
|
mtype='chat')
|
|
|
|
# Having no return statement is the same as unsetting the 'payload'
|
|
# and 'next' session values and returning the session.
|
|
|
|
# Unless it is the final step, always return the session dictionary.
|
|
|
|
session['payload'] = None
|
|
session['next'] = None
|
|
|
|
return session
|
|
|
|
|
|
if __name__ == '__main__':
|
|
# Setup the command line arguments.
|
|
parser = ArgumentParser()
|
|
|
|
# Output verbosity options.
|
|
parser.add_argument("-q", "--quiet", help="set logging to ERROR",
|
|
action="store_const", dest="loglevel",
|
|
const=logging.ERROR, default=logging.INFO)
|
|
parser.add_argument("-d", "--debug", help="set logging to DEBUG",
|
|
action="store_const", dest="loglevel",
|
|
const=logging.DEBUG, default=logging.INFO)
|
|
|
|
# JID and password options.
|
|
parser.add_argument("-j", "--jid", dest="jid",
|
|
help="JID to use")
|
|
parser.add_argument("-p", "--password", dest="password",
|
|
help="password to use")
|
|
|
|
args = parser.parse_args()
|
|
|
|
# Setup logging.
|
|
logging.basicConfig(level=args.loglevel,
|
|
format='%(levelname)-8s %(message)s')
|
|
|
|
if args.jid is None:
|
|
args.jid = input("Username: ")
|
|
if args.password is None:
|
|
args.password = getpass("Password: ")
|
|
|
|
# Setup the CommandBot and register plugins. Note that while plugins may
|
|
# have interdependencies, the order in which you register them does
|
|
# not matter.
|
|
xmpp = CommandBot(args.jid, args.password)
|
|
xmpp.register_plugin('xep_0030') # Service Discovery
|
|
xmpp.register_plugin('xep_0004') # Data Forms
|
|
xmpp.register_plugin('xep_0050') # Adhoc Commands
|
|
xmpp.register_plugin('xep_0199', {'keepalive': True, 'frequency':15})
|
|
|
|
# Connect to the XMPP server and start processing XMPP stanzas.
|
|
xmpp.connect()
|
|
xmpp.process()
|