text: #!/usr/bin/env python3
  # -*- coding: utf-8 -*-
  
  """
      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()
  