Avm.Authoring
0.1.8
Minimum PowerShell version
7.4
Installation Options
Owners
Copyright
(c) Microsoft Corporation. All rights reserved.
Package Details
Author(s)
- Azure Verified Modules
Tags
Azure AVM AzureVerifiedModules Bicep Terraform Authoring CLI
Functions
Get-AvmAuthoringPlaceholder Get-AvmModuleContext Get-AvmTool Get-AvmVersion Install-AvmTool Invoke-Avm Invoke-AvmCheckConvention Invoke-AvmCheckPolicy Invoke-AvmDoctor Invoke-AvmDocs Invoke-AvmFormat Invoke-AvmLint Invoke-AvmPrCheck Invoke-AvmPreCommit Invoke-AvmSync Invoke-AvmTest Invoke-AvmTestE2e Invoke-AvmTestIntegration Invoke-AvmTestUnit Invoke-AvmTransform
PSEditions
Dependencies
This module has no dependencies.
Release Notes
Log-fidelity round from post-release failure-path testing of `0.1.7` against the
canary repo `Azure/terraform-azurerm-avm-ptn-example-repo` (F57, F58). Both
defects were found by deliberately injecting ordinary mistakes — a typo in a
`.tf` file, and format drift alongside a broken test — and reading what the
tooling actually reported.
### Fixed
- **Tool failures now report what the tool said.** `Invoke-AvmProcess` built its
exception message from the exit code and the command line alone, so a
malformed `.tf` file produced `Process exited with code 2: terraform.exe fmt
...` and nothing else. The stderr was captured and attached to the exception
the whole time, but the only code that rendered it was gated on narration, and
`terraform fmt` does not narrate. The message now carries the tool's own
diagnostic — file, line and reason — bounded to 20 lines / 2000 characters.
This affects every managed tool: terraform, tflint, terraform-docs, conftest
and mapotf. (F57)
- **The single GitHub Actions annotation now names the most severe failure, not
the first one.** `pr-check` emits one annotation per run (deliberately, so the
Files-changed view is not buried). It was selected by step order, so a run with
both `terraform_variable_separate` lint nits and four broken unit tests
annotated the nit and left twelve `error` diagnostics unannotated. Selection is
now severity-ranked. Within a step, position still wins so the F24b headline
behaviour is unchanged; across steps, severity wins so a real error outranks a
positioned style nit. (F58)
A second defect surfaced in the same measurement: within the lint step the
first positioned issue was chosen, which is an `info` finding — but lint gates
on `warning`, so the annotation named a cause that could not have failed the
step. Equal-precision issues are now tie-broken on severity.
FileList
- Avm.Authoring.nuspec
- Avm.Authoring.psd1
- Private\Assets\Resolve-AvmPolicyBundle.ps1
- Private\Output\ConvertTo-AvmResultLine.ps1
- Engines\Terraform\README.md
- Private\Assets\Resolve-AvmPinnedAsset.ps1
- Private\Output\Write-AvmLog.ps1
- Resources\tflint\avm.tflint_module.hcl
- Avm.Authoring.psm1
- Private\Layout\Test-AvmModuleLayout.ps1
- Private\Output\Assert-AvmCommandSuccess.ps1
- Resources\tflint\avm.tflint.hcl
- README.md
- Private\Tools\Expand-AvmToolArchive.ps1
- Private\Output\Write-AvmResult.ps1
- Resources\tflint\avm.tflint_example.hcl
- Resources\avm.pins.jsonc
- Private\Tools\Resolve-AvmMirrorUrl.ps1
- Private\Output\Get-AvmFailureDetail.ps1
- Resources\Rules\030-gitignore-essentials.psd1
- Resources\PSScriptAnalyzerSettings.psd1
- Private\Tools\Install-AvmToolFromPins.ps1
- Engines\ManagedFiles\Merge-AvmFileLine.ps1
- Resources\Rules\010-outputs-tf-not-output-tf.psd1
- Public\Invoke-AvmCheckConvention.ps1
- Private\Tools\Read-AvmPins.ps1
- Engines\ManagedFiles\Sync-AvmManagedFile.ps1
- Resources\Rules\023-tests-dir-must-exist.psd1
- Public\Invoke-AvmDocs.ps1
- Private\Tools\Invoke-AvmHttp.ps1
- Engines\Bicep\Invoke-AvmBicepDocs.ps1
- Resources\Rules\020-terraform-tf-must-exist.psd1
- Public\Invoke-AvmPreCommit.ps1
- Private\Tools\Test-AvmAutoInstallDisabled.ps1
- Engines\Bicep\Invoke-AvmBicepTransform.ps1
- Resources\Rules\011-variables-tf-not-variable-tf.psd1
- Public\Invoke-AvmCheckPolicy.ps1
- Private\Tools\Find-AvmToolOnPath.ps1
- Engines\Bicep\Invoke-AvmBicepCheckConvention.ps1
- Resources\Rules\021-header-md-must-exist.psd1
- Public\Invoke-AvmPrCheck.ps1
- Private\Tools\Resolve-AvmTool.ps1
- Engines\Bicep\Invoke-AvmBicepTest.ps1
- Resources\Rules\022-examples-dir-must-exist.psd1
- Public\Get-AvmAuthoringPlaceholder.ps1
- Private\Tools\Test-AvmPins.ps1
- Engines\Bicep\Invoke-AvmBicepLint.ps1
- Resources\CustomRules\AvmAvoidStringThrow.psm1
- Public\Invoke-Avm.ps1
- Private\Tools\Lock-AvmToolCache.ps1
- Engines\Bicep\Format-AvmBicepModule.ps1
- Private\Rules\Primitives\Test-AvmRuleFileMustNotExist.ps1
- Public\Get-AvmVersion.ps1
- Private\Tools\Get-AvmToolPlatform.ps1
- Engines\Bicep\Invoke-AvmBicepCheckPolicy.ps1
- Private\Rules\Primitives\Test-AvmRuleGitignoreMustContain.ps1
- Public\Invoke-AvmDoctor.ps1
- Private\Folders\Get-AvmFolder.ps1
- Engines\Bicep\README.md
- Private\Rules\Primitives\Test-AvmRuleFileMustExist.ps1
- Public\Install-AvmTool.ps1
- Private\Folders\Get-AvmFileSnapshot.ps1
- Engines\Terraform\Format-AvmTerraformModule.ps1
- Private\Rules\Primitives\Test-AvmRuleDirectoryMustExist.ps1
- Public\Get-AvmModuleContext.ps1
- Private\Process\Invoke-AvmProcess.ps1
- Engines\Terraform\Invoke-AvmTerraformTestE2e.ps1
- Resources\mapotf\pre-commit\required_provider_versions.mptf.hcl
- Public\Invoke-AvmTestUnit.ps1
- Private\Process\ConvertFrom-AvmDotEnv.ps1
- Engines\Terraform\Invoke-AvmTerraformCheckPolicy.ps1
- Resources\mapotf\pre-commit\order_resource_meta.mptf.hcl
- Public\Invoke-AvmTestIntegration.ps1
- Private\Process\New-AvmToolPathEnvironment.ps1
- Engines\Terraform\Invoke-AvmTerraformCheckConvention.ps1
- Resources\mapotf\pre-commit\move_misplaced_blocks.mptf.hcl
- Public\Invoke-AvmFormat.ps1
- Private\Dispatch\Get-AvmVerbRegistry.ps1
- Engines\Terraform\Get-AvmTerraformE2eExample.ps1
- Resources\mapotf\pre-commit\avm_headers_for_azapi.mptf.hcl
- Public\Get-AvmTool.ps1
- Private\Dispatch\Test-AvmDisableSentinel.ps1
- Engines\Terraform\Invoke-AvmTerraformTransform.ps1
- Resources\mapotf\pre-commit\sort_outputs.mptf.hcl
- Public\Invoke-AvmSync.ps1
- Private\Rules\AvmRule.ps1
- Engines\Terraform\Invoke-AvmTerraformLint.ps1
- Resources\mapotf\pre-commit\order_module_attrs.mptf.hcl
- Public\Invoke-AvmTransform.ps1
- Private\Rules\Read-AvmRuleSet.ps1
- Engines\Terraform\Invoke-AvmTerraformTestSuite.ps1
- Resources\mapotf\pre-commit\main_telemetry_tf.mptf.hcl
- Public\Invoke-AvmTestE2e.ps1
- Private\Exceptions\AvmExceptions.ps1
- Engines\Terraform\Invoke-AvmTerraformTest.ps1
- Resources\mapotf\pre-commit\sort_variables.mptf.hcl
- Public\Invoke-AvmLint.ps1
- Private\Context\Read-AvmContextOverride.ps1
- Engines\Terraform\Invoke-AvmTerraformDocs.ps1
- Resources\mapotf\pre-commit\order_resource_attrs.mptf.hcl
- Public\Invoke-AvmTest.ps1
- Private\Context\Get-AvmModuleContextInternal.ps1