waha-py 2026.7.1__tar.gz

waha_py-2026.7.1/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+
+    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 dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint with ruff
+        run: |
+          ruff check .
+
+      - name: Run tests
+        run: |
+          pytest

waha_py-2026.7.1/.github/workflows/publish-trusted.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  pypi-publish:
+    name: Build and publish Python distribution to PyPI
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # Mandatory for PyPI Trusted Publishing (OIDC)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tool
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

waha_py-2026.7.1/.github/workflows/update-types.yml

@@ -0,0 +1,170 @@
+name: Update OpenAPI Types
+
+on:
+  schedule:
+    # Run daily at midnight UTC
+    - cron: '0 0 * * *'
+  workflow_dispatch:
+    inputs:
+      force_release:
+        description: 'Force a new release even if no changes'
+        required: false
+        default: false
+        type: boolean
+
+env:
+  WAHA_URL: http://localhost:3000
+  WHATSAPP_SWAGGER_USERNAME: WHATSAPP_SWAGGER_USERNAME
+  WHATSAPP_SWAGGER_PASSWORD: WHATSAPP_SWAGGER_PASSWORD
+  WAHA_DASHBOARD_USERNAME: WAHA_DASHBOARD_USERNAME
+  WAHA_DASHBOARD_PASSWORD: WAHA_DASHBOARD_PASSWORD
+  WAHA_API_KEY: WAHA_API_KEY
+
+jobs:
+  update-types:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GH_PAT }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Get current OpenAPI SHA
+        id: old_sha
+        run: |
+          if [ -f openapi.json ]; then
+            SHA=$(sha256sum openapi.json | cut -d' ' -f1)
+            echo "sha=$SHA" >> $GITHUB_OUTPUT
+            echo "Current OpenAPI SHA: $SHA"
+          else
+            echo "sha=none" >> $GITHUB_OUTPUT
+            echo "No existing openapi.json"
+          fi
+
+      - name: Start WAHA container
+        run: |
+          docker run -d \
+            --name waha \
+            -p 3000:3000 \
+            -e WHATSAPP_SWAGGER_USERNAME=${{ env.WHATSAPP_SWAGGER_USERNAME }} \
+            -e WHATSAPP_SWAGGER_PASSWORD=${{ env.WHATSAPP_SWAGGER_PASSWORD }} \
+            -e WAHA_DASHBOARD_USERNAME=${{ env.WAHA_DASHBOARD_USERNAME }} \
+            -e WAHA_DASHBOARD_PASSWORD=${{ env.WAHA_DASHBOARD_PASSWORD }} \
+            -e WAHA_API_KEY=${{ env.WAHA_API_KEY }} \
+            devlikeapro/waha:latest
+
+      - name: Wait for WAHA to be ready
+        run: |
+          echo "Waiting for WAHA to start..."
+          for i in {1..60}; do
+            if curl -s -u ${{ env.WHATSAPP_SWAGGER_USERNAME }}:${{ env.WHATSAPP_SWAGGER_PASSWORD }} ${{ env.WAHA_URL }}/-json > /dev/null 2>&1; then
+              echo "WAHA is ready!"
+              break
+            fi
+            if docker logs waha 2>&1 | grep -q "WhatsApp HTTP API is running"; then
+              sleep 2
+              echo "WAHA started, checking API..."
+            fi
+            echo "Waiting... ($i/60)"
+            sleep 2
+          done
+
+      - name: Fetch OpenAPI spec
+        run: |
+          if ! curl -f -s -u ${{ env.WHATSAPP_SWAGGER_USERNAME }}:${{ env.WHATSAPP_SWAGGER_PASSWORD }} -o openapi.json ${{ env.WAHA_URL }}/-json; then
+            echo "Fixed credentials failed, extracting from logs..."
+            SWAGGER_PASSWORD=$(docker logs waha 2>&1 | grep "WHATSAPP_SWAGGER_PASSWORD=" | tail -1 | cut -d'=' -f2)
+            curl -u admin:$SWAGGER_PASSWORD -o openapi.json ${{ env.WAHA_URL }}/-json
+          fi
+          echo "OpenAPI spec size: $(wc -c < openapi.json) bytes"
+
+      - name: Stop WAHA container
+        if: always()
+        run: docker stop waha || true
+
+      - name: Get new OpenAPI SHA
+        id: new_sha
+        run: |
+          SHA=$(sha256sum openapi.json | cut -d' ' -f1)
+          echo "sha=$SHA" >> $GITHUB_OUTPUT
+          echo "New OpenAPI SHA: $SHA"
+
+      - name: Check for changes
+        id: changes
+        run: |
+          if [ "${{ steps.old_sha.outputs.sha }}" = "${{ steps.new_sha.outputs.sha }}" ]; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "No changes detected (SHA match)"
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "Changes detected!"
+            echo "Old SHA: ${{ steps.old_sha.outputs.sha }}"
+            echo "New SHA: ${{ steps.new_sha.outputs.sha }}"
+          fi
+
+      - name: Generate code & models
+        if: steps.changes.outputs.has_changes == 'true' || inputs.force_release == true
+        run: python scripts/generate.py
+
+      - name: Get WAHA version
+        if: steps.changes.outputs.has_changes == 'true' || inputs.force_release == true
+        id: waha_version
+        run: |
+          VERSION=$(python3 -c "import json; spec=json.load(open('openapi.json')); print(spec.get('info', {}).get('version', '2026.7.1'))")
+          echo "waha_version=$VERSION" >> $GITHUB_OUTPUT
+          echo "WAHA version: $VERSION"
+
+      - name: Update pyproject.toml version
+        if: steps.changes.outputs.has_changes == 'true' || inputs.force_release == true
+        id: bump_version
+        run: |
+          VERSION="${{ steps.waha_version.outputs.waha_version }}"
+          echo "New version: $VERSION"
+          python3 -c "
+          import re
+          content = open('pyproject.toml').read()
+          new_content = re.sub(r'version\s*=\s*\".*?\"', f'version = \"{VERSION}\"', content, count=1)
+          open('pyproject.toml', 'w').write(new_content)
+          "
+          echo "new_version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Commit and tag
+        if: steps.changes.outputs.has_changes == 'true' || inputs.force_release == true
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git add openapi.json openapi_cleaned.json src/ pyproject.toml
+          git commit -m "chore: update types for WAHA ${{ steps.waha_version.outputs.waha_version }}"
+          git tag -a "v${{ steps.bump_version.outputs.new_version }}" -m "Release v${{ steps.bump_version.outputs.new_version }} for WAHA ${{ steps.waha_version.outputs.waha_version }}"
+          git push --follow-tags
+
+      - name: Create GitHub Release
+        if: steps.changes.outputs.has_changes == 'true' || inputs.force_release == true
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: v${{ steps.bump_version.outputs.new_version }}
+          name: v${{ steps.bump_version.outputs.new_version }}
+          body: |
+            ## WAHA Version
+            This release was generated from WAHA version **${{ steps.waha_version.outputs.waha_version }}**
+
+            ## Installation
+            ```bash
+            pip install waha-py==${{ steps.bump_version.outputs.new_version }}
+            ```
+          generate_release_notes: true

waha_py-2026.7.1/.gitignore

@@ -0,0 +1,26 @@
+# Byte-compiled / optimized files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Environments
+.venv/
+venv/
+env/
+
+# Tool caches & test coverage
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# IDE / OS
+.DS_Store
+.vscode/
+.idea/

waha_py-2026.7.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muhammed Mustafa AKŞAM
+
+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.

waha_py-2026.7.1/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: waha-py
+Version: 2026.7.1
+Summary: Python SDK for WAHA (WhatsApp HTTP API) - auto-generated from OpenAPI spec with full type safety, sync & async support.
+Project-URL: Homepage, https://github.com/muhammedaksam/waha-py
+Project-URL: Documentation, https://github.com/muhammedaksam/waha-py#readme
+Project-URL: Repository, https://github.com/muhammedaksam/waha-py
+Project-URL: Issues, https://github.com/muhammedaksam/waha-py/issues
+Author-email: Muhammed Mustafa AKŞAM <info@muhammedaksam.com.tr>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: http-api,httpx,pydantic,python,sdk,waha,whatsapp,whatsapp-api
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: eval-type-backport>=0.1.0; python_version < '3.10'
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: datamodel-code-generator>=0.25.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# waha-py
+
+[![PyPI version](https://img.shields.io/pypi/v/waha-py.svg)](https://pypi.org/project/waha-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/)
+
+Python SDK for [WAHA (WhatsApp HTTP API)](https://github.com/devlikeapro/waha) - auto-generated from OpenAPI spec with full type safety, Pydantic v2 models, and HTTPX-based synchronous & asynchronous clients.
+
+## Installation
+
+```bash
+pip install waha-py
+```
+
+## Usage
+
+### Synchronous Client
+
+```python
+from waha import WahaClient
+
+# Initialize with baseURL and optional API key
+client = WahaClient("http://localhost:3000", api_key="your-api-key")
+
+# Access controllers via properties
+# Sessions
+sessions = client.sessions.list()
+
+# Chatting
+message = client.chatting.send_text(
+    session="default",
+    payload={
+        "chatId": "1234567890@c.us",
+        "text": "Hello from waha-py!",
+    },
+)
+
+# Get QR Code
+qr = client.auth.get_qr(session="default", params={"format": "raw"})
+
+# Always close client when done
+client.close()
+```
+
+### Asynchronous Client
+
+```python
+import asyncio
+from waha import AsyncWahaClient
+
+
+async def main():
+    async_client = AsyncWahaClient("http://localhost:3000", api_key="your-api-key")
+
+    # Send message asynchronously
+    message = await async_client.chatting.a_send_text(
+        session="default",
+        payload={
+            "chatId": "1234567890@c.us",
+            "text": "Async hello from waha-py!",
+        },
+    )
+
+    await async_client.close()
+
+
+asyncio.run(main())
+```
+
+## API Controllers
+
+All endpoints are available through client properties:
+
+```python
+client.sessions.*      # SessionsApi
+client.chatting.*      # ChattingApi
+client.contacts.*      # ContactsApi
+client.groups.*        # GroupsApi
+client.auth.*          # AuthApi
+client.labels.*        # LabelsApi
+client.presence.*      # PresenceApi
+client.profile.*       # ProfileApi
+client.media.*         # MediaApi
+# ...and more
+```
+
+## Pydantic Models
+
+All types are auto-generated from the WAHA OpenAPI specification using Pydantic v2:
+
+```python
+from waha.generated.models import SessionInfo, MessageTextRequest, WAMessage
+```
+
+## How It Works
+
+This package is automatically kept in sync with WAHA:
+
+1. **Daily** - GitHub Action spins up latest `devlikeapro/waha` container
+2. **Fetches** OpenAPI spec from `/-json` endpoint
+3. **Compares** SHA256 hash with committed `openapi.json`
+4. **If changed** - Generates new types + Python clients, bumps version, commits, and pushes tag
+5. **Publishes** to PyPI via OIDC trusted publishing
+
+## Development
+
+### Prerequisites
+
+- Python >= 3.9
+- Running WAHA instance (or `openapi.json`)
+
+### Generate Types & Clients Locally
+
+```bash
+# Install development dependencies
+pip install -e ".[dev]"
+
+# Generate models and clients from openapi.json
+python scripts/generate.py
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

waha_py-2026.7.1/README.md

@@ -0,0 +1,127 @@
+# waha-py
+
+[![PyPI version](https://img.shields.io/pypi/v/waha-py.svg)](https://pypi.org/project/waha-py/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/)
+
+Python SDK for [WAHA (WhatsApp HTTP API)](https://github.com/devlikeapro/waha) - auto-generated from OpenAPI spec with full type safety, Pydantic v2 models, and HTTPX-based synchronous & asynchronous clients.
+
+## Installation
+
+```bash
+pip install waha-py
+```
+
+## Usage
+
+### Synchronous Client
+
+```python
+from waha import WahaClient
+
+# Initialize with baseURL and optional API key
+client = WahaClient("http://localhost:3000", api_key="your-api-key")
+
+# Access controllers via properties
+# Sessions
+sessions = client.sessions.list()
+
+# Chatting
+message = client.chatting.send_text(
+    session="default",
+    payload={
+        "chatId": "1234567890@c.us",
+        "text": "Hello from waha-py!",
+    },
+)
+
+# Get QR Code
+qr = client.auth.get_qr(session="default", params={"format": "raw"})
+
+# Always close client when done
+client.close()
+```
+
+### Asynchronous Client
+
+```python
+import asyncio
+from waha import AsyncWahaClient
+
+
+async def main():
+    async_client = AsyncWahaClient("http://localhost:3000", api_key="your-api-key")
+
+    # Send message asynchronously
+    message = await async_client.chatting.a_send_text(
+        session="default",
+        payload={
+            "chatId": "1234567890@c.us",
+            "text": "Async hello from waha-py!",
+        },
+    )
+
+    await async_client.close()
+
+
+asyncio.run(main())
+```
+
+## API Controllers
+
+All endpoints are available through client properties:
+
+```python
+client.sessions.*      # SessionsApi
+client.chatting.*      # ChattingApi
+client.contacts.*      # ContactsApi
+client.groups.*        # GroupsApi
+client.auth.*          # AuthApi
+client.labels.*        # LabelsApi
+client.presence.*      # PresenceApi
+client.profile.*       # ProfileApi
+client.media.*         # MediaApi
+# ...and more
+```
+
+## Pydantic Models
+
+All types are auto-generated from the WAHA OpenAPI specification using Pydantic v2:
+
+```python
+from waha.generated.models import SessionInfo, MessageTextRequest, WAMessage
+```
+
+## How It Works
+
+This package is automatically kept in sync with WAHA:
+
+1. **Daily** - GitHub Action spins up latest `devlikeapro/waha` container
+2. **Fetches** OpenAPI spec from `/-json` endpoint
+3. **Compares** SHA256 hash with committed `openapi.json`
+4. **If changed** - Generates new types + Python clients, bumps version, commits, and pushes tag
+5. **Publishes** to PyPI via OIDC trusted publishing
+
+## Development
+
+### Prerequisites
+
+- Python >= 3.9
+- Running WAHA instance (or `openapi.json`)
+
+### Generate Types & Clients Locally
+
+```bash
+# Install development dependencies
+pip install -e ".[dev]"
+
+# Generate models and clients from openapi.json
+python scripts/generate.py
+
+# Run tests
+pytest
+```
+
+## License
+
+MIT

waha_py-2026.7.1/example.py

@@ -0,0 +1,23 @@
+import asyncio
+
+from waha import AsyncWahaClient, WahaClient
+
+
+def sync_example():
+    print("=== Sync Example ===")
+    client = WahaClient("http://localhost:3000", api_key="secret")
+    print("Initialized WahaClient successfully.")
+    print("Available controllers:", [attr for attr in dir(client) if not attr.startswith("_")])
+    client.close()
+
+
+async def async_example():
+    print("\n=== Async Example ===")
+    async_client = AsyncWahaClient("http://localhost:3000", api_key="secret")
+    print("Initialized AsyncWahaClient successfully.")
+    await async_client.close()
+
+
+if __name__ == "__main__":
+    sync_example()
+    asyncio.run(async_example())