Can I test my database logic without a live connection?

Absolutely. The skill provides detailed TDD requirements and ready-to-use pytest fixtures for mocking the Cosmos DB container and client modules.

Does this skill support the local Cosmos DB emulator?

Yes, it includes dual-authentication logic to switch between local emulator keys and Azure RBAC (DefaultAzureCredential) automatically based on the environment.

Is this optimized for FastAPI?

Yes, it includes async wrappers for the synchronous Cosmos SDK and Pydantic model patterns specifically designed to work seamlessly with FastAPI's event loop and JSON serialization.

How does it handle security?

It enforces the use of Managed Identities via DefaultAzureCredential for production to avoid storing secrets and mandates parameterized queries to prevent NoSQL injection.

Azure Cosmos DB Python Service

Name: Azure Cosmos DB Python Service
Author: sickn33

bysickn33

•

31,722

•

Database Management

Builds production-grade Azure Cosmos DB NoSQL services using clean architecture, RBAC security, and TDD principles.

This skill provides a standardized framework for implementing Azure Cosmos DB NoSQL services in Python, specifically optimized for FastAPI applications. It enforces industry best practices such as the singleton client pattern, five-tier Pydantic model separation, and secure authentication via DefaultAzureCredential. By integrating graceful degradation and comprehensive TDD patterns, it helps developers build resilient, scalable, and maintainable cloud-native data layers that adhere to enterprise security requirements and performance standards.

Key Features

0131,722 GitHub stars

02Standardized five-tier Pydantic model hierarchy for clean data separation.

03Automated TDD patterns and pytest fixtures for mocking Cosmos DB containers.

04Built-in support for parameterized queries and partition key validation.

05Singleton client initialization with async wrappers for non-blocking operations.

06Secure authentication using DefaultAzureCredential (RBAC) and local emulator support.

Use Cases

01Implementing a robust, testable data access layer for cloud-native Python microservices.

02Building a scalable backend for a SaaS application using FastAPI and Cosmos DB.

03Refactoring legacy database code to follow clean architecture and RBAC security standards.

Key Features

0131,722 GitHub stars

02Standardized five-tier Pydantic model hierarchy for clean data separation.

03Automated TDD patterns and pytest fixtures for mocking Cosmos DB containers.

04Built-in support for parameterized queries and partition key validation.

05Singleton client initialization with async wrappers for non-blocking operations.

06Secure authentication using DefaultAzureCredential (RBAC) and local emulator support.

Use Cases

01Implementing a robust, testable data access layer for cloud-native Python microservices.

02Building a scalable backend for a SaaS application using FastAPI and Cosmos DB.

03Refactoring legacy database code to follow clean architecture and RBAC security standards.