Fix class resource generation (#163)

Author: dan-hughes

CHANGELOG.md

@@ -8,6 +8,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Removed
 
 - Removed `build.psd1` as it is no longer required to build the project.
+- Removed ClassAst functions
+  - `Get-ClassResourceProperty`
+  - `Get-ClassAst`
+  - `Get-ClassResourceAst`
 
 ### Added
 
@@ -25,6 +29,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     filename. The task will convert standard hyphens to spaces and Unicode
     hyphens to standard hyphens before comparison. The task can be controlled
     by parameter `RemoveTopLevelHeader` in the task, which defaults to `$true`.
+- Added Helper functions as part of [#163] (https://github.com/dsccommunity/DscResource.DocGenerator/pull/163).
+  - `Get-ClassPropertyCustomAttribute`
+  - `Get-DscResourceAttributeProperty`
+  - `Get-DscPropertyType`
+  - `Test-ClassPropertyDscAttributeArgument`
 
 ### Changed
 
@@ -42,6 +51,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Task `Generate_Markdown_For_DSC_Resources`
   - Outputs a warning message if the old configuration key is used in the
     build configuration but keeps using the old configuration key.
+- `New-DscClassResourcePage`
+  - Remove using Ast to generate documentation. Fixes [#116](https://github.com/dsccommunity/DscResource.DocGenerator/issues/116).
+  - Order properties correctly fixes [#126](https://github.com/dsccommunity/DscResource.DocGenerator/issues/126).
 
 ### Fixed
 

build.yaml

@@ -15,11 +15,11 @@ Prefix: ./prefix.ps1
 ####################################################
 
 NestedModule:
-    DscResource.Common:
-      CopyOnly: true
-      Path: ./output/RequiredModules/DscResource.Common
-      AddToManifest: false
-      Exclude: PSGetModuleInfo.xml
+  DscResource.Common:
+    CopyOnly: true
+    Path: ./output/RequiredModules/DscResource.Common
+    AddToManifest: false
+    Exclude: PSGetModuleInfo.xml
 
 ####################################################
 #       Sampler Pipeline Configuration             #
@@ -35,16 +35,17 @@ BuildWorkflow:
     - Build_Module_ModuleBuilder
     - Build_NestedModules_ModuleBuilder
     - Create_changelog_release_output
+
+  docs:
     - Generate_Conceptual_Help
     - Generate_Wiki_Content
-    - Generate_Markdown_For_Public_Commands
-    - Generate_External_Help_File_For_Public_Commands
     - Generate_Wiki_Sidebar
-    - Clean_Markdown_Of_Public_Commands
     - Clean_Markdown_Metadata
+    - Package_Wiki_Content
 
   pack:
     - build
+    - docs
     - package_module_nupkg
 
   hqrmtest:
@@ -68,8 +69,6 @@ BuildWorkflow:
         Remove-Module -Name 'DscResource.DocGenerator' -ErrorAction SilentlyContinue
     }
 
-
-
 ####################################################
 #       PESTER  Configuration                      #
 ####################################################
@@ -138,7 +137,7 @@ DscResource.DocGenerator:
       - '\*(.+?)\*' # Match Italic (asterisk)
   Publish_GitHub_Wiki_Content:
     Debug: true
-  Generate_Wiki_Content:
+  Generate_Markdown_For_DSC_Resources:
     MofResourceMetadata:
       Type: MofResource
       Category: Resources
@@ -149,5 +148,5 @@ DscResource.DocGenerator:
       Type: CompositeResource
       Category: Resources
   Generate_Wiki_Sidebar:
-     Debug: false
-     AlwaysOverwrite: true
+    Debug: false
+    AlwaysOverwrite: true

source/Private/Get-ClassAst.ps1

@@ -0,0 +1,39 @@
+<#
+    .SYNOPSIS
+        This function returns a filtered list of CustomAttributes from a given AttributeType.
+
+    .DESCRIPTION
+        The function will filter the provided CustomAttributes provided and returns only the matching attributes or null.
+
+    .PARAMETER Attributes
+        The array of attributes that need to be filtered.
+
+    .PARAMETER AttributeType
+        The attribute type name to filter the attributes on.
+
+    .OUTPUTS
+        System.Reflection.CustomAttributeData[]
+
+    .EXAMPLE
+        Get-ClassPropertyCustomAttribute -Attributes $CommonAttributes -AttributeType 'ValidateSetAttribute'
+#>
+
+function Get-ClassPropertyCustomAttribute
+{
+    [CmdletBinding()]
+    [OutputType([System.Reflection.CustomAttributeData[]])]
+    param (
+        [Parameter(Mandatory = $true)]
+        [System.Reflection.CustomAttributeData[]]
+        $Attributes,
+
+        [Parameter(Mandatory = $true)]
+        [System.String]
+        $AttributeType
+    )
+
+    process
+    {
+        return $Attributes | Where-Object { $_.AttributeType.Name -eq $AttributeType }
+    }
+}