Added classmethod Player.from_userid

Removed a redundant word on the index page

Author: Ayuto

addons/source-python/docs/source-python/source/developing/getting-started.rst

@@ -124,6 +124,36 @@ Your plugin should now look like this.
         player.health += EXTRA_HP
 
 
+Alternatively, you can use the classmethod
+:meth:`players.entity.Player.from_userid`. It's a wrapper around
+:func:`players.helpers.index_from_userid` and will shorten your code in
+events.
+
+.. code-block:: python
+
+    from events import Event
+    from players.entity import Player
+    from players.helpers import index_from_userid
+    from messages import SayText2
+
+    # Extra amount of health every player should get on spawn
+    EXTRA_HP = 25
+
+    def load():
+        SayText2('Plugin has been loaded successfully!').send()
+
+    def unload():
+        SayText2('Plugin has been unloaded successfully!').send()
+
+    @Event('player_spawn')
+    def on_player_spawn(game_event):
+        # Create a Player object from the user ID...
+        player = Player.from_userid(game_event['userid'])
+
+        # ... and add some extra HP
+        player.health += EXTRA_HP
+
+
 What's next?
 ------------
 

addons/source-python/docs/source-python/source/index.rst

@@ -5,8 +5,8 @@ Welcome to the Source.Python documentation!
 
 Source.Python is an open-source project that uses Boost.Python to allow
 scripters to interact with Valve's Source-engine. In this wiki, you will find
-documentation on the how to install, update, and use Source.Python. If you
-have any questions, please search for an answer on our
+documentation on how to install, update, and use Source.Python. If you have
+any questions, please search for an answer on our
 `forums <http://www.sourcepython.com/forum.php>`_. If you cannot find the
 answer to your question, please post a question of your own in the appropriate
 forum.

addons/source-python/packages/source-python/players/entity.py

@@ -41,6 +41,7 @@
 from players.helpers import address_from_playerinfo
 from players.helpers import get_client_language
 from players.helpers import playerinfo_from_index
+from players.helpers import index_from_userid
 from players.helpers import uniqueid_from_playerinfo
 from players.games import _GamePlayer
 from players.voice import mute_manager
@@ -71,6 +72,15 @@ def __init__(self, index):
         super().__init__(index)
         object.__setattr__(self, '_playerinfo', None)
 
+    @classmethod
+    def from_userid(cls, userid):
+        """Create an instance from a userid.
+
+        :param int userid: The userid.
+        :rtype: Player
+        """
+        return cls(index_from_userid(userid))
+
     @property
     def permissions(self):
         """Return the player's :class:`auth.manager.PlayerPermissions` object."""