mirror of
https://github.com/progval/irctest.git
synced 2025-04-05 14:59:49 +00:00
496 lines
17 KiB
Python
496 lines
17 KiB
Python
"""
|
|
The INVITE command (`RFC 1459
|
|
<https://datatracker.ietf.org/doc/html/rfc1459#section-4.2.7>`__,
|
|
`RFC 2812 <https://datatracker.ietf.org/doc/html/rfc2812#section-3.2.7>`__,
|
|
`Modern <https://modern.ircdocs.horse/#invite-message>`__)
|
|
"""
|
|
|
|
import pytest
|
|
|
|
from irctest import cases, runner
|
|
from irctest.numerics import (
|
|
ERR_BANNEDFROMCHAN,
|
|
ERR_CHANOPRIVSNEEDED,
|
|
ERR_INVITEONLYCHAN,
|
|
ERR_NEEDMOREPARAMS,
|
|
ERR_NOSUCHNICK,
|
|
ERR_NOTONCHANNEL,
|
|
ERR_USERONCHANNEL,
|
|
RPL_INVITING,
|
|
)
|
|
from irctest.patma import ANYSTR, StrRe
|
|
|
|
|
|
class InviteTestCase(cases.BaseServerTestCase):
|
|
@cases.mark_specifications("Modern")
|
|
def testInvites(self):
|
|
"""Test some basic functionality related to INVITE and the +i mode.
|
|
|
|
https://modern.ircdocs.horse/#invite-only-channel-mode
|
|
https://modern.ircdocs.horse/#rplinviting-341
|
|
"""
|
|
self.connectClient("foo")
|
|
self.joinChannel(1, "#chan")
|
|
self.sendLine(1, "MODE #chan +i")
|
|
self.getMessages(1)
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
m = self.getMessage(1)
|
|
self.assertEqual(m.command, ERR_NOSUCHNICK)
|
|
|
|
self.connectClient("bar")
|
|
self.sendLine(2, "JOIN #chan")
|
|
m = self.getMessage(2)
|
|
self.assertEqual(m.command, ERR_INVITEONLYCHAN)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
m = self.getMessage(1)
|
|
# modern/ircv3 param order: inviter, invitee, channel
|
|
self.assertMessageMatch(m, command=RPL_INVITING, params=["foo", "bar", "#chan"])
|
|
m = self.getMessage(2)
|
|
self.assertMessageMatch(m, command="INVITE", params=["bar", "#chan"])
|
|
self.assertTrue(m.prefix.startswith("foo")) # nickmask of inviter
|
|
|
|
# we were invited, so join should succeed now
|
|
self.joinChannel(2, "#chan")
|
|
|
|
@cases.mark_specifications("RFC1459", "RFC2812", deprecated=True)
|
|
def testInviteNonExistingChannelTransmitted(self):
|
|
"""“There is no requirement that the channel the target user is being
|
|
invited to must exist or be a valid channel.”
|
|
-- <https://tools.ietf.org/html/rfc1459#section-4.2.7>
|
|
and <https://tools.ietf.org/html/rfc2812#section-3.2.7>
|
|
|
|
“Only the user inviting and the user being invited will receive
|
|
notification of the invitation.”
|
|
-- <https://tools.ietf.org/html/rfc2812#section-3.2.7>
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
self.sendLine(1, "INVITE #chan bar")
|
|
self.getMessages(1)
|
|
messages = self.getMessages(2)
|
|
self.assertNotEqual(
|
|
messages,
|
|
[],
|
|
fail_msg="After using “INVITE #chan bar” while #chan does "
|
|
"not exist, “bar” received nothing.",
|
|
)
|
|
self.assertMessageMatch(
|
|
messages[0],
|
|
command="INVITE",
|
|
params=["#chan", "bar"],
|
|
fail_msg="After “foo” invited “bar” do non-existing channel "
|
|
"#chan, “bar” should have received “INVITE #chan bar” but "
|
|
"got this instead: {msg}",
|
|
)
|
|
|
|
@cases.mark_specifications("RFC1459", "RFC2812", deprecated=True)
|
|
def testInviteNonExistingChannelEchoed(self):
|
|
"""“There is no requirement that the channel the target user is being
|
|
invited to must exist or be a valid channel.”
|
|
-- <https://tools.ietf.org/html/rfc1459#section-4.2.7>
|
|
and <https://tools.ietf.org/html/rfc2812#section-3.2.7>
|
|
|
|
“Only the user inviting and the user being invited will receive
|
|
notification of the invitation.”
|
|
-- <https://tools.ietf.org/html/rfc2812#section-3.2.7>
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
self.sendLine(1, "INVITE #chan bar")
|
|
messages = self.getMessages(1)
|
|
self.assertNotEqual(
|
|
messages,
|
|
[],
|
|
fail_msg="After using “INVITE #chan bar” while #chan does "
|
|
"not exist, the author received nothing.",
|
|
)
|
|
self.assertMessageMatch(
|
|
messages[0],
|
|
command="INVITE",
|
|
params=["#chan", "bar"],
|
|
fail_msg="After “foo” invited “bar” do non-existing channel "
|
|
"#chan, “foo” should have received “INVITE #chan bar” but "
|
|
"got this instead: {msg}",
|
|
)
|
|
|
|
def _testInvite(self, opped, invite_only):
|
|
"""
|
|
"Only the user inviting and the user being invited will receive
|
|
notification of the invitation."
|
|
-- https://datatracker.ietf.org/doc/html/rfc2812#section-3.2.7
|
|
|
|
" 341 RPL_INVITING
|
|
"<channel> <nick>"
|
|
|
|
- Returned by the server to indicate that the
|
|
attempted INVITE message was successful and is
|
|
being passed onto the end client."
|
|
-- https://datatracker.ietf.org/doc/html/rfc1459
|
|
-- https://datatracker.ietf.org/doc/html/rfc2812
|
|
|
|
"When the invite is successful, the server MUST send a `RPL_INVITING`
|
|
numeric to the command issuer, and an `INVITE` message,
|
|
with the issuer as prefix, to the target user."
|
|
-- https://modern.ircdocs.horse/#invite-message
|
|
|
|
"### `RPL_INVITING (341)`
|
|
|
|
<client> <nick> <channel>
|
|
|
|
Sent as a reply to the [`INVITE`](#invite-message) command to indicate
|
|
that the attempt was successful and the client with the nickname `<nick>`
|
|
has been invited to `<channel>`.
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
|
|
self.sendLine(1, "JOIN #chan")
|
|
self.getMessages(1)
|
|
|
|
if invite_only:
|
|
self.sendLine(1, "MODE #chan +i")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command="MODE",
|
|
params=["#chan", "+i"],
|
|
)
|
|
|
|
if not opped:
|
|
self.sendLine(1, "MODE #chan -o foo")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command="MODE",
|
|
params=["#chan", "-o", "foo"],
|
|
)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command=RPL_INVITING,
|
|
params=["foo", "bar", "#chan"],
|
|
fail_msg=f"After “foo” invited “bar” to a channel, “foo” should have "
|
|
f"received “{RPL_INVITING} foo #chan bar” but got this instead: "
|
|
f"{{msg}}",
|
|
)
|
|
|
|
messages = self.getMessages(2)
|
|
self.assertNotEqual(
|
|
messages,
|
|
[],
|
|
fail_msg="After using “INVITE #chan bar”, “bar” received nothing.",
|
|
)
|
|
self.assertMessageMatch(
|
|
messages[0],
|
|
prefix=StrRe("foo!.*"),
|
|
command="INVITE",
|
|
params=["bar", "#chan"],
|
|
fail_msg="After “foo” invited “bar”, “bar” should have received "
|
|
"“INVITE bar #chan” but got this instead: {msg}",
|
|
)
|
|
|
|
@pytest.mark.parametrize("invite_only", [True, False])
|
|
@cases.mark_specifications("RFC1459", "RFC2812", "Modern")
|
|
def testInvite(self, invite_only):
|
|
self._testInvite(opped=True, invite_only=invite_only)
|
|
|
|
@cases.mark_specifications("RFC1459", "RFC2812", "Modern", strict=True)
|
|
@cases.xfailIfSoftware(
|
|
["Hybrid", "Plexus4"], "the only strict test that Hybrid fails"
|
|
)
|
|
def testInviteUnopped(self):
|
|
"""Tests invites from unopped users on not-invite-only chans."""
|
|
self._testInvite(opped=False, invite_only=False)
|
|
|
|
@cases.mark_specifications("RFC2812", "Modern")
|
|
def testInviteNoNotificationForOtherMembers(self):
|
|
"""
|
|
"Other channel members are not notified."
|
|
-- https://datatracker.ietf.org/doc/html/rfc2812#section-3.2.7
|
|
|
|
"Other channel members SHOULD NOT be notified."
|
|
-- https://modern.ircdocs.horse/#invite-message
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.connectClient("baz")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
self.getMessages(3)
|
|
|
|
self.sendLine(1, "JOIN #chan")
|
|
self.getMessages(1)
|
|
|
|
self.sendLine(3, "JOIN #chan")
|
|
self.getMessages(3)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
self.getMessages(1)
|
|
|
|
self.assertEqual(
|
|
self.getMessages(3),
|
|
[],
|
|
fail_msg="After foo used “INVITE #chan bar”, other channel members "
|
|
"were notified: {got}",
|
|
)
|
|
|
|
@cases.mark_specifications("RFC1459", "RFC2812", "Modern")
|
|
@cases.xfailIfSoftware(
|
|
["Plexus4"],
|
|
"Plexus4 allows non-op to invite if (and only if) the channel is not "
|
|
"invite-only",
|
|
)
|
|
def testInviteInviteOnly(self):
|
|
"""
|
|
"To invite a user to a channel which is invite only (MODE
|
|
+i), the client sending the invite must be recognised as being a
|
|
channel operator on the given channel."
|
|
-- https://datatracker.ietf.org/doc/html/rfc1459#section-4.2.7
|
|
|
|
"When the channel has invite-only
|
|
flag set, only channel operators may issue INVITE command."
|
|
-- https://datatracker.ietf.org/doc/html/rfc2812#section-3.2.7
|
|
|
|
"When the channel has [invite-only](#invite-only-channel-mode) mode set,
|
|
only channel operators may issue INVITE command.
|
|
Otherwise, the server MUST reject the command with the `ERR_CHANOPRIVSNEEDED`
|
|
numeric."
|
|
-- https://modern.ircdocs.horse/#invite-message
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
|
|
self.sendLine(1, "JOIN #chan")
|
|
self.getMessages(1)
|
|
|
|
self.sendLine(1, "MODE #chan +i")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command="MODE",
|
|
params=["#chan", "+i"],
|
|
)
|
|
|
|
self.sendLine(1, "MODE #chan -o foo")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command="MODE",
|
|
params=["#chan", "-o", "foo"],
|
|
)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command=ERR_CHANOPRIVSNEEDED,
|
|
params=["foo", "#chan", ANYSTR],
|
|
fail_msg=f"After “foo” invited “bar” to a channel to an invite-only "
|
|
f"channel without being opped, “foo” should have received "
|
|
f"“{ERR_CHANOPRIVSNEEDED} foo #chan :*” but got this instead: {{msg}}",
|
|
)
|
|
|
|
@cases.mark_specifications("RFC2812", "Modern")
|
|
def testInviteOnlyFromUsersInChannel(self):
|
|
"""
|
|
"if the channel exists, only members of the channel are allowed
|
|
to invite other users"
|
|
-- https://datatracker.ietf.org/doc/html/rfc2812#section-3.2.7
|
|
|
|
" 442 ERR_NOTONCHANNEL
|
|
"<channel> :You're not on that channel"
|
|
|
|
- Returned by the server whenever a client tries to
|
|
perform a channel affecting command for which the
|
|
client isn't a member.
|
|
"
|
|
-- https://datatracker.ietf.org/doc/html/rfc2812
|
|
|
|
|
|
" Only members of the channel are allowed to invite other users.
|
|
Otherwise, the server MUST reject the command with the `ERR_NOTONCHANNEL`
|
|
numeric."
|
|
-- https://modern.ircdocs.horse/#invite-message
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.connectClient("baz")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
self.getMessages(3)
|
|
|
|
# Create the channel
|
|
self.sendLine(3, "JOIN #chan")
|
|
self.getMessages(3)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command=ERR_NOTONCHANNEL,
|
|
params=["foo", "#chan", ANYSTR],
|
|
fail_msg=f"After “foo” invited “bar” to a channel it is not on "
|
|
f"#chan, “foo” should have received "
|
|
f"“ERR_NOTONCHANNEL ({ERR_NOTONCHANNEL}) foo #chan :*” but "
|
|
f"got this instead: {{msg}}",
|
|
)
|
|
|
|
messages = self.getMessages(2)
|
|
self.assertEqual(
|
|
messages,
|
|
[],
|
|
fail_msg="After using “INVITE #chan bar” while the emitter is "
|
|
"not in #chan, “bar” received something.",
|
|
)
|
|
|
|
@cases.mark_specifications("Modern")
|
|
def testInviteAlreadyInChannel(self):
|
|
"""
|
|
"If the user is already on the target channel,
|
|
the server MUST reject the command with the `ERR_USERONCHANNEL` numeric."
|
|
-- https://modern.ircdocs.horse/#invite-message
|
|
"""
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
|
|
self.sendLine(1, "JOIN #chan")
|
|
self.sendLine(2, "JOIN #chan")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
self.getMessages(1)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command=ERR_USERONCHANNEL,
|
|
params=["foo", "bar", "#chan", ANYSTR],
|
|
)
|
|
|
|
@cases.mark_specifications("RFC2812", "Modern")
|
|
@cases.xfailIfSoftware(
|
|
["ircu2"],
|
|
"Uses 346/347 instead of 336/337 to reply to INVITE "
|
|
"https://github.com/UndernetIRC/ircu2/pull/20",
|
|
)
|
|
def testInviteList(self):
|
|
self.connectClient("foo")
|
|
self.connectClient("bar")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
|
|
self.sendLine(1, "JOIN #chan")
|
|
self.getMessages(1)
|
|
|
|
self.sendLine(1, "INVITE bar #chan")
|
|
self.getMessages(1)
|
|
self.getMessages(2)
|
|
|
|
self.sendLine(2, "INVITE")
|
|
m = self.getMessage(2)
|
|
if m.command == ERR_NEEDMOREPARAMS:
|
|
raise runner.OptionalExtensionNotSupported("INVITE with no parameter")
|
|
if m.command != "337":
|
|
# Hybrid always sends an empty list; so skip this.
|
|
self.assertMessageMatch(
|
|
m,
|
|
command="336",
|
|
params=["bar", "#chan"],
|
|
)
|
|
m = self.getMessage(2)
|
|
self.assertMessageMatch(
|
|
m,
|
|
command="337",
|
|
params=["bar", ANYSTR],
|
|
)
|
|
|
|
@cases.mark_isupport("INVEX")
|
|
@cases.mark_specifications("Modern")
|
|
def testInvexList(self):
|
|
self.connectClient("foo")
|
|
self.getMessages(1)
|
|
|
|
if "INVEX" in self.server_support:
|
|
invex = self.server_support.get("INVEX") or "I"
|
|
else:
|
|
raise runner.IsupportTokenNotSupported("INVEX")
|
|
|
|
self.sendLine(1, "JOIN #chan")
|
|
self.getMessages(1)
|
|
|
|
self.sendLine(1, f"MODE #chan +{invex} bar!*@*")
|
|
self.getMessages(1)
|
|
|
|
self.sendLine(1, f"MODE #chan +{invex}")
|
|
m = self.getMessage(1)
|
|
if len(m.params) == 3:
|
|
# Old format
|
|
self.assertMessageMatch(
|
|
m,
|
|
command="346",
|
|
params=["foo", "#chan", "bar!*@*"],
|
|
)
|
|
else:
|
|
self.assertMessageMatch(
|
|
m,
|
|
command="346",
|
|
params=[
|
|
"foo",
|
|
"#chan",
|
|
"bar!*@*",
|
|
StrRe("foo(!.*@.*)?"),
|
|
StrRe("[0-9]+"),
|
|
],
|
|
)
|
|
self.assertMessageMatch(
|
|
self.getMessage(1),
|
|
command="347",
|
|
params=["foo", "#chan", ANYSTR],
|
|
)
|
|
|
|
@cases.mark_specifications("Ergo")
|
|
def testInviteExemptsFromBan(self):
|
|
# regression test for ergochat/ergo#1876;
|
|
# INVITE should override a +b ban
|
|
self.connectClient("alice", name="alice")
|
|
self.joinChannel("alice", "#alice")
|
|
self.sendLine("alice", "MODE #alice +b bob!*@*")
|
|
result = {msg.command for msg in self.getMessages("alice")}
|
|
self.assertIn("MODE", result)
|
|
|
|
self.connectClient("bob", name="bob")
|
|
self.sendLine("bob", "JOIN #alice")
|
|
result = {msg.command for msg in self.getMessages("bob")}
|
|
self.assertIn(ERR_BANNEDFROMCHAN, result)
|
|
self.assertNotIn("JOIN", result)
|
|
|
|
self.sendLine("alice", "INVITE bob #alice")
|
|
result = {msg.command for msg in self.getMessages("alice")}
|
|
self.assertIn(RPL_INVITING, result)
|
|
self.assertNotIn(ERR_USERONCHANNEL, result)
|
|
|
|
result = {msg.command for msg in self.getMessages("bob")}
|
|
self.assertIn("INVITE", result)
|
|
|
|
self.sendLine("bob", "JOIN #alice")
|
|
result = {msg.command for msg in self.getMessages("bob")}
|
|
self.assertNotIn(ERR_BANNEDFROMCHAN, result)
|
|
self.assertIn("JOIN", result)
|
|
|
|
self.sendLine("alice", "KICK #alice bob")
|
|
self.getMessages("alice")
|
|
result = {msg.command for msg in self.getMessages("bob")}
|
|
self.assertIn("KICK", result)
|
|
|
|
# INVITE gets "used up" after one JOIN
|
|
self.sendLine("bob", "JOIN #alice")
|
|
result = {msg.command for msg in self.getMessages("bob")}
|
|
self.assertIn(ERR_BANNEDFROMCHAN, result)
|
|
self.assertNotIn("JOIN", result)
|