Updated config module tutorial to include ConfigManager.execute and context management.

Updated Sphinx config to use Python 3.6 mapping.

Author: satoon101

addons/source-python/docs/source-python/source/conf.py

@@ -301,7 +301,7 @@
 # =============================================================================
 # >> INTERSPHINX
 # =============================================================================
-intersphinx_mapping = {'python': ('https://docs.python.org/3.5', None)}
+intersphinx_mapping = {'python': ('https://docs.python.org/3.6', None)}
 
 
 # =============================================================================

addons/source-python/docs/source-python/source/developing/module_tutorials/config.rst

@@ -43,6 +43,9 @@ called ``addon_player_damage`` which defaults to 64:
     # Write the configuration file out to the folder.
     addon_config.write()
 
+    # Execute the configuration file.
+    addon_config.execute()
+
 And here is the resulting addon.cfg file:
 
 .. code-block:: none
@@ -108,6 +111,9 @@ called ``Description``:
     # remain unchanged.
     addon_config.write()
 
+    # Execute the configuration file.
+    addon_config.execute()
+
 Which results in the following configuration file:
 
 .. code-block:: none
@@ -190,6 +196,9 @@ character to use in order to create the section boundaries:
     # remain unchanged.
     addon_config.write()
 
+    # Execute the configuration file.
+    addon_config.execute()
+
 This generates the following configuration file:
 
 .. code-block:: none
@@ -213,3 +222,38 @@ This generates the following configuration file:
     // Default Value: models/player.mdl
     // Model to set on the player.
        addon_player_model "models/player.mdl"
+
+
+Using context management
+------------------------
+
+All of the above examples show explicitly calling the :meth:`config.manager.ConfigManager.write`
+and :meth:`config.manager.ConfigManager.execute` methods. You can also
+automatically call these by using context management:
+
+.. code-block:: python
+
+    # =============================================================================
+    # >> IMPORTS
+    # =============================================================================
+    # Source.Python Imports
+    #   Config
+    from config.manager import ConfigManager
+    #   Cvars
+    from cvars.flags import ConVarFlags
+
+    # Create the configuration file.
+    # Using 'with' will utilize the __enter__ and __exit__ methods to
+    # automatically write and execute the configuration file.
+    with ConfigManager('addon') as addon_config:
+
+        # Modify the header of the entire configuration file.
+        addon_config.header = 'Addon configuration file.'
+
+        # Create a console variable to add to the configuration file.
+        addon_player_damage = addon_config.cvar(
+            'addon_player_damage', '64',
+            'How much damage to cause to each player.', ConVarFlags.CHEAT
+        )
+
+For reference: :mod:`contextlib`