Browse Source

Change on_server_create/delete to on_server_join/remove.

pull/36/head
Rapptz 10 years ago
parent
commit
7161723034
  1. 4
      discord/client.py
  2. 25
      docs/api.rst

4
discord/client.py

@ -348,7 +348,7 @@ class ConnectionState(object):
# available, so it isn't in the cache...
self._add_server(data)
self.dispatch('server_create', self.servers[-1])
self.dispatch('server_join', self.servers[-1])
def handle_guild_delete(self, data):
if data.get('unavailable', False):
@ -362,7 +362,7 @@ class ConnectionState(object):
server = self._get_server(data.get('id'))
self.servers.remove(server)
self.dispatch('server_delete', server)
self.dispatch('server_remove', server)
def handle_guild_role_create(self, data):
server = self._get_server(data.get('guild_id'))

25
docs/api.rst

@ -188,15 +188,28 @@ to handle it, which defaults to print a traceback and ignore the exception.
:param member: The :class:`Member` that updated their profile with the updated info.
.. function:: on_server_create(server)
on_server_delete(server)
.. function:: on_server_join(server)
Called when a :class:`Server` is created or deleted.
Called when a :class:`Server` is either created by the :class:`Client` or when the
:class:`Client` joins a server.
Note that the server that is created must belong to the :class:`Client` and the server
that got deleted must have been part of the client's participating servers.
:param server: The class:`Server` that was joined.
:param server: The :class:`Server` that got created or deleted.
.. function:: on_server_remove(server)
Called when a :class:`Server` is removed from the :class:`Client`.
This happens through, but not limited to, these circumstances:
- The client got banned.
- The client got kicked.
- The client left the server.
- The client or the server owner deleted the server.
In order for this event to be invoked then the :class:`Client` must have
been part of the server to begin with. (i.e. it is part of :attr:`Client.servers`)
:param server: The :class:`Server` that got removed.
.. function:: on_server_role_create(server, role)
on_server_role_delete(server, role)

Loading…
Cancel
Save