marinofelipe/swift-package-info

CLI tool, built on top of [Swift Argument Parser](https://github.com/apple/swift-argument-parser), that provides information about a *given Swift Package product*, such as a *measurement of its binary size impact*.

Usage

Examples

Run a complete analysis

swift-package-info --for https://github.com/ReactiveX/RxSwift -v 6.0.0 --product RxSwift

Check supported platforms (sub command)

swift-package-info platforms --for https://github.com/krzyzanowskim/CryptoSwift -v 1.3.8 --product CryptoSwift

See the binary size of a local package (e.g., under development framework)

swift-package-info binary-size --path ../project/my-framework

Report

swift-package-info --for https://github.com/ReactiveX/RxSwift -v 6.0.0 --product RxSwift

+------------------------------------------------+
|               Swift Package Info               |
|                                                |
|                 RxSwift, 6.0.0                 |
+--------------+---------------------------------+
| Provider     | Results                         |
+--------------+---------------------------------+
| Binary Size  | Binary size increases by 963 KB |
| Platforms    | System default                  |
| Dependencies | No third-party dependencies :)  |
+--------------+---------------------------------+
> Total of 3 providers used.

A custom report strategy can be passed via the report argument (check --help for supported values)

swift-package-info --for https://github.com/ReactiveX/RxSwift -v 6.0.0 --product RxSwift --report jsonDump

{
  "binarySize" : {
    "amount" : 962560,
    "formatted" : "963 KB"
  },
  "dependencies" : [

  ],
  "platforms" : {

  }
}

Requirements

Swift >= 6.1
Xcode >= 16.4

Installation

Install mint
Optionally add mint to your $PATH
Run: mint install marinofelipe/swift-package-info to install the latest version

Running

mint run swift-package-info
or simply, swift-package-info in case it was symlinked

Binary size report

Its methodology is inspired by cocoapods-size, and thus works by comparing archives with no bitcode and ARM64 arch. Such a strategy has proven consistent with the size of iOS apps downloaded and installed via TestFlight.

Thanks

Special thanks to @unnamedd for sharing his experience with swift-tools-support-core and on how to build a pretty 👌 report.

Contributing

Check the CONTRIBUTING.md file.

Package Metadata

Repository: marinofelipe/swift-package-info

Default branch: main

README: README.md