Transform.psm1

# PowerShell ConvertForm 
# Transform module
# Objet   : Regroupe des fonctions de transformation de 
#           lignes de code CSharp en code PowerShell.

Import-LocalizedData -BindingVariable TransformMsgs -Filename TransformLocalizedData.psd1 -EA Stop

function Convert-DictionnaryEntry($Parameters) 
{   #Converti un DictionnaryEntry en une string "clé=valeur clé=valeur..." 
  "$($Parameters.GetEnumerator()|% {"$($_.key)=$($_.value)"})"
}#Convert-DictionnaryEntry

function Backup-Collection($Collection,$Message)
{ #Sauvegarde dans un fichier temporaire unique le contenu de la collection de lignes en cours d'analyse
  if ( $DebugPreference -ne 'SilentlyContinue') 
  { 
     $TempFile = [IO.Path]::GetTempFileName()
     $Collection|Set-Content $TempFile
     Write-Debug $Message
     Write-Debug "Sauvegarde dans le fichier temporaire : $TempFile"
  }
}

#todo-Vnext ( C#6) : var name = "Dave";WriteLine($"My name is {name}");

Function Add-LoadAssembly{
 param (
  [System.Collections.ArrayList] $Liste,
  [String[]] $Assemblies
 )
 #Charge une liste d'assemblies .NET 
 #On les suppose présent dans le GAC
 #todo-Vnext : ceux n'étant pas dans le GAC :   Add-Type -Path 'FullPath\filename.dll' #<%REMOVE%>
 foreach ($Assembly in $Assemblies)
 { [void]$Liste.Add("Add-Type -AssemblyName $Assembly") }
 [void]$Liste.Add('')
}

Function Add-EventComponent([String] $ComponentName, [String] $EventName)
{ #Crée et ajoute un événement d'un composant.
  #Par défaut le scriptbloc généré affiche un message d'information
  
  $Message=$ExecutionContext.InvokeCommand.ExpandString($TransformMsgs.AddEventComponent)
  $UnderConstruction = "[void][System.Windows.Forms.MessageBox]::Show(`"$Message`")"
   #La syntaxe d'ajout d'un délégué est : Add_NomEvénément 
   # où le nom de l'événement est celui du SDK .NET
   #On construit le nom de la fonction appellée par le gestionnaire d'événement
  $OnEvent_Name="On{0}_{1}" -f ($EventName,$ComponentName)
  $Fonction ="`r`nfunction $OnEvent_Name {{`r`n`t{0}`r`n}}`r`n" -f ($UnderConstruction)
   #On double le caractère '{' afin de pouvoir l'afficher
  $EvtHdl= "`${0}.Add_{1}( {{ {2} }} )`r`n" -f ($ComponentName, $EventName, $OnEvent_Name)
# Here-string    
@"
$Fonction
$EvtHdl
"@
}

function Add-SpecialEventForm{
 param(
  [String] $FormName,
  [switch] $HideConsole
 )
  # Ajoute des méthodes d'évènement spécifiques à la forme principale
  #FormClosing
    # Permet à l'utilisateur de : 
    #   -déterminer la cause de la fermeture
    #   -autoriser ou non la fermeture

 $Entête = "`r`nfunction OnFormClosing_{0}{{" -F $FormName
 $Close  = "`r`n`${0}.Add_FormClosing( {{ OnFormClosing_{0}}} )" -F $FormName

 $CallHidefnct=""
   #On affiche la fenêtre, mais on cache la console 
 If ($HideConsole)
  {$CallHidefnct="Hide-Window `$MainWindowHandle;"}
   #Replace au premier plan la fenêtre en l'activant.
   # Form1.topmost=$true est inopérant
 $Shown  = "`r`n`${0}.Add_Shown({{{1}`${0}.Activate()}})" -F $FormName,$CallHidefnct

# Here-string  
@"
$Entête 
`t# `$this parameter is equal to the sender (object)
`t# `$_ is equal to the parameter e (eventarg)

`t# The CloseReason property indicates a reason for the closure :
`t#   if ((`$_).CloseReason -eq [System.Windows.Forms.CloseReason]::UserClosing)

`t#Sets the value indicating that the event should be canceled.
`t(`$_).Cancel= `$False
}
$Close
$Shown
"@
}

function Add-GetScriptDirectory{
Write-Debug "Add-GetScriptDirectory" 
@"

function Get-ScriptDirectory
{ #Return the directory name of this script
  `$Invocation = (Get-Variable MyInvocation -Scope 1).Value
  Split-Path `$Invocation.MyCommand.Path
}

`$ScriptPath = Get-ScriptDirectory

"@         
}#Add-GetScriptDirectory

function Add-ManageResources{
 #Ajoute le code gérant un fichier de ressources et ce à l'aide d'une "here-string"
  # 1 fonction
  # 2 test d'existence du fichier
  # 3 récupération dans une hastable des ressources de la Winform

 param (
  [string] $SourceName
 )
Write-Debug "Add-ManageResources $SourceName.resources" 

@"

`$ResourcesPath= Join-Path `$ScriptPath "$SourceName.resources"
if ( !(Test-Path `$ResourcesPath))
{
  Write-Error `"$($TransformMsgs.ManageResourcesError)`"
  break; 
}
  $($TransformMsgs.ManageResourcesComment)
`$Reader = new-Object System.Resources.ResourceReader(`$ResourcesPath)
`$Resources=@{}
`$Reader.GetEnumerator()|% {`$Resources.(`$_.Name)=`$_.value}
 
 $($TransformMsgs.CreateComponentComment)
"@         
}#Add-ManageResources

function Add-ManagePropertiesResources {
 param (
  [string] $SourceName
 )
Write-Debug "Add-ManagePropertiesResources $SourceName.resources"
 
@"

`$ResourcesPath= Join-Path `$ScriptPath "$SourceName.resources"
if ( !(Test-Path `$ResourcesPath))
{
  Write-Error `"$($TransformMsgs.ManageResourcesError)`"
  break; 
}
  #Gestion du fichier des ressources des propiétés du projet
`$PropertiesReader = new-Object System.Resources.ResourceReader(`$ResourcesPath)
`$PropertiesResources=@{}
`$PropertiesReader.GetEnumerator()|% {`$PropertiesResources.(`$_.Name)=`$_.value}

"@                  
}#Add-ManagePropertiesResources

function Convert-Enum([String] $Enumeration)
{ #Converti une valeur d'énumération
  # un.deux.trois en [un.deux]::trois
 $Enumeration = $Enumeration.trim()
  # recherche (et capture) en fin de chaîne un mot précédé d'un point lui-même précédé de n'importe quel caractères
 $Enumeration -replace '(.*)\.(\w+)$', '[$1]::$2'
}

function Select-ParameterEnumeration([String]$NomEnumeration, [String] $Parametres)
{ #Voir le fichier  "..\Documentations\Analyse des propriétés.txt"
 #Gére les propriétés Font et Anchor

  $Valeurs= $Parametres.Split('|')
  $NbValeur = $Valeurs.Count
   
   #Une seule valeur, on la convertie
  if ($NbValeur -eq 1 )
  { return Convert-Enum $Parametres} 

   #Valeur 1 :
   #         ((Nom.Enumeration)((Nom.Enumeration.VALEUR
    # recherche (et capture) en fin de chaîne un mot précédé d'un point lui-même précédé de n'importe quel caractères
  $Valeurs[0]= ($Valeurs[0] -replace '^.*\.(.*)$', '$1').Trim()
 
   #Valeur 2..n :
   #     Nom.Enumeration.VALEUR)    
   # recherche (et capture) en fin de chaîne une parenthèse précédée de caractères uniquement précédés d'un point lui-même précédé de n'importe quel caractères
  for ($i=1;$i -le $NbValeur-2;$i++)
  { $Valeurs[$i]= ($Valeurs[$i] -replace '^.*\.([a-zA-Z]*)\)$', '$1').Trim() }

   #Dernière valeur  :
   #         Nom.Enumeration.VALEUR))  
   # ou      Nom.Enumeration.VALEUR)))  
   # recherche (et capture) en fin de chaîne deux parenthèses précédées de caractères ou de chiffre uniquement précédés d'un point lui-même précédé de n'importe quel caractères
  $Valeurs[$NbValeur-1]= ($Valeurs[$NbValeur-1] -replace '^.*\.([a-zA-Z0-9]+)\)+$', '$1').Trim()
  return "[$NomEnumeration]`"{0}`"" -F ([string]::join(',', $Valeurs))
}

function Select-PropertyFONT([System.Text.RegularExpressions.Match] $MatchStr)
{ #Analyse une déclaration d'une propriété Font
   #Pour la chaîne:  $label1.Font = New-Object System.Drawing.Font("Arial Black", 9.75F, System.Drawing.FontStyle.Bold, System.Drawing.GraphicsUnit.Point, ((byte)(0)))
	# $MatchStr contient 4 groupes :
	#  0- la ligne compléte
	#  1- $label1
	#  2- .Font = New-Object System.Drawing.Font(
	#  3- "Arial Black", 9.75F, System.Drawing.FontStyle.Bold, System.Drawing.GraphicsUnit.Point, ((byte)(0))

    #Récupère les paramètres du constructeur
  $Parametres= [Regex]::Split($MatchStr.Groups[3].value,',')
    #Le premier est tjr le nom de la fonte de caractère
    #Le second est tjr la taille de la fonte de caractère dans ce cas on supprime le caractère 'F' 
    #indiquant un type double
  $Parametres[1]=$Parametres[1] -replace 'F',''
  
   #Teste les différentes signatures de constructeurs
   #On parcourt toute la liste du nombre de paramètre possibles, les uns à la suite des autres.
  Switch ($Parametres.count)
  { 
    {$_ -eq 3} {  #Est-ce un paramètre de type System.Drawing.GraphicsUnit ?
                 if ( $Parametres[2].Contains('System.Drawing.GraphicsUnit') )
         		 {$Parametres[2]=Convert-Enum $Parametres[2]}
         		   #si non c'est donc un paramètre de type System.Drawing.FontStyle ?
       			 else { $Parametres[2]=Select-ParameterEnumeration 'System.Drawing.FontStyle' $Parametres[2] }
     		   }

    {$_ -ge 4} {  #Le troisième est tjr de type FontStyle
   	   			  #Le quatrième est tjr de type GraphicsUnit
                 $Parametres[2]= Select-ParameterEnumeration 'System.Drawing.FontStyle' $Parametres[2]
                 $Parametres[3]=Convert-Enum $Parametres[3]
               }
                 
    {$_ -ge 5} {  #On récupére uniquement la valeur du paramètre : ((byte)(123))
                  # Un ou plusieurs chiffres :                        [0-9]+
                 $Parametres[4]=$Parametres[4] -replace '\(\(byte\)\(([0-9]+)\)\)', '$1' 
               }

    #6 Le sixième (true - false) est traité par la suite dans le script principal

                  #Pb :/
    {$_ -ge 7} { throw (new-object ConvertForm.CSParseException( ('Unexpected case : {0}' -f ($MatchStr.Groups[3].value)))) }
  }
  
  return $Parametres
}
function Select-PropertyANCHOR([System.Text.RegularExpressions.Match] $MatchStr)
{ #Analyse une déclaration d'une propriété Anchor
   #Pour la chaîne: $comboBox1.Anchor = ((System.Windows.Forms.AnchorStyles)((((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom)| System.Windows.Forms.AnchorStyles.Left)| System.Windows.Forms.AnchorStyles.Right)));

	# $MatchStr contient 4 groupes :
	#  0- la ligne compléte
	#  1- $comboBox1
	#  2- .Anchor = ((System.Windows.Forms.AnchorStyles)
	#  3- (((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Bottom)| System.Windows.Forms.AnchorStyles.Left)| System.Windows.Forms.AnchorStyles.Right));

 #Peut être codé dans l'appelant mais cela documente un peu plus
 return Select-ParameterEnumeration 'System.Windows.Forms.AnchorStyles' $MatchStr.Groups[3].value
}

function Select-PropertyShortcutKeys([System.Text.RegularExpressions.Match] $MatchStr)
{ #Analyse une déclaration d'une propriété ShortcutKeys
   #Pour la chaîne: this.toolStripMenuItem2.ShortcutKeys = ((System.Windows.Forms.Keys)((System.Windows.Forms.Keys.Alt | System.Windows.Forms.Keys.A)));

	# $MatchStr contient 4 groupes :
	#  0- la ligne compléte
	#  1- $comboBox1
	#  2- .ShortcutKeys = ((System.Windows.Forms.Keys)
	#  3- ((System.Windows.Forms.Keys.Alt | System.Windows.Forms.Keys.A)));

 #Peut être codé dans l'appelant mais cela documente un peu plus
 return Select-ParameterEnumeration 'System.Windows.Forms.Keys' $MatchStr.Groups[3].value
}

function Select-ParameterRGB([System.Text.RegularExpressions.Match] $MatchStr)
{ #Analyse les paramétres d'un appel de la méthode FromArgb
   #Pour la chaîne:  $CaseàCocher.FlatAppearance.MouseDownBackColor = System.Drawing.Color.FromArgb(((int)(((byte)(192)))), ((int)(((byte)(255)))), ((int)(((byte)(192)))))
	# $MatchStr contient 4 groupes :
	#  0- la ligne compléte
	#  1- $CaseàCocher.FlatAppearance.MouseDownBackColor
	#  2-  = System.Drawing.Color.FromArgb(
	#  3- ((int)(((byte)(192)))), ((int)(((byte)(255)))), ((int)(((byte)(192))))
	 
    #Récupère les 3 paramètres
  $Parametres= [Regex]::Split($MatchStr.Groups[3].value,',')
  for ($i=0; $i -lt $Parametres.count; $i++)
	  # On récupére uniquement la valeur du paramètre : ((int)(((byte)(192))))
	  #Recherche ( et capture) en début de chaine une suite de caractère suivis d'une parenthèse suivi de 
	  #un ou plusieurs chiffres suivis par une ou plusieurs parenthèses
  { $Parametres[$i]=$Parametres[$i]  -replace '^(.*)\(([0-9]+)\)+', '$2' }
   
  return $Parametres
}

function ConvertTo-StringBuilder([System.Text.RegularExpressions.Match] $MatchStr, [Array] $NumerosOrdonnes)
 {  #On reconstruit le début d'une chaîne à partir d'une expression parsée
   # $NumerosOrdonnes : Contient les numéros des groupes à insérer dans la nouvelle chaîne
   $Result=new-object System.Text.StringBuilder
   foreach ($Num in $NumerosOrdonnes)
   { [void]$Result.Append($MatchStr.Groups[$Num].value) }
   return $Result
 }
 
function ConvertTo-Line([System.Text.RegularExpressions.Match] $MatchStr, [Array] $NumerosOrdonnes,[string[]] $Parametres )
{ #Utilisé pour reconstruire une proprieté.

   #On reconstruit l'intégralité d'un chaîne parsée et transformée
  $Sb=ConvertTo-StringBuilder $MatchStr $NumerosOrdonnes
  [void]$Sb.Append( [string]::join(',', $Parametres)) 
  return $Sb.ToString()
}

function New-FilesName{
  #Construit les paths et noms de fichier à partir de $Source et $Destination
 [CmdletBinding()] 
 param(
   [string] $ScriptPath,
    
   [System.IO.FileInfo]$SourceFI,
   
    #PSPathInfo ou string
   $Destination
 )
  [Switch] $isVerbose= $null
  [void]$PSBoundParameters.TryGetValue('Verbose',[REF]$isVerbose)
  if ($isVerbose)
  { $VerbosePreference='Continue' } 
  
  #Le fichier de ressource posséde une autre construction que le nom du fichier source
  #On garde le nom de la Form car on peut avoir + fichiers .Designer.cs
   # en entrée                 : -Source C:\VS\Projet\PS\Form1.Designer.cs -Destination C:\Temp
   # fichier ressource associé : C:\VS\Projet\PS\Form1.resx   
   #
   # fichier script généré     : C:\Temp\Form1.ps1     
   # fichier de log généré     : C:\Temp\Form1.resources.Log
   # fichier ressource généré  : C:\Temp\Form1.resources
      
  $ProjectPaths=@{
     Source=$SourceFI.FullName
     SourcePath = $SourceFI.DirectoryName
     SourceName = ([System.IO.Path]::GetFilenameWithoutExtension($SourceFI.FullName)) -replace '.designer',''
  }
 
  if ($PSBoundParameters.ContainsKey('Destination'))
  { 
      #Récupère le nom de répertoire analysé
     $ProjectPaths.Destination=$Destination.GetFileName()
  }
  else
  { 
      #On utilise le répertoire du fichier source
     $ProjectPaths.Destination=$ProjectPaths.SourcePath
  }
  
   #Construit le nom à partir du nom de fichier source
  $ProjectPaths.Destination+="\$($ProjectPaths.SourceName).ps1"
  
  $DestinationFI=New-object System.IO.FileInfo $ProjectPaths.Destination  
    
  $ProjectPaths.DestinationPath = $DestinationFI.DirectoryName
  $ProjectPaths.DestinationName = ([System.IO.Path]::GetFilenameWithoutExtension($DestinationFi.FullName))

  Write-Debug 'BuildFiles ProjectPaths :' ; Convert-DictionnaryEntry $ProjectPaths|Foreach {Write-Debug $_}
  Write-Verbose ($TransformMsgs.SourcePath-F $ProjectPaths.Source)
  Write-Verbose ($TransformMsgs.DestinationPath -F $ProjectPaths.Destination)
  
  $ProjectPaths 
} #New-FilesName

function New-ResourcesFile{
#Compile le fichier contenant les ressources d'un formulaire, ex : Form1.resx
  [CmdletBinding()] 
 param (
   [string] $Source,
   [string] $Destination,
  [switch] $isLiteral
 ) 
  
  [Switch] $isVerbose= $null
  [void]$PSBoundParameters.TryGetValue('Verbose',[REF]$isVerbose)
  if ($isVerbose)
  { $VerbosePreference='Continue' }
    
  Write-Verbose $TransformMsgs.CompileResource
   #On génére le fichier de ressources
#<DEFINE %DEBUG%>   
   #todo + versions de resgen ?
   #   http://blogs.msdn.com/b/visualstudio/archive/2010/06/18/resgen-exe-error-an-attempt-was-made-to-load-a-program-with-an-incorrect-format.aspx
   #        connect.microsoft.com/VisualStudio/feedback/details/532584/error-when-compiling-resx-file-seems-related-to-beta2-bug-5252020
   #  http://stackoverflow.com/questions/9190885/could-not-load-file-or-assembly-system-drawing-or-one-of-its-dependencies-erro
   #   http://stackoverflow.com/questions/4899322/what-might-cause-a-resx-file-to-compile-correctly-under-windows-xp-but-fail-wi

   # Bug resx dans VS2010 
   #  error RG0000: Le type System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a 

#<UNDEF %DEBUG%>     
  $Resgen="$psScriptRoot\ResGen.exe" 
  if ( !(Test-Path -LiteralPath $Resgen))
  { Write-Error ($TransformMsgs.ResgenNotFound -F $Resgen) }
  else
  {
     $Log="$Destination.log"
     'Resgen','Source','Destination','Log'|
       Get-Variable |
       Foreach { Write-Debug ('{0}={1}' -F $_.Name,$_.Value) }
     
     if ($isLiteral)
     { $FileResourceExist=Test-Path -LiteralPath $Source }
     else
     { $FileResourceExist=Test-Path -Path $Source }
	 
     if ($FileResourceExist)
	 {
	    #Redirige le handle d'erreur vers le handle standard de sortie
	   $ResultExec=.$Resgen $Source $Destination 2>&1
	   if ($LastExitCode -ne 0)
	   { Write-Error ($TransformMsgs.CreateResourceFileError -F $LastExitCode,$log) }
	   else 
       { Write-Verbose ($TransformMsgs.CreateResourceFile -F $Destination) }
       
       try {
         if ($isLiteral)
         { $ResultExec|Out-File -Literal $Log -Width 999 }
         else
         { $ResultExec|Out-File -FilePath $Log -Width 999 }
       }catch {
          Write-Warning ($TransformMsgs.CreateLogFileError -F $Log)
       } 
	 }
     else
     { Write-Error ($TransformMsgs.ResourceFileNotFound -F $Source) }
  } 
} #New-ResourcesFile

function Add-ErrorProvider([String] $ComponentName, [String] $FormName)
{ #Ajoute le texte suivant après la ligne de création de la form,
  #le component ErrorProvider référence la Form contenant les composants qu'il doit gérer

# Here-string  
@"
`#
`# $ComponentName
`#
$('${0}.ContainerControl = ${1}' -F $ComponentName,$FormName)

"@
} #Add-ErrorProvider

function Add-TestApartmentState {
  #Le switch -STA est indiqué, on ajoute un test sur le modèle du thread courant.
@"

 # The -STA parameter is required
if ([System.Threading.Thread]::CurrentThread.GetApartmentState() -ne [System.Threading.ApartmentState]::STA )
{ Throw (new-object System.Threading.ThreadStateException("$($TransformMsgs.NeedSTAthreading)")) }

"@
} #Add-TestApartmentState

function Clear-KeyboardBuffer {
 while ($Host.UI.RawUI.KeyAvailable) 
 { $null=$Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown, IncludeKeyUp')}
}

function Read-Choice{
 #On ne localise pas, Anglais par défaut 
  param(
      $Caption, 
      $Message,
        [ValidateSet('Yes','No')]
      $DefaultChoice='No'
  )
  
  Clear-KeyboardBuffer
  $Yes = New-Object System.Management.Automation.Host.ChoiceDescription '&Yes'
  $No = New-Object System.Management.Automation.Host.ChoiceDescription '&No'
  $Choices = [System.Management.Automation.Host.ChoiceDescription[]]($Yes,$No)
  $Host.UI.PromptForChoice($Caption,$Message,$Choices,([byte]($DefaultChoice -eq 'No')))
}

#Functions Windows
function Add-Win32FunctionsType {
@"  
# Possible value for the nCmdShow parameter
# SW_HIDE = 0;
# SW_SHOWNORMAL = 1;
# SW_NORMAL = 1;
# SW_SHOWMINIMIZED = 2;
# SW_SHOWMAXIMIZED = 3;
# SW_MAXIMIZE = 3;
# SW_SHOWNOACTIVATE = 4;
# SW_SHOW = 5;
# SW_MINIMIZE = 6;
# SW_SHOWMINNOACTIVE = 7;
# SW_SHOWNA = 8;
# SW_RESTORE = 9;
# SW_SHOWDEFAULT = 10;
# SW_MAX = 10
                     
`$signature = @'
 [DllImport("user32.dll")]
 public static extern bool ShowWindowAsync(IntPtr hWnd, int nCmdShow);
'@
Add-Type -MemberDefinition `$signature -Name 'Win32ShowWindowAsync' -Namespace Win32Functions

"@
} #Add-Win32FunctionsType

function Add-Win32FunctionsWrapper {
@'
function Show-Window([IntPtr] $WindowHandle){ 
 #Displays in the foreground, the window with the handle $WindowHandle   
   $SW_SHOW = 5
   $null=[Win32Functions.Win32ShowWindowAsync]::ShowWindowAsync($WindowHandle,$SW_SHOW) 
}

function Hide-Window([IntPtr] $WindowHandle) {
 #Hide the window with the handle WindowHandle
 #The application is no longer available in the taskbar and in the task manager.
   $SW_HIDE = 0
   $null=[Win32Functions.Win32ShowWindowAsync]::ShowWindowAsync($WindowHandle,$SW_HIDE)
}

$MainWindowHandle=(Get-Process -Id $pid).MainWindowHandle
'@
} #Add-Win32FunctionsWrapper

New-Variable ChoiceNO -Value ([int]1) -EA SilentlyContinue
Export-ModuleMember -Variable ChoiceNO -Function *