cocoapods-bb-PodAssistant 0.1.5

data/lib/cocoapods-bb-PodAssistant/command/stable/stable.rb

@@ -0,0 +1,168 @@
+require 'cocoapods-bb-PodAssistant/config/source_manager'
+require 'cocoapods-bb-PodAssistant/config/cache_path'
+require 'cocoapods-bb-PodAssistant/helpers'
+
+module Pod
+
+    # class StableOptions
+    #   # define business specs,defalut is stable_specs
+    #   option :business_specs, "stable_specs"
+
+    #   # define custom lockSpecs tag
+    #   option :tag, ""
+
+    #   # define custom lockSpecs branch
+    #   option :branch, ""
+    # end
+
+    class Command
+      class Stable < Command
+        require 'fileutils'
+        require 'cocoapods/executable.rb'
+        extend Executable
+        executable :git
+
+        self.summary = '拉取稳定lock配置'
+        self.description = <<-DESC
+          拉取稳定lock配置插件。利用版本比对进行更新配置实现对组件版本控制管理。
+        DESC
+
+        self.arguments = [
+            CLAide::Argument.new('Podfile', false)
+        ]
+        def self.options
+          [
+            ['--init', '初始化项目yml配置，根据当前项目Podfile.lock生成'],
+            ['--sync', '同步远端yml配置，更新项目yml配置'],
+            ['--install', '命令同执行`pod install操作`'],
+            ['--update', '命令同执行`pod update操作`'],
+            ['--update-pod', '命令同执行`pod update <组件>操作`,更新yml配置组件版本信息，多个组件使用`,`或者`空格`隔开,注意⚠️  使用`空格`需要使用双引号'],
+          ].concat(super)
+        end
+        
+        def initialize(argv)
+          @names = argv.arguments! unless argv.arguments.empty?
+          @help = argv.flag?('help')
+          @init = argv.flag?('init')
+          @sync = argv.flag?('sync')
+          # install操作
+          @install = argv.flag?('install')
+          @update = argv.flag?('update')
+          # update组件数据支持多个使用`,`或者`空格`隔开
+          update_pods = argv.option('update-pod','')
+          if !update_pods.empty?
+            if update_pods.include?(' ')
+              @update_pods = update_pods.split(' ') unless update_pods.nil?
+            else update_pods.include?(',')
+              @update_pods = update_pods.split(',') unless update_pods.nil?
+            end
+          end
+          super
+        end
+        def validate!
+          super
+          banner! if @help
+        end
+
+        #help load podfile option
+        def stable!(source, options = {})
+          @ll_stable_source = source
+          if options.has_key?(:specs) 
+            @businessSpec = options[:specs]
+            puts "当前业务使用源=>#{@businessSpec}"
+          end
+          @ll_stable_tag = options[:tag] if options.has_key?(:tag) 
+          @ll_stable_branch = options[:branch] if options.has_key?(:branch)
+          @cache = BB::Cache.new()
+          configGitPath(@cache.cachePath)
+        end
+
+        ######################################## Main ########################################
+        
+        def run
+          # begin
+            source_manager = BB::SourceManager.new(@businessSpec)
+            if @init
+              puts "[PodAssistant] 开始配置生成当前项目yml文件".yellow
+              # 生成本地yml配置
+              source_manager.generate_localStable
+              puts "[PodAssistant] `pod stable --init` complete!".green
+            elsif @install
+              puts "[PodAssistant] 执行 $ pod install".yellow
+              system "pod install"
+              puts "[PodAssistant] `pod stable --install` complete!".green
+            elsif @update
+              puts "[PodAssistant] 执行 $ pod update".yellow
+              system "pod update"
+              puts "[PodAssistant] `pod stable --update` complete!".green
+            elsif @update_pods
+              # 更新单个组件
+              puts "更新pod组件#{@update_pods} count:#{@update_pods.count}".yellow
+              source_manager.update_podmodules(@update_pods)
+              podnames = @update_pods.join(" ")
+              puts "[PodAssistant] 执行 $ pod update #{podnames}".yellow
+              system "pod update #{podnames}"
+              source_manager.update_local_stable_from_podmodules(@update_pods)
+              podnames = @update_pods.join(",")
+              puts "[PodAssistant] `pod stable --update-pod=#{podnames}` complete!".green
+            elsif @sync
+              puts "开始合并远端lock数据".yellow
+              ll_load_stable
+              #2、clone origin lock spec to cache dir 
+              ll_cloneStable
+              #3、fetch newest code
+              ll_fetch_stale_git
+              # 数据合并
+              source_manager.merge_stable_data
+              puts "[PodAssistant] `pod stable` complete!".green
+            else
+              puts "[PodAssistant] `pod stable` 帮助文档请查看👇".yellow
+              banner! 
+            end
+          # rescue => exception
+          #   puts "[pod stable] error(已捕获): #{exception}".red
+          # end
+          
+        end
+
+        private
+        ######################################## API ########################################
+        def ll_load_stable
+          unless File.exist?(File.join(Pathname.pwd, "Podfile"))
+            err_msg = "- Error: #{File.join(Pathname.pwd, "Podfile")} is not exit"
+            Pod::UI.puts "#{err_msg}".send(:red)
+            exit -9001
+          end
+
+          #获取podfile 内容
+          #1、删除所有注释行，避免干扰
+          #2、正则匹配，筛选出stable 方法
+          #3、执行stable 方法，获取配置
+          podfileContent = File.read(File.join(Pathname.pwd, "Podfile"))
+          podfileContent_vaild = podfileContent.lines.reject { |line| line.strip.start_with?("#") }.join
+          stableCommand = podfileContent_vaild.match(/^\s*stable!\s*'([^']+)'(?:,\s*(\w+):\s*'([^']+)')*/m)
+          unless stableCommand
+            err_msg = "- Error: not stable define in the podfile! you can define like【stable! 'https://git.babybus.co/babybus/ios/Specs/stable-specs.git', specs:'global_stable_specs'】in podfile"
+            Pod::UI.puts "#{err_msg}".send(:red)
+            exit -9002
+          end
+          eval(stableCommand.to_s)
+        end
+        def ll_cloneStable
+          cachePath = @cache.cachePath
+          unless Dir.exist?(File.join(cachePath))
+            clonePath = File.dirname(cachePath)
+            FileUtils.mkdir_p clonePath
+            git_clone(@stable_source,clonePath)
+          end
+        end
+
+        def ll_fetch_stale_git
+          git_reset
+          git_fetch
+          git_checkout_and_pull(@stable_source, @stable_branch, @stable_tag)
+        end
+
+      end
+    end
+  end

data/lib/cocoapods-bb-PodAssistant/command.rb

@@ -0,0 +1,9 @@
+require 'cocoapods-bb-PodAssistant/command/PodAssistant'
+#stable
+require 'cocoapods-bb-PodAssistant/command/stable/stable'
+require 'cocoapods-bb-PodAssistant/command/stable/podfile-linkline'
+#linkline
+require 'cocoapods-bb-PodAssistant/command/linkline/linkline'
+require 'cocoapods-bb-PodAssistant/command/linkline/target-linkline'
+require 'cocoapods-bb-PodAssistant/command/linkline/targetdefinition-linkline'
+require 'cocoapods-bb-PodAssistant/command/linkline/targetValidator-linkline'

data/lib/cocoapods-bb-PodAssistant/config/cache_path.rb

@@ -0,0 +1,16 @@
+require 'cocoapods-bb-PodAssistant/config/stable_source'
+
+module BB
+    class Cache
+        def initialize(stable_source = nil)
+            if stable_source.nil?
+                stable_source = StableSource.stable_default_source
+            end
+            @stable_source = stable_source
+        end
+
+        def cachePath()
+            File.join(File.expand_path('~/.cache'), 'cocoapods-bb-PodAssistant','stable',@stable_source.split('/').last.chomp('.git').to_s)
+        end
+    end
+end

data/lib/cocoapods-bb-PodAssistant/config/source_manager.rb

@@ -0,0 +1,389 @@
+require 'cocoapods-bb-PodAssistant/helpers'
+require 'cocoapods-bb-PodAssistant/config/stable_specs'
+require 'cocoapods-bb-PodAssistant/helpers/stable_manager_helper'
+require 'cocoapods-core'
+
+# 数据源管理
+module BB
+    class SourceManager
+        def initialize(businessSpecName = nil)
+            @businessSpecName = businessSpecName
+            @stableMgr = BB::StableManager.new()
+        end
+
+        # 公共源路径(远端)
+        def public_stable_yaml
+            return @stableMgr.public_stable_yaml
+        end
+
+        # 业务源路径(远端)
+        def business_stable_yaml
+            return @stableMgr.business_stable_yaml(@businessSpecName)
+        end
+
+        # 本地源路径
+        def local_stable_yaml
+            return @stableMgr.local_stable_yaml
+        end
+
+        # 产品线本地lock数据
+        def fetch_local_stable_datas
+            localSpec = BB::StableSpecs.new()
+            return localSpec.readData(local_stable_yaml)
+        end
+
+        # 远端公共lock数据
+        def fetch_origin_stable_datas
+            # 策略：公共数据包含通用数据 + 业务线数据
+            pubSpec = BB::StableSpecs.new()
+            common_data = pubSpec.readData(public_stable_yaml)
+            # 业务线数据
+            business_config_file = business_stable_yaml
+            if business_config_file
+                if File.exist?(business_config_file)
+                    busimessSpec = BB::StableSpecs.new()
+                    busimess_data = busimessSpec.readData(business_config_file)
+                else
+                    puts "业务线公共配置文件#{business_config_file}不存在，请确认!!!". send(:yellow)
+                    exit
+                end
+            end
+            if busimess_data
+                # 数据合并操作（策略：业务线公共盖通用数据，理论不存在该情况）
+                newData = common_data
+                listdata = newData[YAML_CONFIG_LIST_KEY]
+                removedata = newData[YAML_CONFIG_REMOVE_KEY]
+                dependenciesdata = newData[YAML_CONFIG_DEPENDENCIES_KEY]
+                busimess_data.each do | key, val|
+                    if key == YAML_CONFIG_LIST_KEY
+                        if val.is_a?(Hash)
+                            val.each do |list_name,list_ver|
+                                listdata[list_name] = list_ver
+                            end
+                        end
+                    elsif key == YAML_CONFIG_REMOVE_KEY
+                        if val.is_a?(Array)
+                            val.each do |remove_name|
+                                removedata.push(remove_name)
+                            end
+                        end
+                    elsif key == YAML_CONFIG_DEPENDENCIES_KEY
+                        if val.is_a?(Hash)
+                            val.each do |dependencies_name,dependencies_val|
+                                dependenciesdata[dependencies_name] = dependencies_val
+                            end
+                        end
+                    end
+                end
+                return newData
+            end
+            return common_data
+        end
+
+        # 更新本地lock数据
+        def update_localstable_datas(stable_lock)
+            localSpec = BB::StableSpecs.new()
+            localSpec.writeData(local_stable_yaml, stable_lock)  
+        end
+
+        # 合并stable数据
+        def merge_stable_data()
+            #4、show origin_stable_lock diff with local_stable_lock
+            new_stable_spec = compare_specs(fetch_local_stable_datas, fetch_origin_stable_datas)
+
+            #5、rewirte local_stable_lock with origin_stable_lock
+            update_localstable_datas(new_stable_spec)    
+        end
+  
+        ######################################## Help ########################################
+        # compare tags (>=)
+        def versionGreatOrEqual(tag1, tag2)
+            if (tag1.is_a? String) && (tag2.is_a? String) && tag1.to_i >= tag2.to_i
+                return true
+            else
+                return false
+            end
+            return true
+        end
+
+        # compare tags （>）
+        def versionGreat(tag1, tag2)
+            result = versionGreatOrEqual(tag1,tag2)
+            if result == true && tag1 == tag2
+                return false
+            end
+            return result
+        end
+
+        # compare specs 参数1:本地，参数2:远端
+        def compare_specs(local_specs, common_specs)
+            added_projects = []
+            updated_projects = []
+            rollbacked_projects = []
+            deleted_projects = []
+            new_specs = local_specs
+
+            listdata = common_specs[YAML_CONFIG_LIST_KEY]
+            removedata = common_specs[YAML_CONFIG_REMOVE_KEY]
+            dependenciesdata = common_specs[YAML_CONFIG_DEPENDENCIES_KEY]
+
+            # puts "local_specs:#{local_specs}".send(:green)
+            # puts "common_specs:#{common_specs}".send(:green)
+            need_update_pod_lists={}
+            # step.1 匹配组件版本信息
+            listdata.each do |name, version|
+                name = name.to_s
+                local_version = local_specs[name]
+                if local_version.nil?
+                    # 本地不存在这个数据
+                elsif local_version != version
+                    # puts "merge name:#{name} local_version:#{local_version} route_version:#{version}".red
+                    # 版本不一致
+                    if (version.is_a? String) && (local_version.is_a? String)
+                    end
+                    if versionGreat(version, local_version)
+                        updated_projects << "【#{name}】 (#{local_version}) -> (#{version.to_s.send(:yellow)})"
+                    else
+                        rollbacked_projects << "【#{name}】 (#{version.to_s.send(:red)}) <- (#{local_version})"
+                    end
+                    podCoreName = subspec_podname(name)
+                    need_update_pod_lists[podCoreName] = version
+                end
+            end
+            # 解决subspec组件同步更新版本信息
+            need_update_pod_lists.each do |podCoreName, version|
+                new_specs.keys.each do |podName|
+                    if (podName == podCoreName) || has_pod_subspec(podName, podCoreName)
+                        new_specs[podName] = version
+                    end
+                end
+            end
+            # step.2 匹配组件新增
+            dependenciesdata.each do |name, array|
+                name = name.to_s
+                version = listdata[name]
+                unless version
+                    puts "公共库缺少[#{name}]版本依赖 cls:#{listdata.class} listdata:#{listdata}".send(:red)
+                    exit
+                end
+                local_exist_ver = new_specs[name]
+                if local_exist_ver.nil?
+                    new_specs[name] = version
+                    added_projects << "【#{name}】 (#{version.to_s.send(:green)})"
+                end
+                if array.is_a?(Array)
+                    array.each do |name|
+                        name = name.to_s
+                        local_exist_ver = new_specs[name]
+                        if local_exist_ver.nil?
+                            new_specs[name] = version
+                            added_projects << "【#{name}】 (#{version.to_s.send(:green)})"
+                        end
+                    end
+                end
+            end
+            # step.3 匹配组件移除
+            removedata.each do |name|
+                name = name.to_s
+                # local_exist_ver = new_specs[name]
+                version = listdata[name]
+                if version
+                    deleted_projects << "【#{name}】 (#{"delete".send(:red)}) <- (#{version})"
+                end
+                new_specs.delete(name)
+            end
+            showMergeLog(added_projects, updated_projects, rollbacked_projects, deleted_projects)
+            # puts "new_specs:#{new_specs}".send(:red)
+            return new_specs
+        end
+
+        def showMergeLog(added, updated, rollbacked, deleted)
+            #31m: 红色 32m:绿色 33m:黄色 34m:蓝色
+            #puts "\e[34m#{string}\e[0m"
+            if added.any?
+                puts "新增了以下项目:".send(:green)
+                puts added.join("\n")
+            end
+
+            if updated.any?
+                puts "更新了以下项目:". send(:yellow)
+                puts updated.join("\n")
+            end
+
+            if rollbacked.any?
+                puts "回滚了以下项目:".send(:red)
+                puts rollbacked.join("\n")
+            end
+
+            if deleted.any?
+                puts "移除了以下项目:".send(:red)
+                puts deleted.join("\n")
+            end
+
+            unless added.any? || updated.any? || added.any? || deleted.any?
+                puts "已经是最新版本数据".send(:green)
+            end
+        end
+        private def podfile_lock
+            lock = File.join(Pathname.pwd,"Podfile.lock")
+            raise "podfile.lock,不存在，请先pod install/update" unless File.exist?(lock)
+            lockfile ||= Pod::Lockfile.from_file(Pathname.new(lock))
+            return lockfile
+        end
+
+        def generate_localStable
+            lockfile = podfile_lock
+            local_specs = {}
+            # step.1 获取分支指向信息
+            dependencies = lockfile.dependencies
+            dependencies.each do | dependency |
+                if dependency.external_source.is_a? Hash
+                    name = dependency.name
+                    external_source = dependency.external_source
+                    podCoreName = subspec_podname(name)
+                    # checkout_options = lockfile.checkout_options_for_pod_named(podCoreName)
+                    # if checkout_options.is_a? Hash
+                    #     commit = checkout_options[:commit]
+                    #     external_source[:commit] = commit
+                    #     puts "name:#{podCoreName} checkout_options:#{checkout_options} commit:#{commit}"
+                    # end
+                    if podCoreName != name
+                        # local_specs.delete(podCoreName)
+                        local_specs[podCoreName] = external_source
+                        if (!has_include_core_subspec(name)) # 过滤core数据
+                            local_specs[name] = external_source
+                            Pod::UI.puts "[分支] #{name} => (#{external_source})"
+                        end
+                    else
+                        local_specs[name] = external_source
+                        Pod::UI.puts "[分支] #{name} => (#{external_source})"
+                    end
+                end
+            end
+            # step.2 获取pods标签信息,如果存在分支优先使用分支信息
+            lockfile.pod_names.each do |pod_name|
+                version = lockfile.version(pod_name)
+                podCoreName = subspec_podname(pod_name)
+                if local_specs.has_key?(podCoreName)
+                    if podCoreName != pod_name
+                        if (!has_include_core_subspec(pod_name)) # 过滤core数据
+                            # Pod::UI.puts "step.2 #{pod_name} => (#{local_specs[podCoreName]})"
+                            local_specs[pod_name] = local_specs[podCoreName]
+                        end
+                    end
+                else
+                    if (!has_include_core_subspec(pod_name)) # 过滤core数据
+                        ver = version.to_s
+                        local_specs[pod_name] = ver
+                        Pod::UI.puts "[标签] #{pod_name} => (#{ver})"
+                    end
+                end
+            end
+            # Pod::UI.puts "yml配置数据:#{local_specs}"
+            if local_specs.length > 0
+                update_localstable_datas(local_specs)
+                Pod::UI.puts "Generating yml配置文件=> #{local_stable_yaml} 更新成功".green
+            end
+        end
+        # pod库是否包含core subspec
+        def has_include_core_subspec(pod_name)
+            if has_include_subspec(pod_name)
+                subPodName = pod_name.include?('/') ? pod_name.split('/').last.strip : pod_name
+                if (subPodName == "Core") || (subPodName == "Main") # 过滤core数据
+                    return true
+                end
+            end
+            return false
+        end
+        # pod库是否包含subspec
+        def has_include_subspec(pod_name)
+            podCoreName = subspec_podname(pod_name)
+            if podCoreName != pod_name
+                return true
+            end
+            return false
+        end
+        # subspec pod库名称
+        def subspec_podname(pod_name)
+            return pod_name.include?('/') ? pod_name.split('/').first.strip : pod_name
+        end
+        # 是否pod subspec库
+        def has_pod_subspec(podName, podCoreName)
+            return (has_include_subspec(podName) && podName.include?("#{podCoreName}/"))
+        end
+
+        # 更新单个pod组件
+        def update_podmodules(pod_lists)
+            local_stable_data = fetch_local_stable_datas # 本地stable配置
+            need_update_pod_lists = podCoreNames_from_podmodules(pod_lists)
+            is_resave_stable_data = false
+            need_update_pod_lists.each do |podCoreName|
+                local_stable_data.keys.each do |podName|
+                    if (podName == podCoreName) || has_pod_subspec(podName, podCoreName)
+                        pod = local_stable_data[podName]
+                        if pod.is_a?(String)
+                            version = pod.lstrip # 去除首字母空格
+                            initial_str = version[0..0] # 第一个字母
+                            # 项目配置固定版本，以本项目为主
+                            is_fixed_version = initial_str.include?('=') ? true : false # 固定版本 pod 'A','= x.x.x'
+                            is_lessthan_version = version.include?('<') ? true : false # 限制《最高》组件版本 pod 'A','< x.x.x' 或者 pod 'A','<= x.x.x'
+                            is_greaterthan_version = version.include?('>') ? true : false # 限制《最低》组件版本 pod 'A','> x.x.x' 或者 pod 'A','>= x.x.x'
+                            is_fuzzy_version = version.include?('~>') ? true : false # 固定版本 pod 'A','~> x.x.x'
+                            is_fuzzy_versionV2 = (!is_fixed_version && !is_lessthan_version && !is_greaterthan_version && !is_fuzzy_version) ? true : false # 固定版本 pod 'A','x.x.x'
+                            if (is_fuzzy_versionV2 == true)
+                                local_stable_data[podName] = ">= #{version}"
+                                is_resave_stable_data = true
+                            end
+                        end
+                    end
+                end
+            end
+            if is_resave_stable_data == true
+                puts "[PodAssistant] 更新本地stable数据".yellow
+                update_localstable_datas(local_stable_data)
+            end
+        end
+        # 更新local stable组件
+        def update_local_stable_from_podmodules(pod_lists)
+            local_stable_data = fetch_local_stable_datas # 本地stable配置
+            need_update_pod_lists = podCoreNames_from_podmodules(pod_lists)
+            lockfile = podfile_lock
+            pod_names = lockfile.pod_names # lock标签数据
+            is_resave_stable_data = false
+            need_update_pod_lists.each do |podCoreName|
+                local_stable_data.keys.each do |podName|
+                    if (podName == podCoreName) || has_pod_subspec(podName, podCoreName)
+                        pod = local_stable_data[podName]
+                        if pod.is_a?(String)
+                            version = pod.lstrip # 去除首字母空格
+                            initial_str = version[0..0] # 第一个字母
+                            is_greaterthan_version = version.include?('>') ? true : false # 限制《最低》组件版本 pod 'A','> x.x.x' 或者 pod 'A','>= x.x.x'
+                            if (is_greaterthan_version == true)
+                                version = lockfile.version(podCoreName).to_s
+                                if !version.empty?
+                                    local_stable_data[podName] = version
+                                    is_resave_stable_data = true
+                                    puts "update pod #{podName} (#{version})".green
+                                end
+                            end
+                        end
+                    end
+                end
+            end
+            if is_resave_stable_data == true
+                puts "[PodAssistant] 更新本地stable数据".yellow
+                update_localstable_datas(local_stable_data)
+            end
+        end
+        private def podCoreNames_from_podmodules(pod_lists)
+            need_update_pod_lists = []
+            pod_lists.each do |podName|
+                podCoreName = subspec_podname(podName)
+                if !need_update_pod_lists.include?(podCoreName)
+                    need_update_pod_lists.push(podCoreName)
+                end
+            end
+            return need_update_pod_lists
+        end
+    end
+end

data/lib/cocoapods-bb-PodAssistant/config/stable_source.rb

@@ -0,0 +1,7 @@
+module BB
+    class StableSource
+        def self.stable_default_source
+            return "https://git.babybus.co/babybus/ios/Specs/stable-specs.git"
+        end
+    end
+end

data/lib/cocoapods-bb-PodAssistant/config/stable_specs.rb

@@ -0,0 +1,27 @@
+require 'cocoapods-bb-PodAssistant/helpers'
+
+# 公共spec配置库
+# 业务线公共spec配置库
+# 本地spec配置库 = 公共spec+业务线spec合并数据
+# 数据格式 json {key,val}
+module BB
+  class StableSpecs
+    def readData(yml_path)
+      return YamlFilesHelper.read_stable_lock_yaml(yml_path)
+    end
+    def writeData(yml_path, data)
+      YamlFilesHelper.save_stable_lock_yaml(yml_path, data)  
+    end
+    # podfile 更新配置文件使用(通用)
+    def update_stable_lock(yml_path, pod_targets)
+      YamlFilesHelper.save_stable_podlock(yml_path, pod_targets)
+      puts "[成功] 更新ymal配置文件#{yml_path}".green
+    end
+    #  更新podfile配置文件使用(项目)
+    def update_local_stable_lock(yml_path, pod_targets)
+      YamlFilesHelper.save_local_stable_podlock(yml_path, pod_targets)
+      puts "[成功] 更新ymal配置文件#{yml_path}".green
+    end
+
+  end
+end

data/lib/cocoapods-bb-PodAssistant/gem_version.rb

@@ -0,0 +1,3 @@
+module CocoapodsBbPodassistant
+  VERSION = "0.1.5"
+end