cocoapods-graph 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6d00b5c1eced22d283334372175b45d6a166c71261dcada2731d9581a86facc9
+  data.tar.gz: 6c11214289c0328e13214292758d3757bcafa6f70367b9f84effa7b17e7b038b
+SHA512:
+  metadata.gz: 1477ae702985ad56ff75ad3c134b41fdc85a216d0616399cdd4660b64613f84b588f30c0e56f0e2d1496bbee637f39687da166045d352ed927e02f46d2b205b9
+  data.tar.gz: edc4c0d543bd6ee201d84496041e0476c95b89a50db097a5746eb4efa2d5964f98fc734ddb2ad7467aa60f82cf32d9deec338b8fe47bf04cf12e54c8c872ab84

data/CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-12-15
+
+### Added
+- 🎉 Initial release of CocoaPods Graph
+- ✨ Interactive dependency wheel visualization using D3.js
+- 🔍 Smart search functionality with auto-complete dropdown
+- 📊 Real-time statistics dashboard (total packages, direct dependencies, total dependencies)
+- 📱 Responsive design that works on desktop and mobile
+- 🎨 Modern UI/UX with gradient backgrounds and smooth animations
+- 🌐 Self-contained HTML output that works offline
+- 📄 JSON export for programmatic access
+- 🖥️ Console output for quick dependency inspection
+- 💎 Ruby gem distribution for easy installation
+- 📖 Comprehensive documentation and examples
+
+### Technical Features
+- **Command-line interface** with multiple output options
+- **Modular Ruby architecture** with clean separation of concerns
+- **Professional HTML template** with embedded CSS and JavaScript
+- **D3.js integration** for interactive visualizations
+- **Search and highlight** functionality for exploring large dependency graphs
+- **Color-coded visualization** for easy package identification
+- **Hover effects and animations** for better user experience
+
+### Supported Formats
+- HTML: Interactive dependency wheel with search functionality
+- JSON: Structured data for programmatic use
+- Console: Quick text-based dependency listing

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cocoapods-graph.gemspec
+gemspec
+
+gem 'bundler', '~> 2.0'
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.0'

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2025 Erick Jung
+
+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,217 @@
+# 📦 CocoaPods Graph
+
+[![Gem Version](https://badge.fury.io/rb/cocoapods-graph.svg)](https://badge.fury.io/rb/cocoapods-graph)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Generate beautiful, interactive dependency graphs for your CocoaPods projects. Transform your `Podfile.lock` into stunning visualizations that help you understand complex pod relationships.
+
+![CocoaPods Graph Demo](https://raw.githubusercontent.com/erickjung/cocoapods-graph/main/assets/demo.gif)
+
+## ✨ Features
+
+- **🎨 Interactive Dependency Wheel**: Beautiful D3.js visualization with hover effects and smooth animations
+- **🔍 Smart Search**: Find and highlight specific packages instantly with auto-complete dropdown
+- **📊 Detailed Statistics**: Real-time stats showing total packages, direct dependencies, and relationships
+- **📱 Responsive Design**: Works perfectly on desktop and mobile devices
+- **🎯 Modern UI/UX**: Clean, professional interface with gradient backgrounds and smooth transitions
+- **⚡ Fast Performance**: Optimized for projects with hundreds of dependencies
+- **🌐 Self-contained**: Generated HTML files work offline with no external dependencies
+
+## 🚀 Installation
+
+### Install as a Gem (Recommended)
+
+```bash
+gem install cocoapods-graph
+```
+
+### Install from Source
+
+```bash
+git clone https://github.com/erickjung/cocoapods-graph.git
+cd cocoapods-graph
+bundle install
+gem build cocoapods-graph.gemspec
+gem install cocoapods-graph-*.gem
+```
+
+## 📖 Usage
+
+### Basic Usage
+
+```bash
+# Generate interactive HTML report
+cocoapods-graph -f Podfile.lock --html
+
+# Generate JSON data
+cocoapods-graph -f Podfile.lock --json
+
+# Print dependencies to console
+cocoapods-graph -f Podfile.lock --show
+
+# Generate both HTML and JSON
+cocoapods-graph -f Podfile.lock --html --json
+```
+
+### Command Line Options
+
+| Option | Description |
+|--------|-------------|
+| `-f, --file FILE` | Specify path to Podfile.lock file |
+| `--html` | Generate interactive HTML dependency wheel |
+| `--json` | Generate JSON data file |
+| `--show` | Print dependencies to console |
+| `-h, --help` | Show help message |
+| `-v, --version` | Show version |
+
+### Examples
+
+```bash
+# In your iOS project directory
+cocoapods-graph -f Podfile.lock --html
+# Creates: Podfile.lock.html
+
+# Specify custom file path
+cocoapods-graph -f MyProject/Podfile.lock --html --json
+# Creates: MyProject/Podfile.lock.html and MyProject/Podfile.lock.json
+
+# Quick dependency check
+cocoapods-graph -f Podfile.lock --show
+```
+
+## 🎨 Features Showcase
+
+### Interactive Dependency Wheel
+
+![WordPress iOS App Dependencies](docs/Wordpress-Report.png)
+*Example dependency visualization from the WordPress iOS app, showing the interactive dependency wheel with search functionality and statistics dashboard.*
+
+📊 **[Try the live interactive demo!](docs/Wordpress-Report.html)** - Open the full WordPress iOS app dependency visualization
+
+- **Hover effects**: Move your mouse over any package to see its relationships
+- **Visual highlighting**: Related dependencies are highlighted while others fade
+- **Color coding**: Each package gets a unique color for easy identification
+- **Smooth animations**: Elegant transitions make exploration enjoyable
+
+### Smart Search Functionality
+- **Live search**: Results appear as you type
+- **Auto-complete**: Dropdown shows matching packages with dependency counts
+- **One-click selection**: Click any result to highlight it on the wheel
+- **Keyboard navigation**: Use Enter/Escape for quick actions
+
+### Professional Statistics Dashboard
+- **Total Packages**: Count of all pods in your project
+- **Direct Dependencies**: Number of pods your app directly depends on
+- **Total Dependencies**: Sum of all dependency relationships
+- **Real-time updates**: Stats update as you explore the graph
+
+## 📁 Output Files
+
+### HTML Report (`Podfile.lock.html`)
+- Self-contained interactive visualization
+- Modern, responsive design
+- Search and highlight functionality
+- Professional statistics dashboard
+- Offline-ready (no internet required)
+
+### JSON Data (`Podfile.lock.json`)
+- Structured dependency data
+- Perfect for CI/CD integration
+- Easy to parse programmatically
+- Compatible with other tools
+
+## 🛠️ Development
+
+### Setup Development Environment
+
+```bash
+git clone https://github.com/erickjung/cocoapods-graph.git
+cd cocoapods-graph
+bundle install
+```
+
+### Run Tests
+
+```bash
+bundle exec rake
+```
+
+### Build Gem Locally
+
+```bash
+gem build cocoapods-graph.gemspec
+gem install cocoapods-graph-*.gem
+```
+
+## 🏗️ Project Structure
+
+```
+cocoapods-graph/
+├── lib/
+│   ├── cocoapods_graph.rb          # Main module
+│   └── cocoapods_graph/
+│       ├── version.rb              # Version constant
+│       ├── pod_class.rb            # Pod data structure
+│       ├── generator.rb            # Core parsing logic
+│       └── template.html           # HTML template
+├── exe/
+│   └── cocoapods-graph             # Executable binary
+├── cocoapods-graph.gemspec         # Gem specification
+└── README.md                       # This file
+```
+
+## 🤝 Contributing
+
+We welcome contributions! Here's how you can help:
+
+1. **Fork the repository**
+2. **Create a feature branch**: `git checkout -b my-new-feature`
+3. **Make your changes** and add tests if applicable
+4. **Commit your changes**: `git commit -am 'Add some feature'`
+5. **Push to the branch**: `git push origin my-new-feature`
+6. **Submit a pull request**
+
+### Ideas for Contributions
+- Add more visualization types (tree view, network graph)
+- Implement filtering and grouping options
+- Add export to other formats (SVG, PNG, PDF)
+- Create VS Code / Xcode extensions
+- Add support for other dependency managers
+
+## 📝 Changelog
+
+### v1.0.0 (2024-XX-XX)
+- 🎉 Initial release
+- ✨ Interactive dependency wheel visualization
+- 🔍 Smart search functionality
+- 📊 Statistics dashboard
+- 📱 Responsive design
+- 🌐 Self-contained HTML output
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 👨‍💻 Author
+
+**Erick Jung** - [E7G](https://www.erickjung.com)
+- Email: talk@erickjung.com
+- GitHub: [@erickjung](https://github.com/erickjung)
+
+## 🙏 Acknowledgments
+
+- Built with [D3.js](https://d3js.org/) for beautiful visualizations
+- Inspired by the need for better dependency analysis tools
+- Thanks to the CocoaPods team for creating an amazing dependency manager
+
+## ⭐ Support
+
+If you find this tool helpful, please give it a star on GitHub! ⭐
+
+Found a bug or have a feature request? [Open an issue](https://github.com/erickjung/cocoapods-graph/issues)
+
+---
+
+<div align="center">
+  <sub>Built with ❤️ by <a href="https://www.erickjung.com">E7G</a></sub>
+</div>

data/Rakefile

@@ -0,0 +1,18 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+desc 'Run tests'
+task default: :spec
+
+desc 'Install gem locally'
+task :install_local do
+  sh 'gem build cocoapods-graph.gemspec'
+  sh 'gem install cocoapods-graph-*.gem'
+end
+
+desc 'Uninstall gem'
+task :uninstall do
+  sh 'gem uninstall cocoapods-graph'
+end

data/cocoapods-graph.gemspec

@@ -0,0 +1,44 @@
+require_relative "lib/cocoapods_graph/version"
+require_relative "lib/cocoapods_graph/constants"
+
+Gem::Specification.new do |spec|
+  spec.name          = CocoaPodsGraph::PROJECT_NAME
+  spec.version       = CocoaPodsGraph::VERSION
+  spec.authors       = [CocoaPodsGraph::PROJECT_AUTHOR]
+  spec.email         = [CocoaPodsGraph::PROJECT_EMAIL]
+
+  spec.summary       = CocoaPodsGraph::PROJECT_SUMMARY
+  spec.description   = "A Ruby gem that parses Podfile.lock files and generates beautiful, interactive dependency wheel visualizations using D3.js. Perfect for understanding complex pod relationships in your iOS projects."
+  spec.homepage      = CocoaPodsGraph::PROJECT_HOMEPAGE
+  spec.license       = CocoaPodsGraph::PROJECT_LICENSE
+  spec.required_ruby_version = ">= 2.6.0"
+
+  spec.metadata["allowed_push_host"] = "https://rubygems.org"
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = CocoaPodsGraph::PROJECT_SOURCE_CODE_URI
+  spec.metadata["changelog_uri"] = CocoaPodsGraph::PROJECT_CHANGELOG_URI
+
+  # Specify which files should be added to the gem when it is released.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    Dir.glob("lib/**/*") + Dir.glob("exe/*") + %w[
+      cocoapods-graph.gemspec
+      README.md
+      LICENSE
+      CHANGELOG.md
+      Gemfile
+      Rakefile
+    ]
+  end
+  
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Runtime dependencies
+  spec.add_dependency "json", "~> 2.0"
+
+  # Development dependencies
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/exe/cocoapods-graph

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'optparse'
+require_relative '../lib/cocoapods_graph'
+
+module CocoaPodsGraph
+  class CLI
+    VERSION = CocoaPodsGraph::VERSION
+
+    def self.run
+      options = {}
+      
+      parser = OptionParser.new do |parser|
+        parser.banner = 'Usage: cocoapods-graph [options]'
+        parser.on('-f', '--file FILE', 'Specify Podfile.lock file path') { |f| options[:file] = f }
+        parser.on('--show', 'Print dependencies on console') { options[:show] = true }
+        parser.on('--json', 'Save dependencies to JSON file') { options[:json] = true }
+        parser.on('--html', 'Save dependencies to interactive HTML wheel graph') { options[:html] = true }
+        parser.on('-v', '--version', 'Show version') do
+          puts VERSION
+          exit
+        end
+        parser.on('-h', '--help', 'Show this help message') do
+          puts parser
+          puts "\nExamples:"
+          puts "  cocoapods-graph -f Podfile.lock --html    # Generate interactive HTML report"
+          puts "  cocoapods-graph -f Podfile.lock --json    # Generate JSON output"  
+          puts "  cocoapods-graph -f Podfile.lock --show    # Print to console"
+          puts "  cocoapods-graph -f Podfile.lock --html --json  # Generate both HTML and JSON"
+          exit
+        end
+      end
+      
+      begin
+        parser.parse!
+      rescue OptionParser::InvalidOption, OptionParser::MissingArgument => e
+        puts "Error: #{e.message}"
+        puts parser
+        exit(1)
+      end
+
+      if ARGV.empty? && options.empty?
+        puts "#{PROJECT_NAME} - #{VERSION} (#{PROJECT_DESCRIPTION})"
+        puts "by #{PROJECT_AUTHOR_WITH_EMAIL}"
+        puts 'Type: cocoapods-graph -h to see more information'
+        exit(1)
+      end
+
+      if options[:file] && !options[:file].empty?
+        unless options[:show] || options[:json] || options[:html]
+          puts 'You must select an output option (--show | --json | --html)'
+          exit(1)
+        end
+
+        # Add .lock extension if not present
+        options[:file] += '.lock' unless options[:file].include?('.lock')
+
+        unless File.exist?(options[:file])
+          puts "Error: File '#{options[:file]}' not found"
+          exit(1)
+        end
+
+        result = CocoaPodsGraph::Generator.parse_lock_file(options[:file])
+
+        if options[:show]
+          puts 'Printing dependencies...'
+          result.each(&:print_object)
+        end
+
+        if options[:json]
+          puts 'Saving JSON file...'
+          CocoaPodsGraph::Generator.save_json_file(result, options[:file])
+        end
+
+        if options[:html]
+          puts 'Saving HTML file...'
+          CocoaPodsGraph::Generator.save_html_wheel_file(result, options[:file])
+        end
+
+        puts 'Done!'
+      else
+        puts 'Error: Please specify a Podfile.lock file with -f option'
+        exit(1)
+      end
+    end
+  end
+end
+
+CocoaPodsGraph::CLI.run if __FILE__ == $PROGRAM_NAME

data/lib/cocoapods_graph/constants.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module CocoaPodsGraph
+  # Project metadata constants - single source of truth
+  PROJECT_NAME = 'cocoapods-graph'
+  PROJECT_DESCRIPTION = 'Generate interactive dependency graphs for CocoaPods projects'
+  PROJECT_AUTHOR = 'Erick Jung'
+  PROJECT_EMAIL = 'talk@erickjung.com'
+  PROJECT_HOMEPAGE = 'https://github.com/erickjung/cocoapods-graph'
+  PROJECT_SOURCE_CODE_URI = 'https://github.com/erickjung/cocoapods-graph'
+  PROJECT_CHANGELOG_URI = 'https://github.com/erickjung/cocoapods-graph/blob/main/CHANGELOG.md'
+  PROJECT_LICENSE = 'MIT'
+  
+  # Derived constants for convenience
+  PROJECT_AUTHOR_WITH_EMAIL = "#{PROJECT_AUTHOR} (#{PROJECT_EMAIL})"
+  PROJECT_SUMMARY = 'Interactive dependency wheel visualizations for CocoaPods projects'
+end

data/lib/cocoapods_graph/generator.rb

@@ -0,0 +1,96 @@
+require 'json'
+require 'time'
+
+module CocoaPodsGraph
+  class Generator
+
+    def self.parse_lock_file(file_name)
+      def self.parse_lock_pods_line(line)
+        begin
+          name = line[line.index('-') + 1...line.index('(')].strip
+        rescue
+          name = line[line.index('-') + 1..-1].strip
+        end
+
+        begin
+          version = line[line.index('(') + 1...line.index(')')].strip
+        rescue
+          version = ''
+        end
+
+        PodClass.new(name, version, [])
+      end
+
+      content_file = File.readlines(file_name).map { |x| x.chomp.delete('"') }
+
+      result_list = []
+      pod = PodClass.new('', '', [])
+      
+      content_file.each do |line|
+        if line.start_with?('  -')
+          result_list << pod if pod.name.length > 0
+          pod = parse_lock_pods_line(line)
+        elsif line.start_with?('    -')
+          pod.dependencies << parse_lock_pods_line(line)
+        elsif line.start_with?('DEPENDENCIES')
+          result_list << pod if pod.name.length > 0
+          break
+        end
+      end
+
+      result_list
+    end
+
+    def self.generate_json(result_list)
+      def self.generate_json_deps(result_list)
+        data = '{'
+        result_list.each do |result|
+          data += '"%s":"1",' % [result.name]
+        end
+        data = data[0...-1]
+        data + '}'
+      end
+
+      json = '{"packages": ['
+      deps = generate_json_deps(result_list)
+      json += '{"name":"app","require":%s},' % deps
+
+      result_list.each do |pod|
+        if pod.dependencies.length > 0
+          pod_deps = generate_json_deps(pod.dependencies)
+          json += '{"name":"%s","require":%s},' % [pod.name, pod_deps]
+        else
+          json += '{"name":"%s","require":{}},' % pod.name
+        end
+      end
+
+      json[0...-1] + ']}'
+    end
+
+    def self.save_json_file(data, file_name)
+      File.open(file_name + '.json', 'w') do |outfile|
+        outfile.write(generate_json(data))
+      end
+    end
+
+    def self.save_html_wheel_file(data, file_name)
+      template_path = File.join(__dir__, 'template.html')
+      p_template = File.read(template_path)
+      p_data_json = "'%s'" % generate_json(data)
+      p_data_width = '960'
+      p_data_margin = '200'
+      p_data_padding = '.02'
+      p_generation_date = Time.now.strftime('%B %d, %Y at %I:%M %p')
+
+      html_out = p_template.gsub('P_DATA_JSON', p_data_json)
+                          .gsub('P_DATA_WIDTH', p_data_width)
+                          .gsub('P_DATA_MARGIN', p_data_margin)
+                          .gsub('P_DATA_PADDING', p_data_padding)
+                          .gsub('P_GENERATION_DATE', p_generation_date)
+
+      File.open(file_name + '.html', 'w') do |outfile|
+        outfile.write(html_out)
+      end
+    end
+  end
+end

data/lib/cocoapods_graph/pod_class.rb

@@ -0,0 +1,18 @@
+module CocoaPodsGraph
+  class PodClass
+    attr_accessor :name, :version, :dependencies
+
+    def initialize(name, version, dependencies)
+      @name = name
+      @version = version
+      @dependencies = dependencies
+    end
+
+    def print_object
+      puts "#{@name} #{@version}"
+      @dependencies.each do |dep|
+        puts "  #{dep.name} #{dep.version}"
+      end
+    end
+  end
+end

data/lib/cocoapods_graph/template.html

@@ -0,0 +1,537 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>CocoaPods Dependencies Graph</title>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        
+        body {
+            font-family: "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            color: #333;
+            line-height: 1.6;
+        }
+        
+        .header {
+            text-align: center;
+            padding: 2rem 1rem 1rem;
+            color: white;
+        }
+        
+        .header h1 {
+            font-size: 2.5rem;
+            font-weight: 700;
+            margin-bottom: 0.5rem;
+            text-shadow: 0 2px 4px rgba(0,0,0,0.3);
+        }
+        
+        .header p {
+            font-size: 1.1rem;
+            opacity: 0.9;
+            font-weight: 300;
+        }
+        
+        .main-container {
+            max-width: 1200px;
+            margin: 0 auto;
+            padding: 0 1rem;
+        }
+        
+        .chart-container {
+            background: white;
+            border-radius: 16px;
+            box-shadow: 0 20px 40px rgba(0,0,0,0.1);
+            padding: 2rem;
+            margin-bottom: 2rem;
+            position: relative;
+            overflow: hidden;
+        }
+        
+        .chart-container::before {
+            content: "";
+            position: absolute;
+            top: 0;
+            left: 0;
+            right: 0;
+            height: 4px;
+            background: linear-gradient(90deg, #667eea, #764ba2);
+        }
+        
+        .chart-header {
+            text-align: center;
+            margin-bottom: 2rem;
+        }
+        
+        .chart-title {
+            font-size: 1.5rem;
+            font-weight: 600;
+            color: #2d3748;
+            margin-bottom: 0.5rem;
+        }
+        
+        .chart-subtitle {
+            color: #718096;
+            font-size: 0.95rem;
+        }
+        
+        #chart_placeholder {
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            min-height: 500px;
+            position: relative;
+        }
+        
+        .dependencyWheel {
+            font: 11px "Inter", sans-serif;
+            filter: drop-shadow(0 4px 8px rgba(0,0,0,0.1));
+        }
+        
+        .group text {
+            font-weight: 500;
+            font-size: 11px;
+        }
+        
+        .chord {
+            transition: opacity 0.3s ease;
+        }
+        
+        .group path {
+            transition: all 0.3s ease;
+        }
+        
+        .group:hover path {
+            transform: scale(1.02);
+            filter: brightness(1.1);
+        }
+        
+        .instructions {
+            background: #f7fafc;
+            border-radius: 12px;
+            padding: 1.5rem;
+            margin-bottom: 2rem;
+            border-left: 4px solid #667eea;
+        }
+        
+        .instructions h3 {
+            color: #2d3748;
+            font-size: 1.1rem;
+            font-weight: 600;
+            margin-bottom: 0.5rem;
+            display: flex;
+            align-items: center;
+            gap: 0.5rem;
+        }
+        
+        .instructions ul {
+            color: #4a5568;
+            font-size: 0.9rem;
+            list-style: none;
+            padding-left: 0;
+        }
+        
+        .instructions li {
+            margin-bottom: 0.3rem;
+            padding-left: 1.2rem;
+            position: relative;
+        }
+        
+        .instructions li::before {
+            content: "•";
+            color: #667eea;
+            font-weight: bold;
+            position: absolute;
+            left: 0;
+        }
+        
+        .search-container {
+            background: #f8fafc;
+            border-radius: 8px;
+            padding: 1rem;
+            margin-bottom: 1.5rem;
+            border: 1px solid #e2e8f0;
+        }
+        
+        .search-header {
+            display: flex;
+            align-items: center;
+            gap: 0.5rem;
+            margin-bottom: 0.75rem;
+            color: #2d3748;
+            font-weight: 600;
+            font-size: 1rem;
+        }
+        
+        .search-input-container {
+            position: relative;
+            margin-bottom: 0.75rem;
+        }
+        
+        .search-input {
+            width: 100%;
+            padding: 0.75rem 1rem 0.75rem 2.5rem;
+            border: 2px solid #e2e8f0;
+            border-radius: 8px;
+            font-size: 1rem;
+            font-family: inherit;
+            transition: all 0.3s ease;
+        }
+        
+        .search-input:focus {
+            outline: none;
+            border-color: #667eea;
+            box-shadow: 0 0 0 3px rgba(102, 126, 234, 0.1);
+        }
+        
+        .search-icon {
+            position: absolute;
+            left: 0.75rem;
+            top: 50%;
+            transform: translateY(-50%);
+            color: #718096;
+            font-size: 1.1rem;
+        }
+        
+        .search-results {
+            max-height: 200px;
+            overflow-y: auto;
+            border: 1px solid #e2e8f0;
+            border-radius: 6px;
+            background: white;
+            position: absolute;
+            width: 100%;
+            z-index: 10;
+            box-shadow: 0 4px 12px rgba(0,0,0,0.1);
+            display: none;
+        }
+        
+        .search-result-item {
+            padding: 0.75rem 1rem;
+            cursor: pointer;
+            border-bottom: 1px solid #f7fafc;
+            transition: background-color 0.2s ease;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+        }
+        
+        .search-result-item:hover {
+            background-color: #f7fafc;
+        }
+        
+        .search-result-item:last-child {
+            border-bottom: none;
+        }
+        
+        .search-result-name {
+            font-weight: 500;
+            color: #2d3748;
+        }
+        
+        .search-result-version {
+            font-size: 0.85rem;
+            color: #718096;
+            font-family: monospace;
+        }
+        
+        .stats {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+            gap: 1rem;
+            margin-bottom: 2rem;
+        }
+        
+        .stat-card {
+            background: white;
+            border-radius: 12px;
+            padding: 1.5rem;
+            text-align: center;
+            box-shadow: 0 4px 12px rgba(0,0,0,0.05);
+            border: 1px solid #e2e8f0;
+        }
+        
+        .stat-number {
+            font-size: 2rem;
+            font-weight: 700;
+            color: #667eea;
+            margin-bottom: 0.25rem;
+        }
+        
+        .stat-label {
+            color: #718096;
+            font-size: 0.9rem;
+            font-weight: 500;
+        }
+        
+        .footer {
+            text-align: center;
+            padding: 2rem 1rem;
+            color: rgba(255,255,255,0.8);
+            font-size: 0.85rem;
+        }
+        
+        .loading {
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            min-height: 300px;
+            color: #718096;
+            font-size: 1.1rem;
+        }
+        
+        .spinner {
+            width: 40px;
+            height: 40px;
+            border: 3px solid #e2e8f0;
+            border-top: 3px solid #667eea;
+            border-radius: 50%;
+            animation: spin 1s linear infinite;
+            margin-right: 1rem;
+        }
+        
+        @keyframes spin {
+            0% { transform: rotate(0deg); }
+            100% { transform: rotate(360deg); }
+        }
+        
+        @media (max-width: 768px) {
+            .header h1 { font-size: 2rem; }
+            .chart-container { padding: 1rem; margin: 0 0.5rem 1rem; }
+            .stats { grid-template-columns: 1fr 1fr; gap: 0.75rem; }
+        }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <h1>📦 CocoaPods Dependencies</h1>
+        <p>Interactive dependency visualization for your iOS project</p>
+    </div>
+    
+    <div class="main-container">
+        <div class="stats" id="stats"></div>
+        
+        <div class="chart-container">
+            <div class="chart-header">
+                <h2 class="chart-title">Dependencies Wheel</h2>
+                <p class="chart-subtitle">Hover over packages to explore relationships</p>
+            </div>
+            
+            <div class="search-container">
+                <div class="search-header">
+                    🔍 Search Packages
+                </div>
+                <div class="search-input-container">
+                    <span class="search-icon">🔍</span>
+                    <input 
+                        type="text" 
+                        id="packageSearch" 
+                        class="search-input" 
+                        placeholder="Type package name to search and highlight..."
+                        autocomplete="off"
+                    />
+                    <div id="searchResults" class="search-results"></div>
+                </div>
+            </div>
+            
+            <div id="chart_placeholder">
+                <div class="loading">
+                    <div class="spinner"></div>
+                    Loading dependency graph...
+                </div>
+            </div>
+        </div>
+        
+        <div class="instructions">
+            <h3>🎯 How to use this visualization</h3>
+            <ul>
+                <li>Hover over any package name or arc to highlight its dependencies</li>
+                <li>The curves (chords) show dependency relationships between packages</li>
+                <li>Thicker arcs represent packages with more dependencies</li>
+                <li>Colors help distinguish different packages and their relationships</li>
+            </ul>
+        </div>
+    </div>
+    
+    <div class="footer">
+        Generated by CocoaPods Graph • Made with ❤️ by <a href="https://www.erickjung.com" target="_blank" style="color: rgba(255,255,255,0.9); text-decoration: none;">E7G</a><br>
+        <small>Generated on P_GENERATION_DATE</small>
+    </div>
+    
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/d3/4.13.0/d3.min.js"></script>
+    <script>
+        // Parse data and show stats
+        const data = JSON.parse(P_DATA_JSON);
+        const totalPackages = data.packages.length;
+        const appDependencies = Object.keys(data.packages[0].require).length;
+        const totalDependencies = data.packages.reduce((sum, pkg) => sum + Object.keys(pkg.require).length, 0);
+        
+        document.getElementById("stats").innerHTML = `
+            <div class="stat-card">
+                <div class="stat-number">${totalPackages}</div>
+                <div class="stat-label">Total Packages</div>
+            </div>
+            <div class="stat-card">
+                <div class="stat-number">${appDependencies}</div>
+                <div class="stat-label">Direct Dependencies</div>
+            </div>
+            <div class="stat-card">
+                <div class="stat-number">${totalDependencies}</div>
+                <div class="stat-label">Total Dependencies</div>
+            </div>
+        `;
+        
+        // D3 dependency wheel code
+        d3.chart=d3.chart||{},d3.chart.dependencyWheel=function(e){var t=window,r=document,n=r.documentElement,a=r.getElementsByTagName("body")[0],c=(t.innerWidth||n.clientWidth||a.clientWidth,t.innerHeight||n.clientHeight||a.clientHeight,200),i=.03,o=960;function u(e){e.each(function(e){var t=e.matrix,r=e.packageNames,n=o/2-c,a=d3.chord().padAngle(i).sortSubgroups(d3.descending),u=d3.select(this).selectAll("svg").data([e]).enter().append("svg:svg").attr("width",o).attr("height",o).attr("class","dependencyWheel").append("g").attr("transform","translate("+o/2+","+o/2+")"),d=d3.arc().innerRadius(n).outerRadius(n+20),l=function(e){return 0===e.index?"#ccc":"hsl("+parseInt((r[e.index][0].charCodeAt()-97)/26*360,10)+",90%,70%)"},s=function(e){return function(t,r){u.selectAll(".chord").filter(function(e){return e.source.index!=r&&e.target.index!=r}).transition().style("opacity",e);var n=[];u.selectAll(".chord").filter(function(e){e.source.index==r&&n.push(e.target.index),e.target.index==r&&n.push(e.source.index)}),n.push(r);var a=n.length;u.selectAll(".group").filter(function(e){for(var t=0;t<a;t++)if(n[t]==e.index)return!1;return!0}).transition().style("opacity",e)}},g=a(t),p=g.groups[0],h=-(p.endAngle-p.startAngle)/2*(180/Math.PI),f=u.selectAll("g.group").data(g.groups).enter().append("svg:g").attr("class","group").attr("transform",function(e){return"rotate("+h+")"});f.append("svg:path").style("fill",l).style("stroke",l).attr("d",d).style("cursor","pointer").on("mouseover",s(.1)).on("mouseout",s(1)),f.append("svg:text").each(function(e){e.angle=(e.startAngle+e.endAngle)/2}).attr("dy",".35em").attr("text-anchor",function(e){return e.angle>Math.PI?"end":null}).attr("transform",function(e){return"rotate("+(180*e.angle/Math.PI-90)+")translate("+(n+26)+")"+(e.angle>Math.PI?"rotate(180)":"")}).style("cursor","pointer").text(function(e){return r[e.index]}).on("mouseover",s(.1)).on("mouseout",s(1)),u.selectAll("path.chord").data(g).enter().append("svg:path").attr("class","chord").style("stroke",function(e){return d3.rgb(l(e.source)).darker()}).style("fill",function(e){return l(e.source)}).attr("d",d3.ribbon().radius(n)).attr("transform",function(e){return"rotate("+h+")"}).style("opacity",1)})}return u.width=function(e){return arguments.length?(o=e,u):o},u.margin=function(e){return arguments.length?(c=e,u):c},u.padding=function(e){return arguments.length?(i=e,u):i},u};
+        var buildMatrixFromDependencies=function(e){var t=e.packages,r={},n={},a=[],c=0,i={};return t.forEach(function(e){if(e.replace)for(replaced in e.replace)i[replaced]=e.name}),t.forEach(function(e){for(packageName in e.require)packageName in i&&(e.require[i[packageName]]=e.require[packageName],delete e.require[packageName])}),t.forEach(function(e){packageName=e.name,packageName in r||(n[c]=packageName,r[packageName]=c++)}),t.forEach(function(e){var t=r[e.name],n=a[t];if(!n){n=a[t]=[];for(var i=-1;++i<c;)n[i]=0}for(packageName in e.require)n[r[packageName]]++}),a.forEach(function(e,t){for(var r=.001,n=-1;++n<c;){var a=(n+t)%c;1==e[a]&&(e[a]+=r,r+=.001)}}),{matrix:a,packageNames:n}};
+        
+        // Clear loading and render chart
+        d3.select("#chart_placeholder").selectAll("*").remove();
+        d3.select("#chart_placeholder").datum(buildMatrixFromDependencies(data)).call(d3.chart.dependencyWheel().width(P_DATA_WIDTH).margin(P_DATA_MARGIN).padding(P_DATA_PADDING));
+        
+        // Search functionality
+        let currentHighlightedIndex = -1;
+        const packageNames = data.packages.map(pkg => pkg.name);
+        
+        const searchInput = document.getElementById("packageSearch");
+        const searchResults = document.getElementById("searchResults");
+        
+        function highlightPackage(packageName, temporary = false) {
+            const packageIndex = packageNames.indexOf(packageName);
+            if (packageIndex === -1) return;
+            
+            // Find the corresponding group element and trigger mouseover
+            const svg = d3.select("#chart_placeholder svg");
+            const groups = svg.selectAll(".group");
+            
+            groups.each(function(d, i) {
+                if (i === packageIndex) {
+                    // Reset all to normal first
+                    resetHighlight();
+                    
+                    // Highlight this package
+                    currentHighlightedIndex = packageIndex;
+                    d3.select(this).select("path").style("stroke-width", "3px").style("filter", "brightness(1.2)");
+                    d3.select(this).select("text").style("font-weight", "bold").style("font-size", "13px");
+                    
+                    // Fade non-related elements
+                    svg.selectAll(".chord")
+                        .filter(function(chord) { 
+                            return chord.source.index !== packageIndex && chord.target.index !== packageIndex; 
+                        })
+                        .transition().style("opacity", 0.1);
+                    
+                    svg.selectAll(".group")
+                        .filter(function(group, idx) { 
+                            // Find related packages
+                            let related = [packageIndex];
+                            svg.selectAll(".chord").each(function(chord) {
+                                if (chord.source.index === packageIndex) related.push(chord.target.index);
+                                if (chord.target.index === packageIndex) related.push(chord.source.index);
+                            });
+                            return related.indexOf(idx) === -1;
+                        })
+                        .transition().style("opacity", 0.3);
+                }
+            });
+        }
+        
+        function resetHighlight() {
+            const svg = d3.select("#chart_placeholder svg");
+            svg.selectAll(".chord").transition().style("opacity", 1);
+            svg.selectAll(".group").transition().style("opacity", 1);
+            svg.selectAll(".group path").style("stroke-width", "1px").style("filter", "none");
+            svg.selectAll(".group text").style("font-weight", "500").style("font-size", "11px");
+            currentHighlightedIndex = -1;
+        }
+        
+        function performSearch(query) {
+            if (!query.trim()) {
+                searchResults.style.display = "none";
+                resetHighlight();
+                return;
+            }
+            
+            const filtered = data.packages.filter(pkg => 
+                pkg.name.toLowerCase().includes(query.toLowerCase())
+            ).slice(0, 10); // Limit to 10 results
+            
+            if (filtered.length === 0) {
+                searchResults.style.display = "none";
+                resetHighlight();
+                return;
+            }
+            
+            searchResults.innerHTML = filtered.map(pkg => `
+                <div class="search-result-item" data-package="${pkg.name}">
+                    <span class="search-result-name">${pkg.name}</span>
+                    <span class="search-result-version">${Object.keys(pkg.require).length} deps</span>
+                </div>
+            `).join("");
+            
+            searchResults.style.display = "block";
+            
+            // Add click handlers to results
+            searchResults.querySelectorAll(".search-result-item").forEach(item => {
+                item.addEventListener("click", function() {
+                    const packageName = this.dataset.package;
+                    searchInput.value = packageName;
+                    searchResults.style.display = "none";
+                    highlightPackage(packageName);
+                });
+                
+                item.addEventListener("mouseenter", function() {
+                    const packageName = this.dataset.package;
+                    highlightPackage(packageName, true);
+                });
+                
+                item.addEventListener("mouseleave", function() {
+                    if (currentHighlightedIndex === -1) {
+                        resetHighlight();
+                    }
+                });
+            });
+            
+            // Auto-highlight first result if exact match
+            if (filtered.length === 1 || filtered[0].name.toLowerCase() === query.toLowerCase()) {
+                highlightPackage(filtered[0].name, true);
+            }
+        }
+        
+        // Search input events
+        searchInput.addEventListener("input", function() {
+            performSearch(this.value);
+        });
+        
+        searchInput.addEventListener("keydown", function(e) {
+            if (e.key === "Enter") {
+                const results = searchResults.querySelectorAll(".search-result-item");
+                if (results.length > 0) {
+                    results[0].click();
+                }
+            } else if (e.key === "Escape") {
+                this.value = "";
+                searchResults.style.display = "none";
+                resetHighlight();
+            }
+        });
+        
+        // Click outside to close search results
+        document.addEventListener("click", function(e) {
+            if (!e.target.closest(".search-input-container")) {
+                searchResults.style.display = "none";
+            }
+        });
+        
+        // Double-click on chart to reset
+        document.getElementById("chart_placeholder").addEventListener("dblclick", function() {
+            searchInput.value = "";
+            searchResults.style.display = "none";
+            resetHighlight();
+        });
+    </script>
+</body>
+</html>

data/lib/cocoapods_graph/version.rb

@@ -0,0 +1,3 @@
+module CocoaPodsGraph
+  VERSION = "1.0.0"
+end

data/lib/cocoapods_graph.rb

@@ -0,0 +1,8 @@
+require_relative 'cocoapods_graph/version'
+require_relative 'cocoapods_graph/constants'
+require_relative 'cocoapods_graph/pod_class'
+require_relative 'cocoapods_graph/generator'
+
+module CocoaPodsGraph
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: cocoapods-graph
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Erick Jung
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-09-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A Ruby gem that parses Podfile.lock files and generates beautiful, interactive
+  dependency wheel visualizations using D3.js. Perfect for understanding complex pod
+  relationships in your iOS projects.
+email:
+- talk@erickjung.com
+executables:
+- cocoapods-graph
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- cocoapods-graph.gemspec
+- exe/cocoapods-graph
+- lib/cocoapods_graph.rb
+- lib/cocoapods_graph/constants.rb
+- lib/cocoapods_graph/generator.rb
+- lib/cocoapods_graph/pod_class.rb
+- lib/cocoapods_graph/template.html
+- lib/cocoapods_graph/version.rb
+homepage: https://github.com/erickjung/cocoapods-graph
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/erickjung/cocoapods-graph
+  source_code_uri: https://github.com/erickjung/cocoapods-graph
+  changelog_uri: https://github.com/erickjung/cocoapods-graph/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.19
+signing_key:
+specification_version: 4
+summary: Interactive dependency wheel visualizations for CocoaPods projects
+test_files: []