gajim-plural/src/command_system/implementation/standard.py

410 lines
14 KiB
Python
Raw Normal View History

# Copyright (C) 2009-2010 Alexander Cherniuk <ts33kr@gmail.com>
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
"""
Provides an actual implementation for the standard commands.
"""
2009-11-19 06:39:04 +01:00
from time import localtime, strftime
from datetime import date
import dialogs
from common import gajim
from common import helpers
from common.exceptions import GajimGeneralException
2009-11-19 06:39:04 +01:00
from common.logger import Constants
from ..errors import CommandError
2010-03-19 02:22:17 +01:00
from ..framework import CommandContainer, command, doc
from ..mapping import generate_usage
from hosts import *
import execute
2009-11-19 06:39:04 +01:00
# This holds constants fron the logger, which we'll be using in some of our
# commands.
lc = Constants()
class StandardCommonCommands(CommandContainer):
"""
This command container contains standard commands which are common
to all - chat, private chat, group chat.
"""
AUTOMATIC = True
HOSTS = ChatCommands, PrivateChatCommands, GroupChatCommands
@command
2010-03-19 02:22:17 +01:00
@doc(_("Hide the chat buttons"))
def compact(self):
new_status = not self.hide_chat_buttons
self.chat_buttons_set_visible(new_status)
@command(overlap=True)
@doc(_("Show help on a given command or a list of available commands if -a is given"))
def help(self, command=None, all=False):
if command:
command = self.get_command(command)
documentation = _(command.extract_documentation())
usage = generate_usage(command)
2009-10-04 18:56:07 +02:00
text = []
if documentation:
2009-10-04 18:56:07 +02:00
text.append(documentation)
if command.usage:
2009-10-04 18:56:07 +02:00
text.append(usage)
2009-10-04 18:56:07 +02:00
return '\n\n'.join(text)
elif all:
for command in self.list_commands():
names = ', '.join(command.names)
description = command.extract_description()
self.echo("%s - %s" % (names, description))
else:
help = self.get_command('help')
self.echo(help(self, 'help'))
@command(raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Send a message to the contact"))
def say(self, message):
self.send(message)
@command(raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Send action (in the third person) to the current chat"))
def me(self, action):
self.send("/me %s" % action)
2009-11-19 06:39:04 +01:00
@command('lastlog', overlap=True)
2010-03-19 02:22:17 +01:00
@doc(_("Show logged messages which mention given text"))
2009-11-19 06:39:04 +01:00
def grep(self, text, limit=None):
results = gajim.logger.get_search_results_for_query(self.contact.jid,
text, self.account)
if not results:
raise CommandError(_("%s: Nothing found") % text)
if limit:
try:
results = results[len(results) - int(limit):]
except ValueError:
raise CommandError(_("Limit must be an integer"))
for row in results:
contact, time, kind, show, message, subject = row
if not contact:
if kind == lc.KIND_CHAT_MSG_SENT:
contact = gajim.nicks[self.account]
else:
contact = self.contact.name
time_obj = localtime(time)
date_obj = date.fromtimestamp(time)
date_ = strftime('%Y-%m-%d', time_obj)
time_ = strftime('%H:%M:%S', time_obj)
if date_obj == date.today():
formatted = "[%s] %s: %s" % (time_, contact, message)
else:
formatted = "[%s, %s] %s: %s" % (date_, time_, contact, message)
self.echo(formatted)
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("""
2012-07-28 20:46:11 +02:00
Set the current status
2012-09-23 21:59:26 +02:00
Status can be given as one of the following values:
online, away, chat, xa, dnd.
"""))
def status(self, status, message):
if status not in ('online', 'away', 'chat', 'xa', 'dnd'):
raise CommandError("Invalid status given")
2012-02-14 21:49:48 +01:00
for connection in gajim.connections.itervalues():
if not gajim.config.get_per('accounts', connection.name,
'sync_with_global_status'):
continue
if connection.connected < 2:
2012-02-14 21:49:48 +01:00
continue
connection.change_status(status, message)
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Set the current status to away"))
def away(self, message):
if not message:
message = _("Away")
2012-02-14 21:49:48 +01:00
for connection in gajim.connections.itervalues():
if not gajim.config.get_per('accounts', connection.name,
'sync_with_global_status'):
continue
if connection.connected < 2:
2012-02-14 21:49:48 +01:00
continue
connection.change_status('away', message)
@command('back', raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Set the current status to online"))
def online(self, message):
if not message:
message = _("Available")
2012-02-14 21:49:48 +01:00
for connection in gajim.connections.itervalues():
if not gajim.config.get_per('accounts', connection.name,
'sync_with_global_status'):
continue
if connection.connected < 2:
2012-02-14 21:49:48 +01:00
continue
connection.change_status('online', message)
class StandardCommonChatCommands(CommandContainer):
"""
This command container contans standard commands, which are common
to a chat and a private chat only.
"""
AUTOMATIC = True
HOSTS = ChatCommands, PrivateChatCommands
@command
@doc(_("Clear the text window"))
def clear(self):
self.conv_textview.clear()
@command
2010-03-19 02:22:17 +01:00
@doc(_("Toggle the GPG encryption"))
def gpg(self):
self._toggle_gpg()
@command
2010-03-19 02:22:17 +01:00
@doc(_("Send a ping to the contact"))
def ping(self):
if self.account == gajim.ZEROCONF_ACC_NAME:
raise CommandError(_('Command is not supported for zeroconf accounts'))
gajim.connections[self.account].sendPing(self.contact)
@command
2010-08-07 16:26:12 +02:00
@doc(_("Send DTMF sequence through an open audio session"))
def dtmf(self, sequence):
if not self.audio_sid:
2010-08-07 16:26:12 +02:00
raise CommandError(_("No open audio sessions with the contact"))
for tone in sequence:
if not (tone in ("*", "#") or tone.isdigit()):
raise CommandError(_("%s is not a valid tone") % tone)
gjs = self.connection.get_jingle_session
session = gjs(self.full_jid, self.audio_sid)
content = session.get_content("audio")
content.batch_dtmf(sequence)
@command
2010-03-19 02:22:17 +01:00
@doc(_("Toggle audio session"))
2009-11-10 22:06:59 +01:00
def audio(self):
if not self.audio_available:
raise CommandError(_("Audio sessions are not available"))
# An audio session is toggled by inverting the state of the
# appropriate button.
state = self._audio_button.get_active()
self._audio_button.set_active(not state)
2009-11-10 22:06:59 +01:00
@command
2010-03-19 02:22:17 +01:00
@doc(_("Toggle video session"))
2009-11-10 22:06:59 +01:00
def video(self):
if not self.video_available:
2009-11-10 22:06:59 +01:00
raise CommandError(_("Video sessions are not available"))
# A video session is toggled by inverting the state of the
# appropriate button.
state = self._video_button.get_active()
self._video_button.set_active(not state)
2009-11-10 22:06:59 +01:00
@command(raw=True)
@doc(_("Send a message to the contact that will attract his (her) attention"))
def attention(self, message):
self.send_message(message, process_commands=False, attention=True)
class StandardChatCommands(CommandContainer):
"""
This command container contains standard commands which are unique
to a chat.
"""
AUTOMATIC = True
2010-08-07 15:38:05 +02:00
HOSTS = ChatCommands,
class StandardPrivateChatCommands(CommandContainer):
"""
This command container contains standard commands which are unique
to a private chat.
"""
AUTOMATIC = True
2010-08-07 15:38:05 +02:00
HOSTS = PrivateChatCommands,
class StandardGroupChatCommands(CommandContainer):
"""
This command container contains standard commands which are unique
to a group chat.
"""
AUTOMATIC = True
2010-08-07 15:38:05 +02:00
HOSTS = GroupChatCommands,
@command
@doc(_("Clear the text window"))
def clear(self):
self.conv_textview.clear()
self.gc_count_nicknames_colors = -1
self.gc_custom_colors = {}
@command(raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Change your nickname in a group chat"))
def nick(self, new_nick):
try:
new_nick = helpers.parse_resource(new_nick)
except Exception:
raise CommandError(_("Invalid nickname"))
self.connection.join_gc(new_nick, self.room_jid, None, change_nick=True)
2009-09-15 21:59:48 +02:00
self.new_nick = new_nick
@command('query', raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Open a private chat window with a specified occupant"))
def chat(self, nick):
nicks = gajim.contacts.get_nick_list(self.account, self.room_jid)
if nick in nicks:
self.on_send_pm(nick=nick)
else:
raise CommandError(_("Nickname not found"))
@command('msg', raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Open a private chat window with a specified occupant and send him a message"))
def message(self, nick, a_message):
nicks = gajim.contacts.get_nick_list(self.account, self.room_jid)
if nick in nicks:
self.on_send_pm(nick=nick, msg=a_message)
else:
raise CommandError(_("Nickname not found"))
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Display or change a group chat topic"))
def topic(self, new_topic):
if new_topic:
self.connection.send_gc_subject(self.room_jid, new_topic)
else:
return self.subject
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Invite a user to a room for a reason"))
def invite(self, jid, reason):
self.connection.send_invite(self.room_jid, jid, reason)
return _("Invited %s to %s") % (jid, self.room_jid)
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Join a group chat given by a jid, optionally using given nickname"))
def join(self, jid, nick):
if not nick:
nick = self.nick
if '@' not in jid:
jid = jid + '@' + gajim.get_server_from_jid(self.room_jid)
try:
gajim.interface.instances[self.account]['join_gc'].window.present()
except KeyError:
try:
dialogs.JoinGroupchatWindow(account=self.account, room_jid=jid, nick=nick)
except GajimGeneralException:
pass
@command('part', 'close', raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Leave the groupchat, optionally giving a reason, and close tab or window"))
def leave(self, reason):
self.parent_win.remove_tab(self, self.parent_win.CLOSE_COMMAND, reason)
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("""
Ban user by a nick or a jid from a groupchat
If given nickname is not found it will be treated as a jid.
"""))
def ban(self, who, reason):
if who in gajim.contacts.get_nick_list(self.account, self.room_jid):
contact = gajim.contacts.get_gc_contact(self.account, self.room_jid, who)
who = contact.jid
self.connection.gc_set_affiliation(self.room_jid, who, 'outcast', reason or str())
@command(raw=True, empty=True)
2010-03-19 02:22:17 +01:00
@doc(_("Kick user by a nick from a groupchat"))
def kick(self, who, reason):
if not who in gajim.contacts.get_nick_list(self.account, self.room_jid):
raise CommandError(_("Nickname not found"))
self.connection.gc_set_role(self.room_jid, who, 'none', reason or str())
@command(raw=True)
@doc(_("""Set occupant role in group chat.
Role can be given as one of the following values:
moderator, participant, visitor, none"""))
def role(self, who, role):
if role not in ('moderator', 'participant', 'visitor', 'none'):
raise CommandError(_("Invalid role given"))
if not who in gajim.contacts.get_nick_list(self.account, self.room_jid):
raise CommandError(_("Nickname not found"))
self.connection.gc_set_role(self.room_jid, who, role)
@command(raw=True)
@doc(_("""Set occupant affiliation in group chat.
Affiliation can be given as one of the following values:
owner, admin, member, outcast, none"""))
def affiliate(self, who, affiliation):
if affiliation not in ('owner', 'admin', 'member', 'outcast', 'none'):
raise CommandError(_("Invalid affiliation given"))
if not who in gajim.contacts.get_nick_list(self.account, self.room_jid):
raise CommandError(_("Nickname not found"))
contact = gajim.contacts.get_gc_contact(self.account, self.room_jid, who)
self.connection.gc_set_affiliation(self.room_jid, contact.jid,
affiliation)
@command
2010-03-19 02:22:17 +01:00
@doc(_("Display names of all group chat occupants"))
def names(self, verbose=False):
2010-08-07 15:38:05 +02:00
ggc = gajim.contacts.get_gc_contact
gnl = gajim.contacts.get_nick_list
2010-08-07 15:38:05 +02:00
get_contact = lambda nick: ggc(self.account, self.room_jid, nick)
get_role = lambda nick: get_contact(nick).role
nicks = gnl(self.account, self.room_jid)
2010-08-07 15:38:05 +02:00
nicks = sorted(nicks)
nicks = sorted(nicks, key=get_role)
2010-08-07 15:38:05 +02:00
if not verbose:
return ", ".join(nicks)
2010-08-07 15:38:05 +02:00
for nick in nicks:
contact = get_contact(nick)
role = helpers.get_uf_role(contact.role)
affiliation = helpers.get_uf_affiliation(contact.affiliation)
self.echo("%s - %s - %s" % (nick, role, affiliation))
@command('ignore', raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Forbid an occupant to send you public or private messages"))
def block(self, who):
self.on_block(None, who)
@command('unignore', raw=True)
2010-03-19 02:22:17 +01:00
@doc(_("Allow an occupant to send you public or private messages"))
def unblock(self, who):
self.on_unblock(None, who)