cosmos

package

v1.6.0 Latest Latest Go to latest Published: Apr 29, 2026 License: MIT Imports: 8 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/stackshy/cloudemu

Links

Open Source Insights

Documentation ¶

Overview ¶

Package cosmos implements the Azure Cosmos DB SQL data-plane REST API against a CloudEmu database driver. Real azure-sdk-for-go/sdk/data/azcosmos clients configured with a custom endpoint hit this handler the same way they hit {account}.documents.azure.com.

Supported operations (parity with AWS DynamoDB):

Databases:  POST /dbs, GET /dbs, GET /dbs/{db}, DELETE /dbs/{db}
Containers: POST /dbs/{db}/colls, GET /dbs/{db}/colls, GET .../{c}, DELETE .../{c}
Items:      POST /dbs/{db}/colls/{c}/docs   (also Query with x-ms-documentdb-isquery)
            GET .../docs, GET .../docs/{id}
            PUT .../docs/{id}, DELETE .../docs/{id}

The driver doesn't model Cosmos's database-level grouping, so we expose a single virtual database "cloudemu" that always exists and contains every driver table as a container.

Index ¶

type Handler
- func New(db dbdriver.Database) *Handler
- func (*Handler) Matches(r *http.Request) bool
- func (h *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Handler ¶

type Handler struct {
	// contains filtered or unexported fields
}

Handler serves Cosmos DB SQL API requests against a database driver.

func New ¶

func New(db dbdriver.Database) *Handler

New returns a Cosmos handler backed by db.

func (*Handler) Matches ¶

func (*Handler) Matches(r *http.Request) bool

Matches returns true for the Cosmos data plane URLs we serve: the account root probe (GET /) and the /dbs/... resource tree.

func (*Handler) ServeHTTP ¶

func (h *Handler) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP routes the request based on URL path shape.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL