🩹 [Patch]: Initialize Hcl module (#3)

The `Hcl` module is now available on the [PowerShell
Gallery](https://www.powershellgallery.com/) as version `0.0.1`. This
initial release reserves the module name and establishes the intended
API surface — `ConvertFrom-Hcl` and `ConvertTo-Hcl` — for working with
[HashiCorp Configuration Language](https://github.com/hashicorp/hcl) as
used in Terraform, OpenTofu, and related infrastructure-as-code tooling.
Both functions are placeholders that throw `NotImplementedException`
until the full parser and serializer are implemented.

- Fixes #2

## New: Hcl module on the PowerShell Gallery

The module can be installed from the PowerShell Gallery:

```powershell
Install-PSResource -Name Hcl
Import-Module -Name Hcl
```

`ConvertFrom-Hcl` and `ConvertTo-Hcl` are available as commands but
throw `NotImplementedException` until the implementation is complete.
Their presence reserves the intended API and allows downstream tooling
to take a dependency on the module name.

## Technical Details

- All template boilerplate removed: `Test-PSModuleTest.ps1`,
`completers.ps1`, `PSModule/` and `SomethingElse/` subdirectories, and
`tests/PSModuleTest.Tests.ps1`.
- `ConvertFrom-Hcl` and `ConvertTo-Hcl` added as public placeholder
functions, following the same pattern as
[PSModule/Toml#init](https://github.com/PSModule/Toml/tree/init).
- `src/manifest.psd1` set to `ModuleVersion = '0.0.1'` to trigger the
first publish pipeline run.
- `tests/Hcl.Tests.ps1` added with assertions that both placeholders
throw as expected.
- `examples/General.ps1` and `README.md` updated with HCL-specific
content (Terraform locals, `.tfvars` examples).

---------

Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Author: MariusStorhaug

.github/workflows/Process-PSModule.yml

@@ -27,6 +27,6 @@ permissions:
 
 jobs:
   Process-PSModule:
-    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@60bdf8a5a4c92c53fcf2a8d23f7d5f5c93e6864e # v5.4.3
+    uses: PSModule/Process-PSModule/.github/workflows/workflow.yml@11117919e65242d3388727819a751f74ad24ea9e # v5.5.0
     secrets:
       APIKEY: ${{ secrets.APIKEY }}

README.md

@@ -1,6 +1,6 @@
-# {{ NAME }}
+# Hcl
 
-{{ DESCRIPTION }}
+A PowerShell module for working with [HashiCorp Configuration Language (HCL)](https://github.com/hashicorp/hcl), as used in [Terraform](https://www.terraform.io/), [OpenTofu](https://opentofu.org/), and other infrastructure-as-code tools. Supports parsing `.tf` configuration files, `.tfvars` variable files, `locals {}` blocks, and converting PowerShell objects back to HCL format.
 
 ## Prerequisites
 
@@ -12,58 +12,80 @@ This uses the following external resources:
 To install the module from the PowerShell Gallery, you can use the following command:
 
 ```powershell
-Install-PSResource -Name {{ NAME }}
-Import-Module -Name {{ NAME }}
+Install-PSResource -Name Hcl
+Import-Module -Name Hcl
 ```
 
 ## Usage
 
-Here is a list of example that are typical use cases for the module.
+Here is a list of examples that are typical use cases for the module.
 
-### Example 1: Greet an entity
-
-Provide examples for typical commands that a user would like to do with the module.
+### Example 1: Parse a Terraform locals block
 
 ```powershell
-Greet-Entity -Name 'World'
-Hello, World!
+$hcl = @'
+locals {
+  environment = "production"
+  region      = "us-east-1"
+  tags = {
+    project = "myapp"
+    team    = "platform"
+  }
+}
+'@
+$result = ConvertFrom-Hcl -InputObject $hcl
+$result.locals.environment  # production
+$result.locals.tags.project # myapp
 ```
 
-### Example 2
+### Example 2: Parse a .tfvars file
 
-Provide examples for typical commands that a user would like to do with the module.
+```powershell
+$tfvars = Get-Content -Path 'terraform.tfvars' -Raw
+$variables = ConvertFrom-Hcl -InputObject $tfvars
+$variables.region  # us-east-1
+```
+
+### Example 3: Convert a PowerShell object to HCL
 
 ```powershell
-Import-Module -Name PSModuleTemplate
+$config = [ordered]@{
+    resource = [ordered]@{
+        aws_instance = [ordered]@{
+            example = [ordered]@{
+                ami           = 'ami-0c55b159cbfafe1f0'
+                instance_type = 't2.micro'
+            }
+        }
+    }
+}
+ConvertTo-Hcl -InputObject $config
 ```
 
 ### Find more examples
 
 To find more examples of how to use the module, please refer to the [examples](examples) folder.
 
-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'.
+Alternatively, you can use `Get-Command -Module 'Hcl'` to find commands available in the module.
+To find examples of each command, 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.
+For detailed documentation on each function, use the built-in help system:
+
+```powershell
+Get-Help ConvertFrom-Hcl -Full
+Get-Help ConvertTo-Hcl -Full
+```
 
 ## Contributing
 
 Coder or not, you can contribute to the project! We welcome all contributions.
 
-### For Users
-
-If you don't code, you still sit on valuable information that can make this project even better. If you experience that the
-product does unexpected things, throw errors or is missing functionality, you can help by submitting bugs and feature requests.
-Please see the issues tab on this project and submit a new issue that matches your needs.
-
-### For Developers
+### For users
 
-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.
+If you don't code, you still sit on valuable information that can make this project even better. If you experience that the product does unexpected things, throw errors or is missing functionality, you can help by submitting bugs and feature requests. Please see the issues tab on this project and submit a new issue that matches your needs.
 
-## Acknowledgements
+### For developers
 
-Here is a list of people and projects that helped this project in some way.
+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.

examples/General.ps1

@@ -1,19 +1,16 @@
-<#
+<#
   .SYNOPSIS
-    This is a general example of how to use the module.
+    This is a general example of how to use the Hcl module.
 #>
 
 # Import the module
-Import-Module -Name 'PSModule'
+Import-Module -Name 'Hcl'
 
-# Define the path to the font file
-$FontFilePath = 'C:\Fonts\CodeNewRoman\CodeNewRomanNerdFontPropo-Regular.tff'
-
-# Install the font
-Install-Font -Path $FontFilePath -Verbose
-
-# List installed fonts
-Get-Font -Name 'CodeNewRomanNerdFontPropo-Regular'
-
-# Uninstall the font
-Get-Font -Name 'CodeNewRomanNerdFontPropo-Regular' | Uninstall-Font -Verbose
+# Convert an HCL locals block to a PowerShell object
+$hcl = @'
+locals {
+  environment = "production"
+  region      = "us-east-1"
+}
+'@
+ConvertFrom-Hcl -InputObject $hcl