refactor: Migrate SentryMsgPackSerializer from Objective-C to Swift #6143

philprime · 2025-09-11T09:57:11Z

Summary

This PR migrates the SentryMsgPackSerializer from Objective-C to Swift while maintaining 100% behavioral compatibility.

Changes Made

Complete Migration

Converted SentryMsgPackSerializer.m/.h to modular Swift implementation
Reorganized code into separate files in Sources/Swift/Tools/MsgPack/ directory:
- SentryMsgPackSerializer.swift - Main serialization logic
- SentryStreamable.swift - Protocol definition
- SentryMsgPackSerializerError.swift - Error types
- Data+SentryStreamable.swift - Data extension
- URL+SentryStreamable.swift - URL extension
- NSData+SentryStreamable.swift - NSData extension
- NSURL+SentryStreamable.swift - NSURL extension

Behavioral Compatibility

Maintained exact behavior matching original Objective-C implementation
Preserved edge cases like silent key length truncation for >255 byte keys
Kept error handling patterns including -1 return values for file size errors
Maintained logging levels (error vs debug) matching original code

Enhanced Test Coverage

Added comprehensive test suite with 14 test cases covering all code paths
Added edge case testing for large dictionaries, long keys, stream errors
Improved error validation for nil input streams and invalid file paths
AAA test pattern with proper setup/teardown and temp file cleanup

Implementation Improvements

Modern Swift patterns with proper error throwing instead of boolean returns
Type safety with explicit error types via SentryMsgPackSerializerError
Memory safety improvements while maintaining compatibility
Cleaner byte operations using modern Swift APIs

Key Technical Details

Protocol signature: Uses streamSize() -> Int to support -1 error values from Objective-C
Truncating conversion: Uses UInt8(truncatingIfNeeded:) to match Objective-C silent truncation
Error propagation: Swift errors are caught and converted to boolean returns for Objective-C compatibility
File I/O: Improved path validation through Swift's Data.write(to:) method

Testing

All existing functionality verified through comprehensive test suite:

14 tests covering all code paths and edge cases
100% backward compatibility with existing behavior
Proper error handling for all failure scenarios

Closes #6140

#skip-changelog

…nverted tests - Updated SentryMsgPackSerializer to log errors instead of debug messages for empty data and input stream issues. - Modified the `asInputStream` method in the SentryStreamable protocol to return nullable streams. - Removed outdated Objective-C tests and added comprehensive Swift tests for SentryMsgPackSerializer, covering various scenarios including nil input streams and invalid file paths. - Ensured proper cleanup of temporary files in tests.

codecov · 2025-09-11T10:09:02Z

❌ 2 Tests Failed:

Tests completed	Failed	Passed	Skipped
4035	2	4033	28

View the top 3 failed test(s) by shortest run time

SentryTests.SentryFileManagerTests::testCreateDirectoryIfNotExists_pathTooLogError_shouldLogError

Stack Traces | 0s run time

.../SentryTests/Helper/SentryFileManagerTests.swift:1116 - XCTAssertEqual failed: ("2") is not equal to ("1")

iOS_Swift_UITests.LaunchUITests::testBreadcrumbData

Stack Traces | 0s run time

.../iOS-Swift/iOS-Swift-UITests/LaunchUITests.swift:6 - Failed to Error Domain=com.apple.dt.XCTest.XCTFuture Code=1000 "Timed out while evaluating UI query." UserInfo={NSLocalizedDescription=Timed out while evaluating UI query.}: Timed out while evaluating UI query.

iOS_Swift_UITests.TopViewControllerTests::testSplitViewController

Stack Traces | 0s run time

.../iOS-Swift/iOS-Swift-UITests/TopViewControllerTests.swift:35 - Failed to tap "Transactions" Button: Timed out while evaluating UI query.

iOS_Swift_UITests.TopViewControllerTests::testTabBarViewController

Stack Traces | 0s run time

.../iOS-Swift/iOS-Swift-UITests/TopViewControllerTests.swift:77 - Failed to tap "TOPVCBTN" Button: Timed out while evaluating UI query.

To view more test analytics, go to the Test Analytics Dashboard
_{📋 Got 3 mins? Take this short survey to help us improve Test Analytics.}

github-actions · 2025-09-11T10:17:54Z

Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	1222.09 ms	1248.02 ms	25.93 ms
Size	23.74 KiB	1.00 MiB	1002.97 KiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`b6f8eb3`	1217.94 ms	1246.57 ms	28.63 ms
`8da82b4`	1220.08 ms	1248.24 ms	28.16 ms
`37183fe`	1212.33 ms	1238.92 ms	26.59 ms
`a2a3bfb`	1227.94 ms	1261.26 ms	33.32 ms
`ef2c9b3`	1222.12 ms	1253.96 ms	31.84 ms
`ae79d35`	1227.15 ms	1252.55 ms	25.41 ms
`326984b`	1235.06 ms	1252.75 ms	17.69 ms
`16f6edc`	1234.02 ms	1269.67 ms	35.65 ms
`efa740d`	1220.71 ms	1246.20 ms	25.50 ms
`acac774`	1217.76 ms	1253.29 ms	35.52 ms

App size

Revision	Plain	With Sentry	Diff
`b6f8eb3`	23.75 KiB	988.70 KiB	964.95 KiB
`8da82b4`	23.75 KiB	913.63 KiB	889.88 KiB
`37183fe`	23.75 KiB	913.63 KiB	889.87 KiB
`a2a3bfb`	23.75 KiB	872.67 KiB	848.92 KiB
`ef2c9b3`	23.75 KiB	933.03 KiB	909.29 KiB
`ae79d35`	23.75 KiB	928.13 KiB	904.38 KiB
`326984b`	23.74 KiB	926.64 KiB	902.90 KiB
`16f6edc`	23.74 KiB	1022.94 KiB	999.19 KiB
`efa740d`	23.75 KiB	919.69 KiB	895.95 KiB
`acac774`	23.75 KiB	866.51 KiB	842.76 KiB

Previous results on branch: philprime/msg-pack-serializer-null-handling

Startup times

Revision	Plain	With Sentry	Diff
`2c09b1c`	1196.13 ms	1225.79 ms	29.66 ms
`c0e1523`	1229.65 ms	1263.41 ms	33.76 ms
`43dc3b5`	1236.69 ms	1255.65 ms	18.95 ms
`8215a0d`	1206.23 ms	1237.04 ms	30.81 ms

App size

Revision	Plain	With Sentry	Diff
`2c09b1c`	23.75 KiB	992.26 KiB	968.52 KiB
`c0e1523`	23.75 KiB	988.63 KiB	964.88 KiB
`43dc3b5`	23.75 KiB	988.55 KiB	964.80 KiB
`8215a0d`	23.75 KiB	969.21 KiB	945.46 KiB

…rializer-null-handling

…nal serialization tests - Added support for error streams in TestStreamableObject. - Introduced new test cases for serializing empty dictionaries, single elements, large dictionaries, long keys, and handling invalid paths. - Implemented a custom ErrorInputStream to simulate read errors during serialization.

…ntation - Deleted the Objective-C SentryMsgPackSerializer and its associated header files. - Introduced a new Swift implementation of SentryMsgPackSerializer with improved error handling. - Added SentryStreamable protocol and extensions for Data, NSData, NSURL, and URL to support serialization. - Updated tests to validate the new Swift serialization logic and error handling.

…r error propagation - Changed keyData.withUnsafeBytes to use try for improved error handling. - This ensures that any errors during buffer address retrieval are properly thrown.

philprime · 2025-09-15T09:18:41Z

@cursor review

- Introduced TestStreamableObject to simulate various SentryStreamable behaviors, including handling nil and error streams. - Updated SentryMsgPackSerializerTests to utilize TestStreamableObject for improved test coverage on serialization scenarios. - Removed redundant TestStreamableObject implementation from SentryMsgPackSerializerTests to streamline code.

…rializer-null-handling

philprime · 2025-09-23T12:19:26Z

@cursor review
@seer review

Sources/Swift/Tools/MsgPack/NSData+SentryStreamable.swift

Sources/Swift/Tools/MsgPack/NSURL+SentryStreamable.swift

Sources/Swift/Tools/MsgPack/NSData+SentryStreamable.swift

Sources/Swift/Tools/MsgPack/NSURL+SentryStreamable.swift

…rializer-null-handling

philprime · 2025-10-09T11:59:07Z

@sentry review

Sources/Swift/Tools/MsgPack/SentryMsgPackSerializer.swift

Sources/Swift/Tools/MsgPack/SentryStreamable.swift

Tests/SentryTests/SentryMsgPackSerializerTests.swift

…rializer-null-handling

…ror handling - Updated `serializeDictionary` method to directly serialize to a file. - Introduced `serializeToFile` method for better separation of concerns. - Enhanced error handling to clean up partial files on serialization failure. - Updated tests to validate new serialization approach and error scenarios.

cursor · 2025-10-21T10:43:46Z

Sources/Swift/Tools/MsgPack/URL+SentryStreamable.swift

+        do {
+            attributes = try FileManager.default.attributesOfItem(atPath: path)
+        } catch {
+            SentrySDKLog.error("Could not read file attributes - File: \(self) - Error: \(error)")


Bug: Logging Level Change Causes Unexpected Noise

File attribute errors in streamSize() are now logged at ERROR level instead of the previous DEBUG level. This changes the expected logging behavior, potentially causing noisy logs in production, and contradicts the PR's stated goal of maintaining original logging levels.

philprime self-assigned this Sep 11, 2025

philprime requested review from itaybre, noahsmartin and philipphofmann as code owners September 11, 2025 09:57

philprime marked this pull request as draft September 11, 2025 11:32

philprime added 3 commits September 15, 2025 10:29

Merge remote-tracking branch 'origin/main' into philprime/msg-pack-se…

6eb1e43

…rializer-null-handling

philprime changed the title ~~refactor: Add nullability-handling to SentryMsgPackSerializer with converted tests~~ refactor: Migrate SentryMsgPackSerializer from Objective-C to Swift Sep 15, 2025

fix: Update keyData handling in SentryMsgPackSerializer to use try fo…

b73f131

…r error propagation - Changed keyData.withUnsafeBytes to use try for improved error handling. - This ensures that any errors during buffer address retrieval are properly thrown.

This comment was marked as outdated.

Sign in to view

philprime added 2 commits September 23, 2025 14:17

Merge remote-tracking branch 'origin/main' into philprime/msg-pack-se…

9b91dac

…rializer-null-handling

This comment was marked as outdated.

Sign in to view

fix potential overflow for very large files

7726ae1

philprime marked this pull request as ready for review September 23, 2025 12:49

This comment was marked as outdated.

Sign in to view

philprime added the Waiting for: Review ⏳ label Sep 26, 2025

noahsmartin reviewed Oct 6, 2025

View reviewed changes

Sources/Swift/Tools/MsgPack/NSData+SentryStreamable.swift Outdated Show resolved Hide resolved

noahsmartin reviewed Oct 6, 2025

View reviewed changes

Sources/Swift/Tools/MsgPack/NSURL+SentryStreamable.swift Outdated Show resolved Hide resolved

noahsmartin reviewed Oct 6, 2025

View reviewed changes

Sources/Swift/Tools/MsgPack/NSData+SentryStreamable.swift Outdated Show resolved Hide resolved

noahsmartin reviewed Oct 6, 2025

View reviewed changes

Sources/Swift/Tools/MsgPack/NSURL+SentryStreamable.swift Outdated Show resolved Hide resolved

philprime added 2 commits October 9, 2025 13:24

Merge remote-tracking branch 'origin/main' into philprime/msg-pack-se…

2307fe1

…rializer-null-handling

remove legacy extensions

5181e9e

This comment was marked as outdated.

Sign in to view

resolve conversion mistakes

568d287

philprime requested a review from noahsmartin October 9, 2025 11:58

This comment was marked as outdated.

Sign in to view

seer-by-sentry bot reviewed Oct 9, 2025

View reviewed changes

philprime added 3 commits October 21, 2025 12:13

Merge remote-tracking branch 'origin/main' into philprime/msg-pack-se…

157de83

…rializer-null-handling

Fix xcode proj

e7abc0a

cursor bot reviewed Oct 21, 2025

View reviewed changes

Uh oh!

refactor: Migrate SentryMsgPackSerializer from Objective-C to Swift #6143

Are you sure you want to change the base?

refactor: Migrate SentryMsgPackSerializer from Objective-C to Swift #6143

Conversation

philprime commented Sep 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes Made

Complete Migration

Behavioral Compatibility

Enhanced Test Coverage

Implementation Improvements

Key Technical Details

Testing

Uh oh!

codecov bot commented Sep 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

❌ 2 Tests Failed:

Uh oh!

github-actions bot commented Sep 11, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Previous results on branch: philprime/msg-pack-serializer-null-handling

Startup times

App size

Uh oh!

philprime commented Sep 15, 2025

Uh oh!

This comment was marked as outdated.

Uh oh!

philprime commented Sep 23, 2025

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

philprime commented Oct 9, 2025

Uh oh!

This comment was marked as outdated.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

cursor bot Oct 21, 2025

Choose a reason for hiding this comment

Bug: Logging Level Change Causes Unexpected Noise

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

philprime commented Sep 11, 2025 •

edited

Loading

codecov bot commented Sep 11, 2025 •

edited

Loading

github-actions bot commented Sep 11, 2025 •

edited

Loading