xcsize 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0d86f0fe7c228c1c06cbb79130d170d87f3268f06b11fa73dc235f0d403bfaf2
+  data.tar.gz: 3a2e220065e60cb8b5415c722d9fe7f4ddfb6c4d8b8fc2aa6dfb5b5f2b22c44c
+SHA512:
+  metadata.gz: c0732e5fc2794a03ae60f56234d25097f047a20237bc8a39506c6e2b9c15ba7ca9ab6b40702851d9df668f6fde733b45395901bf5fc42a1b59afeb74e5b88b18
+  data.tar.gz: 01f87c29009a16dd0f2c969182813be17934895c68259ff05e2db16d1dec59cffde428ed8aeebafe09afeb99b1cbf85a3621f22cb85d9a86fbf109db46c69271

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,25 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+## What did you do?
+
+
+## What did you expect to happen?
+
+
+## What happened instead?
+
+
+## Environment
+
+- `xcsize` version:
+- `xcode` version:
+- `macOS` version:
+
+## Additional context

data/.github/ISSUE_TEMPLATE/feature-request.md

@@ -0,0 +1,25 @@
+---
+name: Feature request
+about: Got any ideas about new features? Let us know!
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+## What are you trying to achieve?
+
+
+## If possible, how can you achieve this currently?
+
+
+## What would be the better way?
+
+
+## Environment
+
+- `xcsize` version:
+- `xcode` version:
+- `macOS` version:
+
+## Additional context

data/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: bundler
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 1
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 1

data/.gitignore

@@ -0,0 +1,44 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/spec/fixtures/
+/tmp/
+*.gem
+*.rbc
+/.config
+/coverage
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+Gemfile.lock
+report.xml
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db

data/.rubocop.yml

@@ -0,0 +1,144 @@
+---
+plugins:
+- rubocop-performance
+- rubocop-rake
+
+AllCops:
+  TargetRubyVersion: 2.4
+  NewCops: enable
+  Include:
+  - "**/*.rb"
+  - "**/*file"
+Style/MultipleComparison:
+  Enabled: false
+Style/PercentLiteralDelimiters:
+  Enabled: false
+Style/ClassCheck:
+  EnforcedStyle: kind_of?
+Style/FrozenStringLiteralComment:
+  Enabled: false
+Style/SafeNavigation:
+  Enabled: false
+Performance/RegexpMatch:
+  Enabled: false
+Performance/StringReplacement:
+  Enabled: false
+Performance/CollectionLiteralInLoop:
+  Enabled: false
+Style/NumericPredicate:
+  Enabled: false
+Metrics/BlockLength:
+  Enabled: false
+Metrics/ModuleLength:
+  Enabled: false
+Naming/VariableNumber:
+  Enabled: false
+Style/MissingRespondToMissing:
+  Enabled: false
+Style/MultilineBlockChain:
+  Enabled: false
+Style/NumericLiteralPrefix:
+  Enabled: false
+Style/TernaryParentheses:
+  Enabled: false
+Style/EmptyMethod:
+  Enabled: false
+Lint/UselessAssignment:
+  Exclude:
+  - "**/spec/**/*"
+Layout/FirstHashElementIndentation:
+  Enabled: false
+Layout/HashAlignment:
+  Enabled: false
+Layout/DotPosition:
+  Enabled: false
+Style/DoubleNegation:
+  Enabled: false
+Style/SymbolArray:
+  Enabled: false
+Layout/HeredocIndentation:
+  Enabled: false
+Style/MixinGrouping:
+  Exclude:
+  - "**/spec/**/*"
+Lint/SuppressedException:
+  Enabled: false
+Lint/UnusedBlockArgument:
+  Enabled: false
+Lint/AmbiguousBlockAssociation:
+  Enabled: false
+Style/GlobalVars:
+  Enabled: false
+Style/ClassAndModuleChildren:
+  Enabled: false
+Style/SpecialGlobalVars:
+  Enabled: false
+Metrics/AbcSize:
+  Enabled: false
+Metrics/MethodLength:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Enabled: false
+Style/WordArray:
+  MinSize: 19
+Style/SignalException:
+  Enabled: false
+Style/RedundantReturn:
+  Enabled: false
+Style/IfUnlessModifier:
+  Enabled: false
+Style/AndOr:
+  Enabled: true
+  EnforcedStyle: conditionals
+Metrics/ClassLength:
+  Max: 320
+Layout/LineLength:
+  Max: 370
+Metrics/ParameterLists:
+  Max: 17
+Metrics/PerceivedComplexity:
+  Max: 20
+Style/GuardClause:
+  Enabled: false
+Style/StringLiterals:
+  Enabled: false
+Style/ConditionalAssignment:
+  Enabled: false
+Style/RedundantSelf:
+  Enabled: false
+Lint/UnusedMethodArgument:
+  Enabled: false
+Lint/ParenthesesAsGroupedExpression:
+  Exclude:
+  - "**/spec/**/*"
+Naming/PredicatePrefix:
+  Enabled: false
+Style/PerlBackrefs:
+  Enabled: false
+Naming/FileName:
+  Exclude:
+  - "**/Dangerfile"
+  - "**/Brewfile"
+  - "**/Gemfile"
+  - "**/Podfile"
+  - "**/Rakefile"
+  - "**/Fastfile"
+  - "**/Scanfile"
+  - "**/Matchfile"
+  - "**/Appfile"
+  - "**/Allurefile"
+  - "**/Sonarfile"
+  - "**/Deliverfile"
+  - "**/Snapfile"
+  - "**/Pluginfile"
+  - "**/*.gemspec"
+Style/Documentation:
+  Enabled: false
+Style/MutableConstant:
+  Enabled: false
+Style/ZeroLengthPredicate:
+  Enabled: false
+Style/IfInsideElse:
+  Enabled: false
+Style/CollectionMethods:
+  Enabled: false

data/CHANGELOG

@@ -0,0 +1,11 @@
+# XCSize Changelog
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [1.0.0](https://github.com/testableapple/xcsize/releases/tag/1.0.0)
+
+_October 08, 2025_
+
+### ✅ Added
+
+- xcsize profile and compare commands

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'bundler'
+gem 'fastlane'
+gem 'rake'
+gem 'rubocop', '1.81.1'
+gem 'rubocop-performance', '1.26.0'
+gem 'rubocop-rake', '0.7.1'

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alexey Alter-Pesotskiy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+# XCSize
+
+A Ruby gem to profile iOS and macOS app and framework sizes from linkmap files, providing detailed breakdowns and insights.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'xcsize'
+```
+
+And then execute:
+
+```bash
+$ bundle install
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install xcsize
+```
+
+## Usage
+
+### Profile a single linkmap
+
+```bash
+xcsize profile --linkmap path/to/your/app.linkmap
+```
+
+Options:
+- `--linkmap STRING` - Linkmap file path
+- `--threshold BYTES` - Minimum size threshold in bytes (default: 0)
+
+### Compare two linkmaps
+
+```bash
+xcsize compare --old-linkmap old.linkmap --new-linkmap new.linkmap
+```
+
+Options:
+- `--old-linkmap STRING` - Old linkmap file path
+- `--new-linkmap STRING` - New linkmap file path
+- `--threshold BYTES` - Minimum size threshold in bytes (default: 0)
+
+## [fastlane](https://github.com/fastlane/fastlane) integration
+
+To get started with [xcsize fastlane plugin](https://github.com/testableapple/fastlane-plugin-xcsize), add it to your project by running:
+
+```bash
+fastlane add_plugin xcsize
+```
+
+### Usage
+
+```ruby
+lane :test do
+  xcsize(linkmap: 'path/to/your/app.linkmap')
+
+  xcsize_diff(old_linkmap: 'path/to/your/old.linkmap', new_linkmap: 'path/to/your/new.linkmap')
+end
+```
+
+## License
+
+This project is licensed under the terms of the MIT license. See the [LICENSE](LICENSE) file.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new(:rubocop)
+
+task(default: [:rubocop])

data/bin/xcsize

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
+require 'xcsize'
+
+Xcsize::CLI.run

data/fastlane/Fastfile

@@ -0,0 +1,27 @@
+opt_out_usage
+skip_docs
+
+lane :release do
+  code_review
+  sh('bundle exec rake build')
+  gem_path = "pkg/xcsize-#{version}.gem"
+  sh("gem push ../#{gem_path}")
+  set_github_release(
+    repository_name: 'testableapple/xcsize',
+    api_token: ENV.fetch("GITHUB_TOKEN", nil),
+    name: version,
+    tag_name: version,
+    description: "See [CHANGELOG.md](https://github.com/testableapple/xcsize/blob/main/CHANGELOG.md##{version.delete('.')})",
+    commitish: git_branch,
+    upload_assets: [gem_path]
+  )
+end
+
+lane :code_review do
+  sh('bundle exec rake')
+end
+
+def version
+  version_path = '../lib/xcsize/version.rb'
+  File.read(version_path).scan(/\d+/).join('.')
+end

data/lib/xcsize/cli.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Xcsize
+  class CLI
+    def self.run
+      program :name, 'xcsize'
+      program :version, Xcsize::VERSION
+      program :description, 'Measure iOS and macOS app and framework sizes using linkmaps'
+
+      command :profile do |c|
+        c.syntax = 'xcsize profile [options]'
+        c.description = 'Profile iOS and macOS binary using linkmap file'
+        c.option('-l', '--linkmap STRING', String, 'Set linkmap path')
+        c.option('-m', '--threshold INTEGER', Integer, 'Set minimum size threshold in bytes')
+        c.action do |_, options|
+          profiler = Xcsize::Profiler.new(
+            linkmap_path: options.linkmap,
+            threshold: options.threshold
+          )
+          profiler.profile
+        end
+      end
+
+      command :compare do |c|
+        c.syntax = 'xcsize compare [options]'
+        c.description = 'Compare two iOS and macOS binaries using linkmap files'
+        c.option('-o', '--old-linkmap STRING', String, 'Set old linkmap path')
+        c.option('-n', '--new-linkmap STRING', String, 'Set new linkmap path')
+        c.option('-m', '--threshold INTEGER', Integer, 'Set minimum size difference threshold in bytes')
+        c.action do |_, options|
+          comparator = Xcsize::Comparator.new(
+            old_linkmap_path: options.old_linkmap,
+            new_linkmap_path: options.new_linkmap,
+            threshold: options.threshold
+          )
+          comparator.compare
+        end
+      end
+    end
+  end
+end

data/lib/xcsize/comparator.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Xcsize
+  class Comparator
+    def initialize(old_linkmap_path:, new_linkmap_path:, threshold:)
+      @old_linkmap_path = old_linkmap_path
+      @new_linkmap_path = new_linkmap_path
+      @threshold = threshold
+    end
+
+    def compare
+      Reader.linkmaps(
+        old_linkmap_path: @old_linkmap_path,
+        new_linkmap_path: @new_linkmap_path,
+        threshold: @threshold
+      )
+    end
+  end
+end

data/lib/xcsize/profiler.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Xcsize
+  class Profiler
+    def initialize(linkmap_path:, threshold:)
+      @linkmap_path = linkmap_path
+      @threshold = threshold
+    end
+
+    def profile
+      Reader.linkmap(
+        linkmap_path: @linkmap_path,
+        threshold: @threshold
+      )
+    end
+  end
+end

data/lib/xcsize/reader.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+module Xcsize
+  class Reader
+    IGNORED_PATTERNS = [
+      /libclang_rt/i,
+      /libsystem/i,
+      /libobjc/i,
+      /libswift/i,
+      /linker synthesized/i
+    ]
+
+    def self.linkmap(linkmap_path:, threshold:)
+      threshold ||= 0
+      data = parse_linkmap(linkmap_path)
+      filtered_keys = data.keys.reject { |f| IGNORED_PATTERNS.any? { |r| f =~ r } }
+      total = total_size(data)
+
+      col1_width = filtered_keys.map(&:length).max || 40
+      col1_width = [col1_width, 15].max
+
+      puts "\n📊 Binary Size Report\n\n"
+      border(col1_width + 15)
+      puts "Total size: #{format_size(total)}"
+      border(col1_width + 15)
+      puts "\n"
+      puts format("%-#{col1_width}s %12s", 'Object File', 'Size')
+      border(col1_width + 15)
+
+      details = {}
+      filtered_keys
+        .select { |file| data[file] >= threshold }
+        .sort_by { |file| data[file] }
+        .reverse_each do |file|
+          printf "%-#{col1_width}s %12d\n", file, data[file]
+          details[file] = data[file]
+        end
+
+      { total_size: total, details: details }
+    end
+
+    def self.linkmaps(old_linkmap_path:, new_linkmap_path:, threshold:)
+      threshold ||= 0
+      old_data = parse_linkmap(old_linkmap_path)
+      new_data = parse_linkmap(new_linkmap_path)
+
+      all_keys = (old_data.keys + new_data.keys).uniq
+      filtered_keys = all_keys.reject { |f| IGNORED_PATTERNS.any? { |r| f =~ r } }
+
+      old_total = total_size(old_data)
+      new_total = total_size(new_data)
+      diff_total = new_total - old_total
+
+      col1_width = filtered_keys.map(&:length).max || 40
+      col1_width = [col1_width, 15].max
+
+      puts "\n📊 Binary Size Comparison\n\n"
+      border(col1_width + 50)
+      puts "Old binary size:  #{format_size(old_total)}"
+      puts "New binary size: #{format_size(new_total)}"
+      puts "Difference:       #{'+' if diff_total.positive?}#{format_size(diff_total)}"
+      border(col1_width + 50)
+      puts "\n"
+      puts format("%-#{col1_width}s %12s %12s %12s", 'Object File', 'Old Size', 'New Size', 'Diff')
+      border(col1_width + 50)
+
+      details = {}
+      filtered_keys
+        .select { |file| ((new_data[file] || 0) - (old_data[file] || 0)).abs >= threshold }
+        .sort_by { |file| ((new_data[file] || 0) - (old_data[file] || 0)).abs }
+        .reverse_each do |file|
+          o = old_data[file] || 0
+          n = new_data[file] || 0
+          diff = n - o
+          diff_str = if diff.zero?
+                       '+0'
+                     else
+                       (diff.positive? ? "+#{diff}" : diff.to_s)
+                     end
+          printf "%-#{col1_width}s %12d %12d %12s\n", file, o, n, diff_str
+          details[file] = diff_str
+        end
+
+      {
+        old_total_size: old_total,
+        new_total_size: new_total,
+        difference: diff_total,
+        details: details
+      }
+    end
+
+    def self.parse_linkmap(path)
+      unless File.exist?(path)
+        puts("Error: linkmap file not found: #{path}")
+        exit(1)
+      end
+
+      files = {}
+      in_objects = false
+      in_symbols = false
+      id_to_path = {}
+
+      File.foreach(path, chomp: true) do |line|
+        if line.start_with?('# Object files:')
+          in_objects = true
+          next
+        elsif line.start_with?('# Sections:')
+          in_objects = false
+        elsif line.start_with?('# Symbols:')
+          in_symbols = true
+          next
+        end
+
+        if in_objects && line =~ /\[\s*(\d+)\]\s*(.*)/
+          id = Regexp.last_match(1)
+          full_path = Regexp.last_match(2)
+          short_name = File.basename(full_path)
+          id_to_path[id] = short_name
+          files[short_name] = 0
+        end
+
+        if in_symbols && line =~ /^0x[0-9A-Fa-f]+\s+0x?([0-9A-Fa-f]+)\s+\[\s*(\d+)\]/
+          size = Regexp.last_match(1).to_i(16)
+          id = Regexp.last_match(2)
+          files[id_to_path[id]] ||= 0
+          files[id_to_path[id]] += size
+        end
+      end
+
+      files
+    end
+
+    def self.total_size(files)
+      files.values.compact.sum
+    end
+
+    def self.format_size(bytes)
+      kb = bytes / 1024.0
+      mb = kb / 1024.0
+      "#{bytes} bytes (#{kb.round(2)} KB / #{mb.round(2)} MB)"
+    end
+
+    def self.border(width)
+      puts '-' * width
+    end
+  end
+end

data/lib/xcsize/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Xcsize
+  VERSION = '1.0.0'
+end

data/lib/xcsize.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative 'xcsize/version'
+require_relative 'xcsize/profiler'
+require_relative 'xcsize/comparator'
+require_relative 'xcsize/reader'
+require_relative 'xcsize/cli'
+require 'commander/import'
+require 'json'
+
+module Xcsize
+end

data/xcsize.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'lib/xcsize/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'xcsize'
+  spec.version = Xcsize::VERSION
+  spec.authors = ['Alexey Alter-Pesotskiy']
+  spec.email = ['alex@testableapple.com']
+
+  spec.summary = 'Measure iOS and macOS app and framework sizes using linkmaps'
+  spec.description = 'A Ruby gem to profile iOS and macOS app and framework sizes from linkmap files, providing detailed breakdowns and insights.'
+  spec.homepage = 'https://github.com/testableapple/xcsize'
+  spec.license = 'MIT'
+
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.bindir = 'bin'
+  spec.executables = ['xcsize']
+  spec.files = `git ls-files -z`.split("\x0")
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 2.4'
+
+  spec.add_dependency('commander', '~> 4.6')
+
+  spec.metadata['rubygems_mfa_required'] = 'true'
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: xcsize
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Alexey Alter-Pesotskiy
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-10-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.6'
+description: A Ruby gem to profile iOS and macOS app and framework sizes from linkmap
+  files, providing detailed breakdowns and insights.
+email:
+- alex@testableapple.com
+executables:
+- xcsize
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/ISSUE_TEMPLATE/bug_report.md"
+- ".github/ISSUE_TEMPLATE/feature-request.md"
+- ".github/dependabot.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/xcsize
+- fastlane/Fastfile
+- lib/xcsize.rb
+- lib/xcsize/cli.rb
+- lib/xcsize/comparator.rb
+- lib/xcsize/profiler.rb
+- lib/xcsize/reader.rb
+- lib/xcsize/version.rb
+- xcsize.gemspec
+homepage: https://github.com/testableapple/xcsize
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/testableapple/xcsize
+  source_code_uri: https://github.com/testableapple/xcsize
+  changelog_uri: https://github.com/testableapple/xcsize/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: Measure iOS and macOS app and framework sizes using linkmaps
+test_files: []