makit 0.0.168 → 0.0.169

data/lib/makit/nuget.rb

@@ -1,458 +1,460 @@
-# frozen_string_literal: true
-
-require "tmpdir"
-require "open3"
-require "fileutils"
-# This module provides classes for the Makit gem.
-module Makit
-  # This class provide methods for working with the  Nuget package cache
-  #
-  # Example:
-  #
-  #   Makit::Directory.cache("Google.Protobuf", "3.27.2")
-  #
-  # dotnet nuget locals all --list
-  # dotnet nuget locals all --clear
-  #
-  class NuGet
-    def self.get_cache_dir(package, version)
-      File.join(Makit::Directories::NUGET_PACKAGE_CACHE, package, version)
-    end
-
-    def self.cache(package, version)
-      # if the package is already cached, there is nothing to do
-      return if Dir.exist?(get_cache_dir(package, version))
-
-      Dir.mktmpdir do |dir|
-        # Use the temp directory here
-        Dir.chdir(dir) do
-          system("dotnet new classlib -n ClassLib")
-          Dir.chdir("ClassLib") do
-            # display a list of directories in the current directory
-            puts Dir.entries(Dir.pwd)
-            # display a list of files in the current directory
-            puts Dir.entries(Dir.pwd)
-            puts "dotnet add ClassLib.csproj package #{package} --version #{version}"
-            system("dotnet add ClassLib.csproj package #{package} --version #{version}")
-          end
-        end
-        # The directory and its contents will be removed automatically after the block
-      end
-    end
-
-    def self.clear_cache(package, version)
-      return unless Dir.exist?(get_cache_dir(package, version))
-
-      FileUtils.rm_rf(get_cache_dir(package, version))
-    end
-
-    # get the latest version of the package
-    def self.get_latest_version(package)
-      dir = File.join(Makit::Directories::NUGET_PACKAGE_CACHE, package)
-      if Dir.exist?(dir)
-        versions = Dir.entries(dir).select do |entry|
-          File.directory?(File.join(dir, entry)) && ![".", ".."].include?(entry)
-        end
-        highest_version = Makit::Version.get_highest_version(versions)
-        return highest_version
-      end
-      nil
-    end
-
-    # publish a package to a nuget directory feed
-    def self.add_package(_package, path)
-      system("dotnet nuget push #{path} --source #{path}")
-    end
-
-    def self.publish(package, api_key, source)
-      "dotnet nuget push #{package} --skip-duplicate --api-key #{api_key} --source #{source}".run
-    end
-
-    def self.publish_to_directory(nuget_package_path, directory, package_name, version)
-      target_package_path = "#{directory}/#{package_name}/#{version}/#{package_name}.#{version}.nupkg".downcase
-      if File.exist?(target_package_path)
-        puts "  #{target_package_path} already exists".colorize(:grey)
-      else
-        "dotnet nuget push #{nuget_package_path} --source #{directory}".run
-      end
-    end
-
-    # -----------------------
-    # NuGet Source Management
-    # -----------------------
-
-    # Lists all configured NuGet sources
-    #
-    # @return [Array<Hash>] Array of source hashes with keys: :name, :url, :enabled
-    def self.list_sources
-      stdout, stderr, status = Open3.capture3("dotnet", "nuget", "list", "source")
-      
-      unless status.success?
-        Makit::Logging.default_logger.warn("Failed to list NuGet sources: #{stderr}")
-        return []
-      end
-
-      sources = []
-      current_source = nil
-      lines = stdout.lines
-      
-      lines.each_with_index do |line, index|
-        line_stripped = line.strip
-        next if line_stripped.empty?
-        
-        # Skip header lines
-        next if line_stripped.start_with?("Registered") || line_stripped.start_with?("---")
-        
-        # Parse numbered source lines like:
-        # "  11. nuget.org [Enabled]"
-        # "  1.  nuget.org [Disabled]"
-        match = line_stripped.match(/^\s*\d+\.\s+(.+?)(?:\s+\[(Enabled|Disabled)\])?$/)
-        if match
-          name_part = match[1]
-          enabled_str = match[2]
-          
-          next if name_part.nil? || name_part.strip.empty?
-          
-          name = name_part.strip
-          
-          # Default to enabled if not specified
-          enabled = enabled_str.nil? ? true : (enabled_str == "Enabled")
-          
-          # Create new source entry
-          current_source = { name: name, url: nil, enabled: enabled }
-          sources << current_source
-          
-          # Check next line for URL or path (indented line)
-          if index + 1 < lines.length
-            next_line = lines[index + 1]
-            next_line_stripped = next_line.strip
-            
-            # Check if next line is indented (starts with whitespace) and contains URL or path
-            if next_line.match?(/^\s+/) && !next_line_stripped.empty?
-              # Check if it's a URL
-              if next_line_stripped.match?(/^https?:\/\//)
-                current_source[:url] = next_line_stripped
-              # Check if it's a file path (Windows drive letter, UNC path, or Unix path)
-              elsif next_line_stripped.match?(/^[A-Z]:[\\\/]/) || next_line_stripped.match?(/^\\\\/) || next_line_stripped.match?(/^\/[^\/]/)
-                # For local sources, use the path as the "URL" for comparison purposes
-                current_source[:url] = next_line_stripped
-              end
-            end
-          end
-        end
-      end
-
-      sources
-    end
-
-    # Checks if a NuGet source with the given name exists
-    #
-    # @param name [String] The source name to check
-    # @return [Boolean] true if the source exists, false otherwise
-    def self.has_source?(name)
-      sources = list_sources
-      sources.any? { |source| source[:name] == name }
-    end
-
-    # Adds a NuGet source
-    #
-    # @param name [String] The source name
-    # @param url [String] The source URL
-    # @param username [String, nil] Optional username for authenticated sources
-    # @param password [String, nil] Optional password for authenticated sources
-    # @param store_password_in_clear_text [Boolean] Whether to store password in clear text (default: false)
-    # @return [Boolean] true if successful, false otherwise
-    def self.add_source(name, url, username: nil, password: nil, store_password_in_clear_text: false)
-      raise ArgumentError, "name is required" if name.nil? || name.strip.empty?
-      raise ArgumentError, "url is required" if url.nil? || url.strip.empty?
-
-      # Check if source already exists
-      if has_source?(name)
-        Makit::Logging.default_logger.info("NuGet source '#{name}' already exists")
-        return false
-      end
-
-      args = ["dotnet", "nuget", "add", "source", url, "--name", name]
-      args << "--username" << username if username
-      args << "--password" << password if password
-      args << "--store-password-in-clear-text" if store_password_in_clear_text
-
-      stdout, stderr, status = Open3.capture3(*args)
-
-      if status.success?
-        Makit::Logging.default_logger.info("Added NuGet source '#{name}' (#{url})")
-        true
-      else
-        Makit::Logging.default_logger.error("Failed to add NuGet source '#{name}': #{stderr}")
-        false
-      end
-    end
-
-    # Removes a NuGet source
-    #
-    # @param name [String] The source name to remove
-    # @return [Boolean] true if successful, false otherwise
-    def self.remove_source(name)
-      raise ArgumentError, "name is required" if name.nil? || name.strip.empty?
-
-      unless has_source?(name)
-        Makit::Logging.default_logger.info("NuGet source '#{name}' does not exist")
-        return false
-      end
-
-      stdout, stderr, status = Open3.capture3("dotnet", "nuget", "remove", "source", name)
-
-      if status.success?
-        Makit::Logging.default_logger.info("Removed NuGet source '#{name}'")
-        true
-      else
-        Makit::Logging.default_logger.error("Failed to remove NuGet source '#{name}': #{stderr}")
-        false
-      end
-    end
-
-    # Configures a NuGet source (adds if it doesn't exist, updates if URL differs, no-op if already configured)
-    #
-    # @param name [String] The source name
-    # @param url [String] The source URL
-    # @param username [String, nil] Optional username for authenticated sources
-    # @param password [String, nil] Optional password for authenticated sources
-    # @param store_password_in_clear_text [Boolean] Whether to store password in clear text (default: false)
-    # @return [Boolean] true if successful or already configured, false otherwise
-    def self.configure_source(name, url, username: nil, password: nil, store_password_in_clear_text: false)
-      raise ArgumentError, "name is required" if name.nil? || name.strip.empty?
-      raise ArgumentError, "url is required" if url.nil? || url.strip.empty?
-
-      # Check if source already exists
-      if has_source?(name)
-        # Get existing source details
-        sources = list_sources
-        existing_source = sources.find { |s| s[:name] == name }
-        
-        # If source exists with the same URL, it's already configured correctly (no-op)
-        if existing_source && existing_source[:url] == url
-          Makit::Logging.default_logger.info("NuGet source '#{name}' already exists with URL '#{url}', skipping configuration")
-          return true
-        end
-        
-        # Source exists but URL is different, update it
-        Makit::Logging.default_logger.info("NuGet source '#{name}' already exists with different URL, updating...")
-        remove_source(name)
-      end
-
-      # Add the source
-      add_source(name, url, username: username, password: password, store_password_in_clear_text: store_password_in_clear_text)
-    end
-
-    # Migrates packages from one NuGet source to another, matching a pattern
-    #
-    # For local directory feeds, packages are found by scanning the directory structure:
-    # {source_path}/{package_name}/{version}/{package_name}.{version}.nupkg
-    #
-    # @param source_name [String] The name of the source to migrate from
-    # @param package_pattern [String] The package name pattern to match (e.g., "rep*", "MyPackage.*")
-    # @param destination_name [String] The name of the destination source
-    # @return [Integer] The number of packages migrated, or -1 if an error occurred
-    def self.migrate_packages(source_name, package_pattern, destination_name)
-      raise ArgumentError, "source_name is required" if source_name.nil? || source_name.strip.empty?
-      raise ArgumentError, "package_pattern is required" if package_pattern.nil? || package_pattern.strip.empty?
-      raise ArgumentError, "destination_name is required" if destination_name.nil? || destination_name.strip.empty?
-
-      source_name = source_name.strip
-      package_pattern = package_pattern.strip
-      destination_name = destination_name.strip
-
-      # Get source information
-      sources = list_sources
-      source_info = sources.find { |s| s[:name] == source_name }
-      destination_info = sources.find { |s| s[:name] == destination_name }
-
-      unless source_info
-        Makit::Logging.default_logger.error("Source '#{source_name}' not found")
-        return -1
-      end
-
-      unless destination_info
-        Makit::Logging.default_logger.error("Destination source '#{destination_name}' not found")
-        return -1
-      end
-
-      source_path = source_info[:url]
-      destination_path = destination_info[:url]
-
-      # Source must be a local directory feed (not a URL)
-      unless source_path && !source_path.match?(/^https?:\/\//)
-        Makit::Logging.default_logger.error("Source '#{source_name}' is not a local directory feed (URL: #{source_path})")
-        return -1
-      end
-
-      # Expand and normalize the source path
-      source_path = File.expand_path(source_path)
-      
-      # Destination can be either local directory feed or remote feed (Azure DevOps, NuGet.org, etc.)
-      is_remote_destination = destination_path && destination_path.match?(/^https?:\/\//)
-
-      # Ensure source directory exists
-      unless Dir.exist?(source_path)
-        Makit::Logging.default_logger.error("Source directory does not exist: #{source_path}")
-        return -1
-      end
-
-      Makit::Logging.default_logger.info("Searching for packages matching '#{package_pattern}' in source '#{source_name}' (#{source_path})")
-      Makit::Logging.default_logger.info("Destination: #{destination_name} (#{destination_path}) - #{is_remote_destination ? 'Remote feed' : 'Local directory feed'}")
-
-      # Ensure destination directory exists (only for local feeds)
-      unless is_remote_destination
-        FileUtils.mkdir_p(destination_path) unless Dir.exist?(destination_path)
-      end
-
-      # Find all .nupkg files matching the pattern
-      # Simply search recursively for all .nupkg files and match package names
-      matching_packages = []
-      
-      # Glob for all .nupkg files recursively in the source directory
-      Dir.glob(File.join(source_path, "**", "*.nupkg")) do |nupkg_file|
-        # Extract package name from the file path
-        # Path structure is typically: {source_path}/{package_name}/{version}/{package_name}.{version}.nupkg
-        relative_path = nupkg_file.sub(/^#{Regexp.escape(source_path)}[\/\\]?/, "")
-        path_parts = relative_path.split(/[\/\\]/)
-        
-        # Get package name from directory structure (first directory after source_path)
-        package_name = path_parts.length >= 1 ? path_parts[0] : nil
-        
-        # If we can't get it from path, try to extract from filename
-        if package_name.nil? || package_name.empty?
-          filename = File.basename(nupkg_file, ".nupkg")
-          # Try to extract package name by removing version suffix (e.g., "1.2.3" or "1.2.3-beta")
-          if filename.match?(/^(.+?)\.(\d+\.\d+.*)$/)
-            package_name = $1
-          else
-            package_name = filename
-          end
-        end
-        
-        # Check if package name matches pattern
-        if package_name && File.fnmatch?(package_pattern, package_name, File::FNM_DOTMATCH)
-          # Extract version from path (second directory) or from filename
-          version = path_parts.length >= 2 ? path_parts[1] : nil
-          
-          # If we couldn't extract version from path, try from filename
-          if version.nil? || version.empty?
-            filename = File.basename(nupkg_file, ".nupkg")
-            if filename.match?(/^.+?\.(\d+\.\d+.*)$/)
-              version = $1
-            else
-              version = "unknown"
-            end
-          end
-          
-          matching_packages << {
-            package_name: package_name,
-            version: version,
-            nupkg_path: nupkg_file
-          }
-        end
-      end
-
-      if matching_packages.empty?
-        Makit::Logging.default_logger.info("No packages found matching pattern '#{package_pattern}' in source '#{source_name}'")
-        return 0
-      end
-
-      Makit::Logging.default_logger.info("Found #{matching_packages.length} package(s) matching pattern '#{package_pattern}' in source '#{source_name}'")
-
-      # Migrate each package
-      migrated_count = 0
-      failed_count = 0
-
-      matching_packages.each do |package_info|
-        package_name = package_info[:package_name]
-        version = package_info[:version]
-        nupkg_path = package_info[:nupkg_path]
-
-        Makit::Logging.default_logger.info("Migrating #{package_name}.#{version} from '#{source_name}' to '#{destination_name}'...")
-
-        if is_remote_destination
-          # For remote feeds (Azure DevOps, NuGet.org, etc.), use dotnet nuget push
-          # Azure DevOps requires --api-key az (placeholder) and --skip-duplicate
-          Makit::Logging.default_logger.info("  Pushing #{package_name}.#{version} to remote feed...")
-          
-          args = ["dotnet", "nuget", "push", nupkg_path, "--source", destination_path, "--skip-duplicate"]
-          
-          # For Azure DevOps feeds, add --api-key az (required placeholder)
-          if destination_path.include?("dev.azure.com") || destination_path.include?("pkgs.dev.azure.com")
-            args << "--api-key" << "az"
-          end
-          
-          stdout, stderr, status = Open3.capture3(*args)
-          
-          if status.success?
-            Makit::Logging.default_logger.info("  Successfully migrated #{package_name}.#{version} to remote feed")
-            migrated_count += 1
-          else
-            # Check if it's a duplicate (which is okay with --skip-duplicate)
-            if stderr.include?("already exists") || stderr.include?("duplicate")
-              Makit::Logging.default_logger.info("  Package already exists in destination, skipping: #{package_name}.#{version}")
-              migrated_count += 1
-            else
-              Makit::Logging.default_logger.error("  Failed to migrate #{package_name}.#{version}: #{stderr}")
-              failed_count += 1
-            end
-          end
-        else
-          # For local directory feeds, use 'nuget add' which automatically organizes packages
-          # into the hierarchical structure: {packageID}/{version}/packageID.version.nupkg
-          target_package_dir = File.join(destination_path, package_name.downcase, version)
-          target_package_path = File.join(target_package_dir, File.basename(nupkg_path).downcase)
-          
-          if File.exist?(target_package_path)
-            Makit::Logging.default_logger.info("  Package already exists in destination, skipping: #{package_name}.#{version}")
-            migrated_count += 1
-            next
-          end
-          
-          stdout, stderr, status = Open3.capture3("nuget", "add", nupkg_path, "-Source", destination_path)
-
-          if status.success?
-            Makit::Logging.default_logger.info("  Successfully migrated and organized #{package_name}.#{version}")
-            migrated_count += 1
-          else
-            # Fallback to dotnet nuget push if nuget.exe is not available
-            nuget_exe = Makit::Environment.which("nuget")
-            if nuget_exe.nil? || nuget_exe.empty?
-              Makit::Logging.default_logger.info("  nuget.exe not found, falling back to dotnet nuget push")
-              
-              # Manually organize package into proper directory structure
-              Makit::Logging.default_logger.info("  Organizing package into directory structure: #{target_package_dir}")
-              FileUtils.mkdir_p(target_package_dir)
-              FileUtils.cp(nupkg_path, target_package_path)
-              
-              # Push using dotnet nuget push from the organized location
-              stdout, stderr, status = Open3.capture3("dotnet", "nuget", "push", target_package_path, "--source", destination_path)
-              
-              if status.success?
-                Makit::Logging.default_logger.info("  Successfully migrated and organized #{package_name}.#{version}")
-                migrated_count += 1
-              else
-                Makit::Logging.default_logger.warn("  Package copied to organized structure but dotnet nuget push failed: #{stderr}")
-                Makit::Logging.default_logger.warn("  Package is available at #{target_package_path} but may need manual indexing")
-                migrated_count += 1
-              end
-            else
-              Makit::Logging.default_logger.error("  Failed to migrate #{package_name}.#{version}: #{stderr}")
-              failed_count += 1
-            end
-          end
-        end
-      end
-
-      if failed_count > 0
-        Makit::Logging.default_logger.warn("Migration completed with #{failed_count} failure(s). #{migrated_count} package(s) migrated successfully.")
-      else
-        Makit::Logging.default_logger.info("Successfully migrated #{migrated_count} package(s) from '#{source_name}' to '#{destination_name}'")
-      end
-
-      migrated_count
-    end
-  end
-end
+# frozen_string_literal: true
+
+require "tmpdir"
+require "open3"
+require "fileutils"
+# This module provides classes for the Makit gem.
+module Makit
+  # This class provide methods for working with the  Nuget package cache
+  #
+  # Example:
+  #
+  #   Makit::Directory.cache("Google.Protobuf", "3.27.2")
+  #
+  # dotnet nuget locals all --list
+  # dotnet nuget locals all --clear
+  #
+  class NuGet
+    def self.get_cache_dir(package, version)
+      File.join(Makit::Directories::NUGET_PACKAGE_CACHE, package, version)
+    end
+
+    def self.cache(package, version)
+      # if the package is already cached, there is nothing to do
+      return if Dir.exist?(get_cache_dir(package, version))
+
+      Dir.mktmpdir do |dir|
+        # Use the temp directory here
+        Dir.chdir(dir) do
+          system("dotnet new classlib -n ClassLib")
+          Dir.chdir("ClassLib") do
+            # display a list of directories in the current directory
+            puts Dir.entries(Dir.pwd)
+            # display a list of files in the current directory
+            puts Dir.entries(Dir.pwd)
+            puts "dotnet add ClassLib.csproj package #{package} --version #{version}"
+            system("dotnet add ClassLib.csproj package #{package} --version #{version}")
+          end
+        end
+        # The directory and its contents will be removed automatically after the block
+      end
+    end
+
+    def self.clear_cache(package, version)
+      return unless Dir.exist?(get_cache_dir(package, version))
+
+      FileUtils.rm_rf(get_cache_dir(package, version))
+    end
+
+    # get the latest version of the package
+    def self.get_latest_version(package)
+      dir = File.join(Makit::Directories::NUGET_PACKAGE_CACHE, package)
+      if Dir.exist?(dir)
+        versions = Dir.entries(dir).select do |entry|
+          File.directory?(File.join(dir, entry)) && ![".", ".."].include?(entry)
+        end
+        highest_version = Makit::Version.get_highest_version(versions)
+        return highest_version
+      end
+      nil
+    end
+
+    # publish a package to a nuget directory feed
+    def self.add_package(_package, path)
+      system("dotnet nuget push #{path} --source #{path}")
+    end
+
+    def self.publish(package, api_key, source)
+      # we do not want the api_key echoed to the console, substitute *****
+      puts "dotnet nuget push #{package} --skip-duplicate --api-key ***** --source #{source}"
+      puts `dotnet nuget push #{package} --skip-duplicate --api-key #{api_key} --source #{source}`
+    end
+
+    def self.publish_to_directory(nuget_package_path, directory, package_name, version)
+      target_package_path = "#{directory}/#{package_name}/#{version}/#{package_name}.#{version}.nupkg".downcase
+      if File.exist?(target_package_path)
+        puts "  #{target_package_path} already exists".colorize(:grey)
+      else
+        "dotnet nuget push #{nuget_package_path} --source #{directory}".run
+      end
+    end
+
+    # -----------------------
+    # NuGet Source Management
+    # -----------------------
+
+    # Lists all configured NuGet sources
+    #
+    # @return [Array<Hash>] Array of source hashes with keys: :name, :url, :enabled
+    def self.list_sources
+      stdout, stderr, status = Open3.capture3("dotnet", "nuget", "list", "source")
+      
+      unless status.success?
+        Makit::Logging.default_logger.warn("Failed to list NuGet sources: #{stderr}")
+        return []
+      end
+
+      sources = []
+      current_source = nil
+      lines = stdout.lines
+      
+      lines.each_with_index do |line, index|
+        line_stripped = line.strip
+        next if line_stripped.empty?
+        
+        # Skip header lines
+        next if line_stripped.start_with?("Registered") || line_stripped.start_with?("---")
+        
+        # Parse numbered source lines like:
+        # "  11. nuget.org [Enabled]"
+        # "  1.  nuget.org [Disabled]"
+        match = line_stripped.match(/^\s*\d+\.\s+(.+?)(?:\s+\[(Enabled|Disabled)\])?$/)
+        if match
+          name_part = match[1]
+          enabled_str = match[2]
+          
+          next if name_part.nil? || name_part.strip.empty?
+          
+          name = name_part.strip
+          
+          # Default to enabled if not specified
+          enabled = enabled_str.nil? ? true : (enabled_str == "Enabled")
+          
+          # Create new source entry
+          current_source = { name: name, url: nil, enabled: enabled }
+          sources << current_source
+          
+          # Check next line for URL or path (indented line)
+          if index + 1 < lines.length
+            next_line = lines[index + 1]
+            next_line_stripped = next_line.strip
+            
+            # Check if next line is indented (starts with whitespace) and contains URL or path
+            if next_line.match?(/^\s+/) && !next_line_stripped.empty?
+              # Check if it's a URL
+              if next_line_stripped.match?(/^https?:\/\//)
+                current_source[:url] = next_line_stripped
+              # Check if it's a file path (Windows drive letter, UNC path, or Unix path)
+              elsif next_line_stripped.match?(/^[A-Z]:[\\\/]/) || next_line_stripped.match?(/^\\\\/) || next_line_stripped.match?(/^\/[^\/]/)
+                # For local sources, use the path as the "URL" for comparison purposes
+                current_source[:url] = next_line_stripped
+              end
+            end
+          end
+        end
+      end
+
+      sources
+    end
+
+    # Checks if a NuGet source with the given name exists
+    #
+    # @param name [String] The source name to check
+    # @return [Boolean] true if the source exists, false otherwise
+    def self.has_source?(name)
+      sources = list_sources
+      sources.any? { |source| source[:name] == name }
+    end
+
+    # Adds a NuGet source
+    #
+    # @param name [String] The source name
+    # @param url [String] The source URL
+    # @param username [String, nil] Optional username for authenticated sources
+    # @param password [String, nil] Optional password for authenticated sources
+    # @param store_password_in_clear_text [Boolean] Whether to store password in clear text (default: false)
+    # @return [Boolean] true if successful, false otherwise
+    def self.add_source(name, url, username: nil, password: nil, store_password_in_clear_text: false)
+      raise ArgumentError, "name is required" if name.nil? || name.strip.empty?
+      raise ArgumentError, "url is required" if url.nil? || url.strip.empty?
+
+      # Check if source already exists
+      if has_source?(name)
+        Makit::Logging.default_logger.info("NuGet source '#{name}' already exists")
+        return false
+      end
+
+      args = ["dotnet", "nuget", "add", "source", url, "--name", name]
+      args << "--username" << username if username
+      args << "--password" << password if password
+      args << "--store-password-in-clear-text" if store_password_in_clear_text
+
+      stdout, stderr, status = Open3.capture3(*args)
+
+      if status.success?
+        Makit::Logging.default_logger.info("Added NuGet source '#{name}' (#{url})")
+        true
+      else
+        Makit::Logging.default_logger.error("Failed to add NuGet source '#{name}': #{stderr}")
+        false
+      end
+    end
+
+    # Removes a NuGet source
+    #
+    # @param name [String] The source name to remove
+    # @return [Boolean] true if successful, false otherwise
+    def self.remove_source(name)
+      raise ArgumentError, "name is required" if name.nil? || name.strip.empty?
+
+      unless has_source?(name)
+        Makit::Logging.default_logger.info("NuGet source '#{name}' does not exist")
+        return false
+      end
+
+      stdout, stderr, status = Open3.capture3("dotnet", "nuget", "remove", "source", name)
+
+      if status.success?
+        Makit::Logging.default_logger.info("Removed NuGet source '#{name}'")
+        true
+      else
+        Makit::Logging.default_logger.error("Failed to remove NuGet source '#{name}': #{stderr}")
+        false
+      end
+    end
+
+    # Configures a NuGet source (adds if it doesn't exist, updates if URL differs, no-op if already configured)
+    #
+    # @param name [String] The source name
+    # @param url [String] The source URL
+    # @param username [String, nil] Optional username for authenticated sources
+    # @param password [String, nil] Optional password for authenticated sources
+    # @param store_password_in_clear_text [Boolean] Whether to store password in clear text (default: false)
+    # @return [Boolean] true if successful or already configured, false otherwise
+    def self.configure_source(name, url, username: nil, password: nil, store_password_in_clear_text: false)
+      raise ArgumentError, "name is required" if name.nil? || name.strip.empty?
+      raise ArgumentError, "url is required" if url.nil? || url.strip.empty?
+
+      # Check if source already exists
+      if has_source?(name)
+        # Get existing source details
+        sources = list_sources
+        existing_source = sources.find { |s| s[:name] == name }
+        
+        # If source exists with the same URL, it's already configured correctly (no-op)
+        if existing_source && existing_source[:url] == url
+          Makit::Logging.default_logger.info("NuGet source '#{name}' already exists with URL '#{url}', skipping configuration")
+          return true
+        end
+        
+        # Source exists but URL is different, update it
+        Makit::Logging.default_logger.info("NuGet source '#{name}' already exists with different URL, updating...")
+        remove_source(name)
+      end
+
+      # Add the source
+      add_source(name, url, username: username, password: password, store_password_in_clear_text: store_password_in_clear_text)
+    end
+
+    # Migrates packages from one NuGet source to another, matching a pattern
+    #
+    # For local directory feeds, packages are found by scanning the directory structure:
+    # {source_path}/{package_name}/{version}/{package_name}.{version}.nupkg
+    #
+    # @param source_name [String] The name of the source to migrate from
+    # @param package_pattern [String] The package name pattern to match (e.g., "rep*", "MyPackage.*")
+    # @param destination_name [String] The name of the destination source
+    # @return [Integer] The number of packages migrated, or -1 if an error occurred
+    def self.migrate_packages(source_name, package_pattern, destination_name)
+      raise ArgumentError, "source_name is required" if source_name.nil? || source_name.strip.empty?
+      raise ArgumentError, "package_pattern is required" if package_pattern.nil? || package_pattern.strip.empty?
+      raise ArgumentError, "destination_name is required" if destination_name.nil? || destination_name.strip.empty?
+
+      source_name = source_name.strip
+      package_pattern = package_pattern.strip
+      destination_name = destination_name.strip
+
+      # Get source information
+      sources = list_sources
+      source_info = sources.find { |s| s[:name] == source_name }
+      destination_info = sources.find { |s| s[:name] == destination_name }
+
+      unless source_info
+        Makit::Logging.default_logger.error("Source '#{source_name}' not found")
+        return -1
+      end
+
+      unless destination_info
+        Makit::Logging.default_logger.error("Destination source '#{destination_name}' not found")
+        return -1
+      end
+
+      source_path = source_info[:url]
+      destination_path = destination_info[:url]
+
+      # Source must be a local directory feed (not a URL)
+      unless source_path && !source_path.match?(/^https?:\/\//)
+        Makit::Logging.default_logger.error("Source '#{source_name}' is not a local directory feed (URL: #{source_path})")
+        return -1
+      end
+
+      # Expand and normalize the source path
+      source_path = File.expand_path(source_path)
+      
+      # Destination can be either local directory feed or remote feed (Azure DevOps, NuGet.org, etc.)
+      is_remote_destination = destination_path && destination_path.match?(/^https?:\/\//)
+
+      # Ensure source directory exists
+      unless Dir.exist?(source_path)
+        Makit::Logging.default_logger.error("Source directory does not exist: #{source_path}")
+        return -1
+      end
+
+      Makit::Logging.default_logger.info("Searching for packages matching '#{package_pattern}' in source '#{source_name}' (#{source_path})")
+      Makit::Logging.default_logger.info("Destination: #{destination_name} (#{destination_path}) - #{is_remote_destination ? 'Remote feed' : 'Local directory feed'}")
+
+      # Ensure destination directory exists (only for local feeds)
+      unless is_remote_destination
+        FileUtils.mkdir_p(destination_path) unless Dir.exist?(destination_path)
+      end
+
+      # Find all .nupkg files matching the pattern
+      # Simply search recursively for all .nupkg files and match package names
+      matching_packages = []
+      
+      # Glob for all .nupkg files recursively in the source directory
+      Dir.glob(File.join(source_path, "**", "*.nupkg")) do |nupkg_file|
+        # Extract package name from the file path
+        # Path structure is typically: {source_path}/{package_name}/{version}/{package_name}.{version}.nupkg
+        relative_path = nupkg_file.sub(/^#{Regexp.escape(source_path)}[\/\\]?/, "")
+        path_parts = relative_path.split(/[\/\\]/)
+        
+        # Get package name from directory structure (first directory after source_path)
+        package_name = path_parts.length >= 1 ? path_parts[0] : nil
+        
+        # If we can't get it from path, try to extract from filename
+        if package_name.nil? || package_name.empty?
+          filename = File.basename(nupkg_file, ".nupkg")
+          # Try to extract package name by removing version suffix (e.g., "1.2.3" or "1.2.3-beta")
+          if filename.match?(/^(.+?)\.(\d+\.\d+.*)$/)
+            package_name = $1
+          else
+            package_name = filename
+          end
+        end
+        
+        # Check if package name matches pattern
+        if package_name && File.fnmatch?(package_pattern, package_name, File::FNM_DOTMATCH)
+          # Extract version from path (second directory) or from filename
+          version = path_parts.length >= 2 ? path_parts[1] : nil
+          
+          # If we couldn't extract version from path, try from filename
+          if version.nil? || version.empty?
+            filename = File.basename(nupkg_file, ".nupkg")
+            if filename.match?(/^.+?\.(\d+\.\d+.*)$/)
+              version = $1
+            else
+              version = "unknown"
+            end
+          end
+          
+          matching_packages << {
+            package_name: package_name,
+            version: version,
+            nupkg_path: nupkg_file
+          }
+        end
+      end
+
+      if matching_packages.empty?
+        Makit::Logging.default_logger.info("No packages found matching pattern '#{package_pattern}' in source '#{source_name}'")
+        return 0
+      end
+
+      Makit::Logging.default_logger.info("Found #{matching_packages.length} package(s) matching pattern '#{package_pattern}' in source '#{source_name}'")
+
+      # Migrate each package
+      migrated_count = 0
+      failed_count = 0
+
+      matching_packages.each do |package_info|
+        package_name = package_info[:package_name]
+        version = package_info[:version]
+        nupkg_path = package_info[:nupkg_path]
+
+        Makit::Logging.default_logger.info("Migrating #{package_name}.#{version} from '#{source_name}' to '#{destination_name}'...")
+
+        if is_remote_destination
+          # For remote feeds (Azure DevOps, NuGet.org, etc.), use dotnet nuget push
+          # Azure DevOps requires --api-key az (placeholder) and --skip-duplicate
+          Makit::Logging.default_logger.info("  Pushing #{package_name}.#{version} to remote feed...")
+          
+          args = ["dotnet", "nuget", "push", nupkg_path, "--source", destination_path, "--skip-duplicate"]
+          
+          # For Azure DevOps feeds, add --api-key az (required placeholder)
+          if destination_path.include?("dev.azure.com") || destination_path.include?("pkgs.dev.azure.com")
+            args << "--api-key" << "az"
+          end
+          
+          stdout, stderr, status = Open3.capture3(*args)
+          
+          if status.success?
+            Makit::Logging.default_logger.info("  Successfully migrated #{package_name}.#{version} to remote feed")
+            migrated_count += 1
+          else
+            # Check if it's a duplicate (which is okay with --skip-duplicate)
+            if stderr.include?("already exists") || stderr.include?("duplicate")
+              Makit::Logging.default_logger.info("  Package already exists in destination, skipping: #{package_name}.#{version}")
+              migrated_count += 1
+            else
+              Makit::Logging.default_logger.error("  Failed to migrate #{package_name}.#{version}: #{stderr}")
+              failed_count += 1
+            end
+          end
+        else
+          # For local directory feeds, use 'nuget add' which automatically organizes packages
+          # into the hierarchical structure: {packageID}/{version}/packageID.version.nupkg
+          target_package_dir = File.join(destination_path, package_name.downcase, version)
+          target_package_path = File.join(target_package_dir, File.basename(nupkg_path).downcase)
+          
+          if File.exist?(target_package_path)
+            Makit::Logging.default_logger.info("  Package already exists in destination, skipping: #{package_name}.#{version}")
+            migrated_count += 1
+            next
+          end
+          
+          stdout, stderr, status = Open3.capture3("nuget", "add", nupkg_path, "-Source", destination_path)
+
+          if status.success?
+            Makit::Logging.default_logger.info("  Successfully migrated and organized #{package_name}.#{version}")
+            migrated_count += 1
+          else
+            # Fallback to dotnet nuget push if nuget.exe is not available
+            nuget_exe = Makit::Environment.which("nuget")
+            if nuget_exe.nil? || nuget_exe.empty?
+              Makit::Logging.default_logger.info("  nuget.exe not found, falling back to dotnet nuget push")
+              
+              # Manually organize package into proper directory structure
+              Makit::Logging.default_logger.info("  Organizing package into directory structure: #{target_package_dir}")
+              FileUtils.mkdir_p(target_package_dir)
+              FileUtils.cp(nupkg_path, target_package_path)
+              
+              # Push using dotnet nuget push from the organized location
+              stdout, stderr, status = Open3.capture3("dotnet", "nuget", "push", target_package_path, "--source", destination_path)
+              
+              if status.success?
+                Makit::Logging.default_logger.info("  Successfully migrated and organized #{package_name}.#{version}")
+                migrated_count += 1
+              else
+                Makit::Logging.default_logger.warn("  Package copied to organized structure but dotnet nuget push failed: #{stderr}")
+                Makit::Logging.default_logger.warn("  Package is available at #{target_package_path} but may need manual indexing")
+                migrated_count += 1
+              end
+            else
+              Makit::Logging.default_logger.error("  Failed to migrate #{package_name}.#{version}: #{stderr}")
+              failed_count += 1
+            end
+          end
+        end
+      end
+
+      if failed_count > 0
+        Makit::Logging.default_logger.warn("Migration completed with #{failed_count} failure(s). #{migrated_count} package(s) migrated successfully.")
+      else
+        Makit::Logging.default_logger.info("Successfully migrated #{migrated_count} package(s) from '#{source_name}' to '#{destination_name}'")
+      end
+
+      migrated_count
+    end
+  end
+end