Implement allowed_types option for one-declaration-per-file rule

.bazelrc

@@ -13,6 +13,7 @@ build --disk_cache=~/.bazel_cache
 build --experimental_remote_cache_compression
 build --remote_build_event_upload=minimal
 build --nolegacy_important_outputs
+build --incompatible_strict_action_env
 
 build:release \
   --compilation_mode=opt \

.bazelversion

@@ -1 +1 @@
-7.0.0
+7.6.1

.buildkite/pipeline.yml

@@ -28,6 +28,6 @@ steps:
   - label: "Registration"
     commands:
       - echo "+++ Register Rules and Reporters"
-      - make --always-make register
+      - make --always-make bazel_register
       - echo "+++ Diff Files"
       - git diff --quiet HEAD

.github/actions/bazel-linux-build/action.yml

@@ -0,0 +1,24 @@
+name: Bazel Linux Build
+description: Common steps to build SwiftLint with Bazel on GitHub Linux runners
+inputs:
+  target:
+    description: The Bazel target to build
+    default: //:swiftlint
+runs:
+  using: composite
+  steps:
+    - name: Create ci.bazelrc file
+      shell: bash
+      run: echo "$CI_BAZELRC_FILE_CONTENT" | base64 -d > ci.bazelrc
+      env:
+        CI_BAZELRC_FILE_CONTENT: ${{ env.CI_BAZELRC_FILE_CONTENT }}
+    - name: Apply patch
+      shell: bash
+      run: git apply --ignore-whitespace .bcr/patches/no-warnings-as-errors.patch
+    - name: Build SwiftLint with Bazel
+      shell: bash
+      run: |
+        export PATH="/usr/share/swift/usr/bin:$PATH"
+        bazel build --config release ${{ inputs.target }}
+      env:
+        CC: clang

.github/actions/run-make/action.yml

@@ -0,0 +1,19 @@
+name: Run Make Rule
+description: Runs a specified Makefile rule
+inputs:
+  rule:
+    description: The Makefile rule to run
+    required: true
+    default: build
+runs:
+  using: composite
+  steps:
+    - run: |
+        awk '
+          $0 ~ "${{ inputs.rule }}:" { in_rule = 1; next }
+          in_rule && /^\t/ { print $0 }
+          in_rule && !/^\t/ { in_rule = 0 }
+        ' Makefile | while IFS= read -r command; do
+          eval "$command"
+        done
+      shell: bash

.github/copilot-instructions.md

@@ -0,0 +1,7 @@
+You are working on SwiftLint, a linter for Swift code that enforces coding style and conventions. It helps maintain a clean and consistent codebase by identifying and reporting issues in Swift files. It can even automatically fix some of these issues.
+
+Linting rules are defined in `Source/SwiftLintBuiltInRules/Rules`. If someone mentions a rule by its identifier that is in "snake_case" (e.g., `rule_name`), you can usually find the rule's implementation file named "UpperCamelCaseRule.swift" (e.g., `<RuleName>Rule.swift`) in one of the sub-folders depending on the rule's kind. Specific configurations for rules are located in the `RuleConfigurations` folder, which contains files named as `<RuleName>Configuration.swift` (e.g., `IdentifierNameConfiguration.swift`).
+
+User-facing changes must be documented in the `CHANGELOG.md` file, which is organized by version. New entries always go into the "Main" section. They give credit to the person who has made the change and they reference the issue which has been fixed by the change.
+
+All changes need to pass `swift test` as well as running SwiftLint on itself. This is done by running `swift run swiftlint` in the root directory of the project.

.github/workflows/build.yml

@@ -0,0 +1,43 @@
+name: Build
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  bazel_linux:
+    name: Bazel, Linux, Swift 6.1 # pre-installed
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ./.github/actions/bazel-linux-build
+        name: Build SwiftLint with Bazel
+        env:
+          CI_BAZELRC_FILE_CONTENT: ${{ secrets.CI_BAZELRC_FILE_CONTENT }}
+
+  plugins_linux:
+    name: SPM plugins, Linux, Swift ${{ matrix.version }}
+    runs-on: ubuntu-24.04
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - image: swift:5.9-focal
+            version: '5.9'
+          - image: swift:5.10-noble
+            version: '5.10'
+          - image: swift:6.0-noble
+            version: '6.0'
+          - image: swift:6.1-noble
+            version: '6.1'
+    container: ${{ matrix.image }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build plugins
+        uses: ./.github/actions/run-make
+        with:
+          rule: spm_build_plugins

.github/workflows/docs.yml

@@ -0,0 +1,61 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  create-docs:
+    name: Create
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - name: Build SwiftLint and SourceKitten
+        uses: ./.github/actions/bazel-linux-build
+        with:
+          target: "//:swiftlint @com_github_jpsim_sourcekitten//:sourcekitten"
+        env:
+          CI_BAZELRC_FILE_CONTENT: ${{ secrets.CI_BAZELRC_FILE_CONTENT }}
+      - uses: actions/cache@v4
+        with:
+          key: ${{ runner.os }}-swift-spm-${{ hashFiles('Package.resolved') }}
+          restore-keys: ${{ runner.os }}-swift-spm-
+          path: .build
+      - name: Generate documentation
+        run: |
+          export PATH="/usr/share/swift/usr/bin:$PATH"
+          make docs_linux
+      - name: Validate documentation coverage
+        run: |
+          if ruby -rjson -e "j = JSON.parse(File.read('docs/undocumented.json')); exit j['warnings'].length != 0"; then
+            echo "Undocumented declarations:"
+            cat docs/undocumented.json
+            exit 1
+          fi
+      - name: Upload documentation
+        if: github.event_name == 'push'
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs
+
+  deploy-docs:
+    name: Deploy
+    runs-on: ubuntu-24.04
+    needs: create-docs
+    if: github.event_name == 'push'
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy documentation
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/lint.yml

@@ -2,36 +2,37 @@ name: Lint
 
 on:
   pull_request:
-    branches:
-      - '*'
 
 permissions:
   contents: read
   pull-requests: write
 
 jobs:
   lint-swift:
-    name: Lint Swift
+    name: Swift
     runs-on: ubuntu-24.04 # "Noble Numbat"
-    container: swift:6.1-noble
     steps:
       - uses: actions/checkout@v4
+      - uses: ./.github/actions/bazel-linux-build
+        name: Build SwiftLint with Bazel
+        env:
+          CI_BAZELRC_FILE_CONTENT: ${{ secrets.CI_BAZELRC_FILE_CONTENT }}
       - name: Lint
-        run: swift run swiftlint --reporter github-actions-logging --strict 2> /dev/null
+        run: ./bazel-bin/swiftlint lint --reporter github-actions-logging --strict 2> /dev/null
   lint-markdown:
-    name: Lint Markdown
+    name: Markdown
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
       - name: Lint
-        uses: DavidAnson/markdownlint-cli2-action@v19
+        uses: DavidAnson/markdownlint-cli2-action@v20
         with:
           globs: |
             CHANGELOG.md
             CONTRIBUTING.md
             README.md
   lint-actions:
-    name: Lint Actions
+    name: Actions
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4

.github/workflows/release.yml

@@ -51,6 +51,7 @@ jobs:
         run: |
           sed 's/__VERSION__/${{ inputs.version }}/g' tools/Version.swift.template > Source/SwiftLintFramework/Models/Version.swift
           sed -i -e '3s/.*/    version = "${{ inputs.version }}",/' MODULE.bazel
+          sed -i -e "s/^\(\s*s\.version\s*=\s*'\)[^']*'/\1${{ inputs.version }}'/" SwiftLint.podspec
       - name: Configure Git author
         uses: Homebrew/actions/git-user-config@master
         with:

.github/workflows/test.yml

@@ -0,0 +1,51 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+env:
+  SKIP_INTEGRATION_TESTS: 'true'
+
+jobs:
+  spm_linux:
+    name: SPM, Linux, Swift 6.1
+    runs-on: ubuntu-24.04
+    container: swift:6.1-noble
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/cache@v4
+        with:
+          key: ${{ runner.os }}-swift-spm-${{ hashFiles('Package.resolved') }}
+          restore-keys: ${{ runner.os }}-swift-spm-
+          path: .build
+      - name: Run tests
+        uses: ./.github/actions/run-make
+        with:
+          rule: spm_test
+
+  spm_macos:
+    name: SPM, macOS ${{ matrix.macOS }}, Xcode ${{ matrix.xcode }}
+    runs-on: macos-${{ matrix.macOS }}
+    strategy:
+      matrix:
+        include:
+          - macOS: '14'
+            xcode: '15.4'
+          - macOS: '15'
+            xcode: '16.4'
+    env:
+      DEVELOPER_DIR: /Applications/Xcode_${{ matrix.xcode }}.app
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/cache@v4
+        with:
+          key: ${{ runner.os }}-xcode-spm-${{ matrix.xcode }}-${{ hashFiles('Package.resolved') }}
+          restore-keys: ${{ runner.os }}-xcode-spm-${{ matrix.xcode }}-
+          path: .build
+      - name: Run tests
+        run: make spm_test

.gitignore

@@ -61,9 +61,10 @@ Packages/
 # Bundler
 .bundle/
 bundle/
+bin/
 
 # Bazel
-bazel-*
+/bazel-*
 /MODULE.bazel.lock
 
 # Danger

.sourcekit-lsp/config.json

@@ -0,0 +1,4 @@
+{
+    "$schema": "https://raw.githubusercontent.com/swiftlang/sourcekit-lsp/refs/heads/release/6.1/config.schema.json",
+    "backgroundIndexing": false
+}

.swiftlint.yml

@@ -16,7 +16,6 @@ opt_in_rules:
   - all
 disabled_rules:
   - anonymous_argument_in_multiline_closure
-  - async_without_await
   - conditional_returns_on_newline
   - contrasted_opening_brace
   - convenience_type
@@ -75,6 +74,8 @@ file_name:
     - RuleConfigurationMacros.swift
     - SwiftSyntax+SwiftLint.swift
     - TestHelpers.swift
+  excluded_paths:
+    - Tests/GeneratedTests/GeneratedTests_\d\d\.swift
 final_test_case: *unit_test_configuration
 function_body_length: 60
 identifier_name:
@@ -88,7 +89,9 @@ redundant_type_annotation:
 single_test_class: *unit_test_configuration
 trailing_comma:
   mandatory_comma: true
-type_body_length: 400
+type_body_length:
+  warning: 400
+  excluded_types: []
 unneeded_override:
   affect_initializers: true
 unused_import: