Patcher.Rules.RuleEngine.Run C# (CSharp) Method

Run() public method

public Run ( ) : void
return void
        public void Run()
        {
            int totalRulesToRun = rules.SelectMany(p => p.Value).Count();
            if (totalRulesToRun == 0)
            {
                Log.Warning("No rules loaded, nothing to do.");
                return;
            }

            using (var progress = Display.StartProgress("Executing rules"))
            {
                int run = 0;
                foreach (var pluginFileName in rules.Keys)
                {
                    foreach (var rule in rules[pluginFileName])
                    {
                        Log.Info("Executing rule {0}", rule);
                        progress.Update(run++, totalRulesToRun, "{0}", rule);

                        // Run rule
                        var runner = new RuleRunner(this, rule);
                        try
                        {
                            runner.Run();
                        }
            #if !DEBUG
                        catch (Exception ex)
                        {
                            if (ex is CompiledRuleAssertException)
                            {
                                Log.Error("Assertion failed while executing rule {0} with message: {1}", rule, ex.Message);
                            }
                            else
                            {
                                Log.Error("Error occured while executing rule {0} with message: {1}", rule, ex.Message);
                            }
                            Log.Fine(ex.ToString());

                            // Determine were the exception occured
                            var stackTrace = new StackTrace(ex, true);
                            var frame = stackTrace.GetFrames().Where(f => f.GetMethod().DeclaringType.Namespace == "Patcher.Rules.Compiled.Generated").FirstOrDefault();
                            if (frame != null)
                            {
                                Display.ShowProblems("Runtime Error", ex.ToString(), new Problem()
                                {
                                    Message = string.Format("{0}: {1}", ex.GetType().FullName, ex.Message),
                                    File = DataFile.GetRelativePath(frame.GetFileName()),
                                    Line = frame.GetFileLineNumber(),
                                    Solution = RuleRunner.GetRuntimeErrorHint(ex)
                                });
                            }

                            var choice = Display.Choice("Continue executing rules?", ChoiceOption.Ok, ChoiceOption.Cancel);
                            if (choice == ChoiceOption.Cancel)
                            {
                                Log.Warning("Rule execution has been aborted.");
                                throw new UserAbortException("Rule execution has been aborted by the user.");
                            }
                            else
                            {
                                Log.Warning("The last rule has not been fully applied.");
                                continue;
                            }
                        }
            #endif
                        finally
                        {
                            Display.ClearProblems();
                        }

                        Log.Info("Rule completed with {0} updates and {1} inserts", runner.Updated, runner.Created);
                    }

                    // After all rules of a plugin were run
                    // Clear tags
                    Tags.Clear();
                }
            }
        }

Usage Example

示例#1
0
        private void Main(ProgramOptions options)
        {
            // Validate rules folder
            if (string.IsNullOrWhiteSpace(options.RulesFolder) || options.RulesFolder.IndexOfAny(new char[] { '"', '\'', '\\', '/', ':' }) >= 0)
            {
                Display.WriteText("Specified rule folder name does not seems to be valid: \n\n" + options.RulesFolder +
                    "\n\nEnsure the value is a single folder name (not a full path) without special characters: \", ', \\, / and :.");
                return;
            }

            // Initialize data file provider
            IDataFileProvider fileProvider;
            try
            {
                // Use data folder path from options which will default the parent direcotry unless another path is specified
                // Pass custom plugins.txt file path if provided via options
                fileProvider = new DefaultDataFileProvider(options.DataFolder, options.PluginListFile);
            }
            catch (Exception ex)
            {
                // Program will exit on error
                // Appropriate hint is displayed
                Display.WriteText("Data folder path does not seems to be valid: " + ex.Message + "\n\n" + options.DataFolder +
                    "\n\nUse option -d or --data to specify correct path to the data folder or use option -h or --help for more help.");
                return;
            }

            // Mod Ogranizer
            if (!string.IsNullOrEmpty(options.ModOrganizerProfile))
            {
                try
                {
                    // After verifying data folder with DefaultDataFolderProvider
                    // replace it with MO data file provider
                    fileProvider = new ModOrganizerDataFileProvider(options.DataFolder, options.ModOrganizerProfile, options.ModOrganizerModsPath);
                }
                catch (Exception ex)
                {
                    // Program will exit on error
                    // Appropriate hint is displayed
                    Display.WriteText("Incorrect Mod Organizer configuration: " + ex.Message +
                        "\n\nUse option -h or --help for more help.");
                    return;
                }
            }

            // Determine output plugin file name, use filename from options if provided
            string targetPluginFileName = options.OutputFilename ?? string.Format("Patcher-{0}.esp", options.RulesFolder);

            // File log will be created in the data folder, named as the output plugin plus .log extension
            string logFileName = Path.Combine(Program.ProgramFolder, Program.ProgramLogsFolder, targetPluginFileName + ".log");
            using (var logger = new StreamLogger(fileProvider.GetDataFile(FileMode.Create, logFileName).Open()))
            {
                Log.AddLogger(logger);

                // Put some handy info at the beginning of the log file
                Log.Info(Program.GetProgramVersionInfo());
                Log.Fine("Options: " + options);

                try
                {
                    // Create suitable data context according to the data folder content
                    using (DataContext context = DataContext.CreateContext(fileProvider))
                    {
                        Log.Fine("Initialized data context: " + context.GetType().FullName);

                        // Context tweaks
                        context.AsyncFormIndexing = true;
                        context.AsyncFormLoading = options.MaxLoadingThreads > 0;
                        context.AsyncFormLoadingWorkerThreshold = 100;
                        context.AsyncFromLoadingMaxWorkers = Math.Max(1, options.MaxLoadingThreads);

                        if (!options.Append)
                        {
                            // Inform context to ignore output plugin in case it is active
                            context.IgnorePlugins.Add(targetPluginFileName);
                        }

                        // Index all forms except hidden (such as cells and worlds)
                        context.Load();

                        if (options.Append && context.Plugins.Exists(targetPluginFileName) && context.Plugins.Count > 0)
                        {
                            // Make sure output plugin is loaded last when appending
                            var plugin = context.Plugins[(byte)(context.Plugins.Count - 1)];
                            if (!plugin.FileName.Equals(targetPluginFileName))
                                throw new ApplicationException("Output plugin must be loaded last when appending changes.");
                        }

                        using (RuleEngine engine = new RuleEngine(context))
                        {
                            engine.RulesFolder = options.RulesFolder;

                            // Apply debug scope to rule engine
                            if (!string.IsNullOrEmpty(options.DebugScope))
                            {
                                if (options.DebugScope == "*")
                                {
                                    engine.DebugAll = true;
                                }
                                else
                                {
                                    var parts = options.DebugScope.Split('/', '\\');
                                    if (parts.Length > 0)
                                        engine.DebugPluginFileName = parts[0];
                                    if (parts.Length > 1)
                                        engine.DebugRuleFileName = parts[1];
                                }
                            }

                            foreach (var param in options.Parameters)
                            {
                                var split = param.Split('=');
                                if (split.Length != 2 || !split[0].Contains(':'))
                                {
                                    Log.Warning("Ignored malformatted parameter: '{0}' Expected format is 'plugin:param=value'", param);
                                }
                                engine.Params.Add(split[0], split[1]);
                            }

                            // Load rules
                            engine.Load();

            #if DEBUG
                            // Load supported forms in debug mode
                            context.LoadForms(f => context.IsSupportedFormKind(f.FormKind));
            #else
                            // Load all indexed forms in release mode
                            context.LoadForms();
            #endif

                            if (options.Append && context.Plugins.Exists(targetPluginFileName))
                            {
                                // Use existing plugin as the target plugin
                                engine.ActivePlugin = context.Plugins[targetPluginFileName];
                            }
                            else
                            {
                                // Create and set up target plugin
                                engine.ActivePlugin = context.CreatePlugin(targetPluginFileName);
                                engine.ActivePlugin.Author = options.Author ?? Program.GetProgramVersionInfo();
                                engine.ActivePlugin.Description = options.Description ?? string.Format("Generated by {0}", Program.GetProgramVersionInfo());
                            }

                            // See if target plugin exists
                            var targetPluginFile = fileProvider.GetDataFile(FileMode.Open, targetPluginFileName);
                            if (targetPluginFile.Exists())
                            {
                                Log.Info("Target plugin {0} already exists and will be overwriten, however previously used FormIDs will be preserved if possible.", targetPluginFileName);

                                try
                                {
                                    var inspector = new PluginInspector(context, targetPluginFile);
                                    foreach (var record in inspector.NewRecords)
                                    {
                                        engine.ActivePlugin.ReserveFormId(record.FormId, record.EditorId);
                                    }
                                }
                                catch (Exception ex)
                                {
                                    Log.Warning("Previously used Form IDs cannot be preserved because target plugin {0} could not be read: {1}", targetPluginFileName, ex.ToString());
                                }
                            }

                            engine.Run();

                            if (!options.KeepDirtyEdits)
                                engine.ActivePlugin.PurgeDirtyEdits();

                            // Prepare list of master to be removed by force
                            IEnumerable<string> removeMasters = options.RemovedMasters != null ? options.RemovedMasters.Split(',') : null;

                            // Save target plugin
                            engine.ActivePlugin.Save(removeMasters);
                        }
                    }
                }
                catch (UserAbortException ex)
                {
                    Log.Error("Program aborted: " + ex.Message);
                }
            #if !DEBUG
                catch (Exception ex)
                {
                    Log.Error("Program error: " + ex.Message);
                    Log.Error(ex.ToString());
                }
            #endif
            }

            return;
        }