vendor-fabric 2.1.3__tar.gz

vendor_fabric-2.1.3/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+.coverage
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.tox/
+.venv/
+build/
+dist/
+htmlcov/
+*.egg-info/
+__pycache__/
+*.py[cod]
+docs/_build/
+docs/apidocs/

vendor_fabric-2.1.3/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+## [2.1.3](https://github.com/jbcom/vendor-fabric/compare/vendor-fabric-v2.1.2...vendor-fabric-v2.1.3) (2026-07-01)
+
+
+### Bug Fixes
+
+* align SecretSync binding session facade ([089ce7c](https://github.com/jbcom/vendor-fabric/commit/089ce7c3874a50f16ee7d84c75f8a84bda121f12))
+
+## [2.1.2](https://github.com/jbcom/vendor-fabric/compare/vendor-fabric-v2.1.1...vendor-fabric-v2.1.2) (2026-06-27)
+
+
+### Bug Fixes
+
+* align PyPI trusted publishing claim ([5c56532](https://github.com/jbcom/vendor-fabric/commit/5c56532169179e1899143389a7658e89e3772d6d))
+
+## [2.1.1](https://github.com/jbcom/vendor-fabric/compare/vendor-fabric-v2.1.0...vendor-fabric-v2.1.1) (2026-06-27)
+
+
+### Bug Fixes
+
+* keep release lock version in sync ([5f437a5](https://github.com/jbcom/vendor-fabric/commit/5f437a5384b7b66968e6adac9c1b36274c8ebaf6))
+
+## [2.1.0](https://github.com/jbcom/vendor-fabric/compare/vendor-fabric-v2.0.0...vendor-fabric-v2.1.0) (2026-06-27)
+
+
+### Features
+
+* consolidate vendor fabric sync and agentic surfaces ([ef1a4dd](https://github.com/jbcom/vendor-fabric/commit/ef1a4dd66c269b259ee5c98dfd096909cca61eb7))
+
+## Changelog
+
+This repository uses release-please for versioning and changelog generation.

vendor_fabric-2.1.3/PKG-INFO

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: vendor-fabric
+Version: 2.1.3
+Summary: Extended Data-native vendor connectors and sync capabilities
+Project-URL: Documentation, https://jonbogaty.com/vendor-fabric/
+Project-URL: Issues, https://github.com/jbcom/vendor-fabric/issues
+Project-URL: Source, https://github.com/jbcom/vendor-fabric
+Project-URL: Changelog, https://github.com/jbcom/vendor-fabric/blob/main/packages/vendor-fabric/CHANGELOG.md
+Author-email: Jon Bogaty <jon@jonbogaty.com>
+Maintainer-email: Jon Bogaty <jon@jonbogaty.com>
+License: MIT
+Keywords: aws,connectors,gcp,github,meshy,secrets,slack,vault,zoom
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: extended-data<9.0.0,>=8.4.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: more-itertools>=11.0.2
+Requires-Dist: pydantic<3.0.0,>=2.13.4
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: requests>=2.33.1
+Requires-Dist: tenacity<10.0.0,>=8.4.1
+Provides-Extra: all
+Requires-Dist: anthropic>=0.96.0; extra == 'all'
+Requires-Dist: boto3>=1.42.92; extra == 'all'
+Requires-Dist: fastapi>=0.136.0; extra == 'all'
+Requires-Dist: filelock>=3.29.0; extra == 'all'
+Requires-Dist: google-api-python-client>=2.194.0; extra == 'all'
+Requires-Dist: google-cloud-billing>=1.19.0; extra == 'all'
+Requires-Dist: google-cloud-resource-manager>=1.17.0; extra == 'all'
+Requires-Dist: hvac>=2.4.0; extra == 'all'
+Requires-Dist: numpy>=2.2.6; extra == 'all'
+Requires-Dist: pygithub>=2.9.1; extra == 'all'
+Requires-Dist: pyngrok>=8.0.0; extra == 'all'
+Requires-Dist: python-graphql-client>=0.4.3; extra == 'all'
+Requires-Dist: rich<16.0.0,>=13.7.0; extra == 'all'
+Requires-Dist: slack-sdk>=3.41.0; extra == 'all'
+Requires-Dist: sqlite-vec>=0.1.9; extra == 'all'
+Requires-Dist: starlette>=1.3.1; extra == 'all'
+Requires-Dist: uvicorn>=0.45.0; extra == 'all'
+Requires-Dist: validators>=0.35.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.96.0; extra == 'anthropic'
+Provides-Extra: aws
+Requires-Dist: boto3>=1.42.92; extra == 'aws'
+Provides-Extra: cursor
+Provides-Extra: dev
+Requires-Dist: coverage[toml]>=7.6.0; extra == 'dev'
+Requires-Dist: hypothesis>=6.100.2; extra == 'dev'
+Requires-Dist: mypy>=1.20.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.15.1; extra == 'dev'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'dev'
+Requires-Dist: pytest>=9.0.3; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12.20240724; extra == 'dev'
+Requires-Dist: types-requests>=2.33.0.20260408; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: furo>=2025.12.19; extra == 'docs'
+Requires-Dist: myst-parser<6.0.0,>=4.0.1; extra == 'docs'
+Requires-Dist: sphinx-autodoc2>=0.5.0; extra == 'docs'
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == 'docs'
+Requires-Dist: sphinx<10.0.0,>=8.2.3; extra == 'docs'
+Provides-Extra: github
+Requires-Dist: pygithub>=2.9.1; extra == 'github'
+Requires-Dist: python-graphql-client>=0.4.3; extra == 'github'
+Provides-Extra: google
+Requires-Dist: google-api-python-client>=2.194.0; extra == 'google'
+Requires-Dist: google-cloud-billing>=1.19.0; extra == 'google'
+Requires-Dist: google-cloud-resource-manager>=1.17.0; extra == 'google'
+Provides-Extra: meshy
+Requires-Dist: filelock>=3.29.0; extra == 'meshy'
+Requires-Dist: numpy>=2.2.6; extra == 'meshy'
+Requires-Dist: rich<16.0.0,>=13.7.0; extra == 'meshy'
+Requires-Dist: validators>=0.35.0; extra == 'meshy'
+Provides-Extra: secrets-sync
+Requires-Dist: boto3>=1.42.92; extra == 'secrets-sync'
+Requires-Dist: hvac>=2.4.0; extra == 'secrets-sync'
+Provides-Extra: slack
+Requires-Dist: slack-sdk>=3.41.0; extra == 'slack'
+Provides-Extra: tests
+Requires-Dist: coverage[toml]>=7.6.0; extra == 'tests'
+Requires-Dist: hypothesis>=6.100.2; extra == 'tests'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'tests'
+Requires-Dist: pytest-cov>=7.1.0; extra == 'tests'
+Requires-Dist: pytest-mock>=3.15.1; extra == 'tests'
+Requires-Dist: pytest-timeout>=2.4.0; extra == 'tests'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'tests'
+Requires-Dist: pytest>=9.0.3; extra == 'tests'
+Provides-Extra: typing
+Requires-Dist: mypy>=1.20.1; extra == 'typing'
+Requires-Dist: types-pyyaml>=6.0.12.20240724; extra == 'typing'
+Requires-Dist: types-requests>=2.33.0.20260408; extra == 'typing'
+Provides-Extra: vault
+Requires-Dist: hvac>=2.4.0; extra == 'vault'
+Provides-Extra: vector
+Requires-Dist: sqlite-vec>=0.1.9; extra == 'vector'
+Provides-Extra: webhooks
+Requires-Dist: fastapi>=0.136.0; extra == 'webhooks'
+Requires-Dist: pyngrok>=8.0.0; extra == 'webhooks'
+Requires-Dist: starlette>=1.3.1; extra == 'webhooks'
+Requires-Dist: uvicorn>=0.45.0; extra == 'webhooks'
+Provides-Extra: zoom
+Description-Content-Type: text/markdown
+
+# Vendor Fabric
+
+`vendor-fabric` is the optional vendor integration layer for the
+Extended Data Python stack. It depends on `extended-data>=8.4.0` for the
+polymorphic `ExtendedData` root, concrete containers, local file sync, inputs,
+logging, and workflow utilities, then adds
+adapter-registered API clients and vendor-backed sync capabilities.
+
+Documentation: [jonbogaty.com/vendor-fabric](https://jonbogaty.com/vendor-fabric/)
+
+```bash
+pip install vendor-fabric
+pip install "vendor-fabric[github,slack]"
+pip install "vendor-fabric[aws,google,vault,secrets-sync]"
+pip install secrets-sync-python-binding
+pip install pytest-vendor-fabric
+```
+
+The base install keeps vendor SDKs out of the environment. Connector metadata
+is available even when an optional SDK is absent:
+
+```python
+from vendor_fabric import get_connector_info, list_connector_info
+
+print(get_connector_info("github")["available"])
+print(list_connector_info(include_unavailable=True))
+```
+
+Construct connectors through the registry or `ConnectorFabric`:
+
+```python
+from vendor_fabric import ConnectorFabric
+
+fabric = ConnectorFabric(inputs={"GITHUB_TOKEN": "..."})
+github = fabric.get_connector("github")
+```
+
+Unavailable features report install guidance instead of requiring callers to
+wrap their own imports.
+
+SecretSync access is exposed through a binding-backed facade:
+
+```python
+from vendor_fabric.secrets_sync import ProviderSession, SyncOptions, get_targets, run_pipeline
+
+result = run_pipeline("pipeline.yaml", SyncOptions(dry_run=True))
+targets = get_targets("pipeline.yaml")
+
+print(result["success"])
+print(targets["targets"])
+
+session = ProviderSession(
+    vault_address="https://vault.example.com",
+    vault_token=vault_token,
+    aws_region="us-east-1",
+    aws_access_key_id=aws_credentials.access_key,
+    aws_secret_access_key=aws_credentials.secret_key,
+    aws_session_token=aws_credentials.token,
+)
+run_pipeline("pipeline.yaml", SyncOptions(dry_run=True), provider_session=session)
+```
+
+`vendor-fabric` consumes the `secrets_sync` import from
+`secrets-sync-python-binding` and shapes those payloads into Extended Data
+values. The canonical SecretSync runtime, CLI, pipeline semantics, and gopy
+binding source live in `jbcom/secrets-sync`.
+
+Connector and sync payloads are `ExtendedData` values at the boundary. Dict,
+list, string, tuple, and set payloads are concrete extended subclasses, so code
+can use normal container operations and extended-data methods without import
+juggling.
+
+Testing support lives in the separately published `pytest-vendor-fabric`
+package. It provides connector fixtures, E2E controls, and credential guards
+without forcing test-only dependencies into the runtime package.

vendor_fabric-2.1.3/README.md

@@ -0,0 +1,75 @@
+# Vendor Fabric
+
+`vendor-fabric` is the optional vendor integration layer for the
+Extended Data Python stack. It depends on `extended-data>=8.4.0` for the
+polymorphic `ExtendedData` root, concrete containers, local file sync, inputs,
+logging, and workflow utilities, then adds
+adapter-registered API clients and vendor-backed sync capabilities.
+
+Documentation: [jonbogaty.com/vendor-fabric](https://jonbogaty.com/vendor-fabric/)
+
+```bash
+pip install vendor-fabric
+pip install "vendor-fabric[github,slack]"
+pip install "vendor-fabric[aws,google,vault,secrets-sync]"
+pip install secrets-sync-python-binding
+pip install pytest-vendor-fabric
+```
+
+The base install keeps vendor SDKs out of the environment. Connector metadata
+is available even when an optional SDK is absent:
+
+```python
+from vendor_fabric import get_connector_info, list_connector_info
+
+print(get_connector_info("github")["available"])
+print(list_connector_info(include_unavailable=True))
+```
+
+Construct connectors through the registry or `ConnectorFabric`:
+
+```python
+from vendor_fabric import ConnectorFabric
+
+fabric = ConnectorFabric(inputs={"GITHUB_TOKEN": "..."})
+github = fabric.get_connector("github")
+```
+
+Unavailable features report install guidance instead of requiring callers to
+wrap their own imports.
+
+SecretSync access is exposed through a binding-backed facade:
+
+```python
+from vendor_fabric.secrets_sync import ProviderSession, SyncOptions, get_targets, run_pipeline
+
+result = run_pipeline("pipeline.yaml", SyncOptions(dry_run=True))
+targets = get_targets("pipeline.yaml")
+
+print(result["success"])
+print(targets["targets"])
+
+session = ProviderSession(
+    vault_address="https://vault.example.com",
+    vault_token=vault_token,
+    aws_region="us-east-1",
+    aws_access_key_id=aws_credentials.access_key,
+    aws_secret_access_key=aws_credentials.secret_key,
+    aws_session_token=aws_credentials.token,
+)
+run_pipeline("pipeline.yaml", SyncOptions(dry_run=True), provider_session=session)
+```
+
+`vendor-fabric` consumes the `secrets_sync` import from
+`secrets-sync-python-binding` and shapes those payloads into Extended Data
+values. The canonical SecretSync runtime, CLI, pipeline semantics, and gopy
+binding source live in `jbcom/secrets-sync`.
+
+Connector and sync payloads are `ExtendedData` values at the boundary. Dict,
+list, string, tuple, and set payloads are concrete extended subclasses, so code
+can use normal container operations and extended-data methods without import
+juggling.
+
+Testing support lives in the separately published `pytest-vendor-fabric`
+package. It provides connector fixtures, E2E controls, and credential guards
+without forcing test-only dependencies into the runtime package.

vendor_fabric-2.1.3/examples/README.md

@@ -0,0 +1,69 @@
+# Connector Examples
+
+This directory contains working examples for `vendor_fabric` and the
+registered integrations that hang off `ConnectorFabric`.
+
+Connector examples assume the `extended-data>=8.4.0` contract: external data
+payloads are promoted through the `ExtendedData` root at connector boundaries.
+Callers can use `ExtendedDict`, `ExtendedList`, and `ExtendedString` methods on
+decoded API, file, and SDK-shaped results, then call `to_builtin()` only when a
+plain Python payload is needed for serialization or SDK handoff.
+Provider capability functions follow that same payload contract. Agent runtime
+wrappers and framework-specific tool objects belong in `agentic-fabric`.
+
+## Quick Start
+
+Install vendor-fabric with the extras you need:
+
+```bash
+# Install with all connectors
+pip install "vendor-fabric[all]"
+
+# Or install specific connectors
+pip install "vendor-fabric[aws,google,meshy]"
+
+```
+
+## Examples
+
+### Basic Connectors
+
+- [`basic_aws.py`](basic_aws.py) - AWS connector with Organizations and S3
+- [`basic_google.py`](basic_google.py) - Google Vendor fabric with Workspace and Billing
+- [`basic_meshy.py`](basic_meshy.py) - Meshy AI 3D generation
+
+### Provider Capability Integration
+
+Provider capability metadata lives in the provider modules. Agent-facing
+runtime transports over those capabilities belong in `agentic-fabric`.
+
+## Environment Variables
+
+Most examples require API keys set as environment variables:
+
+```bash
+# AWS
+export AWS_ACCESS_KEY_ID="your-key"
+export AWS_SECRET_ACCESS_KEY="your-secret"
+
+# Google Cloud
+export GOOGLE_SERVICE_ACCOUNT='{"type": "service_account", ...}'
+
+# Meshy AI
+export MESHY_API_KEY="msy_your_key"
+
+```
+
+## Running Examples
+
+```bash
+# Run any example
+uv run --package vendor-fabric python packages/vendor-fabric/examples/basic_meshy.py
+
+# Run with debug logging
+LOGLEVEL=DEBUG uv run --package vendor-fabric python packages/vendor-fabric/examples/basic_meshy.py
+```
+
+SecretSync examples live in this repository because that surface composes
+vendor capabilities. Install `vendor-fabric[secrets-sync]` for vendor secret
+sync. Agent runtime examples belong in `agentic-fabric`.

vendor_fabric-2.1.3/examples/basic_aws.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+"""Example: Basic AWS Connector usage.
+
+This example demonstrates how to use the AWS connector to interact with
+AWS Organizations and S3.
+
+Requirements:
+    pip install vendor-fabric[aws]
+
+Environment Variables:
+    AWS_ACCESS_KEY_ID: AWS access key
+    AWS_SECRET_ACCESS_KEY: AWS secret key
+    AWS_DEFAULT_REGION: AWS region (optional, defaults to us-east-1)
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from vendor_fabric import ConnectorFabric
+
+
+def main() -> int:
+    """Demonstrate AWS connector usage."""
+    # Check for required environment variables
+    if not os.getenv("AWS_ACCESS_KEY_ID"):
+        print("Error: AWS_ACCESS_KEY_ID environment variable is required.")
+        return 1
+
+    fabric = ConnectorFabric()
+    info = fabric.get_connector_info("aws")
+    if not info["available"]:
+        print(f"Error: AWS connector is unavailable. Install with: {info['install']}")
+        if info["missing"]:
+            print(f"Missing packages: {', '.join(info['missing'])}")
+        return 1
+
+    print("Creating AWS connector...")
+    connector = fabric.get_connector("aws")
+    print("AWS connector created successfully.")
+
+    # List S3 buckets
+    print("\n--- S3 Buckets ---")
+    try:
+        buckets = connector.list_s3_buckets()
+        for bucket_name, bucket in list(buckets.items())[:5]:  # Show first 5
+            created = bucket.get("creation_date") or bucket.get("CreationDate")
+            print(f"  Bucket: {bucket_name} ({created})")
+        if len(buckets) > 5:
+            print(f"  ... and {len(buckets) - 5} more buckets")
+    except Exception as e:
+        print(f"  Could not list buckets: {e}")
+
+    # List organization accounts (if using Organizations)
+    print("\n--- Organization Accounts ---")
+    try:
+        accounts = connector.get_accounts()
+        for account_id, account in list(accounts.items())[:5]:
+            name = account.get("name") or account.get("Name") or account_id
+            print(f"  Account: {account_id} ({name})")
+        if len(accounts) > 5:
+            print(f"  ... and {len(accounts) - 5} more accounts")
+    except Exception as e:
+        print(f"  Could not list accounts: {e}")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

vendor_fabric-2.1.3/examples/basic_google.py

@@ -0,0 +1,72 @@
+#!/usr/bin/env python3
+"""Example: Basic Google Cloud Connector usage.
+
+This example demonstrates how to use the Google Vendor fabric to interact
+with Google Workspace and Cloud Platform.
+
+Requirements:
+    pip install vendor-fabric[google]
+
+Environment Variables:
+    GOOGLE_SERVICE_ACCOUNT: JSON service account credentials
+    GOOGLE_DOMAIN: Google Workspace domain (for Workspace operations)
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+from vendor_fabric import ConnectorFabric
+
+
+def main() -> int:
+    """Demonstrate Google connector usage."""
+    # Check for required environment variables
+    if not os.getenv("GOOGLE_SERVICE_ACCOUNT"):
+        print("Error: GOOGLE_SERVICE_ACCOUNT environment variable is required.")
+        return 1
+
+    fabric = ConnectorFabric()
+    info = fabric.get_connector_info("google")
+    if not info["available"]:
+        print(f"Error: Google connector is unavailable. Install with: {info['install']}")
+        if info["missing"]:
+            print(f"Missing packages: {', '.join(info['missing'])}")
+        return 1
+
+    print("Creating Google connector...")
+    connector = fabric.get_connector("google")
+    print("Google connector created successfully.")
+
+    # List projects
+    print("\n--- Google Cloud Projects ---")
+    try:
+        projects = connector.list_projects()
+        for project in projects[:5]:
+            print(f"  Project: {project}")
+        if len(projects) > 5:
+            print(f"  ... and {len(projects) - 5} more projects")
+    except Exception as e:
+        print(f"  Could not list projects: {e}")
+
+    # List workspace users (if domain configured)
+    if os.getenv("GOOGLE_DOMAIN"):
+        print("\n--- Workspace Users ---")
+        try:
+            users = connector.list_users()
+            for user in users[:5]:
+                email = user.get("primaryEmail", "Unknown")
+                print(f"  User: {email}")
+            if len(users) > 5:
+                print(f"  ... and {len(users) - 5} more users")
+        except Exception as e:
+            print(f"  Could not list users: {e}")
+    else:
+        print("\nSkipping Workspace users (GOOGLE_DOMAIN not set).")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

vendor_fabric-2.1.3/examples/basic_meshy.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""Example: Meshy AI 3D Generation.
+
+This example demonstrates how to use the Meshy connector for AI-powered
+3D asset generation.
+
+Requirements:
+    pip install vendor-fabric[meshy]
+
+Environment Variables:
+    MESHY_API_KEY: Your Meshy API key (get one at https://meshy.ai)
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+
+
+def main() -> int:
+    """Demonstrate Meshy AI 3D generation."""
+    if not os.getenv("MESHY_API_KEY"):
+        print("Error: MESHY_API_KEY environment variable is required.")
+        print("Get an API key at https://meshy.ai")
+        return 1
+
+    from vendor_fabric.meshy import text3d
+
+    prompt = "a medieval sword with ornate handle"
+    print(f"Generating 3D model for prompt: '{prompt}'")
+
+    try:
+        # `generate` submits a preview task and polls until it completes.
+        # Pass `wait=False` to get the task id back immediately and poll
+        # yourself with `text3d.poll(task_id)`.
+        result = text3d.generate(
+            prompt=prompt,
+            art_style="realistic",
+            negative_prompt="blurry, low detail",
+            target_polycount=15000,
+            enable_pbr=True,
+        )
+
+        # text3d.generate returns an ExtendedDict when wait=True.
+        status = result["status"]
+        print(f"Final status: {status}")
+
+        if status != "SUCCEEDED":
+            error = result.get("error")
+            print(f"Generation failed: {error}")
+            return 1
+
+        model_urls = result.get("model_urls") or {}
+        print(f"GLB url: {model_urls.get('glb')}")
+        print(f"OBJ url: {model_urls.get('obj')}")
+
+        # Refine the preview to full quality using the task id.
+        task_id = str(result["id"])
+        print(f"Refining task {task_id} to full quality...")
+        refined_id = text3d.refine(task_id)
+        refined = text3d.poll(str(refined_id))
+        refined_urls = refined.get("model_urls") or {}
+        print(f"Refined GLB url: {refined_urls.get('glb')}")
+
+    except Exception as e:
+        print(f"Error during generation: {e}")
+        return 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())