aiproxyguard-python-sdk 0.1.0__tar.gz

aiproxyguard_python_sdk-0.1.0/.clabot

@@ -0,0 +1,9 @@
+{
+  "message": "Thank you for your contribution! Before we can review and merge your pull request, we need you to sign our Contributor License Agreement (CLA).\n\n**To sign the CLA:**\n\n1. Review the agreement below\n2. Reply to this PR with the following statement:\n\n> I have read the Contributor License Agreement and I hereby accept the terms.\n\n**Contributor License Agreement (Summary)**\n\nBy signing this CLA, you certify that:\n\n- You created the contribution or have the right to submit it under the Apache 2.0 license\n- You grant AInvirion and recipients of this software a perpetual, worldwide, non-exclusive, royalty-free license to use, reproduce, modify, and distribute your contribution\n- You understand that your contribution is public and may be redistributed under the Apache 2.0 license\n- You have the legal right to make this grant (if employed, your employer has waived rights or you are contributing outside the scope of employment)\n- You agree to notify us if you become aware of any facts that would make these representations inaccurate\n\nThis agreement is based on the Apache Software Foundation CLA. Your contribution will remain publicly available under the Apache 2.0 license.\n\nOnce you post your acceptance, we'll review your contribution. Thank you!\n\n---\n\nQuestions? Contact legal@ainvirion.com",
+  "label": "cla-signed",
+  "recheckComment": "recheck",
+  "contributors": [
+    "oscarvalenzuelab",
+    "cla-bot[bot]"
+  ]
+}

aiproxyguard_python_sdk-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,45 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+---
+
+## Bug Description
+
+A clear and concise description of what the bug is.
+
+## Steps to Reproduce
+
+1. Go to '...'
+2. Click on '...'
+3. Scroll down to '...'
+4. See error
+
+## Expected Behavior
+
+A clear and concise description of what you expected to happen.
+
+## Actual Behavior
+
+A clear and concise description of what actually happened.
+
+## Screenshots
+
+If applicable, add screenshots to help explain your problem.
+
+## Environment
+
+- **OS**: [e.g., macOS 13.0, Windows 11, Ubuntu 22.04]
+- **Browser**: [e.g., Chrome 119, Firefox 120, Safari 17] (if applicable)
+- **Version**: [e.g., 1.2.3]
+- **Node Version**: [e.g., 18.17.0] (if applicable)
+
+## Additional Context
+
+Add any other context about the problem here.
+
+## Possible Solution
+
+If you have suggestions on how to fix the bug, please describe them here.

aiproxyguard_python_sdk-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,41 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: 'enhancement'
+assignees: ''
+---
+
+## Feature Description
+
+A clear and concise description of the feature you'd like to see.
+
+## Problem Statement
+
+Describe the problem this feature would solve. Ex. I'm always frustrated when [...]
+
+## Proposed Solution
+
+A clear and concise description of what you want to happen.
+
+## Alternatives Considered
+
+Describe any alternative solutions or features you've considered.
+
+## Use Case
+
+Describe the use case(s) for this feature. Who would benefit from it and how?
+
+## Additional Context
+
+Add any other context, screenshots, or examples about the feature request here.
+
+## Implementation Ideas
+
+If you have ideas about how this could be implemented, please share them here.
+
+## Willingness to Contribute
+
+- [ ] I am willing to help implement this feature
+- [ ] I can help with documentation
+- [ ] I can help with testing

aiproxyguard_python_sdk-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,49 @@
+# Description
+
+Please include a summary of the changes and the related issue. Please also include relevant motivation and context.
+
+Fixes # (issue)
+
+## Type of Change
+
+Please delete options that are not relevant.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Code refactoring
+- [ ] Dependency update
+
+## How Has This Been Tested?
+
+Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce.
+
+- [ ] Test A
+- [ ] Test B
+
+**Test Configuration**:
+- OS:
+- Node version:
+- Other relevant details:
+
+## Checklist
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+- [ ] I have updated the CHANGELOG.md
+
+## Screenshots (if applicable)
+
+Add screenshots to help explain your changes.
+
+## Additional Notes
+
+Add any additional notes or context about the pull request here.

aiproxyguard_python_sdk-0.1.0/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "ci"

aiproxyguard_python_sdk-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: Template Validation
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  validate:
+    name: Validate Template Files
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+
+    - name: Check required files exist
+      run: |
+        test -f LICENSE
+        test -f README.md
+        test -f CONTRIBUTING.md
+        test -f SECURITY.md
+        test -f CODE_OF_CONDUCT.md
+        test -f .clabot
+        echo "All required template files present"
+
+    - name: Validate markdown files
+      uses: DavidAnson/markdownlint-cli2-action@v23
+      with:
+        globs: '**/*.md'
+        config: |
+          {
+            "default": true,
+            "MD013": false,
+            "MD033": false,
+            "MD041": false
+          }
+      continue-on-error: true
+
+    - name: Check for placeholder text
+      run: |
+        echo "Note: Remember to replace [Project Name] and other placeholders when using this template"

aiproxyguard_python_sdk-0.1.0/.github/workflows/cla-auto-sign.yml

@@ -0,0 +1,58 @@
+name: CLA Auto Sign
+
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+  auto-sign:
+    if: github.event.issue.pull_request && contains(github.event.comment.body, 'I have read the Contributor License Agreement and I hereby accept the terms')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Add contributor to CLA whitelist
+        id: add-contributor
+        env:
+          CONTRIBUTOR: ${{ github.event.comment.user.login }}
+        run: |
+          if jq -e --arg user "$CONTRIBUTOR" '.contributors | index($user)' .clabot > /dev/null 2>&1; then
+            echo "already_signed=true" >> $GITHUB_OUTPUT
+          else
+            jq --arg user "$CONTRIBUTOR" '.contributors += [$user]' .clabot > .clabot.tmp
+            mv .clabot.tmp .clabot
+            echo "already_signed=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit and push changes
+        if: steps.add-contributor.outputs.already_signed == 'false'
+        env:
+          CONTRIBUTOR: ${{ github.event.comment.user.login }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add .clabot
+          git commit -m "chore: add $CONTRIBUTOR to CLA contributors [skip ci]"
+          git push
+
+      - name: Trigger CLA recheck
+        if: steps.add-contributor.outputs.already_signed == 'false'
+        uses: actions/github-script@v8
+        env:
+          CONTRIBUTOR: ${{ github.event.comment.user.login }}
+        with:
+          script: |
+            const contributor = process.env.CONTRIBUTOR;
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: 'Thanks @' + contributor + '! Your CLA signature has been recorded.\n\n@cla-bot check'
+            });

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

@@ -0,0 +1,130 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  # Allow manual trigger for testing
+  workflow_dispatch:
+    inputs:
+      target:
+        description: 'Target repository'
+        required: true
+        default: 'testpypi'
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+jobs:
+  test:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run linting
+        run: ruff check src/ tests/
+
+      - name: Run type checking
+        run: mypy src/
+
+      - name: Run tests
+        run: pytest
+
+  build:
+    name: Build Distribution
+    needs: test
+    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.12'
+
+      - name: Install build tools
+        run: python -m pip install --upgrade pip build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check distribution
+        run: |
+          pip install twine
+          twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    needs: build
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'testpypi'
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/aiproxyguard-python-sdk/
+    permissions:
+      id-token: write
+      attestations: write
+      contents: read
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: build
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.target == 'pypi')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/aiproxyguard-python-sdk/
+    permissions:
+      id-token: write
+      attestations: write
+      contents: read
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: false
+          verbose: true

aiproxyguard_python_sdk-0.1.0/.gitignore

@@ -0,0 +1,77 @@
+# Dependencies
+node_modules/
+bower_components/
+vendor/
+
+# Build outputs
+dist/
+build/
+out/
+*.log
+*.min.js
+*.min.css
+
+# Environment files
+.env
+.env.local
+.env.*.local
+*.env
+
+# IDE and editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+*.sublime-project
+*.sublime-workspace
+
+# OS files
+Thumbs.db
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Testing
+coverage/
+.nyc_output/
+*.test.js.snap
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# Cache
+.cache/
+.parcel-cache/
+.next/
+.nuxt/
+.eslintcache
+
+# Optional npm cache directory
+.npm
+
+# Optional REPL history
+.node_repl_history
+
+# Package manager lock files (uncomment if needed)
+# package-lock.json
+# yarn.lock
+# pnpm-lock.yaml

aiproxyguard_python_sdk-0.1.0/CHANGELOG.md

@@ -0,0 +1,30 @@
+# 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.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-04-03
+
+### Added
+
+- Initial release of the AIProxyGuard Python SDK
+- `AIProxyGuard` client with sync and async support
+- Support for both self-hosted and cloud API modes (`ApiMode.SELF_HOSTED`, `ApiMode.CLOUD`)
+- Prompt injection detection via `check()` and `check_async()` methods
+- `@guard` decorator for automatic input validation on functions
+- `@guard_output` decorator for automatic output validation
+- Comprehensive exception hierarchy:
+  - `AIProxyGuardError` (base exception)
+  - `ValidationError` for invalid inputs
+  - `ConnectionError` for network issues
+  - `TimeoutError` for request timeouts
+  - `RateLimitError` for rate limit exceeded
+  - `ServerError` for server-side errors
+  - `ContentBlockedError` for blocked content
+- Health check endpoints (`health()`, `ready()`, `info()`)
+- Full type annotations and `py.typed` marker
+- Support for Python 3.9, 3.10, 3.11, 3.12, and 3.13
+
+[0.1.0]: https://github.com/AInvirion/aiproxyguard-python-sdk/releases/tag/v0.1.0

aiproxyguard_python_sdk-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,81 @@
+# Code of Conduct
+
+## Our Commitment
+
+We are committed to providing a welcoming and inclusive environment for all contributors, regardless of experience level, gender identity, sexual orientation, disability, personal appearance, race, ethnicity, age, religion, or nationality.
+
+## Standards
+
+### Expected Behavior
+
+- Use welcoming and inclusive language
+- Respect differing viewpoints and experiences
+- Accept constructive criticism gracefully
+- Focus on what is best for the community
+- Show empathy towards other community members
+
+### Unacceptable Behavior
+
+- Harassment, intimidation, or discrimination of any kind
+- Trolling, insulting comments, or personal attacks
+- Public or private harassment
+- Publishing others' private information without permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Responsibilities
+
+Project maintainers are responsible for clarifying standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
+
+Project maintainers have the right to remove, edit, or reject comments, commits, code, issues, and other contributions that do not align with this Code of Conduct, or to ban temporarily or permanently any contributor for behaviors they deem inappropriate, threatening, or harmful.
+
+## Scope
+
+This Code of Conduct applies within all project spaces, including the repository, issue tracker, and any other forums created by the project team. It also applies when an individual is representing the project in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at legal@ainvirion.com. All complaints will be reviewed and investigated promptly and fairly.
+
+All project team members are obligated to respect the privacy and security of the reporter of any incident.
+
+## Enforcement Guidelines
+
+Project maintainers will follow these guidelines in determining consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed unprofessional.
+
+**Consequence**: A private written warning, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No interaction with the people involved for a specified period. This includes avoiding interactions in project spaces as well as external channels. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any interaction or public communication with the project for a specified period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment, or aggression toward individuals.
+
+**Consequence**: A permanent ban from any public interaction within the project.
+
+## Attribution
+
+This Code of Conduct is adapted from the Contributor Covenant, version 2.1.
+
+## Contact
+
+For questions or concerns about this Code of Conduct, contact:
+- Email: legal@ainvirion.com
+- General inquiries: contact@ainvirion.com
+
+---
+
+Copyright (c) 2025-2026 AInvirion LLC. All Rights Reserved.