Update meta data to prepare v0.0.2 release (#8)

#### 📖 Summary

- update changelog
- update readme

#### 📑 Test Plan

> 💡 Select your test plan for the code changes.

- [x] Tested via Drone.io pipeline
- [ ] Custom test
- [ ] No test plan

##### Details / Justification

<!-- Add your test details or justification for missing tests here. -->

#### 📚 Additional Notes

<!-- A place for additional detail notes. -->

Co-authored-by: OCram85 <marco.blessing@googlemail.com>
Reviewed-on: #8

CHANGELOG.md

@@ -3,4 +3,13 @@
 <!-- insertMark -->
 ## `v0.0.2`
 
+- (e22fb0a) Fixes external dependencies in updated module manifest files (#7)
+- (6a314ee) add platyPS generated docs (#5)
+- (10182c5) fix module tags
+- (175e770) update meta files (#4)
+- (1f86741) adds assets (#3)
+- (c2b2dc8) prepare release (#2)
+
+## pre `v0.0.2`
+
 - 🧙 Initial migrated version

README.md

@@ -1,24 +1,64 @@
-# DroneHelper
+<p align="right">
+  <img src="http://forthebadge.com/images/badges/built-with-love.svg">
+  <img src="http://forthebadge.com/images/badges/for-you.svg">
+</p>
 
-[![Build Status](https://drone.ocram85.com/api/badges/OCram85/DroneHelper/status.svg)](https://drone.ocram85.com/OCram85/DroneHelper)
+<p align="center">
+  <a href="https://gitea.ocram85.com/OCram85/DroneHelper/">
+    <img src="https://gitea.ocram85.com/OCram85/DroneHelper/raw/branch/master/assets/social-logo.png" alt="DroneHelper" />
+  </a>
+</p>
 
-## Description
+<h1 align="center">
+  DroneHelper
+</h1>
 
-Helper module for Drone.io based build pipelines.
+<p align="center">
+  :hammer_and_wrench: Helper module for Drone.io based build pipelines.
+</p>
 
-## About
+<p align="center">
+  <a href="https://drone.ocram85.com/OCram85/DroneHelper">
+    <img src="https://drone.ocram85.com/api/badges/OCram85/DroneHelper/status.svg" alt="Master Branch Build Status">
+  </a>
+  <a href="https://www.powershellgallery.com/packages/DroneHelper">
+    <img src="https://img.shields.io/powershellgallery/v/DroneHelper.svg?style=plastic" alt="PowershellGallery Published Version">
+  </a>
+  <a href="https://www.powershellgallery.com/packages/DroneHelper">
+    <img src="https://img.shields.io/powershellgallery/vpre/DroneHelper.svg?label=latest%20preview&style=plastic" />
+  </a>
+  <a href="https://www.powershellgallery.com/packages/DroneHelper">
+    <img src="https://img.shields.io/powershellgallery/dt/DroneHelper.svg?style=plastic" />
+  </a>
+</p>
 
-The DroneHelper PowerShell Modules adds several feature to a `Gitea -> Drone.IO` based build pipeline. It's designed
+## :key: General
+
+The DroneHelper PowerShell module adds several features for `Gitea -> Drone.IO` based build pipelines. It's designed
 to perform all needed tasks for PowerShell Module development like:
 
-- `FileLinter` -> Runs basic FileLinter tests with console and log file output
-- `Linter` -> Runs PSScriptAnalyer with embedded to custom profiles.
-- `UnitTest` -> Executes Pester tests with code coverage with console and log file output.
-- `BuildReport` -> Takes all generated reports and reports them back as Pull Request Comment for a simplified overview.
-- `StateReporter` -> Marks the current pipeline run / build as failed if the previous steps also raised errors.
-- `DoksUpdater` -> Automatically updates the markdown based docs generated form your Comment Based Help blocks in your functions
+### Testing
 
-To use these feature, all you have to do, is follow the `.drone.yml` template:
+- `Invoke-FileLinter` -> Runs basic FileLinter tests with console and log file output
+- `Invoke-Linter` -> Runs PSScriptAnalyzer with embedded to custom profiles.
+- `Invoke-UnitTest` -> Runs Pester tests including code coverage report with console and log file output.
+
+### Build Pipeline
+- `Send-PRComment` -> Takes all generated reports and reports them back as Pull Request Comment for a simplified overview.
+- `Write-FailureStateFile`, `Invoke-Build` -> Marks the current pipeline run / build as failed if the previous steps also raised errors.
+
+### Helper
+
+- `New-Docs`, `Update-Docs` -> Automatically updates the markdown based docs generated form your Comment Based Help blocks in your functions
+
+
+### Building & Publishing
+
+- `Update-ModuleMeta` -> Updates the `ModuleVersion` + `Prerelease` properties wit the current git tag.
+- `Merge-ModuleRoot` -> Takes all single file functions and merges them into a single `*.psm1` file.
+- `New-BuildPackage` -> Creates a new build artifact for an alternate publishing target like a Gitea release.
+
+To use these features, all you have to do, is follow the `.drone.yml` template:
 
 ### `.drone.yml` Template
 
@@ -40,9 +80,14 @@ steps:
     environment:
       EXCLUDE: "(.exe|.dll|.ico|.gitkeep)"
     commands:
+      - |
+        apt-get update
+        apt-get install -y file
+
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module 'DroneHelper' -ErrorAction 'Stop';
           Invoke-FileLinter
         }"
 
@@ -52,7 +97,8 @@ steps:
     commands:
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           Invoke-Linter
         }"
@@ -61,9 +107,14 @@ steps:
     image: mcr.microsoft.com/dotnet/sdk:6.0-focal
     failure: ignore
     commands:
+      - |
+        apt-get update
+        apt-get install -y file
+
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           Invoke-UnitTest -Verbosity 'Detailed' -ExcludeTag 'Integration'
         }"
@@ -79,7 +130,8 @@ steps:
     commands:
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Send-PRComment
         }"
     when:
@@ -92,7 +144,8 @@ steps:
     commands:
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           Invoke-BuildState
         }"
@@ -116,13 +169,15 @@ steps:
     commands:
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           Update-ModuleMeta -Verbose
         }"
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           New-BuildPackage -Verbose
         }"
@@ -148,7 +203,8 @@ steps:
     commands:
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           Invoke-Publish -Verbose
         }"
@@ -175,7 +231,8 @@ steps:
     commands:
       - |
         pwsh -NonInteractive -c "& {
-          Import-Module -Name 'DroneHelper';
+          Install-Module -Name 'DroneHelper' -Repository 'PSGallery' -ErrorAction 'Stop';
+          Import-Module -Name 'DroneHelper' -ErrorAction 'Stop';
           Install-ModuleDependency;
           Update-Docs -Verbose
         }"

docs/Get-RepoPath.md

@@ -0,0 +1,58 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Get-RepoPath
+
+## SYNOPSIS
+Updates the module manifest file fields to prepare the new build.
+
+## SYNTAX
+
+```
+Get-RepoPath [[-SubPath] <String[]>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Replaces the version fields in the manifest file.
+Uses Drone env vars populated by pushed tags.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; Get-RepoPath
+```
+
+## PARAMETERS
+
+### -SubPath
+An optional string array of sub directories relative to the root.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [DroneHelper.Repo.Path] Returns a folder structured like object with relevant full paths.s
+## NOTES
+
+## RELATED LINKS

docs/Install-ModuleDependency.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Install-ModuleDependency
+
+## SYNOPSIS
+Install required modules of the module manifest file.
+
+## SYNTAX
+
+```
+Install-ModuleDependency [<CommonParameters>]
+```
+
+## DESCRIPTION
+Use this cmdlet to install required modules of the module manifest file.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Install-ModuleDependency
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None]
+## OUTPUTS
+
+### [None]
+## NOTES
+
+## RELATED LINKS

docs/Invoke-BuildState.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Invoke-BuildState
+
+## SYNOPSIS
+Sets final Drone pipeline build state.
+
+## SYNTAX
+
+```
+Invoke-BuildState [<CommonParameters>]
+```
+
+## DESCRIPTION
+Marks the pipeline ass succeeded of fail based on the custom state file.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Invoke-BuildState
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Invoke-FileLinter.md

@@ -0,0 +1,58 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Invoke-FileLinter
+
+## SYNOPSIS
+Runs the file linter for all src files found in current repository.
+
+## SYNTAX
+
+```
+Invoke-FileLinter [-PassThru] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Invoke-FileLinter runs the basic file tests and generates a report file for furher usage in the
+drone pipeline.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Invoke-FileLinter
+```
+
+## PARAMETERS
+
+### -PassThru
+{{ Fill PassThru Description }}
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None]
+## OUTPUTS
+
+### [DroneHelper.FileLinter.Report]
+## NOTES
+
+## RELATED LINKS

docs/Invoke-InstallDependency.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Invoke-InstallDependency
+
+## SYNOPSIS
+Install required modules for executing the DroneHelper pipeline helpers.
+
+## SYNTAX
+
+```
+Invoke-InstallDependency [<CommonParameters>]
+```
+
+## DESCRIPTION
+This can be used in drone.io docker pipeline if the modules are not integrated in the build image.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; Invoke-Install-Dependency
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No Input required.
+## OUTPUTS
+
+### [None] No Output
+## NOTES
+
+## RELATED LINKS

docs/Invoke-Linter.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Invoke-Linter
+
+## SYNOPSIS
+Runs all PSScriptAnalyzer Rules within this repo.
+
+## SYNTAX
+
+```
+Invoke-Linter [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used in Drone pipeline to run the PSScriptAnalyzer rules..
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Invoke-Linter
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Invoke-Publish.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Invoke-Publish
+
+## SYNOPSIS
+Publishes powershell module to internal Nexus repository.
+
+## SYNTAX
+
+```
+Invoke-Publish [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used to publish the module via Drone pipeline.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Invoke-Publish
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Invoke-UnitTest.md

@@ -0,0 +1,124 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Invoke-UnitTest
+
+## SYNOPSIS
+Runs all Pester tests within this repo.
+
+## SYNTAX
+
+```
+Invoke-UnitTest [[-CoverageFormat] <String>] [[-Verbosity] <String>] [-PassThru] [[-Tag] <String[]>]
+ [[-ExcludeTag] <String[]>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used in Drone pipeline to perform the Pester based unit tests.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Invoke-UnitTest
+```
+
+## PARAMETERS
+
+### -CoverageFormat
+Pester provides the formats JaCoCo ans CoverageGutters.
+Default is JaCoCo.
+These are the known use cases:
+- JaCoCo -\> Used as standard coverage report used by sonar
+- CoverageGutters -\> Custom Format to show coverage in VSCode.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: JaCoCo
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ExcludeTag
+Pester build in exclude filter for tests as string array.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 4
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PassThru
+Tells Invoke-UnitTest to write back the Pester results into your variable / output.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Tag
+Pester build in tag filter as string array.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Verbosity
+This parameter sets the Pester detail level.
+Default is 'Normal.' Available values are:
+'None', 'Normal', 'Detailed', 'Diagnostic'
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: Normal
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Merge-ModuleRoot.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Merge-ModuleRoot
+
+## SYNOPSIS
+Merges single ps1 files into one module script file.
+
+## SYNTAX
+
+```
+Merge-ModuleRoot [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used in build pipeline to reduce the file load and import performance to the target module.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; Merge-ModuleRoot
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/New-BuildPackage.md

@@ -0,0 +1,57 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# New-BuildPackage
+
+## SYNOPSIS
+Creates a new module package as compressed archive.
+
+## SYNTAX
+
+```
+New-BuildPackage [[-AdditionalPath] <String[]>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function is used in build pipeline to create an uploadable module version for the Gitea release page.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; New-BuildPackage
+```
+
+## PARAMETERS
+
+### -AdditionalPath
+You can provide additional paths to add files or folders in published module.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/New-Docs.md

@@ -0,0 +1,44 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# New-Docs
+
+## SYNOPSIS
+Creates a ne set of markdown based help in the docs folder.
+
+## SYNTAX
+
+```
+New-Docs [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet should be used once locally, or after adding new functions.
+The function \`Update-Docs\`
+can be used via pipeline to keep the docs up to date.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+New-Docs
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Readme.md

@@ -0,0 +1,86 @@
+---
+Module Name: DroneHelper
+Module Guid: 4293292f-eac8-42ed-8e9d-437d4f405d2c
+Download Help Link: {{ Update Download Link }}
+Help Version: {{ Please enter version of help manually (X.X.X.X) format }}
+Locale: en-US
+---
+
+# DroneHelper Module
+## Description
+See global [Readme file](../README.md) for usage instructions.
+
+## DroneHelper Cmdlets
+### [Get-RepoPath](Get-RepoPath.md)
+Updates the module manifest file fields to prepare the new build.
+
+### [Install-ModuleDependency](Install-ModuleDependency.md)
+Install required modules of the module manifest file.
+
+### [Invoke-BuildState](Invoke-BuildState.md)
+Sets final Drone pipeline build state.
+
+### [Invoke-FileLinter](Invoke-FileLinter.md)
+Runs the file linter for all src files found in current repository.
+
+### [Invoke-InstallDependency](Invoke-InstallDependency.md)
+Install required modules for executing the DroneHelper pipeline helpers.
+
+### [Invoke-Linter](Invoke-Linter.md)
+Runs all PSScriptAnalyzer Rules within this repo.
+
+### [Invoke-Publish](Invoke-Publish.md)
+Publishes powershell module to internal Nexus repository.
+
+### [Invoke-UnitTest](Invoke-UnitTest.md)
+Runs all Pester tests within this repo.
+
+### [Merge-ModuleRoot](Merge-ModuleRoot.md)
+Merges single ps1 files into one module script file.
+
+### [New-BuildPackage](New-BuildPackage.md)
+Creates a new module package as compressed archive.
+
+### [New-Docs](New-Docs.md)
+Creates a ne set of markdown based help in the docs folder.
+
+### [Send-PRComment](Send-PRComment.md)
+Sends build report as Gitea PR comment.
+
+### [Set-EOL](Set-EOL.md)
+Helper function to set the EOL sequence to LF or CRLF.
+
+### [Test-FileBOM](Test-FileBOM.md)
+Tests given file if native utf8 w/o BOM is used.
+Returns false if BOM is present.
+
+### [Test-FileEncoding](Test-FileEncoding.md)
+Returns true if the given file is written in a valid encoding
+
+### [Test-FileEOF](Test-FileEOF.md)
+Returns false if EOF isn't an empty line.
+
+### [Test-FileEOL](Test-FileEOL.md)
+Returns false if EOL isn't CRLF
+
+### [Test-FileTab](Test-FileTab.md)
+Returns false if tab char is used in file.
+
+### [Test-FileTailingWhitespace](Test-FileTailingWhitespace.md)
+Returns false if there are any tailing whitespace in lines.
+
+### [Update-Changelog](Update-Changelog.md)
+Updates the changelog file with recent commits
+
+### [Update-Docs](Update-Docs.md)
+Publishes powershell module to internal Nexus repository.
+
+### [Update-ModuleMeta](Update-ModuleMeta.md)
+Updates the module manifest file fields to prepare the new build.
+
+### [Write-FailureStateFile](Write-FailureStateFile.md)
+Writes the current pipeline step into failure log.
+
+### [Write-ResultFile](Write-ResultFile.md)
+Writes the current pipeline step into failure log.
+

docs/Send-PRComment.md

@@ -0,0 +1,79 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Send-PRComment
+
+## SYNOPSIS
+Sends build report as Gitea PR comment.
+
+## SYNTAX
+
+```
+Send-PRComment [[-Mode] <String>] [[-GiteaUser] <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Send-PRComment is used to report the build details from drone.io pipeline.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Send-PRComment
+Depends on Drone.IO injected environment vars. Doesn't work locally on dev systems.
+```
+
+## PARAMETERS
+
+### -GiteaUser
+Gitea user for drone bot
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: Drone-bot
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Mode
+Sets the report mode.
+Default is 'Renew'.
+This mode deletes the old pr comments and creates a new onw.
+Also available:
+  - 'Add' -\> simply adds new pr comments.
+  - 'Edit' -\> Edits the last known pr comment.
+Doesn't clean old ones.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: Renew
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None].
+## OUTPUTS
+
+### [None]
+## NOTES
+
+## RELATED LINKS

docs/Set-EOL.md

@@ -0,0 +1,73 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Set-EOL
+
+## SYNOPSIS
+Helper function to set the EOL sequence to LF or CRLF.
+
+## SYNTAX
+
+```
+Set-EOL [[-Style] <String>] [-Path] <FileInfo> [<CommonParameters>]
+```
+
+## DESCRIPTION
+Helper for changing the EOL independent to the current OS defaults.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; Set-EOL -Path './Readme.md'
+```
+
+## PARAMETERS
+
+### -Path
+Mandatory path for target file.
+
+```yaml
+Type: FileInfo
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Style
+Optional style parameter for \`unix\` or \`win.\`.
+Default is \`unix\`.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 1
+Default value: Unix
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [DroneHelper.Repo.Path] Returns a folder structured like object with relevant full paths.s
+## NOTES
+
+## RELATED LINKS

docs/Test-FileBOM.md

@@ -0,0 +1,58 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Test-FileBOM
+
+## SYNOPSIS
+Tests given file if native utf8 w/o BOM is used.
+Returns false if BOM is present.
+
+## SYNTAX
+
+```
+Test-FileBOM [-Path] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This function is used to test for a valid encoding without BOM.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Test-FileBOM -Path './Testfile.txt'
+```
+
+## PARAMETERS
+
+### -Path
+Full or relative path to existing file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None]
+## OUTPUTS
+
+### [bool]
+## NOTES
+
+## RELATED LINKS

docs/Test-FileEOF.md

@@ -0,0 +1,57 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Test-FileEOF
+
+## SYNOPSIS
+Returns false if EOF isn't an empty line.
+
+## SYNTAX
+
+```
+Test-FileEOF [-Path] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+Test the given file against the EOF standard (final empty/blank line + CRLF) and returns true or false.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Test-FileEOF -Path './testfile.txt'
+```
+
+## PARAMETERS
+
+### -Path
+Relative or full path to an existing file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [none]
+## OUTPUTS
+
+### [bool]
+## NOTES
+
+## RELATED LINKS

docs/Test-FileEOL.md

@@ -0,0 +1,58 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Test-FileEOL
+
+## SYNOPSIS
+Returns false if EOL isn't CRLF
+
+## SYNTAX
+
+```
+Test-FileEOL [-Path] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+Tests given file against valid EOL.
+Returns true if CRLF is used.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Test-FileEOL -Path './TestFile.txt'
+```
+
+## PARAMETERS
+
+### -Path
+Relative or full path to an existing file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None]
+## OUTPUTS
+
+### [bool]
+## NOTES
+
+## RELATED LINKS

docs/Test-FileEncoding.md

@@ -0,0 +1,73 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Test-FileEncoding
+
+## SYNOPSIS
+Returns true if the given file is written in a valid encoding
+
+## SYNTAX
+
+```
+Test-FileEncoding [-Path] <String> [[-Encoding] <String>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+Test the given file against the encoding regex and returns true or false
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Test-FileEncoding -Path './testfile.txt'
+```
+
+## PARAMETERS
+
+### -Encoding
+Optional custom encoding regex string.
+Default is (utf8|ascii|xml).
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: 2
+Default value: (utf8|utf-8|ascii|xml)
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Path
+Relative or full path to an existing file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [none]
+## OUTPUTS
+
+### [bool]
+## NOTES
+
+## RELATED LINKS

docs/Test-FileTab.md

@@ -0,0 +1,58 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Test-FileTab
+
+## SYNOPSIS
+Returns false if tab char is used in file.
+
+## SYNTAX
+
+```
+Test-FileTab [-Path] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+Test the given file if tabs are used.
+Returns false if any tabs were found.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Test-FileTab -Path './testfile.txt'
+```
+
+## PARAMETERS
+
+### -Path
+elative or full path to an existing file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [none]
+## OUTPUTS
+
+### [bool]
+## NOTES
+
+## RELATED LINKS

docs/Test-FileTailingWhitespace.md

@@ -0,0 +1,58 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Test-FileTailingWhitespace
+
+## SYNOPSIS
+Returns false if there are any tailing whitespace in lines.
+
+## SYNTAX
+
+```
+Test-FileTailingWhitespace [-Path] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+Tests the given file for tailing whitespace.
+Returns true if not found.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Test-FileTailingWhitespace.ps1 -Path './testfile.txt'
+```
+
+## PARAMETERS
+
+### -Path
+Relative or full path to an existing file.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [none]
+## OUTPUTS
+
+### [bool]
+## NOTES
+
+## RELATED LINKS

docs/Update-Changelog.md

@@ -0,0 +1,75 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Update-Changelog
+
+## SYNOPSIS
+Updates the changelog file with recent commits
+
+## SYNTAX
+
+```
+Update-Changelog [-NewVersion] <String> [-SkipCleanup] [<CommonParameters>]
+```
+
+## DESCRIPTION
+This helper function is used to insert recent changes for an upcoming release.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; Update-Changelog -NewVersion '0.0.1-dev5'
+```
+
+## PARAMETERS
+
+### -NewVersion
+Provide a valid semver based version tag for the upcoming release like:
+
+- \`v0.0.1-dev1\`
+- \`v1.0.0\`
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SkipCleanup
+You can skip the tag update and additional test.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] no pipeline putput.
+## NOTES
+
+## RELATED LINKS

docs/Update-Docs.md

@@ -0,0 +1,42 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Update-Docs
+
+## SYNOPSIS
+Publishes powershell module to internal Nexus repository.
+
+## SYNTAX
+
+```
+Update-Docs [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used to publish the module via Drone pipeline.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Update-Docs
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Update-ModuleMeta.md

@@ -0,0 +1,43 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Update-ModuleMeta
+
+## SYNOPSIS
+Updates the module manifest file fields to prepare the new build.
+
+## SYNTAX
+
+```
+Update-ModuleMeta [<CommonParameters>]
+```
+
+## DESCRIPTION
+Replaces the version fields in the manifest file.
+Uses Drone env vars populated by pushed tags.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Import-Module -Name DroneHelper; Update-ModuleMeta
+```
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Write-FailureStateFile.md

@@ -0,0 +1,57 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Write-FailureStateFile
+
+## SYNOPSIS
+Writes the current pipeline step into failure log.
+
+## SYNTAX
+
+```
+Write-FailureStateFile [-StepName] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used to mark single steps as failed without stopping the complete pipeline.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Write-FailureStateFile
+```
+
+## PARAMETERS
+
+### -StepName
+The current DroneHelper step name which should be added into to the log.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

docs/Write-ResultFile.md

@@ -0,0 +1,87 @@
+---
+external help file: ModuleRoot-help.xml
+Module Name: DroneHelper
+online version:
+schema: 2.0.0
+---
+
+# Write-ResultFile
+
+## SYNOPSIS
+Writes the current pipeline step into failure log.
+
+## SYNTAX
+
+```
+Write-ResultFile [-InputObject] <PSObject> [-Path] <String> [-Type] <String> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This Cmdlet is used to mark single steps as failed without stopping the complete pipeline.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```
+Write-FailureStateFile
+```
+
+## PARAMETERS
+
+### -InputObject
+{{ Fill InputObject Description }}
+
+```yaml
+Type: PSObject
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 1
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Path
+{{ Fill Path Description }}
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 2
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Type
+{{ Fill Type Description }}
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: True
+Position: 3
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### CommonParameters
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### [None] No pipeline input.
+## OUTPUTS
+
+### [None] No pipeline output.
+## NOTES
+
+## RELATED LINKS

resources/MyModule.psd1

@@ -0,0 +1,141 @@
+#
+# Module manifest for module 'MyModule'
+#
+# Generated by: OCram85
+#
+# Generated on: 27.07.2022
+#
+
+@{
+
+    # Script module or binary module file associated with this manifest.
+    # RootModule = ''
+
+    # Version number of this module.
+    ModuleVersion     = '0.0.1'
+
+    # Supported PSEditions
+    # CompatiblePSEditions = @()
+
+    # ID used to uniquely identify this module
+    GUID              = '71364bab-5f39-4c93-a0f6-319d2b6cfc53'
+
+    # Author of this module
+    Author            = 'OCram85'
+
+    # Company or vendor of this module
+    CompanyName       = 'Unknown'
+
+    # Copyright statement for this module
+    Copyright         = '(c) OCram85. All rights reserved.'
+
+    # Description of the functionality provided by this module
+    # Description = ''
+
+    # Minimum version of the PowerShell engine required by this module
+    # PowerShellVersion = ''
+
+    # Name of the PowerShell host required by this module
+    # PowerShellHostName = ''
+
+    # Minimum version of the PowerShell host required by this module
+    # PowerShellHostVersion = ''
+
+    # Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+    # DotNetFrameworkVersion = ''
+
+    # Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.
+    # ClrVersion = ''
+
+    # Processor architecture (None, X86, Amd64) required by this module
+    # ProcessorArchitecture = ''
+
+    # Modules that must be imported into the global environment prior to importing this module
+    # RequiredModules = @()
+
+    # Assemblies that must be loaded prior to importing this module
+    # RequiredAssemblies = @()
+
+    # Script files (.ps1) that are run in the caller's environment prior to importing this module.
+    # ScriptsToProcess = @()
+
+    # Type files (.ps1xml) to be loaded when importing this module
+    # TypesToProcess = @()
+
+    # Format files (.ps1xml) to be loaded when importing this module
+    # FormatsToProcess = @()
+
+    # Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+    # NestedModules = @()
+
+    # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
+    FunctionsToExport = @()
+
+    # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
+    CmdletsToExport   = @()
+
+    # Variables to export from this module
+    VariablesToExport = '*'
+
+    # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
+    AliasesToExport   = @()
+
+    # DSC resources to export from this module
+    # DscResourcesToExport = @()
+
+    # List of all modules packaged with this module
+    # ModuleList = @()
+
+    # List of all files packaged with this module
+    # FileList = @()
+
+    # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+    PrivateData       = @{
+
+        PSData = @{
+
+            # Tags applied to this module. These help with module discovery in online galleries.
+            # Tags = @()
+
+            # A URL to the license for this module.
+            # LicenseUri = ''
+
+            # A URL to the main website for this project.
+            # ProjectUri = ''
+
+            # A URL to an icon representing this module.
+            # IconUri = ''
+
+            # ReleaseNotes of this module
+            # ReleaseNotes = ''
+
+            # Prerelease string of this module
+            # Prerelease = ''
+
+            # Flag to indicate whether the module requires explicit user acceptance for install/update/save
+            # RequireLicenseAcceptance = $false
+
+            # External dependent modules of this module
+            ExternalModuleDependencies = @(
+                @{
+                    ModuleName    = 'WinSCP'
+                    ModuleVersion = '5.17.8.1'
+                },
+                @{
+                    ModuleName    = 'DataONTAP'
+                    ModuleVersion = '9.7.1.1'
+                }
+            )
+
+        } # End of PSData hashtable
+
+    } # End of PrivateData hashtable
+
+    # HelpInfo URI of this module
+    # HelpInfoURI = ''
+
+    # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+    # DefaultCommandPrefix = ''
+
+}
+

src/Build/Update-ModuleMeta.Tests.ps1

@@ -18,4 +18,29 @@ Describe 'Update-ModuleMeta' {
             $foo.Description[0].Text.Length | Should -BeGreaterThan 5
         }
     }
+
+    Context 'Unit Tests' -Tag 'Unit' {
+        It 'Update test module manifest' {
+            {
+                $Env:DRONE = $true
+                $Env:DRONE_BUILD_EVENT = 'tag'
+                $Env:DRONE_SEMVER = '9.9.9-dev9'
+                $Env:DRONE_SEMVER_SHORT = '9.9.9'
+                $Env:DRONE_SEMVER_PRERELEASE = 'dev9'
+                Update-ModuleMeta -Path './resources/MyModule.psd1' -Verbose
+            } | Should -Not -Throw
+            $data = Import-PowerShellDataFile -Path './resources/MyModule.psd1'
+            $data.ModuleVersion | Should -Be '9.9.9'
+            $data.PrivateData.PSData.Prerelease | Should -Be 'dev9'
+        }
+
+        It 'Updated manifest is valid' {
+            { Test-ModuleManifest -Path './resources/MyModule.psd1' } | Should -Not -Throw
+        }
+
+        It 'External dependencies prop is untouched' {
+            $d = Test-ModuleManifest -Path './resources/MyModule.psd1'
+            $d.PrivateData.PSData.ExternalModuleDependencies.Count | Should -Be '2'
+        }
+    }
 }

src/Build/Update-ModuleMeta.ps1

@@ -27,11 +27,31 @@ function Update-ModuleMeta {
         '',
         Justification = 'system state does not change permanent in temp build clients.'
     )]
-    param ()
+    param (
+        [Parameter(Mandatory = $false)]
+        [ValidateScript(
+            {
+                if (Test-Path -Path $_) {
+                    return $true
+                }
+                else {
+                    throw 'Could not find file: {0}' -f $_
+                }
+            }
+        )]
+        [ValidateNotNullOrEmpty()]
+        [string]$Path
+    )
 
     process {
-        if ($Env:DRONE) {
+        if (!$Path) {
             $Repo = Get-RepoPath
+            $ManifestFilePath = $Repo.Src.Manifest.Item.FullName
+        }
+        else {
+            $ManifestFilePath = $Path
+        }
+        if ($Env:DRONE) {
             if ($Env:DRONE_BUILD_EVENT -eq 'tag') {
                 if ($null -ne $Env:DRONE_SEMVER) {
                     $nVersion = $Env:DRONE_SEMVER_SHORT
@@ -39,37 +59,69 @@ function Update-ModuleMeta {
                     if ($null -ne $Env:DRONE_SEMVER_PRERELEASE) {
                         $nPreRelease = $Env:DRONE_SEMVER_PRERELEASE
                     }
-                    $ModManifestParams = @{
-                        Path          = $Repo.Src.Manifest.Item.FullName
-                        ModuleVersion = $nVersion
-                        ErrorAction   = 'Stop'
+                    $DataParams = @{
+                        Path        = $ManifestFilePath
+                        ErrorAction = 'Stop'
                     }
+                    # Getting the module manifest as imported object
+                    try {
+                        $ModManifestData = Import-PowerShellDataFile @DataParams
+                    }
+                    catch {
+                        $_.Exception.Message | Write-Debug
+                        $ErrorParams = @{
+                            Message     = "Could not import the module manifest file."
+                            ErrorAction = 'Stop'
+                        }
+                        Write-Error @ErrorParams
+                    }
+                    # Updating the new module version
+                    $ModManifestData.ModuleVersion = $nVersion
+
+                    # Updating the prerelease property if there is one
                     if ($nPreRelease) {
-                        $ModManifestParams.PreRelease = $nPreRelease
+                        $ModManifestData.PrivateData.PSData.Prerelease = $nPreRelease
                     }
 
-                    $ManifestData = Test-ModuleManifest -Path $Repo.Src.Manifest.Item.FullName
+                    $ManifestData = Test-ModuleManifest -Path $ManifestFilePath
 
                     if (
                         ($nVersion -ne $ManifestData.Version) -or
-                        ($nVersion -ne $ManifestData.PrivateData.PSData.Prerelease)
+                        ($nPreRelease -ne $ManifestData.PrivateData.PSData.Prerelease)
                     ) {
-                        Update-ModuleManifest @ModManifestParams
+                        $OutputFileParams = @{
+                            Path     = $ManifestFilePath
+                            #PassThru = $true
+                            Encoding = 'utf8NoBom'
+                            Force    = $true
+                            Verbose  = $VerbosePreference
+                        }
+                        try {
+                            $ModManifestData | ConvertTo-Psd | Set-Content @OutputFileParams
+                        }
+                        catch {
+                            $_.Exception.Message | Write-Debug
+                            $ErrorParams = @{
+                                Message     = "Failed to update the module manifest file"
+                                ErrorAction = 'Stop'
+                            }
+                            Write-Error @ErrorParams
+                        }
                     }
                     else {
-                        Write-Verbose -Message 'Identical version given. Skipping update.'
+                        Write-Warning -Message 'Identical version given. Skipping update.'
                     }
                 }
                 else {
-                    Write-Verbose -Message 'Could not read the new Tag / Semver!'
+                    Write-Warning -Message 'Could not read the new Tag / Semver!'
                 }
             }
             else {
-                Write-Verbose -Message 'This pipeline was not triggered by a tag.'
+                Write-Warning -Message 'This pipeline was not triggered by a tag.'
             }
         }
         else {
-            Write-Verbose -Message 'Running outside of drone.io pipeline. Skipping module update!'
+            Write-Warning -Message 'Running outside of drone.io pipeline. Skipping module update!'
         }
     }
 }

src/Deps/Invoke-InstallDependency.ps1

@@ -56,6 +56,19 @@ function Invoke-InstallDependency {
                 ErrorAction        = 'Stop'
             }
             Install-Module @PoshParams
+
+            $PsdKitParams = @{
+                Name               = 'PsdKit'
+                Scope              = 'CurrentUser'
+                RequiredVersion    = '0.6.2'
+                Force              = $true
+                SkipPublisherCheck = $true
+                AllowClobber       = $true
+                AllowPrerelease    = $true
+                Verbose            = $VerbosePreference
+                ErrorAction        = 'Stop'
+            }
+            Install-Module @PsdKitParams
         }
         catch {
             $ExecParams = @{

src/DroneHelper.psd1

@@ -68,6 +68,10 @@
         @{
             ModuleName    = 'posh-git'
             ModuleVersion = '1.1.0'
+        },
+        @{
+            ModuleName    = 'PsdKit'
+            ModuleVersion = '0.6.2'
         }
     )
 
@@ -153,19 +157,19 @@
         PSData = @{
 
             # Tags applied to this module. These help with module discovery in online galleries.
-            # Tags = @()
+            Tags         = @('gitea', 'drone.io')
 
             # A URL to the license for this module.
-            # LicenseUri = ''
+            LicenseUri   = 'https://gitea.ocram85.com/OCram85/DroneHelper/src/branch/master/LICENSE'
 
             # A URL to the main website for this project.
-            ProjectUri = 'https://gitea.ocram85.com/OCram85/DroneHelper'
+            ProjectUri   = 'https://gitea.ocram85.com/OCram85/DroneHelper'
 
             # A URL to an icon representing this module.
-            # IconUri = ''
+            IconUri      = 'https://gitea.ocram85.com/OCram85/DroneHelper/raw/branch/master/assets/logo256.png'
 
             # ReleaseNotes of this module
-            # ReleaseNotes = ''
+            ReleaseNotes = 'See https://gitea.ocram85.com/OCram85/DroneHelper/releases page for details.'
 
             # Prerelease string of this module
             # Prerelease = ''

tools/DevDependency.psm1

@@ -49,6 +49,20 @@ function Invoke-FixDevDependency {
                 ErrorAction        = 'Stop'
             }
             Install-Module @PoshParams
+
+
+            $PsdKitParams = @{
+                Name               = 'PsdKit'
+                Scope              = 'CurrentUser'
+                RequiredVersion    = '0.6.2'
+                Force              = $true
+                SkipPublisherCheck = $true
+                AllowClobber       = $true
+                AllowPrerelease    = $true
+                Verbose            = $VerbosePreference
+                ErrorAction        = 'Stop'
+            }
+            Install-Module @PsdKitParams
         }
         catch {
             $ExecParams = @{