Add Get-FunctionName and -Alias (#11)

## Description

This pull request includes changes to the `README.md` documentation, the
addition of 2 new functions, and the removal of some obsolete code.

### Documentation Updates

*
[`README.md`](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L3-R3):
Updated module description, installation instructions, and usage
examples. Removed outdated examples and documentation sections.
[[1]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L3-R3)
[[2]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L15-R29)
[[3]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L47-L51)
[[4]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5L67-R56)

### New Functions

*
[`src/functions/public/Get-FunctionAlias.ps1`](diffhunk://#diff-b3648733339fdf4ed730fba43cac9f8527f9927483116108a6e1d8056392a494R1-R51):
Added a new function `Get-FunctionAlias` to retrieve function aliases
from a PowerShell script file.
*
[`src/functions/public/Get-FunctionName.ps1`](diffhunk://#diff-6036d4a4965d6d1611bc4c77a3f97de19cbcc9dda18de43a9be06a22277a17dbR1-R37):
Added a new function `Get-FunctionName` to extract function names from a
specified PowerShell script.

### Code Removal

*
[`src/finally.ps1`](diffhunk://#diff-9b129ae41500f974ec52cf82cff6b579519ff2ce25e7f93dae0269434317ce76L1-L3):
Removed verbose logging statements.
*
[`src/header.ps1`](diffhunk://#diff-bf5fadbc74186e4ef45ea67f13aa39ff1aa054d079df0853f7c2c7180b486f71L1-L3):
Removed suppression message attribute and parameter block.
*
[`src/manifest.psd1`](diffhunk://#diff-89820c99acb3b881e314c7e358eea621a8687cb4e0c687f541b9dcc9f30cc5dcL1-L5):
Removed the module manifest file.

### Tests

*
[`tests/Module.Tests.ps1`](diffhunk://#diff-a94f0e90abaaff044e3cb0327ce3a63a10cd61551269a414e4dc40ad2af8a951L2-R13):
Updated tests to include new functions `Get-FunctionName` and
`Get-FunctionAlias`.
*
[`tests/src/Test-Function.ps1`](diffhunk://#diff-acc15d75d49a37326a9b7d551a44356f13821f4ab425a228f1b8255c95132859L1-R11):
Renamed from `src/functions/public/Test-PSModuleTemplate.ps1` and
updated to reflect new function name.

## Type of change

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [ ] 📖 [Docs]
- [ ] 🪲 [Fix]
- [x] 🩹 [Patch]
- [ ] ⚠️ [Security fix]
- [ ] 🚀 [Feature]
- [ ] 🌟 [Breaking change]

## Checklist

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas

Author: MariusStorhaug

README.md

@@ -1,6 +1,6 @@
 # AST
 
-A PowerShell module for using the Abstract Syntax Tree (AST) to analyze any PowerShell code.
+A PowerShell module for using the Abstract Syntax Tree (AST) on any PowerShell code.
 
 ## Prerequisites
 
@@ -12,29 +12,21 @@ This uses the following external resources:
 To install the module from the PowerShell Gallery, you can use the following command:
 
 ```powershell
-Install-PSResource -Name YourModuleName
-Import-Module -Name YourModuleName
+Install-PSResource -Name AST
+Import-Module -Name AST
 ```
 
 ## Usage
 
 Here is a list of example that are typical use cases for the module.
 
-### Example 1: Greet an entity
+### Example 1: Get the function name from a script
 
-Provide examples for typical commands that a user would like to do with the module.
+This example shows how to get the function name from a script.
 
 ```powershell
-Greet-Entity -Name 'World'
-Hello, World!
-```
-
-### Example 2
-
-Provide examples for typical commands that a user would like to do with the module.
-
-```powershell
-Import-Module -Name PSModuleTemplate
+Get-FunctionName -Path 'Test-Me.ps1'
+Test-Me
 ```
 
 ### Find more examples
@@ -44,11 +36,6 @@ To find more examples of how to use the module, please refer to the [examples](e
 Alternatively, you can use the Get-Command -Module 'This module' to find more commands that are available in the module.
 To find examples of each of the commands you can use Get-Help -Examples 'CommandName'.
 
-## Documentation
-
-Link to further documentation if available, or describe where in the repository users can find more detailed documentation about
-the module's functions and features.
-
 ## Contributing
 
 Coder or not, you can contribute to the project! We welcome all contributions.
@@ -64,6 +51,6 @@ Please see the issues tab on this project and submit a new issue that matches yo
 If you do code, we'd love to have your contributions. Please read the [Contribution guidelines](CONTRIBUTING.md) for more information.
 You can either help by picking up an existing issue or submit a new one if you have an idea for a new feature or improvement.
 
-## Acknowledgements
+## Tools
 
-Here is a list of people and projects that helped this project in some way.
+- [lzybkr/ShowPSAst](https://github.com/lzybkr/ShowPSAst)

src/finally.ps1

@@ -0,0 +1,51 @@
+function Get-FunctionAlias {
+    <#
+        .SYNOPSIS
+        Retrieves function aliases from a PowerShell script file.
+
+        .DESCRIPTION
+        Parses a specified PowerShell script file to identify function definitions and extract their associated aliases.
+        Returns a custom object containing function names and their corresponding aliases.
+
+        .EXAMPLE
+        Get-FunctionAlias -Path "C:\Scripts\MyScript.ps1"
+
+        Retrieves all function aliases defined in the specified script file.
+
+        .EXAMPLE
+        Get-FunctionAlias -Name "Get-Data" -Path "C:\Scripts\MyScript.ps1"
+
+        Retrieves the alias information for the function named "Get-Data" from the specified script file.
+    #>
+    [CmdletBinding()]
+    param (
+        # The name of the function to search for. Defaults to all functions ('*').
+        [Parameter()]
+        [string] $Name = '*',
+
+        # The path to the PowerShell script file to be parsed.
+        [Parameter(Mandatory)]
+        [string] $Path
+    )
+
+    # Parse the script file into an AST
+    $ast = [System.Management.Automation.Language.Parser]::ParseFile($Path, [ref]$null, [ref]$null)
+
+    # Extract function definitions
+    $functions = $ast.FindAll({ $args[0] -is [System.Management.Automation.Language.FunctionDefinitionAst] }, $true)
+
+    # Process each function and extract aliases
+    $functions | ForEach-Object {
+        $funcName = $_.Name
+        $attributes = $_.FindAll({ $args[0] -is [System.Management.Automation.Language.AttributeAst] }, $true)
+        $aliasAttr = $attributes | Where-Object { $_ -is [System.Management.Automation.Language.AttributeAst] -and $_.TypeName.Name -eq 'Alias' }
+
+        if ($aliasAttr) {
+            $aliases = $aliasAttr.PositionalArguments | ForEach-Object { $_.ToString().Trim('"', "'") }
+            [PSCustomObject]@{
+                Name  = $funcName
+                Alias = $aliases
+            }
+        }
+    } | Where-Object { $_.Name -like $Name }
+}

src/functions/public/Get-FunctionAlias.ps1

@@ -0,0 +1,37 @@
+function Get-FunctionName {
+    <#
+        .SYNOPSIS
+        Extracts function names from a specified PowerShell script.
+
+        .DESCRIPTION
+        Parses the given PowerShell script file and retrieves all function names
+        defined within it. This function utilizes the PowerShell Abstract Syntax Tree (AST)
+        to analyze the script and extract function definitions.
+
+        .EXAMPLE
+        Get-FunctionName -Path "C:\Scripts\MyScript.ps1"
+
+        Retrieves all function names defined in the specified script file.
+
+        .NOTES
+        Uses PowerShell's AST to analyze script structure.
+    #>
+
+    [CmdletBinding()]
+    param (
+        # The path to the script file to parse
+        [Parameter(Mandatory)]
+        [string] $Path
+    )
+
+    # Parse the script file into an AST
+    $ast = [System.Management.Automation.Language.Parser]::ParseFile($Path, [ref]$null, [ref]$null)
+
+    # Extract function definitions
+    $functions = $ast.FindAll({ $args[0] -is [System.Management.Automation.Language.FunctionDefinitionAst] }, $true)
+
+    # Process each function and extract the name
+    $functions | ForEach-Object {
+        $_.Name
+    }
+}

src/functions/public/Get-FunctionName.ps1

@@ -1,8 +1,18 @@
 Describe 'Module' {
-    Context "Function: 'Test-PSModuleTemplate'" {
-        It 'Should be able to call the function' {
-            Test-PSModuleTemplate -Name 'World' | Should -Be 'Hello, World!'
-            Write-Verbose (Test-PSModuleTemplate -Name 'World' | Out-String) -Verbose
+    Context "Function: 'Get-FunctionName'" {
+        It 'Get-FunctionName gets the function name' {
+            $path = Join-Path $PSScriptRoot 'src\Test-Function.ps1'
+            $functionName = Get-FunctionName -Path $path
+            $functionName | Should -Be 'Test-Function'
+        }
+    }
+    Context "Function: 'Get-FunctionAlias'" {
+        It 'Get-FunctionAlias gets the function alias' {
+            $path = Join-Path $PSScriptRoot 'src\Test-Function.ps1'
+            $functionAlias = Get-FunctionAlias -Path $path
+            $functionAlias.Alias | Should -Contain 'Test'
+            $functionAlias.Alias | Should -Contain 'TestFunc'
+            $functionAlias.Alias | Should -Contain 'Test-Func'
         }
     }
 }

src/header.ps1

@@ -1,13 +1,15 @@
-function Test-PSModuleTemplate {
+function Test-Function {
     <#
         .SYNOPSIS
         Performs tests on a module.
 
         .EXAMPLE
-        Test-PSModuleTemplate -Name 'World'
+        Test-Function -Name 'World'
 
         "Hello, World!"
     #>
+    [Alias('Test', 'TestFunc')]
+    [Alias('Test-Func')]
     [CmdletBinding()]
     param (
         # Name of the person to greet.