hlsv 1.0.0

data/lib/hlsv/mon_script.rb

@@ -0,0 +1,169 @@
+# Copyright (c) 2026 AdClin
+# Licensed under the GNU Affero General Public License v3.0 or later.
+# See the LICENSE file for details.
+
+# mon_script.rb
+# Orchestration layer between the web interface (app.rb) and the analysis engine (find_keys.rb)
+require_relative 'find_keys'
+
+module Hlsv
+module MonScript
+  # Execute the complete analysis workflow
+  # @param config [Hash] Configuration parameters from the web interface
+  # @return [Hash] Detailed execution results including steps, files, and statistics
+  def self.executer(config)
+    steps = []
+    temp_config = 'temp_config.yaml'
+
+    begin
+      # ========================================
+      # STEP 1: Configuration Validation
+      # ========================================
+      steps << {
+        etape: 1,
+        nom: "Configuration validation",
+        statut: "en_cours"
+      }
+      puts "=" * 60
+      puts "Step 1/3: Configuration validation"
+
+      # Prepare configuration for FindKeys
+      # Prefix study_name with "hlsv_results/" to create folders in hlsv_results/ directory
+      config_with_results = config.dup
+      original_study_name = config['study_name']
+      config_with_results['study_name'] = "hlsv_results/#{original_study_name}"
+
+      # Create temporary config file for FindKeys
+      File.write(temp_config, config_with_results.to_yaml)
+
+      # Initialize FindKeys with the configuration
+      fk = FindKeys.new(temp_config, verbose: false)
+
+      # Enable web mode for report generation
+      fk.report.instance_variable_set(:@web_mode, true)
+
+      steps[0][:statut] = "termine"
+      steps[0][:message] = "Configuration validated successfully"
+
+      # ========================================
+      # STEP 2: Analysis Execution
+      # ========================================
+      steps << {
+        etape: 2,
+        nom: "Analysis execution",
+        statut: "en_cours"
+      }
+      puts "Step 2/3: Analysis execution"
+
+      # Execute high-level check on all datasets
+      fk.high_level_check
+
+      steps[1][:statut] = "termine"
+      steps[1][:message] = "Analysis completed successfully"
+
+      # ========================================
+      # STEP 3: Report Generation
+      # ========================================
+      steps << {
+        etape: 3,
+        nom: "Report generation",
+        statut: "en_cours"
+      }
+      puts "Step 3/3: Report generation"
+
+      # Generate HTML report
+      fk.write_html_report
+
+      steps[2][:statut] = "termine"
+      steps[2][:message] = "Report generated successfully"
+
+      # ========================================
+      # Post-Processing: Move Config File
+      # ========================================
+      # Move the temp config file to the study directory for reference
+      config_destination = "hlsv_results/#{config['study_name']}/config.yaml"
+      if File.exist?(temp_config)
+        FileUtils.mv(temp_config, config_destination)
+      end
+
+      puts "All steps completed successfully"
+      puts "=" * 60
+
+      # ========================================
+      # Return Detailed Results
+      # ========================================
+      build_result_summary(
+        fk: fk,
+        steps: steps,
+        original_study_name: original_study_name
+      )
+
+    rescue => e
+      # ========================================
+      # Error Handling
+      # ========================================
+      handle_execution_error(
+        error: e,
+        steps: steps,
+        temp_config: temp_config
+      )
+    end
+  end
+
+  private
+
+  # Build a comprehensive result summary
+  # @param fk [FindKeys] FindKeys instance with analysis results
+  # @param steps [Array<Hash>] Execution steps with their status
+  # @param original_study_name [String] Original study name without 'hlsv_results/' prefix
+  # @return [Hash] Complete result summary
+  def self.build_result_summary(fk:, steps:, original_study_name:)
+    {
+      message: "Analysis completed successfully",
+      etapes: steps,
+
+      # Report information
+      rapport_path: "/telecharger/#{original_study_name}/#{File.basename(fk.report.report_name)}",
+      rapport_name: File.basename(fk.report.report_name),
+
+      # Output directory (without 'hlsv_results/' prefix for display)
+      output_directory: fk.dir_out.split('/')[1..].join('/'),
+
+      # Dataset statistics
+      nombre_datasets_analyses: fk.ds_list.size,
+
+      # Invalid datasets breakdown
+      nombre_datasets_invalid: {
+        invalid_dataset: fk.dslist_invalid.size,
+        invalid_ascii: fk.ds_with_issue[:ascii].empty? ? nil : fk.ds_with_issue[:ascii].join(', '),
+        invalid_define: fk.ds_with_issue[:define].empty? ? nil : fk.ds_with_issue[:define].join(', '),
+        invalid_data: fk.ds_with_issue[:data].empty? ? nil : fk.ds_with_issue[:data].join(', ')
+      }
+    }
+  end
+
+  # Handle execution errors gracefully
+  # @param error [Exception] The raised exception
+  # @param steps [Array<Hash>] Execution steps
+  # @param temp_config [String] Path to temporary config file
+  def self.handle_execution_error(error:, steps:, temp_config:)
+    # Mark the current step as failed
+    current_step = steps.find { |st| st[:statut] == "en_cours" }
+    if current_step
+      current_step[:statut] = "erreur"
+      current_step[:message] = error.message
+    end
+
+    # Clean up temporary config file
+    File.delete(temp_config) if File.exist?(temp_config)
+
+    # Build detailed error message
+    error_details = steps.map { |st|
+      "#{st[:nom]}: #{st[:statut]}"
+    }.join("\n")
+
+    # Re-raise with enhanced context
+    raise "#{error.message}\n\nExecution steps:\n#{error_details}"
+  end
+end
+end

data/lib/hlsv/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Hlsv
+  VERSION = "1.0.0"
+end