configpig 0.1.0__tar.gz

configpig-0.1.0/.env.example

@@ -0,0 +1,2 @@
+CONFIGPIG_API_KEY=sk-api01-your-key-here
+CONFIGPIG_URL=https://configpig.com

configpig-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish package to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true

configpig-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+env/
+.env
+*.so
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/

configpig-0.1.0/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0 (2026-02-24)
+
+- Initial release
+- `Client` class with 19 API methods (configs, versions, fetch, labels, exports, health)
+- `get_config()` drop-in function with TTL caching
+- `configure()` for setting global defaults

configpig-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bright Wing Solutions LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

configpig-0.1.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: configpig
+Version: 0.1.0
+Summary: Python SDK for ConfigPig — managed config file registry for teams
+Project-URL: Homepage, https://configpig.com
+Project-URL: Repository, https://github.com/Brightwing-Systems-LLC/configpig-python
+Project-URL: Documentation, https://configpig.com/docs/sdks/python
+Project-URL: Bug Tracker, https://github.com/Brightwing-Systems-LLC/configpig-python/issues
+Project-URL: Changelog, https://github.com/Brightwing-Systems-LLC/configpig-python/blob/main/CHANGELOG.md
+Author-email: Bright Wing Solutions LLC <support@brightwingsolutions.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: config,configuration,json,sdk,toml,yaml
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24
+Description-Content-Type: text/markdown
+
+# ConfigPig — Python SDK
+
+Python SDK for [ConfigPig](https://configpig.com), a managed config file registry for teams.
+
+## Installation
+
+```bash
+pip install configpig
+```
+
+Or with uv:
+
+```bash
+uv add configpig
+```
+
+## Configuration
+
+Set environment variables or pass directly to the client:
+
+```bash
+export CONFIGPIG_API_KEY="sk-api01-your-key-here"
+export CONFIGPIG_URL="https://configpig.com"  # optional, this is the default
+```
+
+## Quick Start — `get_config()`
+
+The simplest way to use ConfigPig. One function, no boilerplate:
+
+```python
+from configpig import get_config
+
+# Fetch a config
+content = get_config("my-config")
+
+# With a specific label
+content = get_config("my-config", label="production")
+
+# With format conversion
+content = get_config("my-config", output_format="yaml")
+
+# With a fallback if the service is unreachable
+content = get_config("my-config", fallback='{"default": true}')
+
+# With TTL caching (seconds)
+content = get_config("my-config", ttl=300)
+```
+
+Set global defaults so you don't repeat yourself:
+
+```python
+import configpig
+
+configpig.configure(
+    api_key="sk-api01-...",
+    base_url="https://configpig.com",
+    default_label="latest",
+    default_ttl=300,
+)
+```
+
+## Using the Full Client
+
+For advanced use cases (creating configs, managing versions, labels, etc.):
+
+```python
+from configpig import Client
+
+client = Client()
+
+# List all configs
+result = client.list_configs()
+if result.ok:
+    for cfg in result.data:
+        print(f"{cfg.slug}: {cfg.name}")
+
+# Get a specific config
+result = client.get_config("my-config")
+if result.ok:
+    print(result.data.name)
+
+# Fetch config content with optional format conversion
+result = client.fetch("my-config", label="latest", output_format="yaml")
+if result.ok:
+    print(result.data.content)
+
+# Create a new config
+result = client.create_config(
+    name="App Settings",
+    slug="app-settings",
+    content='{"debug": false, "log_level": "info"}',
+    format="json",
+    tags=["app"],
+)
+
+# Create a new version
+result = client.create_version(
+    "app-settings",
+    content='{"debug": false, "log_level": "warn"}',
+    change_note="Changed log level to warn",
+)
+
+# Promote a version to a label
+result = client.promote("app-settings", version=2, label="production")
+```
+
+## API Reference
+
+All methods return `APIResponse[T]` with fields:
+- `ok: bool` — whether the request succeeded
+- `status_code: int` — HTTP status code
+- `data: T | None` — response data (when `ok` is True)
+- `error: str | None` — error message (when `ok` is False)
+
+### Configs
+
+| Method | Description |
+|---|---|
+| `list_configs(tag?, search?)` | List all configs |
+| `get_config(slug)` | Get config details |
+| `create_config(...)` | Create a new config |
+| `update_config(slug, ...)` | Update config metadata |
+| `delete_config(slug)` | Delete a config |
+
+### Versions
+
+| Method | Description |
+|---|---|
+| `list_versions(slug)` | List all versions |
+| `get_version(slug, version_number)` | Get specific version |
+| `create_version(slug, ...)` | Create a new version |
+
+### Fetch
+
+| Method | Description |
+|---|---|
+| `fetch(slug, label?, output_format?)` | Fetch config content with optional format conversion |
+
+### Labels
+
+| Method | Description |
+|---|---|
+| `list_labels()` | List team labels |
+| `create_label(name, ...)` | Create a team label |
+| `delete_label(name)` | Delete a team label |
+| `list_config_labels(slug)` | List labels for a config |
+| `assign_label(slug, label, version)` | Assign label to version |
+
+### Promote / Rollback
+
+| Method | Description |
+|---|---|
+| `promote(slug, version, label)` | Assign label to a version |
+| `rollback(slug, label)` | Rollback label to previous version |
+
+### Exports
+
+| Method | Description |
+|---|---|
+| `list_exports()` | List exports |
+| `create_export(name, ...)` | Create an export |
+| `get_export(export_id)` | Get export details |
+| `delete_export(export_id)` | Delete an export |
+
+### System
+
+| Method | Description |
+|---|---|
+| `health_check()` | Check API health |
+
+## License
+
+MIT — Bright Wing Solutions LLC

configpig-0.1.0/README.md

@@ -0,0 +1,173 @@
+# ConfigPig — Python SDK
+
+Python SDK for [ConfigPig](https://configpig.com), a managed config file registry for teams.
+
+## Installation
+
+```bash
+pip install configpig
+```
+
+Or with uv:
+
+```bash
+uv add configpig
+```
+
+## Configuration
+
+Set environment variables or pass directly to the client:
+
+```bash
+export CONFIGPIG_API_KEY="sk-api01-your-key-here"
+export CONFIGPIG_URL="https://configpig.com"  # optional, this is the default
+```
+
+## Quick Start — `get_config()`
+
+The simplest way to use ConfigPig. One function, no boilerplate:
+
+```python
+from configpig import get_config
+
+# Fetch a config
+content = get_config("my-config")
+
+# With a specific label
+content = get_config("my-config", label="production")
+
+# With format conversion
+content = get_config("my-config", output_format="yaml")
+
+# With a fallback if the service is unreachable
+content = get_config("my-config", fallback='{"default": true}')
+
+# With TTL caching (seconds)
+content = get_config("my-config", ttl=300)
+```
+
+Set global defaults so you don't repeat yourself:
+
+```python
+import configpig
+
+configpig.configure(
+    api_key="sk-api01-...",
+    base_url="https://configpig.com",
+    default_label="latest",
+    default_ttl=300,
+)
+```
+
+## Using the Full Client
+
+For advanced use cases (creating configs, managing versions, labels, etc.):
+
+```python
+from configpig import Client
+
+client = Client()
+
+# List all configs
+result = client.list_configs()
+if result.ok:
+    for cfg in result.data:
+        print(f"{cfg.slug}: {cfg.name}")
+
+# Get a specific config
+result = client.get_config("my-config")
+if result.ok:
+    print(result.data.name)
+
+# Fetch config content with optional format conversion
+result = client.fetch("my-config", label="latest", output_format="yaml")
+if result.ok:
+    print(result.data.content)
+
+# Create a new config
+result = client.create_config(
+    name="App Settings",
+    slug="app-settings",
+    content='{"debug": false, "log_level": "info"}',
+    format="json",
+    tags=["app"],
+)
+
+# Create a new version
+result = client.create_version(
+    "app-settings",
+    content='{"debug": false, "log_level": "warn"}',
+    change_note="Changed log level to warn",
+)
+
+# Promote a version to a label
+result = client.promote("app-settings", version=2, label="production")
+```
+
+## API Reference
+
+All methods return `APIResponse[T]` with fields:
+- `ok: bool` — whether the request succeeded
+- `status_code: int` — HTTP status code
+- `data: T | None` — response data (when `ok` is True)
+- `error: str | None` — error message (when `ok` is False)
+
+### Configs
+
+| Method | Description |
+|---|---|
+| `list_configs(tag?, search?)` | List all configs |
+| `get_config(slug)` | Get config details |
+| `create_config(...)` | Create a new config |
+| `update_config(slug, ...)` | Update config metadata |
+| `delete_config(slug)` | Delete a config |
+
+### Versions
+
+| Method | Description |
+|---|---|
+| `list_versions(slug)` | List all versions |
+| `get_version(slug, version_number)` | Get specific version |
+| `create_version(slug, ...)` | Create a new version |
+
+### Fetch
+
+| Method | Description |
+|---|---|
+| `fetch(slug, label?, output_format?)` | Fetch config content with optional format conversion |
+
+### Labels
+
+| Method | Description |
+|---|---|
+| `list_labels()` | List team labels |
+| `create_label(name, ...)` | Create a team label |
+| `delete_label(name)` | Delete a team label |
+| `list_config_labels(slug)` | List labels for a config |
+| `assign_label(slug, label, version)` | Assign label to version |
+
+### Promote / Rollback
+
+| Method | Description |
+|---|---|
+| `promote(slug, version, label)` | Assign label to a version |
+| `rollback(slug, label)` | Rollback label to previous version |
+
+### Exports
+
+| Method | Description |
+|---|---|
+| `list_exports()` | List exports |
+| `create_export(name, ...)` | Create an export |
+| `get_export(export_id)` | Get export details |
+| `delete_export(export_id)` | Delete an export |
+
+### System
+
+| Method | Description |
+|---|---|
+| `health_check()` | Check API health |
+
+## License
+
+MIT — Bright Wing Solutions LLC

configpig-0.1.0/pyproject.toml

@@ -0,0 +1,56 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "configpig"
+version = "0.1.0"
+description = "Python SDK for ConfigPig — managed config file registry for teams"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Bright Wing Solutions LLC", email = "support@brightwingsolutions.com" },
+]
+keywords = ["config", "configuration", "json", "yaml", "toml", "sdk"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "httpx>=0.24",
+]
+
+[project.urls]
+Homepage = "https://configpig.com"
+Repository = "https://github.com/Brightwing-Systems-LLC/configpig-python"
+Documentation = "https://configpig.com/docs/sdks/python"
+"Bug Tracker" = "https://github.com/Brightwing-Systems-LLC/configpig-python/issues"
+Changelog = "https://github.com/Brightwing-Systems-LLC/configpig-python/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/configpig"]
+
+[tool.bumpversion]
+current_version = "0.1.0"
+commit = true
+tag = true
+allow_dirty = true
+
+[[tool.bumpversion.files]]
+filename = "pyproject.toml"
+
+[[tool.bumpversion.files]]
+filename = "src/configpig/__init__.py"
+
+[dependency-groups]
+dev = [
+    "bump-my-version>=1.2.7",
+]

configpig-0.1.0/scripts/bump_version.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Usage: ./scripts/bump_version.sh [patch|minor|major]
+
+set -e
+
+VERSION_TYPE=${1:-patch}
+
+if [[ ! "$VERSION_TYPE" =~ ^(patch|minor|major)$ ]]; then
+    echo "Error: Version type must be 'patch', 'minor', or 'major'"
+    echo "Usage: $0 [patch|minor|major]"
+    exit 1
+fi
+
+echo "Bumping $VERSION_TYPE version..."
+
+source .venv/bin/activate
+bump-my-version bump "$VERSION_TYPE"
+
+echo "Version bump completed successfully!"
+echo "Don't forget to:"
+echo "1. Update CHANGELOG.md"
+echo "2. git add CHANGELOG.md && git commit -m 'Update changelog for version'"
+echo "3. git push origin main && git push origin --tags"

configpig-0.1.0/src/configpig/__init__.py

@@ -0,0 +1,34 @@
+"""ConfigPig — Python SDK for managing configs via API."""
+
+__version__ = "0.1.0"
+
+from .client import Client
+from .drop_in import configure, get_config
+from .types import (
+    APIResponse,
+    Config,
+    ConfigLabel,
+    ConfigSummary,
+    ConfigVersion,
+    Export,
+    FetchResult,
+    HealthCheck,
+    LabelInfo,
+    TeamLabel,
+)
+
+__all__ = [
+    "Client",
+    "configure",
+    "get_config",
+    "APIResponse",
+    "Config",
+    "ConfigLabel",
+    "ConfigSummary",
+    "ConfigVersion",
+    "Export",
+    "FetchResult",
+    "HealthCheck",
+    "LabelInfo",
+    "TeamLabel",
+]

configpig-0.1.0/src/configpig/_http.py

@@ -0,0 +1,103 @@
+"""HTTP transport layer with retry, logging, and connection pooling."""
+
+from __future__ import annotations
+
+import json
+import logging
+import time
+
+logger = logging.getLogger("configpig")
+
+_MAX_RETRIES = 2
+_INITIAL_BACKOFF = 0.5  # seconds; doubles each retry
+_USER_AGENT = "ConfigPig-Python/0.1.0"
+_LOG_PREFIX = "CONFIGPIG_UNSENT_REQUEST"
+
+_client = None
+
+
+def _get_client():
+    import httpx
+
+    global _client
+    if _client is None or _client.is_closed:
+        _client = httpx.Client(
+            timeout=httpx.Timeout(connect=5.0, read=15.0, write=10.0, pool=5.0),
+            headers={"User-Agent": _USER_AGENT},
+        )
+    return _client
+
+
+def _is_retryable(status_code: int) -> bool:
+    return status_code in (429, 500, 502, 503, 504)
+
+
+def _log_unsent(method: str, url: str, reason: str, body: dict | None = None) -> None:
+    logger.warning(
+        "%s method=%s url=%s reason=%s payload=%s",
+        _LOG_PREFIX,
+        method,
+        url,
+        reason,
+        json.dumps(body, separators=(",", ":")) if body else "null",
+    )
+
+
+def request(
+    method: str,
+    url: str,
+    *,
+    headers: dict | None = None,
+    json_body: dict | None = None,
+    params: dict | None = None,
+) -> tuple[int, dict | None]:
+    """Make an HTTP request with retry on transient failures.
+
+    Returns (status_code, parsed_json_or_None).
+    """
+    import httpx
+
+    client = _get_client()
+    last_err = None
+
+    for attempt in range(_MAX_RETRIES + 1):
+        try:
+            resp = client.request(
+                method,
+                url,
+                headers=headers,
+                json=json_body,
+                params=params,
+            )
+
+            if _is_retryable(resp.status_code) and attempt < _MAX_RETRIES:
+                logger.info(
+                    "Server returned %d, retrying (%d/%d)",
+                    resp.status_code,
+                    attempt + 1,
+                    _MAX_RETRIES,
+                )
+                time.sleep(_INITIAL_BACKOFF * (2**attempt))
+                continue
+
+            try:
+                data = resp.json()
+            except Exception:
+                data = None
+
+            return resp.status_code, data
+
+        except (httpx.ConnectError, httpx.TimeoutException, httpx.ReadTimeout) as e:
+            last_err = e
+            if attempt < _MAX_RETRIES:
+                logger.info(
+                    "Request failed (%s), retrying (%d/%d)",
+                    e,
+                    attempt + 1,
+                    _MAX_RETRIES,
+                )
+                time.sleep(_INITIAL_BACKOFF * (2**attempt))
+                continue
+
+    _log_unsent(method, url, f"unreachable:{last_err}", json_body)
+    return 0, None