release 8.0.0a1 to PyPI (DM-3062)

.coveragerc

@@ -1,5 +1,7 @@
 [run]
-source=cognite
+source =
+    cognite
+    tests
 omit =
     cognite/client/_proto/*
 

.gemini/styleguide.md

@@ -73,7 +73,7 @@ import logging
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from requests import Response
+from httpx import Response
 
 from cognite.client.data_classes import Asset
 

.github/workflows/build.yml

@@ -4,7 +4,6 @@ name: build
 on:
   merge_group:
   pull_request:
-    branches: [master]
 
 concurrency:
   group: pr-${{ github.workflow }}-${{ github.head_ref }}
@@ -14,36 +13,46 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/checkout@v5
       - uses: ./.github/actions/setup
         with:
           extras: "-E pandas"
       - name: Linting and static code checks
         run: pre-commit run --all-files --show-diff-on-failure
 
+  verify-sync-codegen:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: ./.github/actions/setup
+        with:
+          extras: "-E pandas"
+      - name: Ensures sync code is up-to-date, with no stale files
+        run: python scripts/sync_client_codegen/main.py verify
+
   build_docs:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/checkout@v5
       - uses: ./.github/actions/setup
       - name: Build docs
         run: cd docs && make html SPHINXOPTS="-W --keep-going"
 
   build_package:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/checkout@v5
       - uses: ./.github/actions/setup
       - name: Build package
         run: poetry build
 
   test_core:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/checkout@v5
       - uses: ./.github/actions/setup
       - name: Test core
-        run: pytest tests/tests_unit -n8 --dist loadscope --maxfail 10 -m 'not dsl' --test-deps-only-core
+        run: pytest tests/tests_unit -n6 --dist loadscope --maxfail 10 -m 'not dsl' --test-deps-only-core
 
   test_full:
     runs-on: ${{ matrix.os }}
@@ -53,7 +62,7 @@ jobs:
         os: [ubuntu-latest, windows-latest]
         python-version: ["3.10", "3.11", "3.12", "3.13"]
     steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/checkout@v5
       - uses: ./.github/actions/setup
         with:
           python_version: ${{ matrix.python-version }}
@@ -73,6 +82,7 @@ jobs:
         run: pytest --durations=10 --cov --cov-report term --cov-report xml:coverage.xml -n8 --dist loadscope --reruns 2 --maxfail 20
 
       - uses: codecov/codecov-action@18283e04ce6e62d37312384ff67231eb8fd56d24 # v5
+        # Report code coverage from windows runner; xdist + ubuntu gives incorrect results
         if: matrix.os == 'windows-latest' && matrix.python-version == '3.10'
         with:
           token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/verify-jupyter.yml

@@ -29,5 +29,5 @@ jobs:
           whl_file=$(find dist -name "*.whl" | sed 's|^dist/||') # Find the built wheel file, remove dist/ prefix
           echo "Found built wheel file: $whl_file"
           SDK_FILE_PATH=$whl_file \
-          PACKAGES="[\"pyodide-http\", \"http://localhost:3000/dist/$whl_file\"]" \
+          PACKAGES="[\"anyio\", \"http://localhost:3000/dist/$whl_file\"]" \
           node scripts/test-pyodide.js

.github/workflows/verify-streamlit.yml

@@ -29,5 +29,5 @@ jobs:
           whl_file=$(find dist -name "*.whl" | sed 's|^dist/||') # Find the built wheel file, remove dist/ prefix
           echo "Found built wheel file: $whl_file"
           SDK_FILE_PATH=$whl_file \
-          PACKAGES="[\"pyodide-http\", \"http://localhost:3000/dist/$whl_file\"]" \
+          PACKAGES="[\"ssl\", \"anyio\", \"http://localhost:3000/dist/$whl_file\"]" \
           node scripts/test-pyodide.js

.pre-commit-config.yaml

@@ -13,6 +13,7 @@ repos:
           - --fix
           - --exit-non-zero-on-fix
           - --force-exclude
+
       - id: ruff-format
         name: ruff format
         language: python
@@ -32,22 +33,11 @@ repos:
     hooks:
       - id: mypy
         name: mypy
-      # Eventually we want to run mypy on the whole test code base. But for now we only enable it for data modeling, simulators and datapoints
-        entry: |
-          poetry run dmypy run -- cognite tests/tests_integration/test_api/test_data_modeling
-          tests/tests_unit/test_data_classes/test_data_models
-          tests/tests_unit/test_utils/test_time.py
-          tests/tests_integration/test_api/test_datapoints.py
-          tests/tests_integration/test_api/test_simulators
-          tests/tests_integration/test_api/test_principals.py
-          tests/tests_unit/test_api/test_simulators
-          tests/tests_unit/test_data_classes/test_simulators.py
+        entry: poetry run dmypy run -- cognite tests
         files: ^.*.(py|pyi)$
         language: system
         pass_filenames: false
 
-  - repo: local
-    hooks:
       - id: custom-checks
         name: custom repo checks
         entry: poetry run python scripts/run_checks.py
@@ -56,8 +46,16 @@ repos:
         pass_filenames: true
         require_serial: true  # avoid possible race conditions
 
+      - id: sync-client-codegen
+        name: run sync codegen on changed files
+        entry: poetry run python scripts/sync_client_codegen/main.py run --files
+        files: ^cognite/.*.(py|pyi)$
+        language: system
+        pass_filenames: true
+        require_serial: true
+
   - repo: https://github.com/jsh9/pydoclint  # Run after 'custom-checks' as these may auto-fix
-    rev: 0.7.3
+    rev: 0.8.1
     hooks:
       - id: pydoclint
         require_serial: true  # Spammy in run-all scenarios (more than fast enough already)

CHANGELOG.md

@@ -13,6 +13,13 @@ As of 2025-08-29, changes are grouped as follows
 - 🐛 Bug Fixes: Bug fixes.
 - ⚡ Improvements: Transparent changes, e.g. better performance.
 
+## [7.89.0](https://github.com/cognitedata/cognite-sdk-python/compare/v7.88.0...v7.89.0) (2025-11-04)
+
+
+### Features
+
+* **simint-alpha:** add kind=long routines support ([#2388](https://github.com/cognitedata/cognite-sdk-python/issues/2388)) ([e9e2c9e](https://github.com/cognitedata/cognite-sdk-python/commit/e9e2c9ee7965aed71b1b8db4f609ab3cb17a7e22))
+
 ## [7.88.0](https://github.com/cognitedata/cognite-sdk-python/compare/v7.87.0...v7.88.0) (2025-10-22)
 
 

CONTRIBUTING.md

@@ -5,7 +5,7 @@
 Get the code!
 
 ```bash
-git clone https://github.com/cognitedata/cognite-sdk-python.git
+git clone https://github.com/cognitedata/cognite-sdk-python
 cd cognite-sdk-python
 ```
 
@@ -15,10 +15,12 @@ Install dependencies and initialize a shell within the virtual environment, with
 
 ```bash
 poetry install -E all
-poetry shell
+poetry env activate
 ```
 
-Install pre-commit hooks to run static code checks on every commit:
+Note that `poetry env activate` only prints out the command, you have to run it yourself (or wrap it in `eval`). You may also prefix commands with `poetry run`.
+
+Install pre-commit hooks to run various checks and linters on every commit:
 
 ```bash
 pre-commit install
@@ -30,9 +32,15 @@ You can also manually trigger the static checks with:
 pre-commit run --all-files
 ```
 
-### Getting access to python-sdk-test CDF project for running integration tests
+To include slower checks that run in CI, include `--hook-stage manual`
+
+```bash
+pre-commit run --all-files --hook-stage manual
+```
+
+### Getting access to `python-sdk-contributor` CDF project for running integration tests
 
-- Request access to python-sdk AAD tenant.
+- Request access to python-sdk AAD tenant. Cognite internals can tag the Python SDK Maintainer shield on Slack.
 - Set environment variables as per the interactive login flow below
 
 ### Environment Variables
@@ -69,6 +77,46 @@ COGNITE_CLIENT_ID=6b0b4266-ffa4-4b9b-8e13-ddbbc8a19ea6
 #COGNITE_CERTIFICATE=aadappcert.pem
 ```
 
+### Automatic Code Generation
+
+The main code base in this repository is written for the `AsyncCogniteClient`. From this source code we also create a
+"sync" `CogniteClient` through automatic code generation. The async->sync conversion script can be found in `scripts/sync_client_codegen/main.py`. It exclusively writes to `cognite/client/_sync_api/` (and temporary files as part of normalized file compares).
+
+The script stores the hash of file it was created from in the module docstring, in order to quickly skip files that don't need to be updated. A variety of updates does not result in actual code changes in the SyncAPIs, as it only wraps the async client directly.
+
+We have certain rules in place that must be followed:
+
+- **Adding nested APIs: Put one API class per file.**
+
+If the entire API addition is "flat", like classic resource types EventsAPI or FilesAPI, please use a single file directly below `cognite/client/_api/`. Else, add a directory instead. There are plenty of existing examples, e.g. IAMAPI, RawAPI.
+
+#### Run modes
+`usage: main.py [-h] [-v] {verify,run} ...`
+
+Use `verify` to ensure all sync source code files are up-to-date and no stale files (that should be removed exists). This is mostly useful as a CI check.
+
+Use `run` to pass a subset of _async_ source files (i.e. anything below `cognite/client/_api/`) to update:
+
+```sh
+python scripts/sync_client_codegen/main.py run --files FILE1 FILE2 ...
+```
+Note: This is how we run it as part of `pre-commit`.
+
+To run through all files, pass `--all-files`. This will also run cleanup automatically:
+
+```sh
+python scripts/sync_client_codegen/main.py run --all-files
+```
+
+If a sync API file has entered into a bad state (e.g. through manual changes), you can simply delete it (or modify
+the hash) to have it re-generated from scratch.
+
+Verbose mode is supported (e.g. debugging). Pass `-v` before the subcommand `run`/`verify`:
+
+```sh
+python scripts/sync_client_codegen/main.py -v [run, verify] ...
+```
+
 ### Testing
 
 Initiate unit tests by running the following command from the root directory:
@@ -84,7 +132,7 @@ If you want to generate code coverage reports run:
 ```
 pytest tests/tests_unit --cov-report html \
                         --cov-report xml \
-                        --cov cognite
+                        --cov cognite tests
 ```
 
 Open `htmlcov/index.html` in the browser to navigate through the report.
@@ -110,8 +158,8 @@ pytest docs
 If you need to add a new capability to the integration runner, you need to create a new Pull Requests (PR) in which
 you do the following:
 
-1. Add a read-only version of the new capability to the `scripts/toolkit/acces/auth/readonly.Group.yaml`
-2. Add a read-write version of the new capability to the `scripts/toolkit/acces/auth/readwrite.Group.yaml`
+1. Add a read-only version of the new capability to the `scripts/toolkit/access/auth/readonly.Group.yaml`
+2. Add a read-write version of the new capability to the `scripts/toolkit/access/auth/readwrite.Group.yaml`
 
 Get the PR reviewed by an SDK maintainer. The integration runner will be updated once the PR is merged.