A set of libraries for writing tests against Bicep files.
BicepTesting is an independent, non-official set of language-native testing libraries for Bicep infrastructure code. Each library supports credential-free offline snapshot evaluation and opt-in live Azure validation or deployment tests. Creating an offline session downloads the requested Bicep CLI version when it is not already cached, so first use may require network access; snapshot evaluation itself requires no Azure credentials or subscription.
Live sessions own Azure credentials and support three Deployment Stack scopes (resource group, subscription, and management group). Live tests compile a .bicepparam file, run Azure validation when requested, and deploy when needed so tests can assert outputs and managed resources. Validation returns scope-aware resources, correlation IDs, and structured errors. Deployment returns pre-submission failures as operation errors and post-submission Azure failures as failed results that still own cleanup. Cleanup deletes the stack and managed resources, is idempotent after successful deletion, and should run on both success and failure paths. Standard repository tests remain credential-free.
- Create a very thin unopinionated library that can easily be supported in multiple languages.
- Use Node as the semantic reference implementation while exposing equivalent behavior through each ecosystem's idioms.
- Allow simple assertions about predicted goal state (e.g. "all storage accounts must be zone-redundant").
- Support end-to-end assertions against real Azure resources with deterministic cleanup.
- Node 22 or later:
@anthony-c-martin/bicep-testing0.1.6 on npm - C# on .NET 10 or later:
AnthonyCMartin.BicepTesting0.1.6 on NuGet - Go 1.25 or later:
github.com/anthony-c-martin/bicep-testing/packages/go/bicep-testingv0.1.6 - PowerShell 7.6 or later:
AnthonyCMartin.BicepTesting0.1.6 on the PowerShell Gallery - Python 3.11 or later:
anthonycmartin-bicep-testing0.1.6 on PyPI
Lower-level Bicep CLI integrations are published as the Go bicep-rpc-client module at v0.1.6 and the Python anthonycmartin-bicep-rpc-client distribution at 0.1.6, imported as anthonycmartin.bicep_rpc_client.
Runnable test suites under samples/ demonstrate three credential-free snapshot scenarios and three opt-in live scenarios (validation, deployment, and reconciliation) with Jest, MSTest, Go's testing package, Pester, and pytest. Every language uses the same shared Bicep fixtures and equivalent assertions. Standard CI compiles or collects the samples without requiring Azure credentials or creating resources. See the sample instructions for the scenario catalog and the environment variables required to run the live tests.
See CONTRIBUTING.md for repository setup, build commands, tests, and project conventions.