<spanid="evennia-web-api-serializers"></span><h1>evennia.web.api.serializers<aclass="headerlink"href="#module-evennia.web.api.serializers"title="Permalink to this headline">¶</a></h1>
<p>Serializers in the Django Rest Framework are similar to Forms in normal django.
They’re used for transmitting and validating data, both going to clients and
coming to the server. However, where forms often contained presentation logic,
such as specifying widgets to use for selection, serializers typically leave
those decisions in the hands of clients, and are more focused on converting
data from the server to JSON (serialization) for a response, and validating
and converting JSON data sent from clients to our enpoints into python objects,
often django model instances, that we can use (deserialization).</p>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">AttributeSerializer</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/web/api/serializers.html#AttributeSerializer"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.AttributeSerializer"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#AttributeSerializer.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.AttributeSerializer.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.api.serializers.AttributeSerializer.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.typeclasses.attributes.html#evennia.typeclasses.attributes.Attribute"title="evennia.typeclasses.attributes.Attribute"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.typeclasses.attributes.Attribute</span></code></a></p>
<emclass="property">static </em><codeclass="sig-name descname">get_value_display</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span><spanclass="p">:</span><spanclass="n"><aclass="reference internal"href="evennia.typeclasses.attributes.html#evennia.typeclasses.attributes.Attribute"title="evennia.typeclasses.attributes.Attribute">evennia.typeclasses.attributes.Attribute</a></span></em><spanclass="sig-paren">)</span>→ str<aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#AttributeSerializer.get_value_display"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.AttributeSerializer.get_value_display"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">TagSerializer</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/web/api/serializers.html#TagSerializer"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TagSerializer"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TagSerializer.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TagSerializer.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.api.serializers.TagSerializer.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.typeclasses.tags.html#evennia.typeclasses.tags.Tag"title="evennia.typeclasses.tags.Tag"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.typeclasses.tags.Tag</span></code></a></p>
<codeclass="sig-name descname">fields</code><emclass="property"> = ['db_key', 'db_category', 'db_data', 'db_tagtype']</em><aclass="headerlink"href="#evennia.web.api.serializers.TagSerializer.Meta.fields"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">SimpleObjectDBSerializer</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/web/api/serializers.html#SimpleObjectDBSerializer"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.SimpleObjectDBSerializer"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#SimpleObjectDBSerializer.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.SimpleObjectDBSerializer.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.api.serializers.SimpleObjectDBSerializer.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.objects.objects.html#evennia.objects.objects.DefaultObject"title="evennia.objects.objects.DefaultObject"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.objects.objects.DefaultObject</span></code></a></p>
<codeclass="sig-name descname">fields</code><emclass="property"> = ['id', 'db_key']</em><aclass="headerlink"href="#evennia.web.api.serializers.SimpleObjectDBSerializer.Meta.fields"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">TypeclassSerializerMixin</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TypeclassSerializerMixin"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TypeclassSerializerMixin"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_tags</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TypeclassSerializerMixin.get_tags"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TypeclassSerializerMixin.get_tags"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_aliases</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TypeclassSerializerMixin.get_aliases"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TypeclassSerializerMixin.get_aliases"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_permissions</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TypeclassSerializerMixin.get_permissions"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TypeclassSerializerMixin.get_permissions"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_attributes</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TypeclassSerializerMixin.get_attributes"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TypeclassSerializerMixin.get_attributes"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_nicks</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#TypeclassSerializerMixin.get_nicks"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.TypeclassSerializerMixin.get_nicks"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">ObjectDBSerializer</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/web/api/serializers.html#ObjectDBSerializer"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.ObjectDBSerializer"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#ObjectDBSerializer.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.ObjectDBSerializer.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.api.serializers.ObjectDBSerializer.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.objects.objects.html#evennia.objects.objects.DefaultObject"title="evennia.objects.objects.DefaultObject"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.objects.objects.DefaultObject</span></code></a></p>
<codeclass="sig-name descname">read_only_fields</code><emclass="property"> = ['id']</em><aclass="headerlink"href="#evennia.web.api.serializers.ObjectDBSerializer.Meta.read_only_fields"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_exits</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#ObjectDBSerializer.get_exits"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.ObjectDBSerializer.get_exits"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_contents</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#ObjectDBSerializer.get_contents"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.ObjectDBSerializer.get_contents"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">AccountSerializer</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/web/api/serializers.html#AccountSerializer"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.AccountSerializer"title="Permalink to this definition">¶</a></dt>
<emclass="property">static </em><codeclass="sig-name descname">get_session_ids</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#AccountSerializer.get_session_ids"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.AccountSerializer.get_session_ids"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#AccountSerializer.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.AccountSerializer.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.api.serializers.AccountSerializer.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.accounts.accounts.html#evennia.accounts.accounts.DefaultAccount"title="evennia.accounts.accounts.DefaultAccount"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.accounts.accounts.DefaultAccount</span></code></a></p>
<codeclass="sig-name descname">read_only_fields</code><emclass="property"> = ['id']</em><aclass="headerlink"href="#evennia.web.api.serializers.AccountSerializer.Meta.read_only_fields"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.api.serializers.</code><codeclass="sig-name descname">ScriptDBSerializer</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/web/api/serializers.html#ScriptDBSerializer"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.ScriptDBSerializer"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/api/serializers.html#ScriptDBSerializer.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.api.serializers.ScriptDBSerializer.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.api.serializers.ScriptDBSerializer.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.scripts.models.html#evennia.scripts.models.ScriptDB"title="evennia.scripts.models.ScriptDB"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.scripts.models.ScriptDB</span></code></a></p>
<codeclass="sig-name descname">read_only_fields</code><emclass="property"> = ['id']</em><aclass="headerlink"href="#evennia.web.api.serializers.ScriptDBSerializer.Meta.read_only_fields"title="Permalink to this definition">¶</a></dt>