amigo_sdk 0.100.0__tar.gz

amigo_sdk-0.100.0/.github/workflows/auto-release.yml

@@ -0,0 +1,183 @@
+name: Auto Release (Backend API changes)
+
+on:
+  repository_dispatch:
+    types: [openapi-updated]
+
+permissions:
+  contents: write
+
+jobs:
+  detect:
+    name: Detect OpenAPI change
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    outputs:
+      changed: ${{ steps.diff.outputs.changed }}
+      spec_url: ${{ steps.spec.outputs.spec_url }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Ensure jq
+        run: sudo apt-get update && sudo apt-get install -y jq
+
+      - name: Resolve spec URL
+        id: spec
+        run: |
+          SPEC_URL="${{ github.event.client_payload.spec_url }}"
+          if [ -z "$SPEC_URL" ]; then
+            SPEC_URL="https://api.amigo.ai/v1/openapi.json"
+          fi
+          echo "spec_url=$SPEC_URL" >> $GITHUB_OUTPUT
+
+      - name: Fetch current production spec
+        run: |
+          mkdir -p specs
+          curl -fSL -o specs/openapi-new.json "${{ steps.spec.outputs.spec_url }}"
+
+      - name: Check baseline presence
+        id: baseline
+        run: |
+          mkdir -p specs
+          if [ ! -f specs/openapi-baseline.json ]; then
+            echo "missing=true" >> $GITHUB_OUTPUT
+          else
+            echo "missing=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Prepare baseline
+        run: |
+          mkdir -p specs
+          if [ ! -f specs/openapi-baseline.json ]; then
+            cp specs/openapi-new.json specs/openapi-baseline.json
+          fi
+
+      - name: Diagnostics (spec and baseline)
+        run: |
+          echo "Resolved spec_url: ${{ steps.spec.outputs.spec_url }}"
+          echo "Baseline missing: ${{ steps.baseline.outputs.missing }}"
+          echo "jq version: $(jq --version)"
+          jq -S '
+            def sort_deep:
+              if type == "array" then
+                map(sort_deep) | sort_by(tostring)
+              elif type == "object" then
+                with_entries(.value |= sort_deep)
+              else . end;
+            (del(.info) | del(.servers)) | sort_deep
+          ' specs/openapi-baseline.json > baseline.norm.json || true
+          jq -S '
+            def sort_deep:
+              if type == "array" then
+                map(sort_deep) | sort_by(tostring)
+              elif type == "object" then
+                with_entries(.value |= sort_deep)
+              else . end;
+            (del(.info) | del(.servers)) | sort_deep
+          ' specs/openapi-new.json > new.norm.json
+          if [ -f baseline.norm.json ]; then
+            echo "BASELINE_NORM_SHA=$(sha256sum baseline.norm.json | awk '{print $1}')"
+          else
+            echo "BASELINE_NORM_SHA=(none)"
+          fi
+          echo "NEW_NORM_SHA=$(sha256sum new.norm.json | awk '{print $1}')"
+          if [ -f baseline.norm.json ]; then
+            if diff -q baseline.norm.json new.norm.json >/dev/null 2>&1; then
+              echo "Quick diff: identical"
+            else
+              echo "Quick diff: differs"
+            fi
+          fi
+
+          # Section-level hashes and key diffs
+          echo "\n== Section-level hashes =="
+          if [ -f specs/openapi-baseline.json ]; then
+            BASELINE_PATHS_SHA=$(jq -cS '(.paths // {})' specs/openapi-baseline.json | sha256sum | awk '{print $1}')
+            BASELINE_SCHEMAS_SHA=$(jq -cS '(.components.schemas // {})' specs/openapi-baseline.json | sha256sum | awk '{print $1}')
+            BASELINE_PATHS_COUNT=$(jq -r '(.paths // {}) | keys | length' specs/openapi-baseline.json)
+            BASELINE_SCHEMAS_COUNT=$(jq -r '(.components.schemas // {}) | keys | length' specs/openapi-baseline.json)
+          else
+            BASELINE_PATHS_SHA=(none)
+            BASELINE_SCHEMAS_SHA=(none)
+            BASELINE_PATHS_COUNT=0
+            BASELINE_SCHEMAS_COUNT=0
+          fi
+          NEW_PATHS_SHA=$(jq -cS '(.paths // {})' specs/openapi-new.json | sha256sum | awk '{print $1}')
+          NEW_SCHEMAS_SHA=$(jq -cS '(.components.schemas // {})' specs/openapi-new.json | sha256sum | awk '{print $1}')
+          NEW_PATHS_COUNT=$(jq -r '(.paths // {}) | keys | length' specs/openapi-new.json)
+          NEW_SCHEMAS_COUNT=$(jq -r '(.components.schemas // {}) | keys | length' specs/openapi-new.json)
+          echo "BASELINE paths: count=$BASELINE_PATHS_COUNT sha=$BASELINE_PATHS_SHA"
+          echo "NEW      paths: count=$NEW_PATHS_COUNT sha=$NEW_PATHS_SHA"
+          echo "BASELINE schemas: count=$BASELINE_SCHEMAS_COUNT sha=$BASELINE_SCHEMAS_SHA"
+          echo "NEW      schemas: count=$NEW_SCHEMAS_COUNT sha=$NEW_SCHEMAS_SHA"
+
+          echo "\n== Key diffs (paths) =="
+          if [ -f specs/openapi-baseline.json ]; then
+            jq -r '(.paths // {}) | keys | sort[]' specs/openapi-baseline.json > baseline.paths.txt || true
+          else
+            : > baseline.paths.txt
+          fi
+          jq -r '(.paths // {}) | keys | sort[]' specs/openapi-new.json > new.paths.txt
+          echo "Removed paths (in baseline, not in new):"; comm -23 baseline.paths.txt new.paths.txt || true
+          echo "Added paths (in new, not in baseline):"; comm -13 baseline.paths.txt new.paths.txt || true
+
+          echo "\n== Key diffs (components.schemas) =="
+          if [ -f specs/openapi-baseline.json ]; then
+            jq -r '(.components.schemas // {}) | keys | sort[]' specs/openapi-baseline.json > baseline.schemas.txt || true
+          else
+            : > baseline.schemas.txt
+          fi
+          jq -r '(.components.schemas // {}) | keys | sort[]' specs/openapi-new.json > new.schemas.txt
+          echo "Removed schemas (in baseline, not in new):"; comm -23 baseline.schemas.txt new.schemas.txt || true
+          echo "Added schemas (in new, not in baseline):"; comm -13 baseline.schemas.txt new.schemas.txt || true
+
+      - name: Compare normalized specs
+        id: diff
+        run: |
+          if [ "${{ steps.baseline.outputs.missing }}" = "true" ]; then
+            echo "changed=true" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+          jq -S '
+            def sort_deep:
+              if type == "array" then
+                map(sort_deep) | sort_by(tostring)
+              elif type == "object" then
+                with_entries(.value |= sort_deep)
+              else . end;
+            (del(.info) | del(.servers)) | sort_deep
+          ' specs/openapi-baseline.json > baseline.norm.json
+          jq -S '
+            def sort_deep:
+              if type == "array" then
+                map(sort_deep) | sort_by(tostring)
+              elif type == "object" then
+                with_entries(.value |= sort_deep)
+              else . end;
+            (del(.info) | del(.servers)) | sort_deep
+          ' specs/openapi-new.json > new.norm.json
+          if diff -q baseline.norm.json new.norm.json >/dev/null 2>&1; then
+            echo "changed=false" >> $GITHUB_OUTPUT
+          else
+            echo "changed=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Upload normalized specs
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: normalized-specs
+          path: |
+            baseline.norm.json
+            new.norm.json
+          retention-days: 7
+
+  release-on-dispatch:
+    name: Trigger SDK release (minor)
+    needs: detect
+    if: needs.detect.outputs.changed == 'true'
+    uses: ./.github/workflows/release.yml
+    with:
+      version_type: minor
+      dry_run: ${{ github.event.client_payload.dry_run == true }}
+      spec_url: ${{ needs.detect.outputs.spec_url }}
+    secrets: inherit

amigo_sdk-0.100.0/.github/workflows/release.yml

@@ -0,0 +1,215 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version_type:
+        description: "Version increment type"
+        required: true
+        default: "patch"
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+      dry_run:
+        description: "Dry run (skip upload)"
+        required: false
+        default: false
+        type: boolean
+  workflow_call:
+    inputs:
+      version_type:
+        description: "Version increment type (patch|minor|major)"
+        required: true
+        type: string
+        default: "patch"
+      dry_run:
+        description: "Dry run (skip upload)"
+        required: false
+        type: boolean
+        default: false
+      spec_url:
+        description: "OpenAPI spec URL to use for generation"
+        required: false
+        type: string
+        default: ""
+
+permissions:
+  contents: write
+
+jobs:
+  # Reuse the existing test workflow
+  test:
+    uses: ./.github/workflows/test.yml
+    with:
+      skip_codecov: true
+    secrets: inherit
+
+  release:
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    needs: test
+
+    steps:
+      - name: Create GitHub App token (release-bot)
+        id: app-token
+        uses: actions/create-github-app-token@v2
+        with:
+          app-id: ${{ secrets.RELEASE_BOT_APP_ID }}
+          private-key: ${{ secrets.RELEASE_BOT_PRIVATE_KEY }}
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          # Fetch full history for version tagging
+          fetch-depth: 0
+          # Use a token that can push tags and create releases
+          token: ${{ steps.app-token.outputs.token }}
+
+      - name: Ensure jq
+        run: sudo apt-get update && sudo apt-get install -y jq
+
+      - name: Fetch OpenAPI spec
+        id: fetch_spec
+        run: |
+          SPEC_URL="${{ inputs.spec_url }}"
+          if [ -z "$SPEC_URL" ]; then
+            SPEC_URL="https://api.amigo.ai/v1/openapi.json"
+          fi
+          mkdir -p specs
+          curl -fSL -o specs/openapi-new.json "$SPEC_URL"
+          cp specs/openapi-new.json specs/openapi-baseline.json
+
+      # Generator always fetches remote; no local spec path needed
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+          pip install hatch
+
+      - name: Configure git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Get current version
+        id: current_version
+        run: |
+          CURRENT_VERSION=$(hatch version)
+          echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "Current version: $CURRENT_VERSION"
+
+      - name: Generate models
+        run: |
+          echo "🔄 Generating models from API spec..."
+          python -m scripts.gen_models
+          echo "✅ Models generated successfully"
+
+      - name: Increment version
+        id: new_version
+        run: |
+          echo "🔄 Incrementing ${{ inputs.version_type }} version..."
+          hatch version ${{ inputs.version_type }}
+          NEW_VERSION=$(hatch version)
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "✅ Version updated: ${{ steps.current_version.outputs.version }} → $NEW_VERSION"
+
+      - name: Build package
+        run: |
+          echo "🔄 Building package..."
+          # Clean any existing build artifacts
+          rm -rf dist/
+          hatch build
+          echo "✅ Package built successfully"
+          ls -la dist/
+
+      - name: Upload to PyPI
+        if: ${{ !inputs.dry_run }}
+        env:
+          HATCH_INDEX_USER: __token__
+          HATCH_INDEX_AUTH: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          echo "🔄 Uploading to PyPI..."
+          hatch publish --repo https://upload.pypi.org/legacy/
+          echo "✅ Package uploaded to PyPI"
+
+      - name: Commit version bump
+        if: ${{ !inputs.dry_run }}
+        run: |
+          git add -A
+          git commit -m "Bump version to ${{ steps.new_version.outputs.version }}"
+          git push origin HEAD
+
+      - name: Create and push tag
+        if: ${{ !inputs.dry_run }}
+        run: |
+          git tag -a "v${{ steps.new_version.outputs.version }}" -m "Release v${{ steps.new_version.outputs.version }}"
+          git push origin "v${{ steps.new_version.outputs.version }}"
+
+      - name: Create GitHub Release
+        if: ${{ !inputs.dry_run }}
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
+        with:
+          tag_name: "v${{ steps.new_version.outputs.version }}"
+          release_name: "Release v${{ steps.new_version.outputs.version }}"
+          body: |
+            ## Changes in v${{ steps.new_version.outputs.version }}
+
+            This release was automatically created by the GitHub Actions release workflow.
+
+            ### Package Information
+            - **Version**: ${{ steps.new_version.outputs.version }}
+            - **Target**: PyPI
+            - **Type**: ${{ inputs.version_type }} release
+
+            ### Links
+            ${{ format('- [View on PyPI](https://pypi.org/project/amigo_sdk/{0}/)', steps.new_version.outputs.version) }}
+
+            ### Installation
+            ```bash
+            pip install amigo_sdk
+            ```
+          draft: false
+
+      - name: Upload build artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ steps.new_version.outputs.version }}
+          path: dist/
+          retention-days: 30
+
+      - name: Release Summary
+        run: |
+          echo "## 🎉 Release Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version**: ${{ steps.new_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Previous**: ${{ steps.current_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Type**: ${{ inputs.version_type }} release" >> $GITHUB_STEP_SUMMARY
+          echo "- **Target**: PyPI" >> $GITHUB_STEP_SUMMARY
+          echo "- **Dry Run**: ${{ inputs.dry_run }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+
+          if [ "${{ inputs.dry_run }}" = "false" ]; then
+            echo "### 📦 Package Links" >> $GITHUB_STEP_SUMMARY
+            echo "- [PyPI Package](https://pypi.org/project/amigo_sdk/${{ steps.new_version.outputs.version }}/)" >> $GITHUB_STEP_SUMMARY
+            echo "- [GitHub Release](https://github.com/${{ github.repository }}/releases/tag/v${{ steps.new_version.outputs.version }})" >> $GITHUB_STEP_SUMMARY
+            echo "" >> $GITHUB_STEP_SUMMARY
+            echo "### 🚀 Next Steps" >> $GITHUB_STEP_SUMMARY
+            echo "The package has been successfully released and is available for installation!" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "### 🚫 Dry Run Results" >> $GITHUB_STEP_SUMMARY
+            echo "- All steps completed successfully" >> $GITHUB_STEP_SUMMARY
+            echo "- Version would be bumped to: ${{ steps.new_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+            echo "- Package built and ready for upload" >> $GITHUB_STEP_SUMMARY
+            echo "- No commits, tags, or uploads were made" >> $GITHUB_STEP_SUMMARY
+          fi

amigo_sdk-0.100.0/.github/workflows/test.yml

@@ -0,0 +1,86 @@
+name: Test
+
+permissions:
+  contents: read
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_call:
+    inputs:
+      skip_codecov:
+        description: "Skip Codecov upload"
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  test:
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run linter
+        run: ruff check .
+
+      - name: Run formatter check
+        run: ruff format --check .
+
+      - name: Run tests with coverage
+        run: pytest --cov=src --cov-report=xml --cov-report=term
+
+      - name: Upload coverage reports to Codecov
+        if: inputs.skip_codecov != true
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage.xml
+          fail_ci_if_error: true
+
+  integration-test:
+    runs-on: blacksmith-4vcpu-ubuntu-2404
+    needs: test # Only run if unit tests pass
+    # Skip for PRs from forks (they don't have access to secrets)
+    # This runs on: pushes to main, PRs from same repo
+    if: >
+      github.event_name == 'push' || 
+      github.event.pull_request.head.repo.full_name == github.repository
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run integration tests
+        env:
+          AMIGO_API_KEY: ${{ secrets.AMIGO_API_KEY }}
+          AMIGO_API_KEY_ID: ${{ secrets.AMIGO_API_KEY_ID }}
+          AMIGO_ORGANIZATION_ID: ${{ secrets.AMIGO_ORGANIZATION_ID }}
+          AMIGO_USER_ID: ${{ secrets.AMIGO_USER_ID }}
+          AMIGO_BASE_URL: ${{ secrets.AMIGO_BASE_URL }}
+        run: pytest -m integration -v -s

amigo_sdk-0.100.0/.gitignore

@@ -0,0 +1,18 @@
+.venv
+.env
+.pytest_cache
+.ruff_cache
+__pycache__
+
+.vscode
+!.vscode/settings.json
+
+dist/
+
+# Coverage files
+htmlcov/
+coverage.xml
+.coverage
+
+# CI/Temp OpenAPI spec (fetched during workflows)
+specs/openapi-new.json

amigo_sdk-0.100.0/CONTRIBUTING.md

@@ -0,0 +1,137 @@
+# Contributing Guide
+
+## Quick Setup
+
+```bash
+# Create and activate virtual environment
+python -m venv .venv
+source .venv/bin/activate
+
+# Install the project in development mode
+pip install -e ".[dev]"
+```
+
+## Development Commands
+
+```bash
+check                     # Run all checks (format, lint, tests)
+check --fix               # Auto-fix issues and run all checks
+check --fast              # Format + lint only (skip tests)
+
+gen-models                # Generate models from API spec
+```
+
+## Workflow
+
+1. **Before committing:** Run `check --fix` to auto-fix issues
+2. **During development:** Use `check --fast` for quick validation
+3. **Update models:** Run `gen-models` when API changes
+
+## Release Process
+
+### GitHub Actions Release
+
+1. Go to the **Actions** tab in GitHub
+2. Select the **Release** workflow
+3. Click **Run workflow** and choose:
+   - **Version type**: `patch` (default), `minor`, or `major`
+   - **Dry run**: Test the release process without publishing
+
+The workflow will automatically:
+
+- ✅ Run all tests, linting, and formatting checks (reuses existing test workflow)
+- 🔄 Generate fresh models from the API spec
+- 📈 Increment the version using Hatch
+- 📦 Build the package
+- 🚀 Upload to PyPI
+- 🏷️ Create a Git tag and GitHub release
+- 📋 Provide detailed summary with links
+
+### Required Repository Secrets
+
+Configure these secrets in your GitHub repository settings:
+
+- `PYPI_API_TOKEN`: Token for https://pypi.org/ (production releases)
+- `CODECOV_TOKEN`: Token for Codecov uploads (used by CI test workflow)
+- `RELEASE_BOT_APP_ID`: GitHub App ID used to create tags/releases
+- `RELEASE_BOT_PRIVATE_KEY`: GitHub App private key (PEM) for the release bot
+
+### Getting API Tokens
+
+1. **PyPI**: Go to https://pypi.org/manage/account/token/
+2. Create a token with upload permissions
+3. Add the token to your repository secrets
+
+## Auto-Release (OpenAPI changes)
+
+When the backend OpenAPI spec changes, the SDK can auto-release a new version.
+
+- Trigger: a `repository_dispatch` event with type `openapi-updated`
+- Detect job: fetches the provided `spec_url` (or defaults to `https://api.amigo.ai/v1/openapi.json`), normalizes and compares against `specs/openapi-baseline.json`
+- If changed: invokes the release workflow with `version_type=minor` and passes `spec_url` (supports `dry_run`)
+- Release workflow: regenerates models, bumps version, builds, publishes to PyPI, pushes tag, and creates a GitHub release
+
+Manual trigger example (repository_dispatch):
+
+```bash
+curl -X POST \
+  -H "Accept: application/vnd.github+json" \
+  -H "Authorization: Bearer $GH_TOKEN" \
+  https://api.github.com/repos/<OWNER>/<REPO>/dispatches \
+  -d '{
+    "event_type": "openapi-updated",
+    "client_payload": {
+      "spec_url": "https://api.amigo.ai/v1/openapi.json",
+      "dry_run": true
+    }
+  }'
+```
+
+Notes:
+
+- The baseline file `specs/openapi-baseline.json` is created on first run and updated as part of the release workflow.
+- Ensure the secrets listed above are configured so the workflow can push tags, create releases, and publish to PyPI.
+
+### Manual trigger using GitHub CLI (gh)
+
+Requires `gh` authenticated with a token that can dispatch events on the SDK repos.
+
+```bash
+# Values that mirror the workflow
+OWNER="amigo-ai"
+BACKEND_REPO="$OWNER/backend"
+COMMIT_SHA="$(git rev-parse HEAD 2>/dev/null || echo manual-test)"
+RUN_ID="$(date +%s)"  # stand-in for GitHub Actions run_id
+
+for repo in amigo-typescript-sdk amigo-python-sdk; do
+  echo "Notifying $repo..."
+  gh api "repos/$OWNER/$repo/dispatches" \
+    --method POST \
+    --header 'Accept: application/vnd.github+json' \
+    --input - <<EOF || echo "⚠️  Failed to notify $repo"
+{
+  "event_type": "openapi-updated",
+  "client_payload": {
+    "spec_url": "https://api.amigo.ai/v1/openapi.json",
+    "commit_sha": "$COMMIT_SHA",
+    "backend_repo": "$BACKEND_REPO",
+    "backend_run_id": "$RUN_ID"
+  }
+}
+EOF
+done
+```
+
+## IDE Setup (VS Code)
+
+Install extensions:
+
+- [Ruff](https://marketplace.visualstudio.com/items?itemName=charliermarsh.ruff)
+- [Python](https://marketplace.visualstudio.com/items?itemName=ms-python.python)
+
+## Troubleshooting
+
+- **Command not found:** Activate virtual environment with `source .venv/bin/activate`
+- **Linting failures:** Run `check --fix` to auto-fix issues
+- **Model import errors:** Run `gen-models` to regenerate models
+- **Release failures:** Check API tokens are configured in repository secrets and try a dry run first

amigo_sdk-0.100.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Amigo
+
+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.