Ticket #3910: t.w.p.irc-action.patch

twisted/words/test/test_irc.py

@@ -723 +723 @@
                 username, hostname, servername, self.protocol.realname),
             '']
         self.assertEquals(self.transport.value().split('\r\n'), expected)
+
+    def test_describe(self):
+        target = 'foo'
+        channel = 'bar'
+        action = 'waves'
+        self.protocol.describe(target, action)
+        self.protocol.describe(channel, action)
+        expected = [
+            'PRIVMSG %s :\01ACTION %s\01' % (target, action),
+            'PRIVMSG %s :\01ACTION %s\01' % (channel, action),
+            '']
+        self.assertEquals(self.transport.value().split('\r\n'), expected)

twisted/words/protocols/irc.py

@@ -30 +30 @@
 
 import errno, os, random, re, stat, struct, sys, time, types, traceback
 import string, socket
+import warnings
 from os import path
 
 from twisted.internet import reactor, protocol
@@ -1067 +1068 @@
 
     ### user input commands, client->client
 
+    def describe(self, channel, action):
+        """
+        Strike a pose.
+
+        @type channel: C{str}
+        @param channel: The name of the channel to have an action on. If it
+            has no prefix, it is sent to the user of that name.
+        @type action: C{str}
+        @param action: The action to preform.
+        """
+        self.ctcpMakeQuery(channel, [('ACTION', action)])
+
     def me(self, channel, action):
         """
         Strike a pose.
 
+        This function is deprecated. Use describe().
+
         @type channel: C{str}
         @param channel: The name of the channel to have an action on. If it
             has no prefix, C{'#'} will to prepended to it.
         @type action: C{str}
         @param action: The action to preform.
         """
+        warnings.warn("me() is deprecated.  Use IRCClient.describe().",
+                DeprecationWarning, stacklevel=2)
+
         if channel[0] not in '&#!+': channel = '#' + channel
-        self.ctcpMakeQuery(channel, [('ACTION', action)])
+        self.describe(channel, action)
 
     _pings = None
     _MAX_PINGRING = 12