mirror of https://github.com/apple/swift-protobuf.git synced 2026-05-17 10:20:36 +00:00

Files

T

Mads Odgaard b16843c4f8 Move runtime to FoundationEssentials (#1993 )

As per the recent [forums
post](https://forums.swift.org/t/the-adoption-of-import-foundationessentials-throughout-the-package-ecosystem/84112/16)
on the `import FoundationEssentials`, this PR implements the strategy
described.

The generator now generates the conditional essentials import.

The only remaining part after this is to do something about the
`BinaryDelimited` APIs which use `InputStream` and `OutputStream`

Fixes #1756

---------

Co-authored-by: Franz Busch <f.busch@apple.com>
Co-authored-by: Thomas Van Lenten <thomasvl@google.com>

2026-03-01 11:05:47 -05:00

FailCases

Range check timestamps on all parsing paths.

2024-07-29 17:16:09 -04:00

Sources

Move runtime to FoundationEssentials (#1993 )

2026-03-01 11:05:47 -05:00

Tests/FuzzCommonTests

Run swift-format -p -r -i .

2024-09-09 14:39:36 -04:00

.gitignore

Add another ignore.

2021-04-13 13:48:58 -04:00

do_build.sh

Fix options needing multiple bytes, add tests.

2024-05-01 14:30:12 -04:00

FuzzAsyncMessageSequence.dict

Update the fuzz input dictionaries and update docs on how to make them. (#1933 )

2026-01-06 08:59:29 +00:00

FuzzBinary.dict

Update the fuzz input dictionaries and update docs on how to make them. (#1933 )

2026-01-06 08:59:29 +00:00

FuzzBinaryDelimited.dict

Update the fuzz input dictionaries and update docs on how to make them. (#1933 )

2026-01-06 08:59:29 +00:00

FuzzJSON.dict

Update the fuzz input dictionaries and update docs on how to make them. (#1933 )

2026-01-06 08:59:29 +00:00

FuzzTextFormat.dict

Update the fuzz input dictionaries and update docs on how to make them. (#1933 )

2026-01-06 08:59:29 +00:00

make_FuzzBinary_dict

Add a dict to help steer binary fuzzing.

2021-09-17 15:57:48 -04:00

Package.swift

Drop support for Swift 5.10 (#1913 )

2026-02-09 12:32:13 -05:00

README.md

Add dictionaries for help steer the fuzz testing.

2021-09-07 13:30:13 -04:00

README.md

FuzzTesting

This subpackage build binaries to be use with Fuzz testing.

NOTE: The Swift toolchain distributed with Xcode do not include the fuzzing support, so for macOS, one needs to install the swift.org toolchain and use that instead.

To build on macOS:

xcrun \
  --toolchain swift \
  swift build -c debug -Xswiftc -sanitize=fuzzer,address -Xswiftc -parse-as-library

To build on linux:

swift build -c debug -Xswiftc -sanitize=fuzzer,address -Xswiftc -parse-as-library

Then the binaries will be found in .build/debug.

Note: You can also use -c release to build/test in release instead as that could find different issues.

In this directory you will also find a do_build.sh script. By default it builds for both debug and release. You can also pass --run-regressions to have it run the the build against the previous failcases to check for regressions.

When issues are found:

Make sure you add a file to FailCases subdirectory so regressions can easily be watched for. The GitHub workflow runs against there.
Consider adding them to Tests/SwiftProtobufTests/Test_FuzzTests.swift, this help in debugging while working on the failure, but also provides yet another way to ensure things don't regress and if they do, it is much easier to immediately debug the issue.

A note about memory issues, the address sanitizer is enabled in the fuzz tests and in that context can find different things that what are found running the unittests with the address sanitizer. So having test cases in both places can be needed to help ensure something is less likely to regress.

There are dictionaries to help steer the fuzzing of JSON and TextFormat, to run with them, just add -dict=FuzzJSON.dict or -dict=FuzzTextFormat.dict to the invocation of the fuzz binary.