PowerShell AST-Änderung und Extents

Question

Ich versuche derzeit, die AST-Funktionalität zu verwenden, die in PowerShell 3.0 eingeführt wird, um einen ScriptBlock zu ändern. Meine Voraussetzung ist, dass alle Parameter im Parameterblock des ScriptBlocks ein [Parameter(Mandatory)] Attribut erhalten.

Grundsätzlich sollte der Code dies ändern:

Param([string]$x) 

Write-Host $x 

dazu:

Param([Parameter(Mandatory)][string]$x) 

Write-Host $x 

Allerdings habe ich ein Problem lief, wenn das neue Attribut hinzufügen, da es eine IScriptExtent erwartet und ich bin nicht sicher wie ich ein neues IScriptExtent erstellen soll.

Wie kann ich einen neuen Skriptumfang erstellen? Welche Werte kann ich für die Position verwenden? Muss ich die Position aller folgenden Extents ändern?

Ich versuchte, nur das Ausmaß jedes Parameters, den ich verändere, wiederzuverwenden, aber leider scheint dies nicht zu den Ergebnissen zu führen, die es sollte (z.B. wenn ich ToString auf dem modifizierten ScriptBlock aufrufen sehe ich keine Änderungen).

Meine bisherige Implementierung basiert auf der ICustomAstVisitor gefunden here.

Die wichtigste Methode sieht wie folgt aus:

public object VisitParameter(ParameterAst parameterAst) 
{ 
    var newName = VisitElement(parameterAst.Name); 

    var extent = // What to do here? 

    var mandatoryArg = new AttributeAst(extent, new ReflectionTypeName(typeof (ParameterAttribute)), 
     new ExpressionAst[0], 
     new[] {new NamedAttributeArgumentAst(extent, "Mandatory", new ConstantExpressionAst(extent, true), true)}); 

    var newAttributes = new[] {mandatoryArg}.Concat(VisitElements(parameterAst.Attributes)); 
    var newDefaultValue = VisitElement(parameterAst.DefaultValue); 
     return new ParameterAst(parameterAst.Extent, newName, newAttributes, newDefaultValue); 
} 

Answer 1

Namen, die mit I beginnen typischerweise Schnittstellen. Es handelt sich nicht um Klassen, mit denen Sie eine Instanz erstellen, sondern um solche, die angeben, dass eine bestimmte Klasse eine bestimmte bekannte Funktionalität implementiert.

Zum Beispiel implementiert ein [hashtable]IEnumerable. Das bedeutet, dass alles, was mit einer IEnumerable Schnittstelle zu arbeiten weiß und auf dieser Klasse arbeiten kann; Sie könnten Ihre eigene Klasse erstellen, die die Schnittstelle implementiert, und Code, der niemals über Ihre Klasse hätte wissen können, oder was er tut, kann weiterhin mit ihm interagieren, wie IEnumerable definiert (was in diesem Fall eine Möglichkeit ist, darüber zu iterieren).

Wenn also eine Funktion einen Parameter mit einem Schnittstellentyp deklariert, sucht sie nicht nach einer bestimmten Klasse, sondern nach einer Klasse, die diese Schnittstelle implementiert.

Der nächste Schritt ist dann zu finden, welche Typen diese Schnittstelle implementieren. Hier einige Powershell-Code, den ich verwendet, um diejenigen zu finden:

IsPublic IsSerial Name          BaseType              
-------- -------- ----          --------              
True  False IScriptExtent                       
False False InternalScriptExtent      System.Object            
False False EmptyScriptExtent      System.Object            
True  False ScriptExtent        System.Object            

---

Der erste Eintrag ist die Schnittstelle selbst:

[System.AppDomain]::CurrentDomain.GetAssemblies().GetTypes() | Where-Object { 
    [System.Management.Automation.Language.IScriptExtent].IsAssignableFrom($_) 
} 

Von diesem können wir folgendes sehen. Von den anderen drei sind zwei von ihnen nicht öffentlich, so dass nur ScriptExtent verlässt.

Sie können eine davon mit New-Object erstellen, aber Sie müssen die Start- und Endpositionen als [ScriptPosition] Objekte liefern. Ich bin nicht ganz sicher, was diese sein sollten, ohne mehr von deinem Code zu sehen.

Answer 2

Das Skript Ausmaß in erster Linie für die Fehlerberichterstattung verwendet wird, sondern auch für die Fehlersuche verwendet wird (z. B. einen Zeilenhaltepunkt setzen)

Im Allgemeinen sind die Optionen für synthetisierte Skript (wie Ihr Beispiel):

• Wiederverwendung eines bestehender ast, vermutlich in der Nähe von/im Zusammenhang mit dem ast Sie hinzufügen
• einen leeren ast verwenden (im Grunde erstellen Instanzen von ScriptExtent und ScriptPosition ohne Datei, leere Zeile)
• ein synthetischen schaffen Extent, das hilft, irgendwie zu debuggen, vielleicht mit etwas besonderem Inhalt

In Ihrem Beispiel sind alle der oben genannten geeignet. Die zweite Option ist die einfachste. Die dritte Option ist nur eine Variante der zweiten, aber Sie würden den Inhalt auf etwas Nützliches einstellen, z.

<#Generated: [Parameter(Mandatory)] #>