DevTesting

DevTesting is a small Swift 6 package that contains useful additions for writing tests with Swift Testing.

• SeedableRandomNumberGenerator is a random number generator that can be seeded to enable repeatable tests with random data.
• RandomValueGenerating uses a seedable random number generator to repeatably generate values in your test suite. It logs the seed before every test so that you can debug tests that failed. It also includes convenient functions for generating random data:
  • Booleans
  • Case iterables
  • Data
  • Floating point types
  • Integer types
  • Optionals
  • Strings
  • UUIDs
  • URLs, URL components, and URL query items
• Stub and ThrowingStub provide stubbing and spying functionality for your mock objects.

DevTesting is fully documented and tested and supports iOS 18+, macOS 15+, tvOS 18+, visionOS 2+, and watchOS 11+.

View our changelog to see what’s new.

Development Requirements

DevTesting requires a Swift 6.2+ toolchain to build. We only test on Apple platforms. We follow the Swift API Design Guidelines. We take pride in the fact that our public interfaces are fully documented and tested. We aim for overall test coverage over 99%.

Development Setup

To set up the development environment:

1. Run Scripts/install-git-hooks to install git hooks that automatically check code formatting on commits and run comprehensive tests before pushing.
2. Use Scripts/lint to manually check code formatting at any time.
3. Use Scripts/test-all-platforms to run tests on all supported platforms locally.

Continuous Integration

DevTesting uses GitHub Actions for continuous integration. The CI pipeline:

• Linting: Automatically checks code formatting on all pull requests using swift format
• Testing: Runs tests on macOS (iOS, tvOS, and watchOS testing are disabled in CI due to reliability issues)
• Coverage: Generates code coverage reports using xccovPretty

For comprehensive cross-platform testing, developers should run Scripts/test-all-platforms locally or rely on the pre-push git hook which automatically runs all platform tests before pushing changes.

Bugs and Feature Requests

Find a bug? Want a new feature? Create a GitHub issue and we’ll take a look.

License

All code is licensed under the MIT license. Do with it as you will.