Release v1.0.0b1

Author: Silviano Diaz

.github/workflows/build.yml

@@ -0,0 +1,41 @@
+name: Build oracle-vecdb Python SDK
+
+permissions:
+  contents: read
+
+# Build job automatically on tags, e.g., v1.0.0, v2.1.3, etc.
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout the repository to access code and build artifacts
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # Set up Python for building the SDK
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      # Install build dependencies
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      # Build vecdb Python SDK
+      - name: Build vecdb Python SDK
+        run: python -m build --sdist --wheel --outdir dist/
+
+      # Upload build artifacts for use in Publish workflow
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: vecdb-python-sdk-artifacts
+          path: dist/*

.github/workflows/publish.yml

@@ -0,0 +1,89 @@
+name: Publish oracle-vecdb Python SDK
+
+permissions:
+  contents: write
+  actions: read
+  id-token: write
+
+# Publish job triggered manually via GitHub UI or API
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    environment: oracle-vecdb-release
+    runs-on: ubuntu-latest
+    steps:
+      # Checkout the repository to access changelog
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      # Download artifacts from latest run of Build oracle-vecdb Python SDK workflow
+      - name: Download artifacts
+        env:
+          GH_TOKEN: ${{ github.token }}
+        # Use gh to find and download the artifact
+        run: |
+          mkdir -p dist
+          gh run download --name vecdb-python-sdk-artifacts --dir dist --repo ${{ github.repository }}
+      
+      # Publish to PyPI via Trusted Publisher (OIDC)
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+      # Extract release notes from CHANGELOG.rst
+      - name: Extract release notes
+        id: release_notes
+        shell: python
+        run: |
+          import re
+          import sys
+          import os
+          from pathlib import Path
+
+          # 1. Prepare version string
+          tag = "${{ github.ref_name }}"
+          version = tag.lstrip("v")
+          
+          # 2. Load file
+          changelog_path = Path("CHANGELOG.rst")
+          if not changelog_path.exists():
+              print(f"::error::CHANGELOG.rst not found")
+              sys.exit(1)
+          
+          content = changelog_path.read_text()
+
+          # 3. Regex Breakdown:
+          # ^ matches start of line (due to MULTILINE)
+          # {version} \s+ - \s+ \d{{4}}... matches "1.0.0 - 2026-03-17"
+          # \n-+ matches the underline of dashes/equals
+          # (.*?) captures the body until the next version header or end of file (\Z)
+          pattern = re.compile(
+              rf"^{re.escape(version)}\s+-\s+\d{{4}}-\d{{2}}-\d{{2}}\n-+\n(.*?)(?=\n\d+\.\d+\.\d+\s+-\s+\d{{4}}-\d{{2}}-\d{{2}}\n-+|\Z)",
+              re.DOTALL | re.MULTILINE
+          )
+
+          match = pattern.search(content)
+          
+          if match:
+              notes = match.group(1).strip()
+          else:
+              print(f"::warning::No section found for version {version}")
+              notes = "No release notes found in CHANGELOG.rst"
+
+          # 4. The "Heredoc" method for multi-line GitHub outputs
+          # This writes to the unique file path provided by the runner environment
+          output_file = os.environ['GITHUB_OUTPUT']
+          with open(output_file, 'a') as f:
+              f.write(f"RELEASE_NOTES<<EOF\n{notes}\nEOF\n")
+
+      # Create GitHub Release
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create ${{ github.ref_name }} \
+            --title "${{ github.ref_name }}" \
+            --notes "${{ steps.release_notes.outputs.RELEASE_NOTES }}"

.github/workflows/python.yml

@@ -0,0 +1,34 @@
+# NOTE: This file is auto generated by OpenAPI Generator.
+# URL: https://openapi-generator.tech
+#
+# ref: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: oracle_vecdb_internal Python package
+
+on: [push, pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r test-requirements.txt
+      - name: Test with pytest
+        run: |
+          pytest --cov=oracle_vecdb_internal

.gitignore

@@ -0,0 +1,73 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# 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/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+reports/
+
+venv/
+.venv/
+.vscode/
+.python-version
+.pytest_cache
+.mypy_cache/
+
+
+# Translations
+*.mo
+*.pot
+
+*.log
+
+# Sphinx documentation
+docs/build/
+
+# PyBuilder
+target/
+
+# Ipython Notebook
+.ipynb_checkpoints
+
+# Oracle Parfait analysis cache
+__parfait__/

CHANGELOG.rst

@@ -0,0 +1,19 @@
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+The format is based on the `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>`__.
+
+.. Unreleased
+.. ----------
+
+1.0.0b1 - 2026-03-24
+------------------
+
+Added
+~~~~~
+
+- Limited Availability release.
+- Support for vector table management, indexing, search, and inference operations in Oracle AI Database (26ai+).

MANIFEST.in

@@ -0,0 +1,2 @@
+include LICENSE.txt README.md CHANGELOG.rst pyproject.toml
+recursive-include examples *.py