<spanid="evennia-utils-verb-conjugation-conjugate"></span><h1>evennia.utils.verb_conjugation.conjugate<aclass="headerlink"href="#module-evennia.utils.verb_conjugation.conjugate"title="Permalink to this headline">¶</a></h1>
<p>English verb conjugation</p>
<p>Original Author: Tom De Smedt <<aclass="reference external"href="mailto:tomdesmedt%40organisms.be">tomdesmedt<span>@</span>organisms<span>.</span>be</a>> of Nodebox
Refactored by Griatch 2021, for Evennia.</p>
<p>This is distributed under the GPL2 license. See ./LICENSE.txt for details.</p>
<p>The verb.txt morphology was adopted from the XTAG morph_englis.flat:
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_infinitive</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_infinitive"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_infinitive"title="Permalink to this definition">¶</a></dt>
<dd><p>Returns the uninflected form of the verb, like ‘are’ ->‘be’</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to get the uninflected form of.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The uninflected verb form of <strong>verb</strong>.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_conjugate</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em>, <emclass="sig-param"><spanclass="n">tense</span><spanclass="o">=</span><spanclass="default_value">'infinitive'</span></em>, <emclass="sig-param"><spanclass="n">negate</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_conjugate"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_conjugate"title="Permalink to this definition">¶</a></dt>
<dd><p>Inflects the verb to the given tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>verb</strong> (<em>str</em>) – The single verb to conjugate.</p></li>
<li><p><strong>tense</strong> (<em>str</em>) – The tense to convert to. This can be given either as a long or short form
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_present</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em>, <emclass="sig-param"><spanclass="n">person</span><spanclass="o">=</span><spanclass="default_value">''</span></em>, <emclass="sig-param"><spanclass="n">negate</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_present"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_present"title="Permalink to this definition">¶</a></dt>
<dd><p>Inflects the verb in the present tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>person</strong> (<em>str</em><em> or </em><em>int</em>) – This can be 1, 2, 3, “1st”, “2nd”, “3rd”, “plural” or “*”.</p></li>
<li><p><strong>negate</strong> (<em>bool</em>) – Some verbs like be, have, must, can be negated.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The present tense verb.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_present_participle</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_present_participle"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_present_participle"title="Permalink to this definition">¶</a></dt>
<dd><p>Inflects the verb in the present participle.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to inflect.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The inflected verb.</p>
</dd>
</dl>
<pclass="rubric">Examples</p>
<p>give -> giving, be -> being, swim -> swimming</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_past</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em>, <emclass="sig-param"><spanclass="n">person</span><spanclass="o">=</span><spanclass="default_value">''</span></em>, <emclass="sig-param"><spanclass="n">negate</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_past"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_past"title="Permalink to this definition">¶</a></dt>
<dd><p>Inflects the verb in the past tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>verb</strong> (<em>str</em>) – The verb to inflect.</p></li>
<li><p><strong>person</strong> (<em>str</em><em>, </em><em>optional</em>) – The person can be specified with 1, 2, 3,
“1st”, “2nd”, “3rd”, “plural”, “*”.</p></li>
<li><p><strong>negate</strong> (<em>bool</em><em>, </em><em>optional</em>) – Some verbs like be, have, must, can be negated.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The inflected verb.</p>
</dd>
</dl>
<pclass="rubric">Examples</p>
<p>give -> gave, be -> was, swim -> swam</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_past_participle</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_past_participle"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_past_participle"title="Permalink to this definition">¶</a></dt>
<dd><p>Inflects the verb in the present participle.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to inflect.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The inflected verb.</p>
</dd>
</dl>
<pclass="rubric">Examples</p>
<p>give -> given, be -> been, swim -> swum</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_all_tenses</code><spanclass="sig-paren">(</span><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_all_tenses"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_all_tenses"title="Permalink to this definition">¶</a></dt>
<dd><p>Get all all possible verb tenses.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Returns</dt>
<ddclass="field-odd"><p><em>list</em>– A list if string names.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_tense</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_tense"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_tense"title="Permalink to this definition">¶</a></dt>
<dd><p>Returns a string from verb_tenses_keys representing the verb’s tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to check the tense of.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>str</em>– The tense.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_is_tense</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em>, <emclass="sig-param"><spanclass="n">tense</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_is_tense"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_is_tense"title="Permalink to this definition">¶</a></dt>
<dd><p>Checks whether the verb is in the given tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>verb</strong> (<em>str</em>) – The verb to check.</p></li>
<li><p><strong>tense</strong> (<em>str</em>) – The tense to check.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>bool</em>– If verb matches given tense.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_is_present</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em>, <emclass="sig-param"><spanclass="n">person</span><spanclass="o">=</span><spanclass="default_value">''</span></em>, <emclass="sig-param"><spanclass="n">negated</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_is_present"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_is_present"title="Permalink to this definition">¶</a></dt>
<dd><p>Checks whether the verb is in the present tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>verb</strong> (<em>str</em>) – The verb to check.</p></li>
<li><p><strong>person</strong> (<em>str</em>) – Check which person.</p></li>
<li><p><strong>negated</strong> (<em>bool</em>) – Check if verb was negated.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>bool</em>– If verb was in present tense.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_is_present_participle</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_is_present_participle"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_is_present_participle"title="Permalink to this definition">¶</a></dt>
<dd><p>Checks whether the verb is in present participle.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to check.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>bool</em>– Result of check.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_is_past</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em>, <emclass="sig-param"><spanclass="n">person</span><spanclass="o">=</span><spanclass="default_value">''</span></em>, <emclass="sig-param"><spanclass="n">negated</span><spanclass="o">=</span><spanclass="default_value">False</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_is_past"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_is_past"title="Permalink to this definition">¶</a></dt>
<dd><p>Checks whether the verb is in the past tense.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><ulclass="simple">
<li><p><strong>verb</strong> (<em>str</em>) – The verb to check.</p></li>
<li><p><strong>person</strong> (<em>str</em>) – The person to check.</p></li>
<li><p><strong>negated</strong> (<em>bool</em>) – Check if verb is negated.</p></li>
</ul>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>bool</em>– Result of check.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_is_past_participle</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_is_past_participle"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_is_past_participle"title="Permalink to this definition">¶</a></dt>
<dd><p>Checks whether the verb is in past participle.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to check.</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><em>bool</em>– The result of the check.</p>
<codeclass="sig-prename descclassname">evennia.utils.verb_conjugation.conjugate.</code><codeclass="sig-name descname">verb_actor_stance_components</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">verb</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/utils/verb_conjugation/conjugate.html#verb_actor_stance_components"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.utils.verb_conjugation.conjugate.verb_actor_stance_components"title="Permalink to this definition">¶</a></dt>
<dd><p>Figure out actor stance components of a verb.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>verb</strong> (<em>str</em>) – The verb to analyze</p>
</dd>
<dtclass="field-even">Returns</dt>
<ddclass="field-even"><p><p><em>tuple</em>–</p>
<dlclass="simple">
<dt>The 2nd person (you) and 3rd person forms of the verb,</dt><dd><p>in the same tense as the ingoing verb.</p>