#6 delaying tests to get buffers cleaned

.github/workflows/release.yml

@@ -0,0 +1,100 @@
+name: Build and Release
+
+on:
+  push:
+    branches:
+      - main
+      - devel
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      create_release:
+        description: "Create a draft release (for testing)"
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  build-and-release:
+    name: Build and Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # Needed to create releases
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Required for git history access
+
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libcairo2 libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev pandoc
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Get Version
+        id: get_version
+        run: |
+          if [[ "${{ github.ref_type }}" == "tag" ]]; then
+            VERSION_NUMBER="${{ github.ref_name }}"
+            VERSION_NUMBER="${VERSION_NUMBER#v}"
+          else
+            VERSION_NUMBER=$(grep '^VERSION' src/dtagent/version.py | cut -d '"' -f 2)
+            if [[ -z "$VERSION_NUMBER" ]]; then
+              echo "Error: Failed to extract version from src/dtagent/version.py. File may be missing or format may be incorrect."
+              exit 1
+            fi
+          fi
+          echo "VERSION=${VERSION_NUMBER}" >> $GITHUB_OUTPUT
+
+      - name: Clean up previous build artifacts
+        run: |
+          rm -f dynatrace_snowflake_observability_agent-*.zip
+          rm -f Dynatrace-Snowflake-Observability-Agent-*.pdf
+
+      - name: Run package script
+        id: package
+        run: |
+          chmod +x *.sh
+          ./package.sh full
+          BUILD_NUMBER=$(grep 'BUILD =' build/_version.py | awk '{print $3}')
+          echo "ZIP_NAME=dynatrace_snowflake_observability_agent-${{ steps.get_version.outputs.VERSION }}.${BUILD_NUMBER}.zip" >> $GITHUB_OUTPUT
+          echo "PDF_NAME=Dynatrace-Snowflake-Observability-Agent-${{ steps.get_version.outputs.VERSION }}.pdf" >> $GITHUB_OUTPUT
+
+      - name: Upload build artifacts
+        if: github.ref_type != 'tag' && inputs.create_release == false
+        uses: actions/upload-artifact@v4
+        with:
+          name: dsoa-package-${{ steps.get_version.outputs.VERSION }}
+          path: |
+            ${{ steps.package.outputs.ZIP_NAME }}
+            ${{ steps.package.outputs.PDF_NAME }}
+
+      - name: Extract Release Notes from CHANGELOG
+        id: extract_release_notes
+        if: github.ref_type == 'tag' || inputs.create_release == true
+        run: |
+          VERSION_HEADER="## Dynatrace Snowflake Observability Agent ${{ steps.get_version.outputs.VERSION }}"
+          # Use awk to find the section for the current version and print until the next ## heading
+          awk -v header="$VERSION_HEADER" '
+            $0 == header { in_section=1; next }
+            /^## / { if (in_section) exit }
+            in_section { print }
+          ' CHANGELOG.md > release_notes.md
+
+      - name: Create GitHub Release
+        if: github.ref_type == 'tag' || inputs.create_release == true
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: Dynatrace Snowflake Observability Agent ${{ steps.get_version.outputs.VERSION }}
+          body_path: release_notes.md
+          draft: ${{ inputs.create_release == true }}
+          files: |
+            ${{ steps.package.outputs.ZIP_NAME }}
+            ${{ steps.package.outputs.PDF_NAME }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -8,7 +8,7 @@ snowflake.local.yml
 output/**
 log.*
 *.log
-*credentials.json
+*credentials*.json
 *.pyc
 build/*
 package/*

.vscode/settings.json

@@ -42,11 +42,13 @@
         "dashboarding",
         "DATEADD",
         "deadsnakes",
+        "dedup",
         "devel",
         "docstrings",
         "doesn't",
         "dsoa",
         "DTAGENT",
+        "Dynatrace",
         "ECAC",
         "ensurepath",
         "externalbrowser",
@@ -61,6 +63,8 @@
         "jsonstrip",
         "judgements",
         "Kamatchi",
+        "kvlist",
+        "LDATA",
         "libcairo",
         "libgdk",
         "libpango",
@@ -98,6 +102,7 @@
         "snowflakedb",
         "snowpark",
         "SNOWPIPE",
+        "softprops",
         "specversion",
         "spendings",
         "SQLERRM",

CONTRIBUTING.md

@@ -140,11 +140,65 @@ The build process for the Dynatrace Snowflake Observability Agent package involv
 
 ## Setting up development environment
 
-You will need [Python 3.9](https://www.python.org/) or newer and [git](https://git-scm.com/).
-If you are on Windows, you will need to install WSL2. Please refer to the `Prerequisites` in [the installation documentation](INSTALL.md) for more details.
+This guide was created for developers who want to contribute to the Dynatrace Snowflake Observability Agent. If you only want to install and use the agent, please refer to the [INSTALL.md](INSTALL.md) guide.
 
-The recommended setup is to use [VS Code](https://code.visualstudio.com/) with [Snowflake plugin](https://marketplace.visualstudio.com/items?itemName=snowflake.snowflake-vsc). Though neither of those are necessary, and any IDE that supports python and SQL should do.
-On Windows, after installing WSL, it is necessary to open your IDE of choice using WSL (see [Setting up WSL on VS Code guide)](https://learn.microsoft.com/en-us/windows/wsl/tutorials/wsl-vscode).
+### Prerequisites
+
+You will need the following software installed:
+
+* [Python](https://www.python.org/) (3.9 or newer)
+* [Git](https://git-scm.com/)
+* On Windows, [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) is required.
+
+The recommended setup is to use [VS Code](https://code.visualstudio.com/) with the [Snowflake plugin](https://marketplace.visualstudio.com/items?itemName=snowflake.snowflake-vsc).
+
+### Environment Setup
+
+1. **Clone the repository:**
+
+    ```bash
+    git clone https://github.com/dynatrace-oss/dynatrace-snowflake-observability-agent.git
+    cd dynatrace-snowflake-observability-agent
+    ```
+
+1. **Create and activate a virtual environment:**
+
+    ```bash
+    python -m venv .venv
+    source .venv/bin/activate
+    ```
+
+1. **Install dependencies:**
+
+    The `setup.sh` script can help install most of the required tools.
+
+    ```bash
+    ./setup.sh
+    ```
+
+    Alternatively, you can install them manually. You will need the dependencies for running the agent (see `INSTALL.md`) plus the development dependencies.
+
+### System Dependencies
+
+For **Ubuntu/Debian**:
+
+  ```bash
+  sudo apt-get update
+  sudo apt-get install -y pango cairo gdk-pixbuf libffi pandoc
+  ```
+
+For **macOS** (using [Homebrew](https://brew.sh/)):
+
+  ```bash
+  brew install pango cairo gdk-pixbuf libffi pandoc
+  ```
+
+Additional **Python packages** for all platforms are listed in `requirements.txt`.
+Install them using pip:
+
+  ```bash
+  pip install -r requirements.txt
+  ```
 
 ## Building Dynatrace Snowflake Observability Agent