Skip to content

METADATA_UPDATE_LOG.md

Latest commit

 

History

History
202 lines (164 loc) · 11 KB

METADATA_UPDATE_LOG.md

File metadata and controls

202 lines (164 loc) · 11 KB

Metadata Update Log

This file records upstream comparison results for metadata updates. Keep entries concise, command-based, and reviewable so future updates do not need to rediscover the same baseline.

Metadata-only updates should ship as patch releases. Use a minor release only when the update also adds public API, new modules, or additive behavior beyond metadata freshness.

2026-06-04: Google libphonenumber v9.0.32

Scope

  • Previous local main, testing, and short-number metadata matched Google libphonenumber v9.0.31.
  • Updated main phone-number metadata to v9.0.32.
  • Testing metadata was unchanged between v9.0.31 and v9.0.32.
  • Short-number metadata was unchanged between v9.0.31 and v9.0.32.
  • Regenerated geocoding metadata from v9.0.32; checked-in geocoding databases were unchanged.
  • Regenerated carrier metadata from v9.0.32; packed metadata now has 31,024 prefix rows and 107 mobile portable regions.
  • Regenerated timezone metadata from v9.0.32; packed metadata still has 3,294 prefix rows.

Commands

swift scripts/checkMetadataFreshness.swift --output .build/metadata-freshness
swift scripts/updateMetadata.swift v9.0.32 --dry-run --output-root .build/metadata-update/v9.0.32-dry-run
swift scripts/updateMetadata.swift v9.0.32 --output-root .build/metadata-update/v9.0.32
swift scripts/updateProjectVersions.swift 1.7.2
swift scripts/checkMetadataFreshness.swift --output .build/metadata-freshness --fail-on-update
swift scripts/checkUpstreamTestParity.swift --upstream-ref v9.0.32
swift scripts/checkUpstreamAPIParity.swift --upstream-ref v9.0.32
swift scripts/checkVersionConsistency.swift
swift test
LC_ALL=ko_KR.UTF-8 LANG=ko_KR.UTF-8 swift test
swift build -c release
swift scripts/publishPodspecs.swift --lint
git diff --check

Results

  • Freshness check found Google libphonenumber v9.0.32 as the latest upstream tag.
  • Main phone-number metadata changed.
  • Testing metadata was unchanged.
  • Short-number metadata was unchanged.
  • Carrier metadata changed to 31,024 prefix rows and 107 mobile portable regions.
  • Timezone metadata source digest changed; row count stayed at 3,294.
  • Geocoding metadata was unchanged after regeneration.
  • Freshness re-check with --fail-on-update: metadata is up to date.
  • Upstream JS test parity: passed, 172 upstream JS tests and 180 local ObjC tests.
  • Upstream JS API parity: passed, 66 upstream JS public prototype methods and 93 local ObjC public selectors.
  • Version consistency: passed for 1.7.2.
  • SwiftPM tests: passed, 230 tests.
  • Korean locale SwiftPM tests: passed, 230 tests.
  • Release build: passed.
  • CocoaPods lint: all podspecs available at release time passed validation.
  • Whitespace check: passed.

2026-05-23: Google libphonenumber v9.0.31

Scope

  • Previous local main, testing, and short-number metadata matched Google libphonenumber v9.0.30.
  • Updated main phone-number metadata to v9.0.31.
  • Updated short-number metadata to v9.0.31.
  • Testing metadata was unchanged between v9.0.30 and v9.0.31.
  • Verified issue #447 with a bundled-metadata regression test using the issue-style Uganda mobile input +25679(4)123456.

Issue #447 Verification

The Uganda mobile pattern changed from 9[0-3589] to 9[0-589], which includes the 794 range.

The new regression test failed against the previous v9.0.30 metadata because the parsed number was not valid for UG and its type was UNKNOWN. After regenerating from v9.0.31, the same issue-style input passed and classified the number as MOBILE.

Commands

swift scripts/checkMetadataFreshness.swift --output .build/metadata-freshness
swift test --filter PhoneNumberSwiftCoreTests/testUganda794MobileRangeFromIssue447
swift scripts/metadataGenerator.swift v9.0.31 --pretty
swift test --filter PhoneNumberSwiftCoreTests/testUganda794MobileRangeFromIssue447
swift scripts/updateProjectVersions.swift 1.7.1
swift scripts/checkMetadataFreshness.swift --current-ref v9.0.31 --output .build/metadata-freshness
swift scripts/checkUpstreamTestParity.swift --upstream-ref v9.0.31
swift scripts/checkUpstreamAPIParity.swift --upstream-ref v9.0.31
swift scripts/checkVersionConsistency.swift
swift test
LC_ALL=ko_KR.UTF-8 LANG=ko_KR.UTF-8 swift test
swift build -c release
git diff --check

xcodebuild test -scheme libPhoneNumber -destination 'id=1451ACEF-2B8C-480B-9D1F-873DBD717BAF' -derivedDataPath /tmp/libphone-xc-core-dd
xcodebuild test -scheme libPhoneNumberGeocoding -destination 'id=1451ACEF-2B8C-480B-9D1F-873DBD717BAF' -derivedDataPath /tmp/libphone-xc-geocoding-dd
xcodebuild test -scheme libPhoneNumberShortNumber -destination 'id=1451ACEF-2B8C-480B-9D1F-873DBD717BAF' -derivedDataPath /tmp/libphone-xc-shortnumber-dd

pod lib lint libPhoneNumber-iOS.podspec --allow-warnings
pod lib lint libPhoneNumberGeocoding.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumberShortNumber.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumberCarrier.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumberTimeZones.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftCore.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftGeocoding.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftShortNumber.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftCarrier.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftTimeZones.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftUI.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftUIEnrichment.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-Swift.podspec --allow-warnings --include-podspecs='*.podspec'

Results

  • Freshness check found Google libphonenumber v9.0.31 as the latest upstream tag.
  • Main phone-number metadata changed.
  • Short-number metadata changed.
  • Testing metadata was unchanged.
  • Issue #447 regression test: failed before the metadata update and passed after the metadata update.
  • SwiftPM tests: passed, 230 tests.
  • Korean locale SwiftPM tests: passed, 230 tests.
  • Release build: passed.
  • Whitespace check: passed.
  • Upstream JS test parity: passed, 172 upstream JS tests and 180 local ObjC tests.
  • Upstream JS API parity: passed, 66 upstream JS public prototype methods and 93 local ObjC public selectors.
  • Version consistency: passed for 1.7.1.
  • Xcode scheme tests: libPhoneNumber, libPhoneNumberGeocoding, and libPhoneNumberShortNumber passed on iPhone 16 simulator 1451ACEF-2B8C-480B-9D1F-873DBD717BAF.
  • CocoaPods lint: all podspecs available at release time passed validation.
  • Freshness re-check with --current-ref v9.0.31: metadata is up to date.

2026-05-12: Google libphonenumber v9.0.30

Scope

  • Previous local main and short-number metadata matched Google libphonenumber v9.0.25.
  • Updated main phone-number metadata to v9.0.30.
  • Updated short-number metadata to v9.0.30.
  • Updated testing metadata to v9.0.30.
  • Updated geocoding metadata to v9.0.30.
  • Added geocoding locale database kk.db.

Upstream Logic And Test Comparison

Compared these JavaScript files between v9.0.25 and v9.0.30:

  • javascript/i18n/phonenumbers/phonenumberutil.js
  • javascript/i18n/phonenumbers/phonenumberutil_test.js
  • javascript/i18n/phonenumbers/asyoutypeformatter.js
  • javascript/i18n/phonenumbers/asyoutypeformatter_test.js
  • javascript/i18n/phonenumbers/shortnumberinfo.js
  • javascript/i18n/phonenumbers/shortnumberinfo_test.js

Result: all files were unchanged. No required ObjC logic port or new upstream JS test port was identified for this metadata update.

Upstream Java had a PhoneNumberUtil.formatInOriginalFormat refactor between v9.0.25 and v9.0.30, but the JavaScript implementation remained unchanged. This project tracks Google JavaScript parity, so no immediate ObjC change was applied for that Java-only diff.

Carrier and timezone data changed upstream and are now packaged as opt-in modules after this baseline.

Commands

swift scripts/metadataGenerator.swift v9.0.30 --pretty
swift scripts/updateGeocodingMetadata.swift v9.0.30 --replace-bundle
swift scripts/updateCarrierMetadata.swift v9.0.30 --replace-bundle --output .build/carrier-metadata/v9.0.30
swift scripts/updateTimeZonesMetadata.swift v9.0.30 --replace-bundle --output .build/timezone-metadata/v9.0.30

swift scripts/checkUpstreamTestParity.swift --upstream-ref v9.0.30
swift scripts/checkUpstreamAPIParity.swift --upstream-ref v9.0.30
swift scripts/checkVersionConsistency.swift
swift test
LC_ALL=ko_KR.UTF-8 LANG=ko_KR.UTF-8 swift test
swift build -c release
git diff --check

pod lib lint libPhoneNumber-iOS.podspec --allow-warnings
pod lib lint libPhoneNumberGeocoding.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumberShortNumber.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumberCarrier.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumberTimeZones.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftCore.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftGeocoding.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftShortNumber.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftCarrier.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftTimeZones.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftUI.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-SwiftUIEnrichment.podspec --allow-warnings --include-podspecs='*.podspec'
pod lib lint libPhoneNumber-iOS-Swift.podspec --allow-warnings --include-podspecs='*.podspec'

Results

  • Upstream JS test parity: passed, 172 upstream JS tests and 180 local ObjC tests.
  • Upstream JS API parity: passed, 66 upstream JS public prototype methods and 93 local ObjC public selectors.
  • Version consistency: passed for 1.4.0.
  • SwiftPM default locale tests: passed, 204 tests.
  • SwiftPM Korean locale tests: passed, 204 tests.
  • Release build: passed.
  • Whitespace check: passed.
  • CocoaPods lint: all podspecs available at release time passed validation.
  • Geocoding database sanity check: 34 databases, en.db has 151 geocoding tables, kk.db has 1 geocoding table.
  • Carrier metadata sanity check: 31,001 prefix rows, 107 mobile portable regions, packed database about 2.0 MB.
  • Timezone metadata sanity check: 3,294 prefix rows, packed database about 232 KB.

Notes

  • libPhoneNumberGeocoding and libPhoneNumberShortNumber still emit CocoaPods Swift version warnings because those podspecs do not specify Swift version metadata. Validation passes with --allow-warnings.
  • No malformed geocoding database names such as (null)*.db were generated.