Bylaws

Overview

Bylaws is an architectural linter for Swift, built for developers and coding agents. You write project rules in Swift that the compiler cannot enforce, such as which layers may depend on each other, and Bylaws reports violations with the file, line and rule. Rules run from a CLI or as part of your Swift Testing suite.

Features

• Rules inspect declarations, function calls and other Swift syntax
• Checks where files and types belong and restricts references between files, folders or modules
• Compares Package.swift with the imports in your sources and finds dependency cycles
• Most rules run without a build; some can read the compiler index
• Run from the CLI with bylaws lint or as Swift Testing tests

Requirements

The source doesn't list any requirements, so check the project's own docs before you install.

Install

1. Install the CLI and run your rules from the project root

   brew install theblixguy/tap/bylaws
   bylaws lint

2. Or add the Bylaws product to a test target and run rules with swift test

Example

Write a rule that keeps print calls inside your logging layer; bylaws lint then fails and points at any stray print in Sources.