# VERILOG028: Each file should define one single design unit

## Summary

```{raw} html
<div class="coding-quality-issue-table"><div class="coding-quality-issue-toolbar"><p>Count: <strong class="coding-quality-visible">1</strong></p><button type="button" class="coding-quality-clear-filters">Clear filters</button></div><table class="docutils coding-quality-issues coding-quality-issue-list"><thead><tr class="coding-quality-headers"><th scope="col">Reliability</th><th scope="col">Security</th><th scope="col">Maintainability</th><th scope="col">Code attribute</th><th scope="col">Effort to fix</th><th scope="col">Tags</th></tr><tr class="coding-quality-filters"><th><input type="search" placeholder="Filter" aria-label="Filter Reliability"></th><th><input type="search" placeholder="Filter" aria-label="Filter Security"></th><th><input type="search" placeholder="Filter" aria-label="Filter Maintainability"></th><th><input type="search" placeholder="Filter" aria-label="Filter Code attribute"></th><th><input type="search" placeholder="Filter" aria-label="Filter Effort to fix"></th><th><input type="search" placeholder="Filter" aria-label="Filter Tags"></th></tr></thead><tbody><tr><td>-</td><td>-</td><td>LOW</td><td>Adaptability &#124; Modular</td><td>30min</td><td>synthesis, vscode, linter, lowrisc, simulation</td></tr></tbody></table></div>
```

## Description

```{raw} html
<h4>Articles &amp; blog posts</h4>
<ul>
  <li><a
    href="https://github.com/lowRISC/style-guides/blob/master/VerilogCodingStyle.md#file-extensions">lowRISC Verilog
    Coding Style Guide - File Extensions</a></li>
</ul>
<p>
  To simplify large project management, review and evolutions, there should not be more than one design unit declaration
  (module, package, interface, program, configuration or class) per file.
</p>
```

## Parameters

No parameters.

```{raw} html

<style>
.coding-quality-issue-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 12px; margin-bottom: 8px; }
.coding-quality-clear-filters { margin-left: auto; cursor: pointer; border: 0; border-radius: 8px; padding: 5px 12px; background: var(--linty-teal, #1d6f78); color: #f4fbfd; font-size: 12px; font-weight: 600; }
.coding-quality-issue-table input { width: 100%; box-sizing: border-box; }
.coding-quality-issues tr.coding-quality-filters th { font-weight: normal; text-transform: none; letter-spacing: normal; }
.coding-quality-issues tr.coding-quality-filters input {
  font-size: 1rem !important;
  font-weight: normal;
  letter-spacing: normal;
  text-transform: none;
}
.coding-quality-issues th[scope="col"] {
  cursor: pointer;
  font-family: var(--font-sans);
  font-size: 1rem !important;
  font-weight: 700;
  letter-spacing: 0.04em;
  text-transform: uppercase;
}
.coding-quality-issues th.coding-quality-nosort { cursor: default; }
.coding-quality-sort {
  display: inline-block;
  margin-left: 0.35em;
  opacity: 0.55;
  font-size: 0.85em;
}
.coding-quality-issues th[aria-sort="ascending"] .coding-quality-sort,
.coding-quality-issues th[aria-sort="descending"] .coding-quality-sort {
  opacity: 1;
}

a.coding-quality-rule-link,
.rst-content a.coding-quality-rule-link,
.rst-content a.coding-quality-rule-link:visited {
  color: var(--linty-cyan-strong);
  font-family: var(--font-mono);
  font-size: inherit;
  text-decoration: none;
  border-bottom: 1px dashed color-mix(in srgb, var(--linty-cyan-strong) 35%, transparent);
  cursor: pointer;
}
a.coding-quality-rule-link:hover,
.rst-content a.coding-quality-rule-link:hover {
  color: #0a5d6d;
  border-bottom-color: var(--linty-cyan);
}

</style>
<script>
document.addEventListener("DOMContentLoaded", function () {
  document.querySelectorAll("table.coding-quality-issues").forEach(function (table) {
    if (table.dataset.enhanced) return;
    table.dataset.enhanced = "true";
    var headers = table.querySelectorAll("thead tr.coding-quality-headers th");
    var inputs = table.querySelectorAll("thead tr.coding-quality-filters input");
    var tbody = table.querySelector("tbody");
    var count = table.parentElement.querySelector(".coding-quality-visible");
    var clear = table.parentElement.querySelector(".coding-quality-clear-filters");
    var directions = {};

    function rows() {
      return Array.prototype.slice.call(tbody.querySelectorAll("tr"));
    }

    function applyFilters() {
      var queries = Array.prototype.map.call(inputs, function (input) {
        return input.value.trim().toLowerCase();
      });
      var visible = 0;
      rows().forEach(function (row) {
        var match = true;
        for (var index = 0; index < queries.length; index++) {
          if (!queries[index]) continue;
          var text = (row.children[index].textContent || "").toLowerCase();
          if (text.indexOf(queries[index]) === -1) {
            match = false;
            break;
          }
        }
        row.style.display = match ? "" : "none";
        if (match) visible += 1;
      });
      if (count) count.textContent = String(visible);
    }

    function sortBy(index) {
      var direction = directions[index] === "asc" ? "desc" : "asc";
      directions = {};
      directions[index] = direction;
      Array.prototype.forEach.call(headers, function (header, headerIndex) {
        if (header.classList.contains("coding-quality-nosort")) return;
        var active = headerIndex === index;
        header.setAttribute("aria-sort", active ? (direction === "asc" ? "ascending" : "descending") : "none");
        var mark = header.querySelector(".coding-quality-sort");
        if (mark) mark.textContent = active ? (direction === "asc" ? " \u25B2" : " \u25BC") : " \u21C5";
      });
      rows().sort(function (left, right) {
        var leftText = (left.children[index].textContent || "").trim();
        var rightText = (right.children[index].textContent || "").trim();
        var result = leftText.localeCompare(rightText, undefined, {numeric: true, sensitivity: "base"});
        return direction === "asc" ? result : -result;
      }).forEach(function (row) {
        tbody.appendChild(row);
      });
    }

    Array.prototype.forEach.call(headers, function (header, index) {
      if ((header.textContent || "").trim() === "Details") {
        header.classList.add("coding-quality-nosort");
        return;
      }
      header.setAttribute("aria-sort", "none");
      header.title = "Sort";
      var mark = document.createElement("span");
      mark.className = "coding-quality-sort";
      mark.textContent = " \u21C5";
      header.appendChild(mark);
      header.addEventListener("click", function () { sortBy(index); });
    });
    Array.prototype.forEach.call(inputs, function (input) {
      input.addEventListener("input", applyFilters);
    });
    if (clear) {
      clear.addEventListener("click", function () {
        Array.prototype.forEach.call(inputs, function (input) { input.value = ""; });
        applyFilters();
      });
    }
  });
});
</script>

```