makit 0.0.173 → 0.0.174

data/lib/makit/nuget.rb

@@ -1,604 +1,604 @@
-# 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
-
-    # Publishes a NuGet package to a remote or local NuGet feed
-    #
-    # This method pushes a .nupkg file to a NuGet source using `dotnet nuget push`.
-    # It automatically includes `--skip-duplicate` to avoid errors when the package
-    # version already exists on the feed.
-    #
-    # When an API key is provided, it is used for authentication but is masked
-    # in the console output for security. When no API key is provided (nil or empty),
-    # the `--api-key` flag is omitted, which is useful for:
-    # - Local directory feeds that don't require authentication
-    # - Azure DevOps feeds using Azure CLI authentication
-    # - Feeds with credential providers configured
-    #
-    # @param package [String] Path to the .nupkg file to publish
-    # @param api_key [String, nil] API key for authentication (nil to skip)
-    # @param source [String] NuGet feed URL or source name
-    # @return [void]
-    #
-    # @example Publish to NuGet.org with an API key
-    #   api_key = ENV["NUGET_API_KEY"]
-    #   Makit::NuGet.publish(
-    #     "bin/Release/MyPackage.1.0.0.nupkg",
-    #     api_key,
-    #     "https://api.nuget.org/v3/index.json"
-    #   )
-    #
-    # @example Publish to Azure DevOps feed (using Azure CLI auth, no API key needed)
-    #   # First authenticate with: az login
-    #   Makit::NuGet.publish(
-    #     "artifacts/MyCompany.Utils.1.2.3.nupkg",
-    #     nil,
-    #     "https://pkgs.dev.azure.com/myorg/myproject/_packaging/myfeed/nuget/v3/index.json"
-    #   )
-    #
-    # @example Publish to Azure DevOps feed with PAT token
-    #   pat_token = ENV["AZURE_DEVOPS_PAT"]
-    #   Makit::NuGet.publish(
-    #     "artifacts/MyCompany.Utils.1.2.3.nupkg",
-    #     pat_token,
-    #     "https://pkgs.dev.azure.com/myorg/myproject/_packaging/myfeed/nuget/v3/index.json"
-    #   )
-    #
-    # @example Publish to a local directory feed (no API key)
-    #   Makit::NuGet.publish(
-    #     "bin/Release/MyPackage.1.0.0.nupkg",
-    #     nil,
-    #     "/Users/louie/code/nuget"
-    #   )
-    #
-    # @example Publish to a configured source by name
-    #   # Using a source name configured via `dotnet nuget add source`
-    #   Makit::NuGet.publish(
-    #     "MyPackage.1.0.0.nupkg",
-    #     nil,
-    #     "local"
-    #   )
-    #
-    # @example Publish with API key from secrets management
-    #   api_key = Makit::Secrets.get("NUGET_API_KEY")
-    #   Makit::NuGet.publish(
-    #     "bin/Release/MyPackage.1.0.0.nupkg",
-    #     api_key,
-    #     "https://api.nuget.org/v3/index.json"
-    #   )
-    #
-    # @see publish_to_directory For publishing to local directory feeds with deduplication
-    # @see configure_source For setting up NuGet sources
-    #
-    def self.publish(package, api_key, source)
-      if api_key.nil? || api_key.to_s.strip.empty?
-        # No API key provided, skip --api-key flag
-        puts "dotnet nuget push #{package} --skip-duplicate --source #{source}"
-        puts `dotnet nuget push #{package} --skip-duplicate --source #{source}`
-      else
-        # 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
-    end
-
-    # Publishes a NuGet package to a local directory feed
-    #
-    # This method pushes a .nupkg file to a local directory-based NuGet feed.
-    # If the package already exists at the target location, it skips the push
-    # and displays a message indicating the package is already present.
-    #
-    # The target path follows the standard NuGet directory feed structure:
-    #   {directory}/{package_name}/{version}/{package_name}.{version}.nupkg
-    #
-    # @param nuget_package_path [String] Full path to the .nupkg file to publish
-    # @param directory [String] Path to the local NuGet feed directory
-    # @param package_name [String] Name of the NuGet package (e.g., "MyCompany.MyPackage")
-    # @param version [String] Version of the package (e.g., "1.2.3")
-    # @return [void]
-    #
-    # @example Publish a package to a local feed directory
-    #   # First, configure a local NuGet source named "local"
-    #   Makit::NuGet.configure_source("local", "/Users/louie/code/nuget")
-    #
-    #   # Publish a package to the local feed
-    #   Makit::NuGet.publish_to_directory(
-    #     "/path/to/MyPackage.1.0.0.nupkg",
-    #     "/Users/louie/code/nuget",
-    #     "MyPackage",
-    #     "1.0.0"
-    #   )
-    #   # Creates: /Users/louie/code/nuget/mypackage/1.0.0/mypackage.1.0.0.nupkg
-    #
-    # @example Publish multiple versions of a package
-    #   local_feed = "/Users/louie/code/nuget"
-    #
-    #   # Publish version 1.0.0
-    #   Makit::NuGet.publish_to_directory(
-    #     "artifacts/MyCompany.Utils.1.0.0.nupkg",
-    #     local_feed,
-    #     "MyCompany.Utils",
-    #     "1.0.0"
-    #   )
-    #
-    #   # Publish version 1.0.1
-    #   Makit::NuGet.publish_to_directory(
-    #     "artifacts/MyCompany.Utils.1.0.1.nupkg",
-    #     local_feed,
-    #     "MyCompany.Utils",
-    #     "1.0.1"
-    #   )
-    #
-    # @example Use with a configured "local" source
-    #   # Configure the "local" source if not already configured
-    #   Makit::NuGet.configure_source("local", "/Users/louie/code/nuget")
-    #
-    #   # Get the source directory from the configured sources
-    #   sources = Makit::NuGet.list_sources
-    #   local_source = sources.find { |s| s[:name] == "local" }
-    #   local_dir = local_source[:url] if local_source
-    #
-    #   # Publish to the local source
-    #   if local_dir
-    #     Makit::NuGet.publish_to_directory(
-    #       "bin/Release/MyApp.1.2.3.nupkg",
-    #       local_dir,
-    #       "MyApp",
-    #       "1.2.3"
-    #     )
-    #   end
-    #
-    # @see configure_source For setting up the local NuGet source
-    # @see list_sources For retrieving configured NuGet sources
-    # @see migrate_packages For migrating packages between feeds
-    #
-    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
+
+    # Publishes a NuGet package to a remote or local NuGet feed
+    #
+    # This method pushes a .nupkg file to a NuGet source using `dotnet nuget push`.
+    # It automatically includes `--skip-duplicate` to avoid errors when the package
+    # version already exists on the feed.
+    #
+    # When an API key is provided, it is used for authentication but is masked
+    # in the console output for security. When no API key is provided (nil or empty),
+    # the `--api-key` flag is omitted, which is useful for:
+    # - Local directory feeds that don't require authentication
+    # - Azure DevOps feeds using Azure CLI authentication
+    # - Feeds with credential providers configured
+    #
+    # @param package [String] Path to the .nupkg file to publish
+    # @param api_key [String, nil] API key for authentication (nil to skip)
+    # @param source [String] NuGet feed URL or source name
+    # @return [void]
+    #
+    # @example Publish to NuGet.org with an API key
+    #   api_key = ENV["NUGET_API_KEY"]
+    #   Makit::NuGet.publish(
+    #     "bin/Release/MyPackage.1.0.0.nupkg",
+    #     api_key,
+    #     "https://api.nuget.org/v3/index.json"
+    #   )
+    #
+    # @example Publish to Azure DevOps feed (using Azure CLI auth, no API key needed)
+    #   # First authenticate with: az login
+    #   Makit::NuGet.publish(
+    #     "artifacts/MyCompany.Utils.1.2.3.nupkg",
+    #     nil,
+    #     "https://pkgs.dev.azure.com/myorg/myproject/_packaging/myfeed/nuget/v3/index.json"
+    #   )
+    #
+    # @example Publish to Azure DevOps feed with PAT token
+    #   pat_token = ENV["AZURE_DEVOPS_PAT"]
+    #   Makit::NuGet.publish(
+    #     "artifacts/MyCompany.Utils.1.2.3.nupkg",
+    #     pat_token,
+    #     "https://pkgs.dev.azure.com/myorg/myproject/_packaging/myfeed/nuget/v3/index.json"
+    #   )
+    #
+    # @example Publish to a local directory feed (no API key)
+    #   Makit::NuGet.publish(
+    #     "bin/Release/MyPackage.1.0.0.nupkg",
+    #     nil,
+    #     "/Users/louie/code/nuget"
+    #   )
+    #
+    # @example Publish to a configured source by name
+    #   # Using a source name configured via `dotnet nuget add source`
+    #   Makit::NuGet.publish(
+    #     "MyPackage.1.0.0.nupkg",
+    #     nil,
+    #     "local"
+    #   )
+    #
+    # @example Publish with API key from secrets management
+    #   api_key = Makit::Secrets.get("NUGET_API_KEY")
+    #   Makit::NuGet.publish(
+    #     "bin/Release/MyPackage.1.0.0.nupkg",
+    #     api_key,
+    #     "https://api.nuget.org/v3/index.json"
+    #   )
+    #
+    # @see publish_to_directory For publishing to local directory feeds with deduplication
+    # @see configure_source For setting up NuGet sources
+    #
+    def self.publish(package, api_key, source)
+      if api_key.nil? || api_key.to_s.strip.empty?
+        # No API key provided, skip --api-key flag
+        puts "dotnet nuget push #{package} --skip-duplicate --source #{source}"
+        puts `dotnet nuget push #{package} --skip-duplicate --source #{source}`
+      else
+        # 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
+    end
+
+    # Publishes a NuGet package to a local directory feed
+    #
+    # This method pushes a .nupkg file to a local directory-based NuGet feed.
+    # If the package already exists at the target location, it skips the push
+    # and displays a message indicating the package is already present.
+    #
+    # The target path follows the standard NuGet directory feed structure:
+    #   {directory}/{package_name}/{version}/{package_name}.{version}.nupkg
+    #
+    # @param nuget_package_path [String] Full path to the .nupkg file to publish
+    # @param directory [String] Path to the local NuGet feed directory
+    # @param package_name [String] Name of the NuGet package (e.g., "MyCompany.MyPackage")
+    # @param version [String] Version of the package (e.g., "1.2.3")
+    # @return [void]
+    #
+    # @example Publish a package to a local feed directory
+    #   # First, configure a local NuGet source named "local"
+    #   Makit::NuGet.configure_source("local", "/Users/louie/code/nuget")
+    #
+    #   # Publish a package to the local feed
+    #   Makit::NuGet.publish_to_directory(
+    #     "/path/to/MyPackage.1.0.0.nupkg",
+    #     "/Users/louie/code/nuget",
+    #     "MyPackage",
+    #     "1.0.0"
+    #   )
+    #   # Creates: /Users/louie/code/nuget/mypackage/1.0.0/mypackage.1.0.0.nupkg
+    #
+    # @example Publish multiple versions of a package
+    #   local_feed = "/Users/louie/code/nuget"
+    #
+    #   # Publish version 1.0.0
+    #   Makit::NuGet.publish_to_directory(
+    #     "artifacts/MyCompany.Utils.1.0.0.nupkg",
+    #     local_feed,
+    #     "MyCompany.Utils",
+    #     "1.0.0"
+    #   )
+    #
+    #   # Publish version 1.0.1
+    #   Makit::NuGet.publish_to_directory(
+    #     "artifacts/MyCompany.Utils.1.0.1.nupkg",
+    #     local_feed,
+    #     "MyCompany.Utils",
+    #     "1.0.1"
+    #   )
+    #
+    # @example Use with a configured "local" source
+    #   # Configure the "local" source if not already configured
+    #   Makit::NuGet.configure_source("local", "/Users/louie/code/nuget")
+    #
+    #   # Get the source directory from the configured sources
+    #   sources = Makit::NuGet.list_sources
+    #   local_source = sources.find { |s| s[:name] == "local" }
+    #   local_dir = local_source[:url] if local_source
+    #
+    #   # Publish to the local source
+    #   if local_dir
+    #     Makit::NuGet.publish_to_directory(
+    #       "bin/Release/MyApp.1.2.3.nupkg",
+    #       local_dir,
+    #       "MyApp",
+    #       "1.2.3"
+    #     )
+    #   end
+    #
+    # @see configure_source For setting up the local NuGet source
+    # @see list_sources For retrieving configured NuGet sources
+    # @see migrate_packages For migrating packages between feeds
+    #
+    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