testing ([current](https://www.swift.org/documentation/server/guides/testing.html))

current content

• 🧭 North Star: show examples of how to run tests for executables (& libraries, but focus on executables)

  • (core path: developing on Mac, running on Linux)
  • (presumption that tests are unit tests)
  • show how to run test within a linux environment
    • using container on the CLI
  • show how to use sanitizers (thread, asan, while testing)
  • show how to capture test coverage & get a simple report
  • XCTest & Swift Testing (prefer Swift testing)
  • reference “testing in a CI article” (new/separate article)

• 🗺️ (Outline)

  • use swift test
    • -v
    • ``-vv`
    • list
    • last
    • --filter ...
    • -s
  • run swift test in a container:
    • docker run -v "$PWD:/code" -w /code swift:latest swift test
  • Using sanitizers
    • thread:
      • swift test --sanitize=thread
    • address:
      • swift test --sanitize=address
      • swift test -c release --sanitize=address
  • (something about capturing test coverage)
    • swift test --enable-code-coverage/--disable-code-coverage
    • --show-codecov-path
    • --xunit-output <xunit-output>
      • ? how is this intended to be used
      • swift test --xunit-output fredfile ==> fredfile-swift-testing
      • swift test --xunit-output . ==> nothing
      • https://forums.swift.org/t/swift-testing-and-vscode/70441
      • https://github.com/swiftlang/swift-package-manager/issues/4752
  • XCTest and swift-testing
    • --enable-xctest/--disable-xctest
    • --enable-swift-testing/--disable-swift-testing
  • Signposts / links to additional content on platform-specific testing techniques
    • Accessing resources (fixtures) from your tests
      • ?? should this be it's own article in swift-testing?
      • (link to an article in swift-testing on using TestScoping & SuiteTrait)
    • (link to an article walking through how to test a hummingbird app)
    • (link to an article walking through how to test a vapor app)
    • (link to an article walking through how to test a grpc service)
    • (placeholder) - link to "functional tests", setting up dependent services
      • link to integration tests