Update and link new discord docs; reformat code for PEP8

docs/source/Coding/Changelog.md

@@ -218,6 +218,9 @@ Increase requirements: Django 4.1+, Twisted 22.10+ Python 3.9, 3.10, 3.11.  Post
 - `utils.justify` now supports `align="a"` (absolute alignments. This keeps
   the given left indent but crops/fills to the width. Used in EvCells.
 - `EvTable` now supports passing `EvColumn`s as a list directly, (`EvTable(table=[colA,colB])`)
+- Add `tags=` search criterion to `DefaultObject.search`.
+- Add `AT_EXIT_TRAVERSE` signal, firing when an exit is traversed.
+- Add integration between Evennia and Discord channels (PR by Inspector Cararacal)
 
 ## Evennia 0.9.5
 

docs/source/Components/Default-Commands.md

@@ -1,6 +1,6 @@
 # Default Commands
 
-The full set of default Evennia commands currently contains 88 commands in 9 source
+The full set of default Evennia commands currently contains 89 commands in 9 source
 files. Our policy for adding default commands is outlined [here](../Coding/Default-Command-Syntax.md). The
 [Commands](./Commands.md) documentation explains how Commands work as well as how to make new or customize
 existing ones.
@@ -59,6 +59,7 @@ with [EvEditor](./EvEditor.md), flipping pages in [EvMore](./EvMore.md) or using
 - [**color**](CmdColorTest) (cmdset: [AccountCmdSet](AccountCmdSet), help-category: _General_)
 - [**connect** [co, con, conn]](CmdUnconnectedConnect) (cmdset: [UnloggedinCmdSet](UnloggedinCmdSet), help-category: _General_)
 - [**create** [cr, cre]](CmdUnconnectedCreate) (cmdset: [UnloggedinCmdSet](UnloggedinCmdSet), help-category: _General_)
+- [**discord2chan** [discord]](CmdDiscord2Chan) (cmdset: [AccountCmdSet](AccountCmdSet), help-category: _Comms_)
 - [**drop**](CmdDrop) (cmdset: [CharacterCmdSet](CharacterCmdSet), help-category: _General_)
 - [**encoding** [encode]](CmdUnconnectedEncoding) (cmdset: [UnloggedinCmdSet](UnloggedinCmdSet), help-category: _General_)
 - [**get** [grab]](CmdGet) (cmdset: [CharacterCmdSet](CharacterCmdSet), help-category: _General_)

docs/source/Setup/Settings-Default.md

@@ -893,6 +893,21 @@ GRAPEVINE_CHANNELS = ["gossip", "testing"]
 # them. These are secret and should thus be overridden in secret_settings file
 GRAPEVINE_CLIENT_ID = ""
 GRAPEVINE_CLIENT_SECRET = ""
+# Discord (discord.com) is a popular communication service for many, especially
+# for game communities. Evennia's channels can be connected to Discord channels
+# and relay messages between Evennia and Discord. To use, you will need to create
+# your own Discord application and bot.
+# Discord also requires installing the pyopenssl library.
+# Full step-by-step instructions are available in the official Evennia documentation.
+DISCORD_ENABLED = False
+# The Intents bitmask required by Discord bots to request particular API permissions.
+# By default, this includes the basic guild status and message read/write flags.
+DISCORD_BOT_INTENTS = 105985
+# The authentication token for the Discord bot. This should be kept secret and
+# put in your secret_settings file.
+DISCORD_BOT_TOKEN = None
+# The account typeclass which the Evennia-side Discord relay bot will use.
+DISCORD_BOT_CLASS = "evennia.accounts.bots.DiscordBot"
 
 ######################################################################
 # Django web features

docs/source/Setup/Setup-Overview.md

@@ -26,8 +26,9 @@ Updating-Evennia
 Settings
 Settings-Default
 Choosing-a-Database
-Channels-to-IRC
+Channels-to-Discord
 Channels-to-Grapevine
+Channels-to-IRC
 Channels-to-RSS
 Channels-to-Twitter
 ```

docs/source/api/evennia.server.portal.discord.md

@@ -0,0 +1,10 @@
+```{eval-rst}
+evennia.server.portal.discord 
+====================================
+
+.. automodule:: evennia.server.portal.discord
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+```

docs/source/api/evennia.server.portal.md

@@ -14,6 +14,7 @@ evennia.server.portal
 
    evennia.server.portal.amp
    evennia.server.portal.amp_server
+   evennia.server.portal.discord
    evennia.server.portal.grapevine
    evennia.server.portal.irc
    evennia.server.portal.mccp