feat!: Add Toolbox LangChain SDK code from 'main' branch of https://g…

.github/auto-label.yaml

@@ -0,0 +1,15 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+enabled: false

.github/header-checker-lint.yaml

@@ -0,0 +1,22 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+allowedCopyrightHolders:
+  - 'Google LLC'
+allowedLicenses:
+  - 'Apache-2.0'
+sourceFileExtensions:
+  - 'py'
+  - 'yaml'
+  - 'yml'

.github/labels.yaml

@@ -0,0 +1,70 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+- name: duplicate
+  color: ededed
+  description: ""
+
+- name: 'type: bug'
+  color: db4437
+  description: Error or flaw in code with unintended results or allowing sub-optimal
+    usage patterns.
+- name: 'type: cleanup'
+  color: c5def5
+  description: An internal cleanup or hygiene concern.
+- name: 'type: docs'
+  color: 0000A0
+  description: Improvement to the documentation for an API.
+- name: 'type: feature request'
+  color: c5def5
+  description: ‘Nice-to-have’ improvement, new feature or different behavior or design.
+- name: 'type: process'
+  color: c5def5
+  description: A process-related concern. May include testing, release, or the like.
+- name: 'type: question'
+  color: c5def5
+  description: Request for information or clarification.
+
+- name: 'priority: p0'
+  color: b60205
+  description: Highest priority. Critical issue. P0 implies highest priority.
+- name: 'priority: p1'
+  color: ffa03e
+  description: Important issue which blocks shipping the next release. Will be fixed
+    prior to next release.
+- name: 'priority: p2'
+  color: fef2c0
+  description: Moderately-important priority. Fix may not be included in next release.
+- name: 'priority: p3'
+  color: ffffc7
+  description: Desirable enhancement or fix. May not be included in next release.
+
+- name: do not merge
+  color: d93f0b
+  description: Indicates a pull request not ready for merge, due to either quality
+    or timing.
+
+- name: 'autorelease: pending'
+  color: ededed
+  description: Release please needs to do its work on this.
+- name: 'autorelease: triggered'
+  color: ededed
+  description: Release please has triggered a release for this.
+- name: 'autorelease: tagged'
+  color: ededed
+  description: Release please has completed a release for this.
+
+- name: 'tests: run'
+  color: 3DED97
+  description: Label to trigger Github Action tests.

.github/release-please.yml

@@ -0,0 +1,18 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+handleGHRelease: true
+packageName: genai-toolbox-langchain-python
+releaseType: simple
+versionFile: "cmd/version.txt"

.github/sync-repo-settings.yaml

@@ -12,7 +12,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-
 # Synchronize repository settings from a centralized config
 # https://github.com/googleapis/repo-automation-bots/tree/main/packages/sync-repo-settings
 # Install: https://github.com/apps/sync-repo-settings
@@ -23,14 +22,19 @@ squashMergeAllowed: true
 mergeCommitAllowed: false
 # Enable branch protection
 branchProtectionRules:
-- pattern: main
-  isAdminEnforced: true
-  requiredStatusCheckContexts:
-    - 'cla/google'
-  # - Add required status checks like presubmit tests
-  requiredApprovingReviewCount: 1
-  requiresCodeOwnerReviews: true
-  requiresStrictStatusChecks: true
+  - pattern: main
+    isAdminEnforced: true
+    requiredStatusCheckContexts:
+      - "cla/google"
+      - "lint"
+      - "conventionalcommits.org"
+      - "header-check"
+    # - Add required status checks like presubmit tests
+      - "unit tests (ubuntu-latest)"
+      - "integration-test-pr (toolbox-testing-438616)"
+    requiredApprovingReviewCount: 1
+    requiresCodeOwnerReviews: true
+    requiresStrictStatusChecks: true
 
 # Set team access
 permissionRules:

.github/workflows/integration.cloudbuild.yaml

@@ -0,0 +1,46 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+steps:
+  - id: Install library requirements
+    name: 'python:${_VERSION}'
+    args:
+      - install
+      - '-r'
+      - './requirements.txt'
+      - '--user'
+    entrypoint: pip
+  - id: Install test requirements
+    name: 'python:${_VERSION}'
+    args:
+      - install
+      - '.[test]'
+      - '--user'
+    entrypoint: pip
+  - id: Run integration tests
+    name: 'python:${_VERSION}'
+    env:
+      - TOOLBOX_URL=$_TOOLBOX_URL
+      - TOOLBOX_VERSION=$_TOOLBOX_VERSION
+      - GOOGLE_CLOUD_PROJECT=$PROJECT_ID
+    args:
+      - '-c'
+      - >-
+        python -m pytest ./tests/
+    entrypoint: /bin/bash
+options:
+  logging: CLOUD_LOGGING_ONLY
+substitutions:
+  _VERSION: '3.13'
+  _TOOLBOX_VERSION: '0.0.5'

.github/workflows/lint.yaml

@@ -0,0 +1,57 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: lint
+on:
+  pull_request:
+    paths:
+      - './**'
+      - '!./**/*.md'
+
+# Declare default permissions as read only.
+permissions: read-all
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+      cancel-in-progress: true
+    defaults:
+      run:
+        working-directory: ./
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
+
+      - name: Setup Python
+        uses: actions/setup-python@0b93645e9fea7318ecaed2b359559ac225c90a2b # v5.3.0
+        with:
+          python-version: "3.13"
+
+      - name: Install library requirements
+        run: pip install -r requirements.txt
+
+      - name: Install test requirements
+        run: pip install .[test]
+
+      - name: Run linters
+        run: |
+          black --check .
+          isort --check .
+
+      - name: Run type-check
+        env:
+          MYPYPATH: './src'
+        run: mypy --install-types --non-interactive --cache-dir=.mypy_cache/ -p toolbox_langchain_sdk

.github/workflows/sync-labels.yaml

@@ -0,0 +1,37 @@
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Sync Labels
+on:
+  push:
+    branches:
+      - main
+
+# Declare default permissions as read only.
+permissions: read-all
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: 'read'
+      issues: 'write'
+      pull-requests: 'write'
+    steps:
+      - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
+      - uses: micnncim/action-label-syncer@3abd5ab72fda571e69fffd97bd4e0033dd5f495c # v1.3.0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          manifest: .github/labels.yaml

DEVELOPER.md

@@ -3,35 +3,35 @@
 Below are the details to set up a development environment and run tests.
 
 ## Install
-
 1. Clone the repository:
-
     ```bash
-    git clone https://github.com/googleapis/genai-toolbox-langchain-sdk-python.git
+
+    git clone https://github.com/googleapis/genai-toolbox-langchain-python
+    ```
+1. Navigate to the repo directory:
+    ```bash
+    cd genai-toolbox-langchain-python
     ```
-
 1. Install the package in editable mode, so changes are reflected without
    reinstall:
-
     ```bash
     pip install -e .
     ```
-
 1. Make code changes and contribute to the SDK's development.
-
 > [!TIP] Using `-e` option allows you to make changes to the SDK code and have
 > those changes reflected immediately without reinstalling the package.
 
 ## Test
-
+1. Navigate to the SDK directory:
+    ```bash
+    cd genai-toolbox-langchain-python
+    ```
 1. Install the SDK and test dependencies:
-
     ```bash
     pip install -e .[test]
     ```
-
 1. Run tests and/or contribute to the SDK's development.
 
     ```bash
     pytest
-    ```
+    ```