incorporate feedback from PowerShell/PowerShellEditorServices#1078 (comment)

Author: JamesWTruher

Engine/HostedAnalyzer.cs

@@ -353,6 +353,19 @@ public string Fix(string scriptDefinition, Settings settings)
         /// <param name="settings">The settings to use when fixing.</param>
         public Task<string> FixAsync(string scriptDefinition, Settings settings) => Task.Run(() => Fix(scriptDefinition, settings));
 
+        /// <summary>
+        /// Create a standard settings object for Script Analyzer
+        /// This is the object used by analyzer internally
+        /// It is more functional than the AnalyzerSettings object because
+        /// it contains the Rule Arguments which are not passable to the Initialize method
+        /// </summary>
+        public Settings CreateSettings(string[] ruleNames)
+        {
+            var s = CreateSettings();
+            s.IncludeRules.AddRange(ruleNames);
+            return s;
+        }
+
         /// <summary>
         /// Create a standard settings object for Script Analyzer
         /// This is the object used by analyzer internally
@@ -437,6 +450,52 @@ public string Format(string scriptDefinition)
         public Task<string> FormatAsync(string scriptDefinition) =>
             Task.Run(() => Format(scriptDefinition));
 
+        /// <summary>
+        /// Format a script according to the formatting rules
+        ///     PSPlaceCloseBrace
+        ///     PSPlaceOpenBrace
+        ///     PSUseConsistentWhitespace
+        ///     PSUseConsistentIndentation
+        ///     PSAlignAssignmentStatement
+        ///     PSUseCorrectCasing
+        /// </summary>
+        /// <param name="scriptDefinition">The script to format.</param>
+        /// <param name="range">The range of the script to format</param>
+        /// <returns>The formatted script.</returns>
+        public string Format(string scriptDefinition, Range range)
+        {
+            Settings settings = CreateSettings("CodeFormatting");
+            string formattedScript;
+            lock(hostedAnalyzerLock)
+            {
+                try {
+                    formattedScript = Formatter.Format(scriptDefinition, settings, range, ps.Runspace, writer);
+                }
+                finally {
+                    analyzer.CleanUp();
+                    // Reset is required because formatting leaves a number of settings behind which
+                    // should be cleared.
+                    Reset();
+                }
+            }
+            return formattedScript;
+        }
+
+        /// <summary>
+        /// Format a script according to the formatting rules
+        ///     PSPlaceCloseBrace
+        ///     PSPlaceOpenBrace
+        ///     PSUseConsistentWhitespace
+        ///     PSUseConsistentIndentation
+        ///     PSAlignAssignmentStatement
+        ///     PSUseCorrectCasing
+        /// </summary>
+        /// <param name="scriptDefinition">The script to format.</param>
+        /// <param name="range">The range of the script to format</param>
+        /// <returns>The formatted script.</returns>
+        public Task<string> FormatAsync(string scriptDefinition, Range range) =>
+            Task.Run(() => Format(scriptDefinition, range));
+
         /// <summary>
         /// Format a script based on settings
         /// </summary>
@@ -497,6 +556,8 @@ internal class hostedWriter : IOutputWriter
             public IList<string> Debug;
             /// <summary>The warning messages emitted during the invocation of the analyzer.</summary>
             public IList<string> Warning;
+            /// <summary>Add a nonterminating error the ccollection.</summary>
+            public void WriteError(SMA.ErrorRecord errorRecord) { TerminatingErrors.Add(errorRecord); }
             /// <summary>Add a terminating error the ccollection.</summary>
             public void ThrowTerminatingError(SMA.ErrorRecord errorRecord) { TerminatingErrors.Add(errorRecord); }
             /// <summary>Add a verbose message to the verbose collection.</summary>

Engine/Settings.cs

@@ -42,10 +42,10 @@ public bool IncludeDefaultRules
             set { includeDefaultRules = value; }
         }
         public string FilePath => filePath;
-        public IEnumerable<string> IncludeRules => includeRules;
-        public IEnumerable<string> ExcludeRules => excludeRules;
-        public IEnumerable<string> Severities => severities;
-        public IEnumerable<string> CustomRulePath => customRulePath;
+        public List<string> IncludeRules => includeRules;
+        public List<string> ExcludeRules => excludeRules;
+        public List<string> Severities => severities;
+        public List<string> CustomRulePath => customRulePath;
         public Dictionary<string, Dictionary<string, object>> RuleArguments => ruleArguments;
 
         /// <summary>