palabra-ai 0.1.2__tar.gz

palabra_ai-0.1.2/.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

palabra_ai-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,183 @@
+name: Create Release with Assets
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      id-token: write  # MANDATORY for OIDC PyPI publishing
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        ref: ${{ github.ref }}  # Use the tag ref to get the updated commit
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+
+    - name: Set up Python
+      run: uv python install 3.11
+
+    - name: Build package
+      run: |
+        # uv builds packages using hatchling
+        uv build
+
+    - name: Check package
+      run: |
+        # Install twine as a tool (not in system Python)
+        uv tool install twine
+        uv tool run twine check dist/*
+        ls -la dist/
+
+    - name: Get version from tag
+      id: get_version
+      run: |
+        VERSION="${GITHUB_REF#refs/tags/v}"
+        echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+        echo "TAG_NAME=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
+
+    # Publish to PyPI FIRST (before GitHub Release and Docker)
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      # No 'with' parameters needed - OIDC authentication is automatic
+      # The action will:
+      # 1. Request OIDC token from GitHub
+      # 2. Exchange it with PyPI for temporary API token
+      # 3. Upload the package using that token
+      # Your pending publisher configuration will be converted to active publisher on first use
+
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      with:
+        tag_name: ${{ steps.get_version.outputs.TAG_NAME }}
+        name: Release ${{ steps.get_version.outputs.TAG_NAME }}
+        draft: false
+        prerelease: ${{ contains(steps.get_version.outputs.VERSION, 'a') || contains(steps.get_version.outputs.VERSION, 'b') || contains(steps.get_version.outputs.VERSION, 'rc') || contains(steps.get_version.outputs.VERSION, 'dev') }}
+        generate_release_notes: true
+        files: |
+          dist/*.whl
+          dist/*.tar.gz
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+    # Docker image for package distribution
+    - name: Log in to GitHub Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    # Try to link the package to this repository if it exists
+    - name: Link Docker package to repository
+      continue-on-error: true
+      run: |
+        OWNER_LOWER=$(echo "${{ github.repository_owner }}" | tr '[:upper:]' '[:lower:]')
+        REPO_NAME=$(echo "${{ github.repository }}" | cut -d'/' -f2)
+        IMAGE_BASE_NAME=$(echo "$REPO_NAME" | sed 's/^draft-//')
+        
+        # Try to link the package to this repository
+        echo "Attempting to link ghcr.io/${OWNER_LOWER}/${IMAGE_BASE_NAME} to ${{ github.repository }}..."
+        
+        # Get repository ID
+        REPO_ID=$(curl -s \
+          -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
+          -H "Accept: application/vnd.github.v3+json" \
+          "https://api.github.com/repos/${{ github.repository }}" | jq -r '.id')
+        
+        if [ "$REPO_ID" != "null" ] && [ -n "$REPO_ID" ]; then
+          # Try to link the package to this repository
+          curl -X PUT \
+            -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
+            -H "Accept: application/vnd.github.v3+json" \
+            "https://api.github.com/orgs/${{ github.repository_owner }}/packages/container/${IMAGE_BASE_NAME}" \
+            -d "{\"repository_id\": ${REPO_ID}}" || true
+        fi
+
+    - name: Create Dockerfile for package
+      run: |
+        cat > Dockerfile << EOF
+        FROM python:3.11-slim
+        LABEL org.opencontainers.image.source=https://github.com/${{ github.repository }}
+        LABEL org.opencontainers.image.description="Palabra AI Python SDK"
+        LABEL org.opencontainers.image.licenses=MIT
+        LABEL org.opencontainers.image.url=https://github.com/${{ github.repository }}
+        LABEL org.opencontainers.image.documentation=https://github.com/${{ github.repository }}/blob/main/README.md
+        LABEL org.opencontainers.image.vendor="${{ github.repository_owner }}"
+        LABEL org.opencontainers.image.version="${{ steps.get_version.outputs.VERSION }}"
+        
+        COPY dist/*.whl /tmp/
+        RUN pip install /tmp/*.whl && rm /tmp/*.whl
+        
+        # This is a library image, not meant to be run directly
+        CMD ["python", "-c", "import palabra_ai; print(f'Palabra AI SDK v{palabra_ai.__version__} installed')"]
+        EOF
+
+    - name: Build and push Docker image with package
+      run: |
+        PACKAGE_VERSION=${{ steps.get_version.outputs.VERSION }}
+        # Convert repository owner to lowercase for Docker
+        OWNER_LOWER=$(echo "${{ github.repository_owner }}" | tr '[:upper:]' '[:lower:]')
+        # Extract repository name from full repository path
+        REPO_NAME=$(echo "${{ github.repository }}" | cut -d'/' -f2)
+        # Remove 'draft-' prefix if present for cleaner image name
+        IMAGE_BASE_NAME=$(echo "$REPO_NAME" | sed 's/^draft-//')
+        IMAGE_NAME=ghcr.io/${OWNER_LOWER}/${IMAGE_BASE_NAME}
+        
+        docker build -t $IMAGE_NAME:$PACKAGE_VERSION -t $IMAGE_NAME:latest .
+        
+        # Try to push, but don't fail the whole workflow if it doesn't work
+        if docker push $IMAGE_NAME:$PACKAGE_VERSION && docker push $IMAGE_NAME:latest; then
+          echo "📦 Successfully pushed Docker images:"
+          echo "  - $IMAGE_NAME:$PACKAGE_VERSION"
+          echo "  - $IMAGE_NAME:latest"
+        
+          # Save image name for use in summary
+          echo "IMAGE_NAME=$IMAGE_NAME" >> $GITHUB_ENV
+          echo "IMAGE_VERSION=$PACKAGE_VERSION" >> $GITHUB_ENV
+          echo "DOCKER_PUSH_SUCCESS=true" >> $GITHUB_ENV
+        else
+          echo "⚠️ Failed to push Docker images to $IMAGE_NAME"
+          echo "This might be due to permissions or existing package conflicts"
+          echo "PyPI publishing will continue..."
+          echo "DOCKER_PUSH_SUCCESS=false" >> $GITHUB_ENV
+        fi
+
+    - name: Release Summary
+      run: |
+        echo "## 🎉 Release Summary" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 📦 Package Information" >> $GITHUB_STEP_SUMMARY
+        echo "- **Repository**: ${{ github.repository }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **Tag**: ${{ steps.get_version.outputs.TAG_NAME }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **Version**: ${{ steps.get_version.outputs.VERSION }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 🚀 Published Artifacts" >> $GITHUB_STEP_SUMMARY
+        echo "- **GitHub Release**: https://github.com/${{ github.repository }}/releases/tag/${{ steps.get_version.outputs.TAG_NAME }}" >> $GITHUB_STEP_SUMMARY
+        if [ "${{ env.DOCKER_PUSH_SUCCESS }}" == "true" ]; then
+          echo "- **Docker Image**: \`${{ env.IMAGE_NAME }}:${{ env.IMAGE_VERSION }}\`" >> $GITHUB_STEP_SUMMARY
+        else
+          echo "- **Docker Image**: ⚠️ Failed to publish (permissions issue)" >> $GITHUB_STEP_SUMMARY
+        fi
+        echo "- **PyPI Package**: https://pypi.org/project/palabra-ai/" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 📥 Installation" >> $GITHUB_STEP_SUMMARY
+        echo "\`\`\`bash" >> $GITHUB_STEP_SUMMARY
+        echo "# PyPI" >> $GITHUB_STEP_SUMMARY
+        echo "pip install palabra-ai==${{ steps.get_version.outputs.VERSION }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        if [ "${{ env.DOCKER_PUSH_SUCCESS }}" == "true" ]; then
+          echo "# Docker" >> $GITHUB_STEP_SUMMARY
+          echo "docker pull ${{ env.IMAGE_NAME }}:${{ env.IMAGE_VERSION }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+        fi
+        echo "# From release assets" >> $GITHUB_STEP_SUMMARY
+        echo "pip install https://github.com/${{ github.repository }}/releases/download/${{ steps.get_version.outputs.TAG_NAME }}/palabra_ai-${{ steps.get_version.outputs.VERSION }}-py3-none-any.whl" >> $GITHUB_STEP_SUMMARY
+        echo "\`\`\`" >> $GITHUB_STEP_SUMMARY

palabra_ai-0.1.2/.github/workflows/sync-tag-to-version.yml

@@ -0,0 +1,108 @@
+name: Update Version from Tag
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  update-version:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+        fetch-depth: 0  # Need full history to update tag
+
+    - name: Extract version from tag
+      id: extract_version
+      run: |
+        # Get tag name and remove 'v' prefix
+        TAG_NAME="${GITHUB_REF#refs/tags/}"
+        VERSION="${TAG_NAME#v}"
+        echo "tag_name=$TAG_NAME" >> $GITHUB_OUTPUT
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+        echo "Tag: $TAG_NAME, Version: $VERSION"
+
+    - name: Update version in pyproject.toml and __init__.py
+      run: |
+        VERSION="${{ steps.extract_version.outputs.version }}"
+        
+        # Update pyproject.toml and __init__.py using Python for safety
+        python << 'EOF'
+        import re
+        import os
+        
+        version = os.environ.get('VERSION', '${{ steps.extract_version.outputs.version }}')
+        
+        # Update pyproject.toml
+        with open('pyproject.toml', 'r') as f:
+            content = f.read()
+        
+        # Replace version - handle any spacing and quote style
+        pattern = r'(version\s*=\s*["\'])([0-9]+\.[0-9]+\.[0-9]+(?:(?:a|b|rc|dev)[0-9]+)?)(["\'])'
+        replacement = rf'\g<1>{version}\g<3>'
+        content = re.sub(pattern, replacement, content)
+        
+        with open('pyproject.toml', 'w') as f:
+            f.write(content)
+        
+        # Update src/palabra_ai/__init__.py
+        with open('src/palabra_ai/__init__.py', 'r') as f:
+            content = f.read()
+        
+        # Replace __version__ - handle any spacing and quote style
+        pattern = r'(__version__\s*=\s*["\'])([0-9]+\.[0-9]+\.[0-9]+(?:(?:a|b|rc|dev)[0-9]+)?)(["\'])'
+        replacement = rf'\g<1>{version}\g<3>'
+        content = re.sub(pattern, replacement, content)
+        
+        with open('src/palabra_ai/__init__.py', 'w') as f:
+            f.write(content)
+        EOF
+        
+        # Configure git
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        
+        # Check if there are changes
+        if git diff --quiet; then
+          echo "No changes needed - version already matches tag"
+          echo "skip_update=true" >> $GITHUB_ENV
+        else
+          # Commit changes
+          git add pyproject.toml src/palabra_ai/__init__.py
+          git commit -m "Update version to $VERSION from tag ${{ steps.extract_version.outputs.tag_name }}"
+          echo "skip_update=false" >> $GITHUB_ENV
+        fi
+
+    - name: Update tag to point to new commit
+      if: env.skip_update == 'false'
+      run: |
+        TAG_NAME="${{ steps.extract_version.outputs.tag_name }}"
+        
+        # Push the commit to main
+        git push origin HEAD:main
+        
+        # Force update the tag to point to the new commit
+        git tag -f $TAG_NAME
+        git push origin $TAG_NAME --force
+        
+        echo "✅ Tag $TAG_NAME now points to the commit with updated version"
+
+    - name: Summary
+      run: |
+        if [ "${{ env.skip_update }}" == "true" ]; then
+          echo "## No Update Needed 🟢" >> $GITHUB_STEP_SUMMARY
+          echo "Version in pyproject.toml and __init__.py already matches tag ${{ steps.extract_version.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
+        else
+          echo "## Version Updated! 🎉" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "- **Tag**: ${{ steps.extract_version.outputs.tag_name }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Version**: ${{ steps.extract_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Action**: Updated pyproject.toml and __init__.py, moved tag to new commit" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "The release workflow will start automatically for the updated tag." >> $GITHUB_STEP_SUMMARY
+        fi

palabra_ai-0.1.2/.github/workflows/test.yml

@@ -0,0 +1,47 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install system dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y portaudio19-dev
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+
+    - name: Install dependencies
+      run: |
+        uv sync --all-extras --dev
+
+    - name: Run tests with pytest
+      run: |
+        uv run pytest -vs --cov=palabra_ai --cov-report=xml --cov-report=html
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false

palabra_ai-0.1.2/.github/workflows/version-bump.yml

@@ -0,0 +1,128 @@
+name: Version Bump
+
+on:
+  workflow_dispatch:
+    inputs:
+      bump_type:
+        description: 'Version bump type'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+          - alpha
+          - beta
+          - rc
+
+jobs:
+  create-version-tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Get current version
+      id: current_version
+      run: |
+        python << 'EOF'
+        import re
+        import sys
+
+        with open('pyproject.toml', 'r') as f:
+            content = f.read()
+            match = re.search(r'version\s*=\s*["\']([0-9]+\.[0-9]+\.[0-9]+(?:(?:a|b|rc|dev)[0-9]+)?)["\']', content)
+            if match:
+                print(f"version={match.group(1)}")
+            else:
+                print('ERROR: Version not found', file=sys.stderr)
+                sys.exit(1)
+        EOF >> $GITHUB_OUTPUT
+
+    - name: Calculate new version
+      id: new_version
+      run: |
+        python << 'EOF'
+        import re
+        import os
+        import sys
+
+        current = "${{ steps.current_version.outputs.version }}"
+        bump_type = "${{ github.event.inputs.bump_type }}"
+
+        # Parse current version
+        match = re.match(r'([0-9]+)\.([0-9]+)\.([0-9]+)(?:(a|b|rc)([0-9]+))?', current)
+        if not match:
+            print(f"ERROR: Invalid version format: {current}", file=sys.stderr)
+            sys.exit(1)
+
+        major = int(match.group(1))
+        minor = int(match.group(2))
+        patch = int(match.group(3))
+        pre_type = match.group(4)
+        pre_num = int(match.group(5)) if match.group(5) else 0
+
+        # Calculate new version
+        if bump_type == "major":
+            major += 1
+            minor = 0
+            patch = 0
+            new_version = f"{major}.{minor}.{patch}"
+        elif bump_type == "minor":
+            minor += 1
+            patch = 0
+            new_version = f"{major}.{minor}.{patch}"
+        elif bump_type == "patch":
+            if pre_type:  # If current is pre-release, just remove pre-release
+                new_version = f"{major}.{minor}.{patch}"
+            else:
+                patch += 1
+                new_version = f"{major}.{minor}.{patch}"
+        elif bump_type in ["alpha", "beta", "rc"]:
+            if pre_type == bump_type[0]:  # Same pre-release type
+                pre_num += 1
+            else:
+                pre_num = 1
+            new_version = f"{major}.{minor}.{patch}{bump_type[0]}{pre_num}"
+
+        # Write to GitHub output
+        with open(os.environ['GITHUB_OUTPUT'], 'a') as f:
+            f.write(f"version={new_version}\n")
+
+        print(f"New version: {new_version}")
+        EOF
+
+    - name: Create and push tag
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+
+        # Create tag
+        git tag v${{ steps.new_version.outputs.version }}
+
+        # Push tag - this will trigger sync-tag-to-version workflow
+        git push origin v${{ steps.new_version.outputs.version }}
+
+    - name: Summary
+      run: |
+        echo "## Version Tag Created! 🎉" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "- **From**: ${{ steps.current_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **To**: ${{ steps.new_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **Type**: ${{ github.event.inputs.bump_type }}" >> $GITHUB_STEP_SUMMARY
+        echo "- **Tag**: v${{ steps.new_version.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "The tag will trigger:" >> $GITHUB_STEP_SUMMARY
+        echo "1. Update version in pyproject.toml to match the tag" >> $GITHUB_STEP_SUMMARY
+        echo "2. Move the tag to the commit with updated version" >> $GITHUB_STEP_SUMMARY
+        echo "3. Create a release automatically" >> $GITHUB_STEP_SUMMARY

palabra_ai-0.1.2/.gitignore

@@ -0,0 +1,156 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.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/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# VSCode
+.vscode/
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+
+
+
+# uv
+uv.lock

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

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-merge-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.7.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format