From 4fafa22e86245080043bae96724ece515040a133 Mon Sep 17 00:00:00 2001 From: Griatch Date: Sun, 5 Jun 2016 09:46:27 +0200 Subject: [PATCH] Added some more doc texts to the puppet hooks of Objects to show how to get the player and sessions at that state. Resolves #992. --- evennia/objects/objects.py | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/evennia/objects/objects.py b/evennia/objects/objects.py index 2bf14937b..8c3bd1c33 100644 --- a/evennia/objects/objects.py +++ b/evennia/objects/objects.py @@ -48,7 +48,7 @@ class ObjectSessionHandler(object): """ self.obj = obj - self._sessid_cache = set() + self._sessid_cache = [] self._recache() def _recache(self): @@ -1030,6 +1030,12 @@ class DefaultObject(with_metaclass(TypeclassBase, ObjectDB)): Called just after puppeting has been completed and all Player<->Object links have been established. + Note: + You can use `self.player` and `self.sessions.get()` to get + player and sessions at this point; the last entry in the + list from `self.sessions.get()` is the latest Session + puppeting this Object. + """ self.player.db._last_puppet = self @@ -1038,6 +1044,12 @@ class DefaultObject(with_metaclass(TypeclassBase, ObjectDB)): Called just before beginning to un-connect a puppeting from this Player. + Note: + You can use `self.player` and `self.sessions.get()` to get + player and sessions at this point; the last entry in the + list from `self.sessions.get()` is the latest Session + puppeting this Object. + """ pass @@ -1471,6 +1483,12 @@ class DefaultCharacter(DefaultObject): Called just after puppeting has been completed and all Player<->Object links have been established. + Note: + You can use `self.player` and `self.sessions.get()` to get + player and sessions at this point; the last entry in the + list from `self.sessions.get()` is the latest Session + puppeting this Object. + """ self.msg("\nYou become {c%s{n.\n" % self.name) self.msg(self.at_look(self.location))