unipod 0.1.0

data/lib/unipod/server/server_handler.rb

@@ -0,0 +1,526 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'fileutils'
+require 'socket'
+require 'digest'
+require 'thread'
+
+module UniPod
+  module Server
+    # 处理HTTP请求的处理程序
+    class ServerHandler
+      attr_reader :cache_manager, :verbose
+      
+      # 使用DownloadHandler的共享锁
+      def self.package_build_locks
+        DownloadHandler.package_build_locks
+      end
+      
+      def self.locks_mutex
+        DownloadHandler.locks_mutex
+      end
+      
+      def initialize(cache_manager, options = {})
+        @cache_manager = cache_manager
+        @verbose = options[:verbose] || false
+      end
+      
+      # 添加CORS头信息
+      def add_cors_headers(res)
+        res['Access-Control-Allow-Origin'] = '*'
+        res['Access-Control-Allow-Methods'] = 'GET, POST, PUT, DELETE, OPTIONS'
+        res['Access-Control-Allow-Headers'] = 'Content-Type, Authorization, Accept, X-Requested-With'
+        res['Access-Control-Max-Age'] = '86400' # 24小时
+        
+        # 添加npm兼容的header
+        res['npm-notice'] = 'UniPod Registry for Unity Package Manager'
+        
+        # Unity Package Manager 专用头
+        res['X-Unity-Package-Manager'] = 'true'
+        
+        # 添加CORS头，确保Unity Package Manager可以正确识别
+        res['Access-Control-Expose-Headers'] = 'Content-Type, ETag, Cache-Control, Content-Length, Accept-Ranges, X-Unity-Package-Manager'
+        
+        # 添加缓存控制头
+        res['Cache-Control'] = 'max-age=0, no-cache, no-store, must-revalidate'
+        res['Pragma'] = 'no-cache'
+        res['Expires'] = '0'
+      end
+      
+      # 处理搜索请求 - Unity Package Manager API
+      def handle_search(req, res, req_id = 0)
+        query = req.query.nil? ? '' : (req.query['text'] || '')
+        from = req.query.nil? ? 0 : (req.query['from'] || '0').to_i
+        size = req.query.nil? ? 20 : (req.query['size'] || '20').to_i
+        
+        log_verbose "[#{req_id}] 处理搜索请求: 查询=#{query}, from=#{from}, size=#{size}"
+        
+        # 动态获取主机地址，优先使用客户端请求的主机地址
+        host_address = if req.header['host'] && !req.header['host'].empty?
+          req.header['host'].first
+        else
+          "localhost:7748"
+        end
+        log_verbose "[#{req_id}] 使用主机地址: #{host_address}"
+        
+        # 初始化空的搜索结果
+        search_results = {'objects' => [], 'total' => 0, 'time' => Time.now.utc.strftime('%a, %d %b %Y %H:%M:%S GMT')}
+        
+        # 尝试从缓存管理器获取包
+        if @cache_manager.respond_to?(:search_packages)
+          # 如果缓存管理器支持搜索功能，直接使用
+          log_verbose "[#{req_id}] 使用缓存管理器搜索包: #{query}"
+          # 修正参数数量, 确保参数顺序正确
+          packages_from_cache = @cache_manager.search_packages(query)
+          
+          if packages_from_cache && packages_from_cache.is_a?(Hash) && packages_from_cache['objects']
+            search_results = packages_from_cache
+          end
+        elsif @cache_manager.respond_to?(:get_all_packages)
+          # 否则获取全部包并自行过滤
+          log_verbose "[#{req_id}] 从缓存管理器获取所有包"
+          all_packages = @cache_manager.get_all_packages
+          
+          if all_packages && all_packages.is_a?(Hash) && all_packages['objects']
+            log_verbose "[#{req_id}] 成功从缓存管理器获取到 #{all_packages['objects'].size} 个包"
+            
+            # 如果有查询，根据查询条件过滤包
+            filtered_packages = all_packages['objects']
+            if !query.empty?
+              filtered_packages = filtered_packages.select do |pkg_obj|
+                pkg = pkg_obj['package']
+                pkg['name'].to_s.downcase.include?(query.downcase) || 
+                (pkg['displayName'] && pkg['displayName'].to_s.downcase.include?(query.downcase)) ||
+                (pkg['description'] && pkg['description'].to_s.downcase.include?(query.downcase)) ||
+                (pkg['keywords'] && pkg['keywords'].any? { |k| k.to_s.downcase.include?(query.downcase) })
+              end
+            end
+            
+            # 更新搜索结果
+            search_results['objects'] = filtered_packages
+            search_results['total'] = filtered_packages.size
+            search_results['time'] = Time.now.utc.strftime('%a, %d %b %Y %H:%M:%S GMT')
+          end
+        end
+        
+        # 确保所有包对象都有正确的格式和字段
+        if search_results['objects'] && search_results['objects'].is_a?(Array)
+          search_results['objects'].each do |package_obj|
+            if package_obj.is_a?(Hash) && package_obj['package'] && package_obj['package'].is_a?(Hash)
+              pkg = package_obj['package']
+              
+              # 确保包含所需字段
+              pkg['name'] ||= ''
+              pkg['description'] ||= ''
+              
+              # 添加或更新dist-tags字段
+              version = pkg['version'] || '1.0.0'
+              pkg['dist-tags'] = {
+                'latest' => version
+              }
+              
+              # 添加versions字段
+              pkg['versions'] = {
+                version => 'latest'
+              }
+              
+              # 确保包含时间信息
+              pkg['time'] = {
+                'modified' => (Time.now - rand(100000)).utc.iso8601
+              } unless pkg['time']
+              
+              # 确保包含readmeFilename
+              pkg['readmeFilename'] = 'README.md' unless pkg['readmeFilename']
+              
+              # 确保包对象有flags和local字段
+              package_obj['flags'] = {} unless package_obj['flags']
+              package_obj['local'] = true unless package_obj.key?('local')
+              
+              # 设置searchScore为客户端期望的值
+              package_obj['searchScore'] = 100000 if package_obj['searchScore']
+              
+              # 确保tarball URL使用正确的主机地址
+              if pkg['dist'] && pkg['dist']['tarball']
+                pkg_name = pkg['name']
+                pkg_version = pkg['version'] || version
+                tarball_url = "http://#{host_address}/#{pkg_name}/-/#{pkg_name}-#{pkg_version}.tgz"
+                pkg['dist']['tarball'] = tarball_url
+              end
+            end
+          end
+        end
+        
+        # 处理分页
+        if search_results['objects'] && search_results['objects'].is_a?(Array)
+          total_packages = search_results['objects'].size
+          
+          # 修复分页问题：Unity Package Manager需要特殊处理
+          if from >= total_packages
+            # 返回所有包而不是空数组 - Unity需要这个行为
+            paginated_packages = search_results['objects']
+          else
+            # 正常分页
+            paginated_packages = search_results['objects'][from, size] || []
+          end
+          
+          # 更新搜索结果
+          search_results['objects'] = paginated_packages
+          search_results['total'] = total_packages
+        end
+        
+        # 确保time字段格式正确（HTTP日期格式）
+        search_results['time'] = Time.now.utc.strftime('%a, %d %b %Y %H:%M:%S GMT')
+        
+        log_verbose "[#{req_id}] 返回 #{search_results['objects'].size} 个搜索结果, 总计 #{search_results['total']} 个"
+        
+        # 设置响应
+        res.status = 200
+        res['Content-Type'] = 'application/json'
+        json_response = JSON.generate(search_results)
+        res.body = json_response
+        puts_formatted_json(json_response, req_id, "搜索响应") if @verbose
+      end
+      
+      # 处理包信息请求 - Unity Package Manager API
+      def handle_package_info(package_name, res, req_id = 0, req = nil)
+        begin
+          log_verbose "[#{req_id}] 处理包信息请求: #{package_name}"
+          
+          # 动态获取主机地址，优先使用客户端请求的主机地址
+          host_address = if req && req.header['host'] && !req.header['host'].empty?
+            req.header['host'].first
+          else
+            "localhost:7748"
+          end
+          log_verbose "[#{req_id}] 使用主机地址: #{host_address}"
+          
+          # 初始化变量，确保它们都有默认值
+          package_data = nil
+          versions = []
+          latest_version = nil
+          
+          # 尝试获取包信息
+          if @cache_manager.respond_to?(:get_package_info)
+            log_verbose "[#{req_id}] 从缓存管理器获取包信息: #{package_name}"
+            package_data = @cache_manager.get_package_info(package_name)
+            
+            if package_data && package_data['version']
+              log_verbose "[#{req_id}] 获取到包信息: #{package_name}, 版本: #{package_data['version']}"
+              latest_version = package_data['version']
+              versions << latest_version
+            else
+              log_verbose "[#{req_id}] 没有获取到包信息或版本号"
+            end
+          end
+          
+          # 如果没有获取到包信息，返回404
+          if versions.empty?
+            log_verbose "[#{req_id}] 未找到包: #{package_name}"
+            res.status = 404
+            res['Content-Type'] = 'application/json'
+            error_response = {
+              "error" => "Not Found",
+              "code" => "PACKAGE_NOT_FOUND",
+              "message" => "Package '#{package_name}' not found"
+            }
+            json_response = JSON.generate(error_response)
+            res.body = json_response
+            return
+          end
+          
+          # 从主版本生成其他可能的版本
+          if versions.size == 1
+            version_parts = latest_version.split('.')
+            if version_parts.size >= 3
+              major, minor, patch = version_parts
+              
+              # 添加可能的之前版本
+              patch_num = patch.to_i
+              if patch_num > 0
+                versions << "#{major}.#{minor}.#{patch_num - 1}"
+              end
+              
+              if minor.to_i > 0
+                versions << "#{major}.#{minor.to_i - 1}.0"
+              end
+              
+              # 确保版本唯一且按照版本号排序
+              versions = versions.uniq.sort_by { |v| Gem::Version.new(v) rescue "0" }
+              latest_version = versions.last
+              
+              log_verbose "[#{req_id}] 生成的版本列表: #{versions.join(', ')}, 最新版本: #{latest_version}"
+            end
+          end
+          
+          # 构建包信息
+          full_package_data = {
+            "name" => package_name,
+            "versions" => {},
+            "time" => {
+              "modified" => Time.now.utc.iso8601,
+              "created" => (Time.now - 86400).utc.iso8601
+            },
+            "users" => {},
+            "dist-tags" => {
+              "latest" => latest_version
+            },
+            "_rev" => "10-#{Digest::MD5.hexdigest(Time.now.to_s)[0,16]}",
+            "_id" => package_name,
+            "_attachments" => {},
+            "readme" => "# #{package_name}\n\n#{package_data && package_data['description'] ? package_data['description'] : '无描述'}"
+          }
+          
+          # 为每个版本生成信息
+          versions.each_with_index do |version, idx|
+            # 创建版本的基本信息
+            version_info = if version == latest_version && package_data
+                            # 使用获取到的包信息作为基础
+                            package_data.clone
+                          else
+                            # 基于最新版本创建其他版本信息
+                            {
+                              'name' => package_name,
+                              'version' => version,
+                              'description' => package_data && package_data['description'] ? package_data['description'] : '无描述',
+                              'keywords' => package_data && package_data['keywords'] ? package_data['keywords'] : [],
+                              'author' => package_data && package_data['author'] ? package_data['author'] : {'name' => 'Unknown', 'email' => 'unknown@example.com'}
+                            }
+                          end
+            
+            # 确保版本号正确
+            version_info['version'] = version
+            
+            # 添加必要的字段
+            version_info['_id'] = "#{package_name}@#{version}"
+            version_info['readmeFilename'] = 'README.md' unless version_info['readmeFilename']
+            version_info['gitHead'] = Digest::SHA1.hexdigest("#{package_name}-#{version}") unless version_info['gitHead']
+            version_info['_nodeVersion'] = '23.9.0' unless version_info['_nodeVersion']
+            version_info['_npmVersion'] = '10.9.2' unless version_info['_npmVersion']
+            version_info['contributors'] = [] unless version_info['contributors']
+            
+            # 添加或更新dist信息
+            version_info['dist'] = {} unless version_info['dist']
+            
+            # 计算shasum
+            shasum = get_or_calculate_shasum(package_name, version, version_info, req_id, version == latest_version)
+            
+            # 生成integrity值
+            integrity_hash = Digest::SHA512.hexdigest("#{package_name}-#{version}-#{shasum}")
+            integrity_chars = integrity_hash[0...40] + rand(10000).to_s.rjust(4, '0')
+            integrity_b64 = integrity_chars.tr('0123456789abcdef', 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/')
+            
+            # 更新dist信息
+            version_info['dist']['integrity'] = "sha512-#{integrity_b64}"
+            version_info['dist']['shasum'] = shasum
+            version_info['dist']['tarball'] = "http://#{host_address}/#{package_name}/-/#{package_name}-#{version}.tgz"
+            
+            # 将版本添加到versions对象
+            full_package_data['versions'][version] = version_info
+            
+            # 添加时间信息
+            time_offset = idx * 600  # 每个版本间隔10分钟
+            full_package_data['time'][version] = (Time.now - (86400 - time_offset)).utc.iso8601
+          end
+          
+          # 设置响应
+          res.status = 200
+          res['Content-Type'] = 'application/json'
+          json_response = JSON.generate(full_package_data)
+          res.body = json_response
+          log_verbose "[#{req_id}] 成功生成包信息响应: #{package_name}, 包含 #{versions.size} 个版本"
+          
+        rescue => e
+          # 捕获所有异常
+          error_message = "处理包信息请求时出错: #{e.message}\n#{e.backtrace.join("\n")}"
+          log_verbose "[#{req_id}] 错误: #{error_message}"
+          
+          res.status = 500
+          res['Content-Type'] = 'application/json'
+          error_response = {
+            "error" => "Internal Server Error",
+            "code" => "REQUEST_PROCESSING_ERROR",
+            "message" => e.message
+          }
+          json_response = JSON.generate(error_response)
+          res.body = json_response
+        end
+      end
+      
+      # 处理根路由请求
+      def handle_root_request(res, req_id = 0)
+        # 尝试读取HTML模板
+        template_path = File.join(File.dirname(__FILE__), 'index.html')
+        
+        # 设置响应状态和内容类型
+        res.status = 200
+        res['Content-Type'] = 'text/html'
+        
+        if File.exist?(template_path)
+          # 读取index.html文件内容
+          html = File.read(template_path)
+          
+          # 获取包列表
+          packages_data = []
+          
+          # 尝试从缓存管理器获取包列表
+          if @cache_manager.respond_to?(:get_all_packages)
+            log_verbose "[#{req_id}] 从缓存管理器获取所有包用于首页展示"
+            all_packages = @cache_manager.get_all_packages
+            
+            if all_packages && all_packages['objects'] && all_packages['objects'].is_a?(Array)
+              log_verbose "[#{req_id}] 成功从缓存管理器获取到 #{all_packages['objects'].size} 个包"
+              
+              # 转换为前端需要的格式
+              packages_data = all_packages['objects'].map do |pkg_obj|
+                pkg = pkg_obj['package']
+                {
+                  name: pkg['name'],
+                  version: pkg['version'],
+                  displayName: pkg['displayName'] || pkg['name'],
+                  description: pkg['description'] || '',
+                  unity: pkg['unity'] || 'unknown',
+                  author: pkg['author'] || { name: 'Unknown', email: '' },
+                  keywords: pkg['keywords'] || [],
+                  category: pkg['category'] || 'Libraries'
+                }
+              end
+            end
+          end
+          
+          # 如果没有从缓存获取到包，使用空数组
+          if packages_data.empty?
+            log_verbose "[#{req_id}] 未从缓存获取到包，返回空数组用于首页展示"
+            packages_data = []
+          end
+          
+          # 转换为JSON并替换模板中的变量
+          packages_json = packages_data.to_json
+          html.gsub!('{{PACKAGES_JSON}}', packages_json)
+          
+          # 设置响应体
+          res.body = html
+          log_verbose "[#{req_id}] 首页展示 #{packages_data.size} 个包"
+        else
+          # 如果找不到模板文件，返回空白页面
+          log_verbose "[#{req_id}] 未找到index.html模板文件，返回空白页面"
+          res.body = ''
+        end
+      end
+      
+      # 处理请求错误
+      def handle_request_error(error, res, req_id = 0)
+        UI.error "[#{req_id}] 请求处理错误: #{error.message}"
+        UI.error error.backtrace.join("\n") if @verbose
+        
+        # 返回500错误
+        res.status = 500
+        res['Content-Type'] = 'application/json'
+        error_json = JSON.generate({
+          error: "服务器内部错误",
+          message: error.message
+        })
+        res.body = error_json
+        puts_formatted_json(error_json, req_id, "错误响应") if @verbose
+      end
+      
+      # 美化JSON并打印输出
+      def puts_formatted_json(json_string, req_id, desc = "JSON响应")
+        begin
+          # 解析JSON字符串为Ruby对象
+          json_obj = JSON.parse(json_string)
+          # 使用pretty_generate重新生成格式化的JSON
+          formatted_json = JSON.pretty_generate(json_obj)
+          # 打印格式化后的JSON
+          puts "[#{req_id}] #{desc}:"
+          puts formatted_json
+        rescue => e
+          puts "[#{req_id}] 无法格式化JSON: #{e.message}"
+          puts json_string
+        end
+      end
+      
+      private
+      
+      def log_verbose(message)
+        UI.puts message if @verbose
+      end
+      
+      # 获取本地IP地址
+      def get_local_ip
+        begin
+          Socket.ip_address_list.detect{|intf| intf.ipv4_private?}&.ip_address || 'localhost'
+        rescue
+          'localhost'
+        end
+      end
+      
+      # 获取包锁
+      def get_package_lock(package_key)
+        self.class.locks_mutex.synchronize do
+          self.class.package_build_locks[package_key] ||= Mutex.new
+        end
+      end
+      
+      # 计算或生成给定包版本的shasum
+      def get_or_calculate_shasum(package_name, version, version_info, req_id, is_latest_version = false)
+        # 锁定此包版本，防止并发生成
+        package_lock = get_package_lock("#{package_name}-#{version}")
+        
+        package_lock.synchronize do
+          tarball_filename = "#{package_name}-#{version}.tgz"
+          tarball_path = @cache_manager.get_package_tarball(package_name, tarball_filename)
+          
+          # 如果tarball文件已存在，使用实际文件计算shasum
+          if tarball_path && File.exist?(tarball_path)
+            file_content = File.open(tarball_path, 'rb') { |f| f.read }
+            shasum = Digest::SHA1.hexdigest(file_content)
+            log_verbose "[#{req_id}] 版本 #{version} 使用实际文件计算的shasum: #{shasum}"
+            return shasum
+          end
+          
+          # 只有最新版本才尝试构建tarball
+          if is_latest_version
+            # 如果有Git信息，尝试构建tarball并计算shasum
+            if version_info && version_info['git'] && version_info['git']['url']
+              git_url = version_info['git']['url']
+              git_tag = version_info['git']['tag'] || "v#{version}"
+              git_branch = version_info['git']['branch'] || 'main'
+              
+              log_verbose "[#{req_id}] 为最新版本#{version}添加tarball构建任务: #{git_url}, tag: #{git_tag}"
+              
+              # 获取包构建队列单例实例
+              builder_queue = PackageBuilderQueue.instance
+              
+              # 设置任务优先级
+              # 包信息API触发的构建优先级为0（普通）
+              priority = 0  # 普通优先级
+              
+              # 将任务添加到队列，不需要等待结果
+              builder_queue.enqueue(package_name, version, git_url, git_tag, git_branch, priority) do |success, result_path|
+                if success
+                  log_verbose "[#{req_id}] 异步包构建成功: #{result_path}"
+                else
+                  log_verbose "[#{req_id}] 异步包构建失败: #{package_name}@#{version}"
+                end
+              end
+              
+              # 不需要等待构建完成，使用默认值
+              log_verbose "[#{req_id}] 任务已加入队列，使用默认shasum"
+            else
+              log_verbose "[#{req_id}] 包没有Git信息，无法构建: #{package_name}@#{version}"
+            end
+          else
+            # 非最新版本，记录日志
+            log_verbose "[#{req_id}] 版本 #{version} 不是最新版本，不加入构建队列"
+          end
+          
+          # 如果无法生成文件或计算失败，使用默认值
+          shasum = Digest::SHA1.hexdigest("#{package_name}-#{version}")
+          log_verbose "[#{req_id}] #{is_latest_version ? '使用默认' : '不生成'}shasum: #{shasum}"
+          return shasum
+        end
+      end
+    end
+  end
+end 

data/lib/unipod/ui.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+require 'rainbow'
+require 'tty-spinner'
+require 'tty-prompt'
+require 'tty-table'
+require 'tty-progressbar'
+
+module UniPod
+  class UI
+    class << self
+      def puts(message)
+        Kernel.puts(message)
+      end
+
+      def info(message)
+        puts Rainbow("ℹ️  #{message}").blue
+      end
+
+      def success(message)
+        puts Rainbow("✅ #{message}").green
+      end
+
+      def warning(message)
+        puts Rainbow("⚠️  #{message}").yellow
+      end
+
+      def error(message)
+        puts Rainbow("❌ #{message}").red
+      end
+
+      def debug(message)
+        return unless debug_mode?
+        puts Rainbow("🔍 #{message}").magenta
+      end
+
+      def title(message)
+        width = terminal_width
+        puts
+        puts Rainbow("━" * width).blue
+        puts Rainbow(message.center(width)).blue.bright
+        puts Rainbow("━" * width).blue
+        puts
+      end
+
+      def spinner(message, &block)
+        spinner = TTY::Spinner.new("[:spinner] #{message}", format: :dots)
+        spinner.auto_spin
+        
+        begin
+          result = block.call
+          spinner.success(Rainbow('(完成)').green)
+          result
+        rescue => e
+          spinner.error(Rainbow("(失败: #{e.message})").red)
+          raise e
+        end
+      end
+
+      def progress(total, message = "处理中")
+        bar = TTY::ProgressBar.new("[:bar] #{message} :percent (:current/:total)", 
+          total: total, width: terminal_width - 30)
+        
+        if block_given?
+          (0...total).each do |i|
+            yield i
+            bar.advance
+          end
+        end
+        
+        bar
+      end
+
+      def prompt
+        @prompt ||= TTY::Prompt.new
+      end
+
+      def select(message, choices)
+        prompt.select(message, choices)
+      end
+
+      def multi_select(message, choices)
+        prompt.multi_select(message, choices)
+      end
+
+      def ask(message, default: nil, required: false)
+        options = {}
+        options[:default] = default if default
+        options[:required] = required
+        
+        prompt.ask(message, **options)
+      end
+
+      def yes?(message, default: true)
+        prompt.yes?(message, default: default)
+      end
+
+      def no?(message, default: true)
+        prompt.no?(message, default: default)
+      end
+
+      def table(headers, rows)
+        table = TTY::Table.new(headers, rows)
+        puts table.render(:unicode, padding: [0, 1])
+      end
+
+      def format_package(package)
+        name = package[:name] || package["name"]
+        version = package[:version] || package["version"]
+        description = package[:description] || package["description"]
+        
+        "#{Rainbow(name).green.bright} #{Rainbow(version).yellow} - #{description}"
+      end
+
+      def format_package_list(packages)
+        packages.each do |package|
+          puts format_package(package)
+        end
+      end
+
+      def format_package_details(package)
+        rows = []
+        
+        # 基本信息
+        rows << ["名称", Rainbow(package[:name] || package["name"]).green.bright]
+        rows << ["版本", Rainbow(package[:version] || package["version"]).yellow]
+        rows << ["描述", package[:description] || package["description"]]
+        
+        # 作者信息
+        author = package[:author] || package["author"]
+        if author
+          author_str = author.is_a?(Hash) ? "#{author[:name]} <#{author[:email]}>" : author.to_s
+          rows << ["作者", author_str]
+        end
+        
+        # 许可证
+        license = package[:license] || package["license"]
+        rows << ["许可证", license] if license
+        
+        # 依赖项
+        dependencies = package[:dependencies] || package["dependencies"]
+        if dependencies && !dependencies.empty?
+          deps_str = dependencies.map { |k, v| "#{k} (#{v})" }.join(", ")
+          rows << ["依赖项", deps_str]
+        end
+        
+        # Unity 特定信息
+        unity_version = 
+          package.dig(:unity, :version) || 
+          package.dig("unity", "version") || 
+          package[:unity_version] || 
+          package["unity_version"]
+        
+        rows << ["Unity 版本", unity_version] if unity_version
+        
+        # 显示表格
+        table = TTY::Table.new([nil, nil], rows)
+        puts table.render(:unicode, padding: [0, 1], multiline: true)
+      end
+
+      private
+
+      def debug_mode?
+        ENV['UNIPOD_DEBUG'] == 'true'
+      end
+
+      def terminal_width
+        require 'io/console'
+        IO.console.winsize[1] rescue 80
+      end
+    end
+  end
+end