EpochtalkServer.Models.RolePermission.html

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="x-ua-compatible" content="ie=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="generator" content="ExDoc v0.37.2">
    <meta name="project" content="epochtalk_server v0.1.0">


    <title>EpochtalkServer.Models.RolePermission — epochtalk_server v0.1.0</title>

    <link rel="stylesheet" href="dist/html-elixir-6X3L5KMG.css" />

    <script defer src="dist/sidebar_items-C8922E45.js"></script>
    <script defer src="docs_config.js"></script>
    <script defer src="dist/html-6XHBGSGW.js"></script>

  </head>
  <body>
    <script>(()=>{var t="ex_doc:settings",e="dark";var o="dark",s="light";var E="sidebar_state",n="closed";var r="sidebar_width";var a="sidebar-open";var i=new URLSearchParams(window.location.search),S=i.get("theme")||JSON.parse(localStorage.getItem(t)||"{}").theme;(S===o||S!==s&&window.matchMedia("(prefers-color-scheme: dark)").matches)&&document.body.classList.add(e);var d=sessionStorage.getItem(E),A=d!==n&&!window.matchMedia(`screen and (max-width: ${768}px)`).matches;document.body.classList.toggle(a,A);var c=sessionStorage.getItem(r);c&&document.body.style.setProperty("--sidebarWidth",`${c}px`);var p=/(Macintosh|iPhone|iPad|iPod)/.test(window.navigator.userAgent);document.documentElement.classList.toggle("apple-os",p);})();
</script>

<div class="body-wrapper">

<button id="sidebar-menu" class="sidebar-button sidebar-toggle" aria-label="toggle sidebar" aria-controls="sidebar">
  <i class="ri-menu-line ri-lg" title="Collapse/expand sidebar"></i>
</button>

<nav id="sidebar" class="sidebar">

  <div class="sidebar-header">
    <div class="sidebar-projectInfo">

      <div>
        <a href="api-reference.html" class="sidebar-projectName" translate="no">
epochtalk_server
        </a>
        <div class="sidebar-projectVersion" translate="no">
          v0.1.0
        </div>
      </div>
    </div>
    <ul id="sidebar-list-nav" class="sidebar-list-nav" role="tablist" data-extras=""></ul>
  </div>
</nav>

<output role="status" id="toast"></output>

<main class="content page-module" id="main" data-type="modules">
  <div id="content" class="content-inner">
    <div class="top-search">
      <div class="search-settings">
        <form class="search-bar" action="search.html">
          <label class="search-label">
            <span class="sr-only">Search documentation of epochtalk_server</span>
            <input name="q" type="text" class="search-input" placeholder="Press / to search" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false" />
          </label>
          <button type="submit" class="search-button" aria-label="Submit Search" tabindex="-1">
            <i class="ri-search-2-line ri-lg" aria-hidden="true"></i>
          </button>
          <button type="button" tabindex="-1" class="search-close-button" aria-hidden="true">
            <i class="ri-close-line ri-lg" title="Cancel search"></i>
          </button>
        </form>
        <div class="autocomplete">
        </div>
        <button class="icon-settings display-settings">
          <i class="ri-settings-3-line"></i>
          <span class="sr-only">Settings</span>
        </button>
      </div>
    </div>

<div id="top-content">
  <div class="heading-with-actions top-heading">
    <h1>
      <span translate="no">EpochtalkServer.Models.RolePermission</span> 
      <small class="app-vsn" translate="no">(epochtalk_server v0.1.0)</small>

    </h1>

  </div>


    <section id="moduledoc">
<p><code class="inline">RolePermission</code> model, for performing actions relating to a roles permissions</p>
    </section>

</div>

  <section id="summary" class="details-list">
    <h1 class="section-heading">
      <a class="hover-link" href="#summary">
        <i class="ri-link-m" aria-hidden="true"></i>
      </a>
      <span class="text">Summary</span>
    </h1>
<div class="summary-types summary">
  <h2>
    <a href="#types">Types</a>
  </h2>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#t:t/0" data-no-tooltip="" translate="no">t()</a>

      </div>

    </div>

</div>
<div class="summary-functions summary">
  <h2>
    <a href="#functions">Functions</a>
  </h2>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#changeset/2" data-no-tooltip="" translate="no">changeset(role_permission, attrs \\ %{})</a>

      </div>

        <div class="summary-synopsis"><p>Creates a generic changeset for <code class="inline">RolePermission</code> model</p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#insert/1" data-no-tooltip="" translate="no">insert(role_permission)</a>

      </div>

        <div class="summary-synopsis"><p>Inserts a new <code class="inline">RolePermission</code> into the database</p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#maybe_init!/0" data-no-tooltip="" translate="no">maybe_init!()</a>

      </div>

        <div class="summary-synopsis"><p>Sets all roles permissions to value: false, modified: false</p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#modify_by_role/1" data-no-tooltip="" translate="no">modify_by_role(attrs)</a>

      </div>

        <div class="summary-synopsis"><p>For admin api use.</p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#permissions_map_by_role_id/1" data-no-tooltip="" translate="no">permissions_map_by_role_id(role_id)</a>

      </div>

        <div class="summary-synopsis"><p>Derives a single nested map of all permissions for a role</p></div>

    </div>

    <div class="summary-row">
      <div class="summary-signature">
        <a href="#upsert_value/1" data-no-tooltip="" translate="no">upsert_value(roles_permissions)</a>

      </div>

        <div class="summary-synopsis"><p>Used to update the value of a <code class="inline">RolePermission</code> in the database, if it exists or create it, if it doesnt</p></div>

    </div>

</div>

  </section>


  <section id="types" class="details-list">
    <h1 class="section-heading">
      <a class="hover-link" href="#types">
        <i class="ri-link-m" aria-hidden="true"></i>
      </a>
      <span class="text">Types</span>
    </h1>
    <div class="types-list">
<section class="detail" id="t:t/0">

  <div class="detail-header">
    <a href="#t:t/0" class="detail-link" data-no-tooltip="" aria-label="Link to this type">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">t()</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@type</span> t() :: %EpochtalkServer.Models.RolePermission{
  __meta__: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  modified: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">boolean</a>() | nil,
  permission: <a href="EpochtalkServer.Models.Permission.html#t:t/0">EpochtalkServer.Models.Permission.t</a>() | <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  permission_path: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  role: <a href="EpochtalkServer.Models.Role.html#t:t/0">EpochtalkServer.Models.Role.t</a>() | <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  role_id: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>(),
  value: <a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">boolean</a>() | nil
}</pre>

      </div>


  </section>
</section>

    </div>
  </section>

  <section id="functions" class="details-list">
    <h1 class="section-heading">
      <a class="hover-link" href="#functions">
        <i class="ri-link-m" aria-hidden="true"></i>
      </a>
      <span class="text">Functions</span>
    </h1>
    <div class="functions-list">
<section class="detail" id="changeset/2">

    <span id="changeset/1"></span>

  <div class="detail-header">
    <a href="#changeset/2" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">changeset(role_permission, attrs \\ %{})</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> changeset(role_permission :: <a href="#t:t/0">t</a>(), attrs :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">map</a>() | nil) :: <a href="https://hexdocs.pm/ecto/3.12.5/Ecto.Changeset.html#t:t/0">Ecto.Changeset.t</a>()</pre>

      </div>

<p>Creates a generic changeset for <code class="inline">RolePermission</code> model</p>
  </section>
</section>
<section class="detail" id="insert/1">

  <div class="detail-header">
    <a href="#insert/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">insert(role_permission)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> insert(role_permission_or_role_permissions :: <a href="#t:t/0">t</a>() | [<a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">map</a>()]) ::
  {:ok, role :: <a href="#t:t/0">t</a>()}
  | {<a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>(), nil | [<a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>()]}
  | {:error, <a href="https://hexdocs.pm/ecto/3.12.5/Ecto.Changeset.html#t:t/0">Ecto.Changeset.t</a>()}</pre>

      </div>

<p>Inserts a new <code class="inline">RolePermission</code> into the database</p>
  </section>
</section>
<section class="detail" id="maybe_init!/0">

  <div class="detail-header">
    <a href="#maybe_init!/0" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">maybe_init!()</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> maybe_init!() :: [<a href="#t:t/0">t</a>()] | nil</pre>

      </div>

<p>Sets all roles permissions to value: false, modified: false</p><p>For server-side role-loading use, only runs if roles permissions table is currently empty</p>
  </section>
</section>
<section class="detail" id="modify_by_role/1">

  <div class="detail-header">
    <a href="#modify_by_role/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">modify_by_role(attrs)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> modify_by_role(role :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">map</a>()) :: {:ok, :success}</pre>

      </div>

<p>For admin api use.</p><p>Updates the <code class="inline">modified</code> value of <code class="inline">RolePermission</code>s for a <code class="inline">Role</code>
and updates the <code class="inline">Role</code>'s permissions and priority restrictions</p><p>If a permission is not included in <code class="inline">new_permissions</code>, it will be set to
<code class="inline">false</code>.  <code class="inline">new_permissions</code> may be an empty list - in which case, all
permissions will be set to <code class="inline">false</code>.</p><p>Any permissions in <code class="inline">new_permissions</code> which are not valid will be ignored.</p>
  </section>
</section>
<section class="detail" id="permissions_map_by_role_id/1">

  <div class="detail-header">
    <a href="#permissions_map_by_role_id/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">permissions_map_by_role_id(role_id)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> permissions_map_by_role_id(role_id :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">integer</a>()) :: <a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">map</a>()</pre>

      </div>

<p>Derives a single nested map of all permissions for a role</p>
  </section>
</section>
<section class="detail" id="upsert_value/1">

  <div class="detail-header">
    <a href="#upsert_value/1" class="detail-link" data-no-tooltip="" aria-label="Link to this function">
      <i class="ri-link-m" aria-hidden="true"></i>
    </a>
    <div class="heading-with-actions">
      <h1 class="signature" translate="no">upsert_value(roles_permissions)</h1>


    </div>
  </div>

  <section class="docstring">

      <div class="specs">

          <pre translate="no"><span class="attribute">@spec</span> upsert_value(role_permissions :: [%{}]) :: {<a href="https://hexdocs.pm/elixir/typespecs.html#basic-types">non_neg_integer</a>(), nil | [<a href="https://hexdocs.pm/elixir/typespecs.html#built-in-types">term</a>()]}</pre>

      </div>

<p>Used to update the value of a <code class="inline">RolePermission</code> in the database, if it exists or create it, if it doesnt</p>
  </section>
</section>

    </div>
  </section>

    <footer class="footer">
      <p>

        <span class="line">
          <button class="a-main footer-button display-quick-switch" title="Search HexDocs packages">
            Search HexDocs
          </button>

            <a href="epochtalk_server.epub" title="ePub version">
              Download ePub version
            </a>

        </span>
      </p>

      <p class="built-using">
        Built using
        <a href="https://github.com/elixir-lang/ex_doc" title="ExDoc" target="_blank" rel="help noopener" translate="no">ExDoc</a> (v0.37.2) for the

          <a href="https://elixir-lang.org" title="Elixir" target="_blank" translate="no">Elixir programming language</a>

      </p>

    </footer>
  </div>
</main>
</div>

  </body>
</html>