Swift Metrics Versions Save

What's Changed

• fix availability of record(:Duration) API by @ktoso in https://github.com/apple/swift-metrics/pull/146

Full Changelog: https://github.com/apple/swift-metrics/compare/2.4.3...2.4.4

Source break fix

This release fixes a minor source break caused between 2.4.1 and 2.4.2:

The PR https://github.com/apple/swift-metrics/pull/133 introduced the following method:

public func record(_ duration: Duration)

There was already a similar function

public func record(_ duration: DispatchTimeInterval)

This can cause ambiguity for the compiler when using . shortcuts because of an overlap in case names, e.g.

timer.record(.nanoseconds(123)) // <-- ambiguous, is this DispatchTimeInterval or Duration?

This release fixes this by having the new method be called record(duration:).

Fixed by https://github.com/apple/swift-metrics/pull/144 in 2.4.3, please use 2.4.3 instead. Thank you @hamzahrmalik for the diagnosis and fix.

What changed

• Change Timer.record(duration: Duration) signature to avoid source breakage by @hamzahrmalik in https://github.com/apple/swift-metrics/pull/144

Full Changelog: https://github.com/apple/swift-metrics/compare/2.4.2...2.4.3

Warning: source break

This release has an accidental minor source break:

The PR https://github.com/apple/swift-metrics/pull/133 introduced the following method:

public func record(_ duration: Duration)

There was already a similar function

public func record(_ duration: DispatchTimeInterval)

This can cause ambiguity for the compiler when using . shortcuts because of an overlap in case names, e.g.

timer.record(.nanoseconds(123)) // <-- ambiguous, is this DispatchTimeInterval or Duration?

Fixed by https://github.com/apple/swift-metrics/pull/144 in 2.4.3, please use 2.4.3 instead. Thank you @hamzahrmalik for the diagnosis and fix.

What's Changed

• Support compiling against Musl by @simonjbeaumont in https://github.com/apple/swift-metrics/pull/142
• Introducing Timer.record(_ duration:), closes #114 by @natikgadzhi in https://github.com/apple/swift-metrics/pull/133
• Add CI for Swift 5.10 by @yim-lee in https://github.com/apple/swift-metrics/pull/138
• Align supported Swift versions with rest of the ecosystem by @FranzBusch in https://github.com/apple/swift-metrics/pull/141
• Update API breakage CI script by @simonjbeaumont in https://github.com/apple/swift-metrics/pull/143

New Contributors

• @natikgadzhi made their first contribution in https://github.com/apple/swift-metrics/pull/133
• @FranzBusch made their first contribution in https://github.com/apple/swift-metrics/pull/141
• @simonjbeaumont made their first contribution in https://github.com/apple/swift-metrics/pull/143

Full Changelog: https://github.com/apple/swift-metrics/compare/2.4.1...2.4.2

What's Changed

• add increment and decrement public API to Meter by @tomerd in https://github.com/apple/swift-metrics/pull/132

Full Changelog: https://github.com/apple/swift-metrics/compare/2.4.0...2.4.1

What's Changed

• Update CI by @yim-lee in https://github.com/apple/swift-metrics/pull/124
• Use UUID instead of NSUUID in MetricsTests by @fabianfett in https://github.com/apple/swift-metrics/pull/126
• Add Package.resolved to .gitignore by @fabianfett in https://github.com/apple/swift-metrics/pull/125
• add "meter" - a new type of metric and metric handler by @tomerd in https://github.com/apple/swift-metrics/pull/123
• Use the MetricsTestKit in the MetricsTests rather than using a copy of the TestMetrics utilities by @hamzahrmalik in https://github.com/apple/swift-metrics/pull/128
• MetricsTestKit: expose all metrics publicly. This allows users to run checks on counters when they might not know the exact label by @hamzahrmalik in https://github.com/apple/swift-metrics/pull/127
• Make 'values' on TestCounter, TestRecorder and TestMeter public by @hamzahrmalik in https://github.com/apple/swift-metrics/pull/129

New Contributors

• @hamzahrmalik made their first contribution in https://github.com/apple/swift-metrics/pull/128

Full Changelog: https://github.com/apple/swift-metrics/compare/2.3.4...2.4.0

What's Changed

• Propagate displayUnit when using MultiplexMetricsHandler by @gjcairo in https://github.com/apple/swift-metrics/pull/122

CI updates

• Add CI for Swift 5.8 and update nightly to Ubuntu 22.04 by @yim-lee in https://github.com/apple/swift-metrics/pull/121

New Contributors

• @gjcairo made their first contribution in https://github.com/apple/swift-metrics/pull/122 - thank you!

Full Changelog: https://github.com/apple/swift-metrics/compare/2.3.3...2.3.4

What's Changed

• Make MetricsFactory Sendable by @fabianfett in https://github.com/apple/swift-metrics/pull/116
• +docc prepare for docc publishing by @ktoso in https://github.com/apple/swift-metrics/pull/118
• Add .spi.yml for Swift Package Index DocC support by @yim-lee in https://github.com/apple/swift-metrics/pull/119

Full Changelog: https://github.com/apple/swift-metrics/compare/2.3.2...2.3.3

What's Changed

• better abstration for MetricsSystem state by @tomerd in https://github.com/apple/swift-metrics/pull/112
• adopt sendable by @tomerd in https://github.com/apple/swift-metrics/pull/109
• Remove testable import from TestMetrics. by @fabianfett in https://github.com/apple/swift-metrics/pull/113

Full Changelog: https://github.com/apple/swift-metrics/compare/2.3.1...2.3.2

What's Changed

• Expose MetricsTestKit as a product by @fabianfett in https://github.com/apple/swift-metrics/pull/111

New Contributors

• @fabianfett made their first contribution in https://github.com/apple/swift-metrics/pull/111

Full Changelog: https://github.com/apple/swift-metrics/compare/2.3.0...2.3.1

• https://github.com/apple/swift-metrics/pull/106 Introduced new MetricsTestKit module that allows asserting certain metrics have been emitted etc.
  • we will provide more documentation soon; meanwhile you can use this test as reference for how to use the testkit here's how one uses it for those curious https://github.com/apple/swift-cluster-membership/blob/main/Tests/SWIMTests/SWIMMetricsTests.swift