configvault-sdk 0.1.0__tar.gz

configvault_sdk-0.1.0/.gitignore

@@ -0,0 +1,487 @@
+## Ignore Visual Studio temporary files, build results, and
+## files generated by popular Visual Studio add-ons.
+##
+## Get latest from `dotnet new gitignore`
+
+# dotenv files
+.env
+
+# User-specific files
+*.rsuser
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# User-specific files (MonoDevelop/Xamarin Studio)
+*.userprefs
+
+# Mono auto generated files
+mono_crash.*
+
+# Build results
+[Dd]ebug/
+[Dd]ebugPublic/
+[Rr]elease/
+[Rr]eleases/
+x64/
+x86/
+[Ww][Ii][Nn]32/
+[Aa][Rr][Mm]/
+[Aa][Rr][Mm]64/
+bld/
+[Bb]in/
+[Oo]bj/
+[Ll]og/
+[Ll]ogs/
+
+# Visual Studio 2015/2017 cache/options directory
+.vs/
+# Uncomment if you have tasks that create the project's static files in wwwroot
+#wwwroot/
+
+# Visual Studio 2017 auto generated files
+Generated\ Files/
+
+# MSTest test Results
+[Tt]est[Rr]esult*/
+[Bb]uild[Ll]og.*
+
+# NUnit
+*.VisualState.xml
+TestResult.xml
+nunit-*.xml
+
+# Build Results of an ATL Project
+[Dd]ebugPS/
+[Rr]eleasePS/
+dlldata.c
+
+# Benchmark Results
+BenchmarkDotNet.Artifacts/
+
+# .NET
+project.lock.json
+project.fragment.lock.json
+artifacts/
+
+# Tye
+.tye/
+
+# ASP.NET Scaffolding
+ScaffoldingReadMe.txt
+
+# StyleCop
+StyleCopReport.xml
+
+# Files built by Visual Studio
+*_i.c
+*_p.c
+*_h.h
+*.ilk
+*.meta
+*.obj
+*.iobj
+*.pch
+*.pdb
+*.ipdb
+*.pgc
+*.pgd
+*.rsp
+*.sbr
+*.tlb
+*.tli
+*.tlh
+*.tmp
+*.tmp_proj
+*_wpftmp.csproj
+*.log
+*.tlog
+*.vspscc
+*.vssscc
+.builds
+*.pidb
+*.svclog
+*.scc
+
+# Chutzpah Test files
+_Chutzpah*
+
+# Visual C++ cache files
+ipch/
+*.aps
+*.ncb
+*.opendb
+*.opensdf
+*.sdf
+*.cachefile
+*.VC.db
+*.VC.VC.opendb
+
+# Visual Studio profiler
+*.psess
+*.vsp
+*.vspx
+*.sap
+
+# Visual Studio Trace Files
+*.e2e
+
+# TFS 2012 Local Workspace
+$tf/
+
+# Guidance Automation Toolkit
+*.gpState
+
+# ReSharper is a .NET coding add-in
+_ReSharper*/
+*.[Rr]e[Ss]harper
+*.DotSettings.user
+
+# TeamCity is a build add-in
+_TeamCity*
+
+# DotCover is a Code Coverage Tool
+*.dotCover
+
+# AxoCover is a Code Coverage Tool
+.axoCover/*
+!.axoCover/settings.json
+
+# Coverlet is a free, cross platform Code Coverage Tool
+coverage*.json
+coverage*.xml
+coverage*.info
+
+# Visual Studio code coverage results
+*.coverage
+*.coveragexml
+
+# NCrunch
+_NCrunch_*
+.*crunch*.local.xml
+nCrunchTemp_*
+
+# MightyMoose
+*.mm.*
+AutoTest.Net/
+
+# Web workbench (sass)
+.sass-cache/
+
+# Installshield output folder
+[Ee]xpress/
+
+# DocProject is a documentation generator add-in
+DocProject/buildhelp/
+DocProject/Help/*.HxT
+DocProject/Help/*.HxC
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/Html2
+DocProject/Help/html
+
+# Click-Once directory
+publish/
+
+# Publish Web Output
+*.[Pp]ublish.xml
+*.azurePubxml
+# Note: Comment the next line if you want to checkin your web deploy settings,
+# but database connection strings (with potential passwords) will be unencrypted
+*.pubxml
+*.publishproj
+
+# Microsoft Azure Web App publish settings. Comment the next line if you want to
+# checkin your Azure Web App publish settings, but sensitive information contained
+# in these scripts will be unencrypted
+PublishScripts/
+
+# NuGet Packages
+*.nupkg
+# NuGet Symbol Packages
+*.snupkg
+# The packages folder can be ignored because of Package Restore
+**/[Pp]ackages/*
+# except build/, which is used as an MSBuild target.
+!**/[Pp]ackages/build/
+# Uncomment if necessary however generally it will be regenerated when needed
+#!**/[Pp]ackages/repositories.config
+# NuGet v3's project.json files produces more ignorable files
+*.nuget.props
+*.nuget.targets
+
+# Microsoft Azure Build Output
+csx/
+*.build.csdef
+
+# Microsoft Azure Emulator
+ecf/
+rcf/
+
+# Windows Store app package directories and files
+AppPackages/
+BundleArtifacts/
+Package.StoreAssociation.xml
+_pkginfo.txt
+*.appx
+*.appxbundle
+*.appxupload
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!?*.[Cc]ache/
+
+# Others
+ClientBin/
+~$*
+*~
+*.dbmdl
+*.dbproj.schemaview
+*.jfm
+*.pfx
+*.publishsettings
+orleans.codegen.cs
+
+# Including strong name files can present a security risk
+# (https://github.com/github/gitignore/pull/2483#issue-259490424)
+#*.snk
+
+# Since there are multiple workflows, uncomment next line to ignore bower_components
+# (https://github.com/github/gitignore/pull/1529#issuecomment-104372622)
+#bower_components/
+
+# RIA/Silverlight projects
+Generated_Code/
+
+# Backup & report files from converting an old project file
+# to a newer Visual Studio version. Backup files are not needed,
+# because we have git ;-)
+_UpgradeReport_Files/
+Backup*/
+UpgradeLog*.XML
+UpgradeLog*.htm
+ServiceFabricBackup/
+*.rptproj.bak
+
+# SQL Server files
+*.mdf
+*.ldf
+*.ndf
+
+# Business Intelligence projects
+*.rdl.data
+*.bim.layout
+*.bim_*.settings
+*.rptproj.rsuser
+*- [Bb]ackup.rdl
+*- [Bb]ackup ([0-9]).rdl
+*- [Bb]ackup ([0-9][0-9]).rdl
+
+# Microsoft Fakes
+FakesAssemblies/
+
+# GhostDoc plugin setting file
+*.GhostDoc.xml
+
+# Node.js Tools for Visual Studio
+.ntvs_analysis.dat
+node_modules/
+dist/
+
+# Visual Studio 6 build log
+*.plg
+
+# Visual Studio 6 workspace options file
+*.opt
+
+# Visual Studio 6 auto-generated workspace file (contains which files were open etc.)
+*.vbw
+
+# Visual Studio 6 auto-generated project file (contains which files were open etc.)
+*.vbp
+
+# Visual Studio 6 workspace and project file (working project files containing files to include in project)
+*.dsw
+*.dsp
+
+# Visual Studio 6 technical files
+*.ncb
+*.aps
+
+# Visual Studio LightSwitch build output
+**/*.HTMLClient/GeneratedArtifacts
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+_Pvt_Extensions
+
+# Paket dependency manager
+.paket/paket.exe
+paket-files/
+
+# FAKE - F# Make
+.fake/
+
+# CodeRush personal settings
+.cr/personal
+
+# Python Tools for Visual Studio (PTVS)
+__pycache__/
+*.pyc
+
+# Cake - Uncomment if you are using it
+# tools/**
+# !tools/packages.config
+
+# Tabs Studio
+*.tss
+
+# Telerik's JustMock configuration file
+*.jmconfig
+
+# BizTalk build output
+*.btp.cs
+*.btm.cs
+*.odx.cs
+*.xsd.cs
+
+# OpenCover UI analysis results
+OpenCover/
+
+# Azure Stream Analytics local run output
+ASALocalRun/
+
+# MSBuild Binary and Structured Log
+*.binlog
+
+# NVidia Nsight GPU debugger configuration file
+*.nvuser
+
+# MFractors (Xamarin productivity tool) working folder
+.mfractor/
+
+# Local History for Visual Studio
+.localhistory/
+
+# Visual Studio History (VSHistory) files
+.vshistory/
+
+# BeatPulse healthcheck temp database
+healthchecksdb
+
+# Backup folder for Package Reference Convert tool in Visual Studio 2017
+MigrationBackup/
+
+# Ionide (cross platform F# VS Code tools) working folder
+.ionide/
+
+# Fody - auto-generated XML schema
+FodyWeavers.xsd
+
+# VS Code files for those working on multiple tools
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+*.code-workspace
+
+# Local History for Visual Studio Code
+.history/
+
+# Windows Installer files from build outputs
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# JetBrains Rider
+*.sln.iml
+.idea/
+
+##
+## Visual studio for Mac
+##
+
+
+# globs
+Makefile.in
+*.userprefs
+*.usertasks
+config.make
+config.status
+aclocal.m4
+install-sh
+autom4te.cache/
+*.tar.gz
+tarballs/
+test-results/
+
+# Mac bundle stuff
+*.dmg
+*.app
+
+# content below from: https://github.com/github/gitignore/blob/main/Global/macOS.gitignore
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# content below from: https://github.com/github/gitignore/blob/main/Global/Windows.gitignore
+# Windows thumbnail cache files
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# Vim temporary swap files
+*.swp
+
+.worktrees

configvault_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: configvault-sdk
+Version: 0.1.0
+Summary: Python SDK for ConfigVault API
+Project-URL: Homepage, https://github.com/sitien173/config-vault
+Project-URL: Repository, https://github.com/sitien173/config-vault
+Project-URL: Issues, https://github.com/sitien173/config-vault/issues
+Author: nst173
+License-Expression: MIT
+Keywords: config,configvault,sdk,vault
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx-sse>=0.4.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# ConfigVault Python SDK
+
+Python client for the ConfigVault configuration management API.
+
+## Installation
+
+```bash
+pip install configvault-sdk
+```
+
+## Usage
+
+```python
+from configvault import ConfigVaultClient
+
+client = ConfigVaultClient(
+    base_url="http://localhost:5000",
+    api_key="your-api-key"
+)
+
+# Get a configuration value
+value = await client.get("production/database/connection")
+
+# Check if key exists
+exists = await client.exists("production/database/connection")
+
+# List all configs in namespace
+configs = await client.list("production")
+
+# Check service health
+health = await client.health()
+```
+
+## Watching for Changes
+
+```python
+from configvault import ConfigVaultClient
+
+client = ConfigVaultClient(
+    base_url="http://localhost:5000",
+    api_key="your-api-key"
+)
+
+# Watch all changes
+watcher = client.watch()
+
+# Or filter by pattern
+watcher = client.watch("production/*")
+
+async for event in watcher.watch():
+    print(f"Changed keys: {event.keys}")
+    print(f"Timestamp: {event.timestamp}")
+
+# Stop watching
+watcher.stop()
+```

configvault_sdk-0.1.0/README.md

@@ -0,0 +1,56 @@
+# ConfigVault Python SDK
+
+Python client for the ConfigVault configuration management API.
+
+## Installation
+
+```bash
+pip install configvault-sdk
+```
+
+## Usage
+
+```python
+from configvault import ConfigVaultClient
+
+client = ConfigVaultClient(
+    base_url="http://localhost:5000",
+    api_key="your-api-key"
+)
+
+# Get a configuration value
+value = await client.get("production/database/connection")
+
+# Check if key exists
+exists = await client.exists("production/database/connection")
+
+# List all configs in namespace
+configs = await client.list("production")
+
+# Check service health
+health = await client.health()
+```
+
+## Watching for Changes
+
+```python
+from configvault import ConfigVaultClient
+
+client = ConfigVaultClient(
+    base_url="http://localhost:5000",
+    api_key="your-api-key"
+)
+
+# Watch all changes
+watcher = client.watch()
+
+# Or filter by pattern
+watcher = client.watch("production/*")
+
+async for event in watcher.watch():
+    print(f"Changed keys: {event.keys}")
+    print(f"Timestamp: {event.timestamp}")
+
+# Stop watching
+watcher.stop()
+```

configvault_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "configvault-sdk"
+version = "0.1.0"
+description = "Python SDK for ConfigVault API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "nst173" }]
+keywords = ["configvault", "config", "vault", "sdk"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+urls = { Homepage = "https://github.com/sitien173/config-vault", Repository = "https://github.com/sitien173/config-vault", Issues = "https://github.com/sitien173/config-vault/issues" }
+dependencies = [
+    "httpx>=0.27.0",
+    "httpx-sse>=0.4.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.23.0",
+    "respx>=0.21.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/configvault"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

configvault_sdk-0.1.0/src/configvault/__init__.py

@@ -0,0 +1,25 @@
+"""ConfigVault Python SDK."""
+
+from configvault.client import ConfigVaultClient
+from configvault.models import ConfigResponse, ConfigListResponse, HealthResponse
+from configvault.exceptions import (
+    ConfigVaultError,
+    ConfigNotFoundError,
+    AuthenticationError,
+    ServiceUnavailableError,
+)
+from configvault.watcher import ConfigWatcher, ConfigChangedEvent
+
+__version__ = "0.1.0"
+__all__ = [
+    "ConfigVaultClient",
+    "ConfigResponse",
+    "ConfigListResponse",
+    "HealthResponse",
+    "ConfigVaultError",
+    "ConfigNotFoundError",
+    "AuthenticationError",
+    "ServiceUnavailableError",
+    "ConfigWatcher",
+    "ConfigChangedEvent",
+]

configvault_sdk-0.1.0/src/configvault/client.py

@@ -0,0 +1,165 @@
+"""ConfigVault API client."""
+
+from typing import Optional
+
+import httpx
+
+from configvault.exceptions import (
+    AuthenticationError,
+    ConfigNotFoundError,
+    ConfigVaultError,
+    ServiceUnavailableError,
+)
+from configvault.models import ConfigListResponse, ConfigResponse, HealthResponse
+
+
+class ConfigVaultClient:
+    """Async client for ConfigVault API."""
+
+    def __init__(
+        self,
+        base_url: str,
+        api_key: str,
+        timeout: float = 30.0,
+    ) -> None:
+        """
+        Initialize the ConfigVault client.
+
+        Args:
+            base_url: Base URL of the ConfigVault API (e.g., "http://localhost:5000")
+            api_key: API key for authentication
+            timeout: Request timeout in seconds
+        """
+        self._base_url = base_url.rstrip("/")
+        self._api_key = api_key
+        self._timeout = timeout
+        self._client: Optional[httpx.AsyncClient] = None
+
+    async def _get_client(self) -> httpx.AsyncClient:
+        """Get or create the HTTP client."""
+        if self._client is None or self._client.is_closed:
+            self._client = httpx.AsyncClient(
+                base_url=self._base_url,
+                headers={"X-Api-Key": self._api_key},
+                timeout=self._timeout,
+            )
+        return self._client
+
+    async def close(self) -> None:
+        """Close the HTTP client."""
+        if self._client is not None:
+            await self._client.aclose()
+            self._client = None
+
+    async def __aenter__(self) -> "ConfigVaultClient":
+        """Async context manager entry."""
+        return self
+
+    async def __aexit__(self, *args) -> None:
+        """Async context manager exit."""
+        await self.close()
+
+    def watch(self, filter_pattern: str | None = None) -> "ConfigWatcher":
+        """
+        Create a watcher for configuration changes.
+
+        Args:
+            filter_pattern: Optional glob pattern to filter keys (e.g., "production/*")
+
+        Returns:
+            ConfigWatcher instance for async iteration
+        """
+        from configvault.watcher import ConfigWatcher
+
+        return ConfigWatcher(
+            base_url=self._base_url,
+            api_key=self._api_key,
+            filter_pattern=filter_pattern,
+        )
+
+    def _handle_error_response(self, response: httpx.Response, key: Optional[str] = None) -> None:
+        """Handle error responses from the API."""
+        if response.status_code == 401:
+            raise AuthenticationError()
+        if response.status_code == 404 and key:
+            raise ConfigNotFoundError(key)
+        if response.status_code == 503:
+            raise ServiceUnavailableError()
+        if response.status_code >= 400:
+            raise ConfigVaultError(f"API error: {response.status_code}")
+
+    async def get(self, key: str) -> str:
+        """
+        Get a configuration value by key.
+
+        Args:
+            key: Hierarchical key (e.g., "production/database/connection")
+
+        Returns:
+            The configuration value
+
+        Raises:
+            ConfigNotFoundError: If the key does not exist
+            AuthenticationError: If the API key is invalid
+            ServiceUnavailableError: If the service is unavailable
+        """
+        client = await self._get_client()
+        response = await client.get(f"/config/{key}")
+
+        self._handle_error_response(response, key)
+
+        data = ConfigResponse.model_validate(response.json())
+        return data.value
+
+    async def exists(self, key: str) -> bool:
+        """
+        Check if a configuration key exists.
+
+        Args:
+            key: Hierarchical key to check
+
+        Returns:
+            True if the key exists, False otherwise
+        """
+        client = await self._get_client()
+        response = await client.head(f"/config/{key}")
+
+        if response.status_code == 404:
+            return False
+        if response.status_code == 401:
+            raise AuthenticationError()
+        if response.status_code == 503:
+            raise ServiceUnavailableError()
+
+        return response.status_code == 200
+
+    async def list(self, namespace: str) -> dict[str, str]:
+        """
+        List all configurations in a namespace.
+
+        Args:
+            namespace: The namespace (folder) to list
+
+        Returns:
+            Dictionary mapping keys to values
+        """
+        client = await self._get_client()
+        response = await client.get("/config", params={"prefix": namespace})
+
+        self._handle_error_response(response)
+
+        data = ConfigListResponse.model_validate(response.json())
+        return data.configs
+
+    async def health(self) -> HealthResponse:
+        """
+        Check the health of the ConfigVault service.
+
+        Returns:
+            Health status information
+        """
+        client = await self._get_client()
+        # Health endpoint doesn't require API key, but we send it anyway
+        response = await client.get("/health")
+
+        return HealthResponse.model_validate(response.json())

configvault_sdk-0.1.0/src/configvault/exceptions.py

@@ -0,0 +1,29 @@
+"""ConfigVault SDK exceptions."""
+
+
+class ConfigVaultError(Exception):
+    """Base exception for ConfigVault SDK."""
+
+    pass
+
+
+class ConfigNotFoundError(ConfigVaultError):
+    """Raised when a configuration key is not found."""
+
+    def __init__(self, key: str) -> None:
+        self.key = key
+        super().__init__(f"Configuration key '{key}' not found")
+
+
+class AuthenticationError(ConfigVaultError):
+    """Raised when API key authentication fails."""
+
+    def __init__(self, message: str = "Invalid or missing API key") -> None:
+        super().__init__(message)
+
+
+class ServiceUnavailableError(ConfigVaultError):
+    """Raised when the ConfigVault service is unavailable."""
+
+    def __init__(self, message: str = "ConfigVault service unavailable") -> None:
+        super().__init__(message)

configvault_sdk-0.1.0/src/configvault/models.py

@@ -0,0 +1,27 @@
+"""ConfigVault SDK models."""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class ConfigResponse(BaseModel):
+    """Response model for a single configuration value."""
+
+    key: str
+    value: str
+
+
+class ConfigListResponse(BaseModel):
+    """Response model for listing configurations."""
+
+    namespace: str = Field(alias="namespace")
+    configs: dict[str, str]
+
+
+class HealthResponse(BaseModel):
+    """Response model for health check."""
+
+    status: str
+    vault: str
+    timestamp: datetime

configvault_sdk-0.1.0/src/configvault/watcher.py

@@ -0,0 +1,94 @@
+"""Configuration change watcher using SSE."""
+
+from collections.abc import AsyncIterator
+from dataclasses import dataclass
+from datetime import datetime
+import asyncio
+import json
+
+import httpx
+from httpx_sse import aconnect_sse
+
+from configvault.exceptions import AuthenticationError, ServiceUnavailableError
+
+
+@dataclass
+class ConfigChangedEvent:
+    """Event emitted when configuration changes are detected."""
+
+    keys: list[str]
+    timestamp: datetime
+
+
+class ConfigWatcher:
+    """Watches for configuration changes via SSE."""
+
+    def __init__(
+        self,
+        base_url: str,
+        api_key: str,
+        filter_pattern: str | None = None,
+        reconnect_delay: float = 5.0,
+    ) -> None:
+        """
+        Initialize the watcher.
+
+        Args:
+            base_url: Base URL of the ConfigVault API.
+            api_key: API key for authentication.
+            filter_pattern: Optional glob pattern to filter keys.
+            reconnect_delay: Delay before reconnecting after a failure.
+        """
+        self._base_url = base_url.rstrip("/")
+        self._api_key = api_key
+        self._filter_pattern = filter_pattern
+        self._reconnect_delay = reconnect_delay
+        self._running = False
+
+    async def watch(self) -> AsyncIterator[ConfigChangedEvent]:
+        """
+        Watch for configuration changes.
+
+        Yields:
+            ConfigChangedEvent instances when changes are detected.
+        """
+        self._running = True
+
+        while self._running:
+            try:
+                async for event in self._connect():
+                    yield event
+            except httpx.HTTPStatusError as exc:
+                if exc.response.status_code == 401:
+                    raise AuthenticationError() from exc
+                if exc.response.status_code == 503:
+                    raise ServiceUnavailableError() from exc
+                raise
+            except (httpx.ConnectError, httpx.ReadError):
+                if self._running:
+                    await asyncio.sleep(self._reconnect_delay)
+
+    async def _connect(self) -> AsyncIterator[ConfigChangedEvent]:
+        """Connect to the SSE endpoint and yield events."""
+        url = f"{self._base_url}/events"
+        if self._filter_pattern:
+            url += f"?filter={self._filter_pattern}"
+
+        async with httpx.AsyncClient() as client:
+            async with aconnect_sse(
+                client,
+                "GET",
+                url,
+                headers={"X-Api-Key": self._api_key},
+            ) as event_source:
+                async for sse in event_source.aiter_sse():
+                    if sse.event == "config-changed":
+                        data = json.loads(sse.data)
+                        timestamp = datetime.fromisoformat(
+                            data["timestamp"].replace("Z", "+00:00")
+                        )
+                        yield ConfigChangedEvent(keys=data["keys"], timestamp=timestamp)
+
+    def stop(self) -> None:
+        """Stop watching for changes."""
+        self._running = False

configvault_sdk-0.1.0/tests/test_client.py

@@ -0,0 +1,129 @@
+"""Tests for ConfigVault client."""
+
+import httpx
+import pytest
+import respx
+
+from configvault import (
+    AuthenticationError,
+    ConfigNotFoundError,
+    ConfigVaultClient,
+    ServiceUnavailableError,
+)
+
+
+@pytest.fixture
+def base_url() -> str:
+    return "http://localhost:5000"
+
+
+@pytest.fixture
+def api_key() -> str:
+    return "test-api-key"
+
+
+class TestConfigVaultClient:
+    @respx.mock
+    async def test_get_returns_value(self, base_url: str, api_key: str) -> None:
+        respx.get(f"{base_url}/config/prod/db/host").mock(
+            return_value=httpx.Response(
+                200,
+                json={"key": "prod/db/host", "value": "localhost"},
+            )
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            value = await client.get("prod/db/host")
+
+        assert value == "localhost"
+
+    @respx.mock
+    async def test_get_raises_not_found(self, base_url: str, api_key: str) -> None:
+        respx.get(f"{base_url}/config/unknown/key").mock(
+            return_value=httpx.Response(404, json={"error": "Not found"})
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            with pytest.raises(ConfigNotFoundError) as exc:
+                await client.get("unknown/key")
+
+        assert exc.value.key == "unknown/key"
+
+    @respx.mock
+    async def test_get_raises_auth_error(self, base_url: str, api_key: str) -> None:
+        respx.get(f"{base_url}/config/prod/key").mock(
+            return_value=httpx.Response(401, json={"error": "Unauthorized"})
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            with pytest.raises(AuthenticationError):
+                await client.get("prod/key")
+
+    @respx.mock
+    async def test_exists_returns_true(self, base_url: str, api_key: str) -> None:
+        respx.head(f"{base_url}/config/prod/db/host").mock(
+            return_value=httpx.Response(200)
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            exists = await client.exists("prod/db/host")
+
+        assert exists is True
+
+    @respx.mock
+    async def test_exists_returns_false(self, base_url: str, api_key: str) -> None:
+        respx.head(f"{base_url}/config/unknown/key").mock(
+            return_value=httpx.Response(404)
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            exists = await client.exists("unknown/key")
+
+        assert exists is False
+
+    @respx.mock
+    async def test_list_returns_configs(self, base_url: str, api_key: str) -> None:
+        respx.get(f"{base_url}/config", params={"prefix": "production"}).mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "namespace": "production",
+                    "configs": {"db/host": "localhost", "db/port": "5432"},
+                },
+            )
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            configs = await client.list("production")
+
+        assert configs["db/host"] == "localhost"
+        assert configs["db/port"] == "5432"
+
+    @respx.mock
+    async def test_health_returns_status(self, base_url: str, api_key: str) -> None:
+        respx.get(f"{base_url}/health").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "status": "healthy",
+                    "vault": "unlocked",
+                    "timestamp": "2026-02-02T12:00:00Z",
+                },
+            )
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            health = await client.health()
+
+        assert health.status == "healthy"
+        assert health.vault == "unlocked"
+
+    @respx.mock
+    async def test_service_unavailable(self, base_url: str, api_key: str) -> None:
+        respx.get(f"{base_url}/config/prod/key").mock(
+            return_value=httpx.Response(503, json={"error": "Service unavailable"})
+        )
+
+        async with ConfigVaultClient(base_url, api_key) as client:
+            with pytest.raises(ServiceUnavailableError):
+                await client.get("prod/key")

configvault_sdk-0.1.0/tests/test_models.py

@@ -0,0 +1,76 @@
+"""Tests for ConfigVault models and exceptions."""
+
+from datetime import datetime, timezone
+
+import pytest
+
+from configvault.exceptions import (
+    AuthenticationError,
+    ConfigNotFoundError,
+    ServiceUnavailableError,
+)
+from configvault.models import ConfigResponse, ConfigListResponse, HealthResponse
+
+
+class TestConfigResponse:
+    def test_create_from_dict(self) -> None:
+        data = {"key": "prod/db/host", "value": "localhost"}
+        response = ConfigResponse.model_validate(data)
+
+        assert response.key == "prod/db/host"
+        assert response.value == "localhost"
+
+
+class TestConfigListResponse:
+    def test_create_from_dict(self) -> None:
+        data = {
+            "namespace": "production",
+            "configs": {"db/host": "localhost", "db/port": "5432"},
+        }
+        response = ConfigListResponse.model_validate(data)
+
+        assert response.namespace == "production"
+        assert response.configs["db/host"] == "localhost"
+        assert len(response.configs) == 2
+
+
+class TestHealthResponse:
+    def test_create_from_dict(self) -> None:
+        data = {
+            "status": "healthy",
+            "vault": "unlocked",
+            "timestamp": "2026-02-02T12:00:00Z",
+        }
+        response = HealthResponse.model_validate(data)
+
+        assert response.status == "healthy"
+        assert response.vault == "unlocked"
+
+    def test_timestamp_parses_to_datetime(self) -> None:
+        data = {
+            "status": "healthy",
+            "vault": "unlocked",
+            "timestamp": "2026-02-02T12:00:00Z",
+        }
+        response = HealthResponse.model_validate(data)
+
+        assert isinstance(response.timestamp, datetime)
+        assert response.timestamp.tzinfo is not None
+        assert response.timestamp == datetime(2026, 2, 2, 12, 0, 0, tzinfo=timezone.utc)
+
+
+class TestExceptions:
+    def test_config_not_found_error_message(self) -> None:
+        error = ConfigNotFoundError("prod/missing")
+
+        assert str(error) == "Configuration key 'prod/missing' not found"
+
+    def test_authentication_error_default_message(self) -> None:
+        error = AuthenticationError()
+
+        assert str(error) == "Invalid or missing API key"
+
+    def test_service_unavailable_error_default_message(self) -> None:
+        error = ServiceUnavailableError()
+
+        assert str(error) == "ConfigVault service unavailable"

configvault_sdk-0.1.0/tests/test_watcher.py

@@ -0,0 +1,48 @@
+"""Tests for ConfigWatcher."""
+
+from datetime import datetime, timezone
+
+from configvault import ConfigVaultClient
+from configvault.watcher import ConfigChangedEvent, ConfigWatcher
+
+
+class TestConfigWatcher:
+    def test_creates_with_filter(self) -> None:
+        watcher = ConfigWatcher(
+            base_url="http://localhost:5000",
+            api_key="test-key",
+            filter_pattern="production/*",
+        )
+
+        assert watcher._filter_pattern == "production/*"
+        assert watcher._running is False
+
+    def test_stop_sets_running_false(self) -> None:
+        watcher = ConfigWatcher(
+            base_url="http://localhost:5000",
+            api_key="test-key",
+        )
+        watcher._running = True
+
+        watcher.stop()
+
+        assert watcher._running is False
+
+    def test_client_watch_returns_watcher(self) -> None:
+        client = ConfigVaultClient("http://localhost:5000", "test-key")
+
+        watcher = client.watch("production/*")
+
+        assert isinstance(watcher, ConfigWatcher)
+        assert watcher._filter_pattern == "production/*"
+
+
+class TestConfigChangedEvent:
+    def test_creates_event(self) -> None:
+        event = ConfigChangedEvent(
+            keys=["prod/db/host", "prod/db/port"],
+            timestamp=datetime(2026, 2, 2, 12, 0, 0, tzinfo=timezone.utc),
+        )
+
+        assert len(event.keys) == 2
+        assert "prod/db/host" in event.keys