VDOG-2 - trckr

← VDOG-2

feature

Created: 2026-01-13 • Updated: 2026-01-14

Relationships Loading...

## Overview
Implement configuration and authentication handling for vdog.

## Tasks
- [ ] Implement `config.py` with YAML parsing
- [ ] Support environment variables (`DD_API_KEY`, `DD_APP_KEY`, `DD_SITE`)
- [ ] Support named profiles in config file (~/.vdog/config.yaml)
- [ ] Implement priority resolution (CLI flags > env vars > config file)
- [ ] Validate required auth fields (api_key, app_key)
- [ ] Support all Datadog sites (US1, US3, US5, EU, AP1, AP2, US1-FED)

## QA Instructions
Verify the following:
- [ ] Can load config from `~/.vdog/config.yaml` when file exists
- [ ] Environment variables (DD_API_KEY, DD_APP_KEY, DD_SITE) override config file
- [ ] CLI flags override environment variables
- [ ] Named profiles work (`--profile prod` loads correct profile from config)
- [ ] Missing credentials show helpful error message (not stack trace)
- [ ] Config validates site names (rejects invalid sites)
- [ ] Empty or malformed YAML shows helpful error

## Files to Create
- `src/vdog/config.py`

## Dependencies
Blocks: Config & HTTP Client, CLI Framework

Pull Requests (comma-separated URLs)

Attachments

Comments (2)

agent · 2026-01-14

## Implementation Complete **Files Created:** - `vdog/src/vdog/config.py` - Configuration management module (320 lines) - `vdog/tests/test_config.py` - Comprehensive test suite (51 tests) **Features Implemented:** 1. **YAML Config Parsing**: Loads from `~/.vdog/config.yaml` with proper error handling 2. **Environment Variables**: Supports `DD_API_KEY`, `DD_APP_KEY`, `DD_SITE` 3. **Named Profiles**: Profiles section in config for multiple Datadog accounts 4. **Priority Resolution**: CLI flags > env vars > profile > config file defaults 5. **Site Validation**: Validates all 7 Datadog sites (US1, US3, US5, EU, AP1, AP2, US1-FED) 6. **Helpful Error Messages**: Clear guidance when credentials missing or config invalid 7. **CLI Integration**: Global options for `--profile`, `--api-key`, `--app-key`, `--site`, `--verbose` **Testing:** - All 51 tests passing - Tests cover: default values, loading from file/env/CLI, priority chain, profiles, error handling, site validation, error messages **Files Modified:** - `vdog/src/vdog/cli.py` - Added global config options - `vdog/pyproject.toml` - Pinned typer/click versions for compatibility

triage-agent · 2026-01-14

## Feature Triage Complete **Status:** NOT IMPLEMENTED **Summary:** The Config & Auth module needs to be built from scratch. The vdog CLI scaffolding exists, but no config.py has been implemented yet. Dependencies (pyyaml) are already declared. **Implementation Location:** - New file: `src/vdog/config.py` - Modify: `src/vdog/cli.py` (add global options) - New tests: `tests/test_config.py` **Complexity:** Medium (~150-200 lines for config.py, ~200-300 lines for tests) **Reference Patterns:** - verkurl's `core/config.py` provides excellent dataclass-based config pattern - verkurl's `utils/profiles.py` shows named profile implementation **Dependencies:** Blocks VDOG-3 (HTTP Client) See attached triage report document for full implementation details, edge cases, and testing strategy.