<spanid="evennia-comms-managers"></span><h1>evennia.comms.managers<aclass="headerlink"href="#module-evennia.comms.managers"title="Permalink to this headline">¶</a></h1>
<p>These managers define helper methods for accessing the database from
<emclass="property">exception </em><codeclass="sig-prename descclassname">evennia.comms.managers.</code><codeclass="sig-name descname">CommError</code><aclass="reference internal"href="../_modules/evennia/comms/managers.html#CommError"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.CommError"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname">evennia.comms.managers.</code><codeclass="sig-name descname">identify_object</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inp</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#identify_object"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.identify_object"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-prename descclassname">evennia.comms.managers.</code><codeclass="sig-name descname">to_object</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inp</span></em>, <emclass="sig-param"><spanclass="n">objtype</span><spanclass="o">=</span><spanclass="default_value">'account'</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#to_object"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.to_object"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.comms.managers.</code><codeclass="sig-name descname">MsgManager</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">*</span><spanclass="n">args</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">identify_object</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">inp</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager.identify_object"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager.identify_object"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_message_by_id</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">idnum</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager.get_message_by_id"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager.get_message_by_id"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_messages_by_sender</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sender</span></em>, <emclass="sig-param"><spanclass="n">exclude_channel_messages</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager.get_messages_by_sender"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager.get_messages_by_sender"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_messages_by_receiver</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">recipient</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager.get_messages_by_receiver"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager.get_messages_by_receiver"title="Permalink to this definition">¶</a></dt>
<dd><p>Get all messages sent to one given recipient.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>recipient</strong> (<em>Object</em><em>, </em><em>Account</em><em> or </em><em>Channel</em>) – The recipient of the messages to search for.</p>
<ddclass="field-odd"><p><aclass="reference internal"href="#evennia.comms.managers.CommError"title="evennia.comms.managers.CommError"><strong>CommError</strong></a>– If the <strong>recipient</strong> is not of a valid type.</p>
<codeclass="sig-name descname">get_messages_by_channel</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">channel</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager.get_messages_by_channel"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager.get_messages_by_channel"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_message</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sender</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">receiver</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">freetext</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">dbref</span><spanclass="o">=</span><spanclass="default_value">None</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#MsgManager.search_message"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.MsgManager.search_message"title="Permalink to this definition">¶</a></dt>
<dd><p>Search the message database for particular messages. At least
one of the arguments must be given to do a search.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>sender</strong> (<em>Object</em><em> or </em><em>Account</em><em>, </em><em>optional</em>) – Get messages sent by a particular account or object</p></li>
<li><p><strong>receiver</strong> (<em>Object</em><em>, </em><em>Account</em><em> or </em><em>Channel</em><em>, </em><em>optional</em>) – Get messages
received by a certain account,object or channel</p></li>
<li><p><strong>freetext</strong> (<em>str</em>) – Search for a text string in a message. NOTE:
This can potentially be slow, so make sure to supply one of
the other arguments to limit the search.</p></li>
<li><p><strong>dbref</strong> (<em>int</em>) – The exact database id of the message. This will override
all other search criteria since it’s unique and
always gives only one match.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>messages (list or Msg)</em>– A list of message matches or a single match if <strong>dbref</strong> was given.</p>
<codeclass="sig-name descname">message_search</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">sender</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">receiver</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">freetext</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="n">dbref</span><spanclass="o">=</span><spanclass="default_value">None</span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#evennia.comms.managers.MsgManager.message_search"title="Permalink to this definition">¶</a></dt>
<dd><p>Search the message database for particular messages. At least
one of the arguments must be given to do a search.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>sender</strong> (<em>Object</em><em> or </em><em>Account</em><em>, </em><em>optional</em>) – Get messages sent by a particular account or object</p></li>
<li><p><strong>receiver</strong> (<em>Object</em><em>, </em><em>Account</em><em> or </em><em>Channel</em><em>, </em><em>optional</em>) – Get messages
received by a certain account,object or channel</p></li>
<li><p><strong>freetext</strong> (<em>str</em>) – Search for a text string in a message. NOTE:
This can potentially be slow, so make sure to supply one of
the other arguments to limit the search.</p></li>
<li><p><strong>dbref</strong> (<em>int</em>) – The exact database id of the message. This will override
all other search criteria since it’s unique and
always gives only one match.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>messages (list or Msg)</em>– A list of message matches or a single match if <strong>dbref</strong> was given.</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.comms.managers.</code><codeclass="sig-name descname">ChannelDBManager</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">*</span><spanclass="n">args</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#ChannelDBManager"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.ChannelDBManager"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_all_channels</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#ChannelDBManager.get_all_channels"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.ChannelDBManager.get_all_channels"title="Permalink to this definition">¶</a></dt>
<dd><p>Get all channels.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Returns</dt>
<ddclass="field-odd"><p><em>channels (list)</em>– All channels in game.</p>
<codeclass="sig-name descname">get_channel</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">channelkey</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#ChannelDBManager.get_channel"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.ChannelDBManager.get_channel"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">get_subscriptions</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">subscriber</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#ChannelDBManager.get_subscriptions"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.ChannelDBManager.get_subscriptions"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_channel</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">ostring</span></em>, <emclass="sig-param"><spanclass="n">exact</span><spanclass="o">=</span><spanclass="default_value">True</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#ChannelDBManager.search_channel"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.ChannelDBManager.search_channel"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">channel_search</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">ostring</span></em>, <emclass="sig-param"><spanclass="n">exact</span><spanclass="o">=</span><spanclass="default_value">True</span></em><spanclass="sig-paren">)</span><aclass="headerlink"href="#evennia.comms.managers.ChannelDBManager.channel_search"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.comms.managers.</code><codeclass="sig-name descname">ChannelManager</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="o">*</span><spanclass="n">args</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/comms/managers.html#ChannelManager"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.comms.managers.ChannelManager"title="Permalink to this definition">¶</a></dt>