// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the MIT License.
using System;
using System.Collections.Generic;
using System.Management.Automation.Language;
using Microsoft.Windows.PowerShell.ScriptAnalyzer.Generic;
using System.IO;
#if !CORECLR
using System.ComponentModel.Composition;
#endif
using System.Globalization;
namespace Microsoft.Windows.PowerShell.ScriptAnalyzer.BuiltinRules
{
///
/// AvoidAlias: Check if help file uses utf8 encoding
///
#if !CORECLR
[Export(typeof(IScriptRule))]
#endif
public class UseUTF8EncodingForHelpFile : IScriptRule
{
///
/// AnalyzeScript: check if the help file uses something other than utf8
///
public IEnumerable AnalyzeScript(Ast ast, string fileName)
{
// we are given a script definition, do not analyze
// this rule is not applicable for that
if (String.IsNullOrWhiteSpace(fileName))
{
yield break;
}
if (!String.IsNullOrWhiteSpace(fileName) && Helper.Instance.IsHelpFile(fileName))
{
using (var fileStream = File.Open(fileName, FileMode.Open))
using (var reader = new System.IO.StreamReader(fileStream, true))
{
reader.ReadToEnd();
if (reader.CurrentEncoding != System.Text.Encoding.UTF8)
{
yield return new DiagnosticRecord(string.Format(CultureInfo.CurrentCulture, Strings.UseUTF8EncodingForHelpFileError, System.IO.Path.GetFileName(fileName), reader.CurrentEncoding),
null, GetName(), DiagnosticSeverity.Warning, fileName);
}
}
}
}
///
/// GetName: Retrieves the name of this rule.
///
/// The name of this rule
public string GetName()
{
return string.Format(CultureInfo.CurrentCulture, Strings.NameSpaceFormat, GetSourceName(), Strings.UseUTF8EncodingForHelpFileName);
}
///
/// GetCommonName: Retrieves the common name of this rule.
///
/// The common name of this rule
public string GetCommonName()
{
return string.Format(CultureInfo.CurrentCulture, Strings.UseUTF8EncodingForHelpFileCommonName);
}
///
/// GetDescription: Retrieves the description of this rule.
///
/// The description of this rule
public string GetDescription()
{
return string.Format(CultureInfo.CurrentCulture, Strings.UseUTF8EncodingForHelpFileDescription);
}
///
/// GetSourceType: Retrieves the type of the rule, Builtin, Managed or Module.
///
public SourceType GetSourceType()
{
return SourceType.Builtin;
}
///
/// GetSeverity: Retrieves the severity of the rule: error, warning of information.
///
///
public RuleSeverity GetSeverity()
{
return RuleSeverity.Warning;
}
///
/// GetSourceName: Retrieves the name of the module/assembly the rule is from.
///
public string GetSourceName()
{
return string.Format(CultureInfo.CurrentCulture, Strings.SourceName);
}
}
}