The cosmosdb-go-sdk-helper is a simple package for the Azure Cosmos DB Go SDK, providing convenience functions for various operations like database/container interactions and querying.
It offers packages like auth for authentication, common for database/container operations, query for generic query helpers, functions for parsing Azure Functions Cosmos DB trigger payloads, and cosmosdb_errors for structured error information.
The authentication package simplifies the process of obtaining an authenticated Cosmos DB client handle for both production and local development environments.
The common package allows creating databases and containers only if they don't exist, facilitating resource management in CI/CD pipelines.
The query package provides type-safe query helpers, eliminating manual unmarshalling and reducing boilerplate code.
Queries with metrics can be executed using the metrics package, with functions for parsing metrics string and index metrics.
For Azure Functions using Cosmos DB triggers, the functions/trigger package simplifies parsing trigger payloads into usable formats like []map[string]any or raw JSON strings.
The cosmosdb_errors package extracts status code and message from Cosmos DB SDK errors for easier downstream handling.
Overall, cosmosdb-go-sdk-helper aims to reduce boilerplate code in Azure Cosmos DB operations, with plans for gradual improvements and additions in the future.
Users are encouraged to provide feedback and suggestions for enhancing the package by opening issues in the repository.