cloudkit 0.1.1__tar.gz → 0.1.2__tar.gz

cloudkit-0.1.2/.devcontainer/devcontainer.json

@@ -0,0 +1,54 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ubuntu
+{
+  "name": "Catalyst Backend Boilerplate",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/base:ubuntu-22.04",
+
+  // Features to add to the dev container. More info: https://containers.dev/features.
+  "features": {
+    "ghcr.io/devcontainers/features/azure-cli:1": {},
+    "ghcr.io/azure/azure-dev/azd:0": {},
+    "ghcr.io/va-h/devcontainers-features/uv:1": {},
+    "ghcr.io/devcontainers-contrib/features/ruff:1": {}
+//    "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {},
+//    "ghcr.io/devcontainers/features/nvidia-cuda:1": {}
+  },
+
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+
+  // Use 'postCreateCommand' to run commands after the container is created.
+  // "postCreateCommand": "uname -a",
+
+  // Configure tool-specific properties.
+  "customizations": {
+    "vscode": {
+        "extensions": [
+            "ms-azuretools.azure-dev",
+            "ms-azuretools.vscode-bicep",
+            "ms-python.python"
+        ]
+    },
+    "codespaces": {
+        "openFiles": [
+          "README.md"
+        ]
+    }
+},
+
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  // "remoteUser": "root"
+
+  "runArgs": ["--userns=keep-id:uid=1000,gid=1000"],
+  "containerUser": "vscode",
+  "updateRemoteUserUID": true,
+  "containerEnv": {
+    "HOME": "/home/vscode"
+  },
+
+ "hostRequirements": {
+  "memory": "8gb"
+//  "gpu": "optional"
+  }
+}

cloudkit-0.1.2/.dockerignore

@@ -0,0 +1,94 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+*.egg
+*.egg-info/
+dist/
+build/
+*.whl
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env.*
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/

cloudkit-0.1.2/.github/dependabot.yml

@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for more information:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://containers.dev/guide/dependabot
+
+version: 2
+updates:
+ - package-ecosystem: "devcontainers"
+   directory: "/"
+   schedule:
+     interval: weekly

cloudkit-0.1.2/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+default_language_version:
+  python: python3.11
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-toml
+      - id: check-yaml
+        args:
+          - --unsafe
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: v0.2.0
+    hooks:
+      - id: ruff
+        args:
+          - --fix
+      - id: ruff-format
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.6.2
+    hooks:
+      - id: uv-lock
+ci:
+  autofix_commit_msg: 🎨 [pre-commit.ci] Auto format from pre-commit.com hooks
+  autoupdate_commit_msg: ⬆ [pre-commit.ci] pre-commit autoupdate

cloudkit-0.1.2/.pypirc

@@ -0,0 +1,6 @@
+[distutils]
+Index-servers =
+  aiis4aa-feed
+
+[aiis4aa-feed]
+Repository = https://pkgs.dev.azure.com/Consulting-DTT-AI-Integration-Services/aiis/_packaging/aiis4aa-feed/pypi/upload/

cloudkit-0.1.2/.python-version

@@ -0,0 +1 @@
+3.11

cloudkit-0.1.2/.vscode/launch.json

@@ -0,0 +1,45 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Python: Debug Current File",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "justMyCode": true,
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            }
+        },
+        {
+            "name": "Python: Run Examples",
+            "type": "debugpy",
+            "request": "launch",
+            "program": "${workspaceFolder}/examples/example_usage.py",
+            "console": "integratedTerminal",
+            "justMyCode": true,
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            }
+        },
+        {
+            "name": "Python: Run Tests",
+            "type": "debugpy",
+            "request": "launch",
+            "module": "pytest",
+            "args": [
+                "tests/",
+                "-v"
+            ],
+            "console": "integratedTerminal",
+            "justMyCode": true,
+            "env": {
+                "PYTHONPATH": "${workspaceFolder}/src"
+            }
+        }
+    ]
+}

cloudkit-0.1.2/.vscode/settings.json

@@ -0,0 +1,38 @@
+{
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff"
+  },
+  "[markdown]": {
+    "editor.wordWrap": "on",
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[yaml]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[html]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[dockerfile]": {
+    "editor.defaultFormatter": "ms-azuretools.vscode-docker"
+  },
+  "editor.tabSize": 4,
+  "editor.insertSpaces": true,
+  "editor.renderWhitespace": "all",
+  "editor.formatOnSave": true,
+  "editor.rulers": [88, 120],
+  "files.insertFinalNewline": true,
+  "files.trimFinalNewlines": true,
+  "files.trimTrailingWhitespace": true,
+  "python.testing.pytestArgs": ["tests"],
+  "python.testing.unittestEnabled": false,
+  "python.testing.pytestEnabled": true
+}

cloudkit-0.1.2/.whitesource

@@ -0,0 +1,3 @@
+{
+  "settingsInheritedFrom": "whitesource-config/whitesource-config@master"
+}

cloudkit-0.1.2/CHANGELOG.md

@@ -0,0 +1,52 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2026-02-04
+
+### Changed
+- Updated README with correct package name and PyPI installation instructions
+- Updated documentation with proper import statements
+
+### Fixed
+- Fixed connection string formatting in .env template
+
+## [0.1.0] - 2026-02-04
+
+### Added
+- Initial release of CloudKit
+- Cloud abstraction layer supporting Azure and AWS
+- Database services:
+  - Azure Cosmos DB (NoSQL and Table API)
+  - Azure Blob Storage
+  - AWS DynamoDB
+  - AWS S3
+- AI services:
+  - Text analysis (sentiment, entity recognition, key phrase extraction)
+  - Chat completion via Azure OpenAI and AWS Bedrock
+  - Text embeddings generation
+  - Vector similarity search
+- Search services:
+  - Azure Cognitive Search integration
+  - AWS OpenSearch integration
+- Messaging services:
+  - Azure Service Bus support
+  - AWS SQS support
+- Unified `CloudProvider` interface for all services
+- Configuration via environment variables or dictionaries
+- Async/await support for all operations
+- Comprehensive examples and documentation
+- Type hints throughout the codebase
+- Testing framework with pytest
+- Development tooling (ruff, mypy, pre-commit)
+
+### Infrastructure
+- Modern Python packaging with pyproject.toml
+- Published to PyPI as `cloudkit`
+- MIT License
+- Python 3.11+ support
+
+[0.1.0]: https://github.com/sleepeatai/cloudkit/releases/tag/v0.1.0

cloudkit-0.1.2/Dockerfile

@@ -0,0 +1,80 @@
+# Agentic Composer SDK - Development and Testing Container
+FROM python:3.11-slim AS base
+
+WORKDIR /app
+
+# Install system dependencies required for various Python packages and development
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    curl \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install UV for dependency management
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Add UV to PATH
+ENV PATH="/root/.local/bin:$PATH" \
+    PYTHONUNBUFFERED=1 \
+    PYTHONPATH=/app
+
+# Development stage
+FROM base AS development
+
+# Create virtual environment
+RUN uv venv .venv
+ENV PATH="/app/.venv/bin:$PATH" \
+    VIRTUAL_ENV="/app/.venv"
+
+# Copy project configuration files
+COPY pyproject.toml .
+COPY uv.lock .
+
+# Install dependencies from lockfile
+RUN uv sync --group dev --locked
+
+# Copy source code and other files
+COPY src/ src/
+COPY tests/ tests/
+COPY examples/ examples/
+COPY README.md .
+COPY Makefile .
+COPY env.template .
+
+# Default command for development
+CMD ["bash"]
+
+# Testing stage
+FROM development AS testing
+
+# Run tests by default
+CMD ["make", "test"]
+
+# Examples stage - for running examples
+FROM development AS examples
+
+# Set working directory to examples
+WORKDIR /app/examples
+
+# Run examples by default
+CMD ["python", "example_usage.py"]
+
+# Production stage - minimal SDK installation
+FROM base AS production
+
+# Create virtual environment
+RUN uv venv .venv
+ENV PATH="/app/.venv/bin:$PATH" \
+    VIRTUAL_ENV="/app/.venv"
+
+# Copy only what's needed for production use
+COPY pyproject.toml .
+COPY uv.lock .
+COPY src/ src/
+COPY README.md .
+
+# Install only production dependencies from lockfile
+RUN uv sync --locked
+
+# Default to Python shell for SDK usage
+CMD ["python"]

cloudkit-0.1.2/Makefile

@@ -0,0 +1,75 @@
+# Agentic Composer SDK - Development Makefile
+
+.PHONY: help install install-dev test lint format clean docs publish
+
+help: ## Show this help message
+	@echo "Agentic Composer SDK - Available commands:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+lock: ## Generate or update uv.lock file
+	uv lock
+
+install: ## Install the SDK in development mode
+	uv venv .venv
+	source .venv/bin/activate && uv sync --locked
+
+install-dev: ## Install SDK with development dependencies
+	uv sync --group dev --locked
+
+test: ## Run tests with coverage
+	uv run pytest tests/ -v --cov=src --cov-report=html --cov-report=term
+
+test-fast: ## Run tests without coverage (faster)
+	uv run pytest tests/ -v
+
+lint: ## Run linting with ruff
+	uv run ruff check src/ tests/ examples/
+
+lint-fix: ## Run linting with auto-fix
+	uv run ruff check --fix src/ tests/ examples/
+
+format: ## Format code with ruff
+	uv run ruff format src/ tests/ examples/
+
+format-check: ## Check if code is properly formatted
+	uv run ruff format --check src/ tests/ examples/
+
+type-check: ## Run type checking with mypy
+	uv run mypy src/
+
+clean: ## Clean up cache and build artifacts
+	find . -type d -name "__pycache__" -exec rm -rf {} +
+	find . -type d -name "*.egg-info" -exec rm -rf {} +
+	find . -type d -name ".pytest_cache" -exec rm -rf {} +
+	find . -type d -name ".mypy_cache" -exec rm -rf {} +
+	find . -type d -name ".ruff_cache" -exec rm -rf {} +
+	rm -rf build/ dist/ htmlcov/
+
+examples: ## Run the example usage script
+	cd examples && uv run python example_usage.py
+
+docs: ## Generate documentation (placeholder)
+	@echo "Documentation generation not yet implemented"
+
+pre-commit: ## Run pre-commit checks (lint, format, type-check, test)
+	make format-check
+	make lint
+	make type-check
+	make test-fast
+
+build: ## Build the package
+	uv build
+
+publish-test: ## Publish to test PyPI
+	uv publish --repository-url https://test.pypi.org/legacy/
+
+publish: ## Publish to PyPI
+	uv publish
+
+# Development workflow
+dev-setup: install-dev ## Complete development setup
+	@echo "Development environment ready!"
+	@echo "Run 'make help' to see available commands"
+
+check-all: pre-commit ## Run all quality checks
+	@echo "All quality checks passed!"

{cloudkit-0.1.1 → cloudkit-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cloudkit
-Version: 0.1.1
+Version: 0.1.2
 Summary: Python cloud abstraction SDK for databases and AI services on Azure and AWS
 Author-email: sleepeatai <sleepeatai@gmail.com>
 License: MIT

cloudkit-0.1.2/config

@@ -0,0 +1,4 @@
+AZURE_ORG=Consulting-DTT-AI-Integration-Services
+AZURE_PROJECT=aiis
+AZURE_FEED=aiis4aa-feed
+AZURE_PAT=

cloudkit-0.1.2/env.template

@@ -0,0 +1,43 @@
+# Agentic Composer SDK Configuration Template
+# Copy this file to .env and fill in your actual values
+
+# Cloud Provider Selection (azure or aws)
+CLOUD_SDK_CLOUD_PROVIDER=azure
+
+# Azure Configuration
+# Storage
+AZURE_STORAGE_CONNECTION_STRING=your_azure_storage_connection_string
+AZURE_STORAGE_CONTAINER_NAME=your_container_name
+
+# Cosmos DB
+AZURE_COSMOS_NOSQL_CONNECTION_STRING=your_cosmos_nosql_connection_string
+AZURE_COSMOS_NOSQL_DB_NAME=your_cosmos_db_name
+AZURE_COSMOS_TABLE_CONNECTION_STRING=your_cosmos_table_connection_string
+
+# Service Bus
+AZURE_SERVICEBUS_CONNECTION_STRING=your_servicebus_connection_string
+
+# Cognitive Services
+AZURE_COGNITIVE_SERVICES_ENDPOINT=your_cognitive_services_endpoint
+AZURE_COGNITIVE_SERVICES_KEY=your_cognitive_services_key
+
+# Azure OpenAI
+AZURE_OPENAI_API_KEY=your_azure_openai_api_key
+AZURE_OPENAI_ENDPOINT=your_azure_openai_endpoint
+AZURE_OPENAI_API_VERSION=2023-12-01-preview
+
+# Azure Search
+AZURE_SEARCH_SERVICE_NAME=your_search_service_name
+AZURE_SEARCH_ADMIN_KEY=your_search_admin_key
+
+# AWS Configuration
+# General
+AWS_ACCESS_KEY_ID=your_aws_access_key_id
+AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key
+AWS_REGION=us-east-1
+
+# S3
+AWS_S3_BUCKET_NAME=your_s3_bucket_name
+
+# OpenSearch
+AWS_OPENSEARCH_ENDPOINT=your_opensearch_endpoint