Add otel proto codegen using forward serialization (#42)

.github/workflows/check-codegen.yml

@@ -0,0 +1,36 @@
+# This workflow will delete and regenerate the opentelemetry marshaling code using scripts/proto_codegen.sh.
+# If generating the code produces any changes from what is currently checked in, the workflow will fail and prompt the user to regenerate the code.
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions
+
+name: Check Codegen
+
+on:
+  push:
+    branches: [ "main" ]
+    paths:
+      - "scripts/**"
+      - "src/snowflake/telemetry/_internal/opentelemetry/proto/**"
+      - ".github/workflows/check-codegen.yml"
+  pull_request:
+    branches: [ "main" ]
+    paths:
+      - "scripts/**"
+      - "src/snowflake/telemetry/_internal/opentelemetry/proto/**"
+      - ".github/workflows/check-codegen.yml"
+
+jobs:
+  check-codegen:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Python
+      uses: actions/setup-python@v3
+      with:
+        python-version: "3.11"
+    - name: Run codegen script
+      run: |
+        rm -rf src/snowflake/telemetry/_internal/opentelemetry/proto/
+        ./scripts/proto_codegen.sh
+    - name: Check for changes
+      run: |
+        git diff --exit-code || { echo "Code generation produced changes! Regenerate the code using ./scripts/proto_codegen.sh"; exit 1; }

README.md

@@ -22,6 +22,8 @@ pip install --upgrade pip
 pip install .
 ```
 
+## Development
+
 To develop this package, run
 
 ```bash
@@ -33,3 +35,9 @@ source .venv/bin/activate
 pip install --upgrade pip
 pip install . ./tests/snowflake-telemetry-test-utils
 ```
+
+### Code generation
+
+To regenerate the code under `src/snowflake/_internal/opentelemetry/proto/`, execute the script `./scripts/proto_codegen.sh`. The script expects the `src/snowflake/_internal/opentelemetry/proto/` directory to exist, and will delete all .py files in it before regerating the code.
+
+The commit/branch/tag of [opentelemetry-proto](https://github.com/open-telemetry/opentelemetry-proto) that the code is generated from is pinned to PROTO_REPO_BRANCH_OR_COMMIT, which can be configured in the script. It is currently pinned to the same tag as [opentelemetry-python](https://github.com/open-telemetry/opentelemetry-python/blob/main/scripts/proto_codegen.sh#L15).

scripts/gen-requirements.txt

@@ -0,0 +1,5 @@
+Jinja2==3.1.4
+grpcio-tools==1.62.3
+protobuf==4.25.5
+black==24.10.0
+isort==5.13.2