release: 0.11.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.10.0"
+  ".": "0.11.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 175
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-04247bf988645580ef6550363a7279d67d7c844e4310b526b6868be92541199f.yml
-openapi_spec_hash: b0f61f1a55a55a187447ff684bf51d3d
-config_hash: 469d30a2d44895c8c53a5aac370a56f1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-7a29c69ab60c231f97fcde7e5c26c616622150422bac562e337d61766c9d706f.yml
+openapi_spec_hash: 179a6c42e3237a19162cdad3abe057a1
+config_hash: 715e953acf41f9c19fd19ec85e91a053

CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.11.0 (2026-03-03)
+
+Full Changelog: [v0.10.0...v0.11.0](https://github.com/gitpod-io/gitpod-sdk-python/compare/v0.10.0...v0.11.0)
+
+### Features
+
+* **api:** add acknowledge_token param to environments.start method ([19ce45f](https://github.com/gitpod-io/gitpod-sdk-python/commit/19ce45ff07385a58858da61619c35291b4bd93aa))
+* **api:** add bpf_debug_level field to KernelControlsConfig ([d0cf7a4](https://github.com/gitpod-io/gitpod-sdk-python/commit/d0cf7a47fc5e68b96a40152ba8f26476da9ded02))
+* **api:** add filter parameter to groups list method ([c21fcff](https://github.com/gitpod-io/gitpod-sdk-python/commit/c21fcff4e84363a6c73d54516afea8ab40c8f218))
+* **api:** add lockdown_at field to environment status ([6317ac9](https://github.com/gitpod-io/gitpod-sdk-python/commit/6317ac97e4de079d158a0839eea63b8b4f11825f))
+* **api:** add resource_ids to role assignments, restructure executable deny list in policies ([b30fc23](https://github.com/gitpod-io/gitpod-sdk-python/commit/b30fc2332c0d2f4c8267c00d15a2e0a3f43446ec))
+* **api:** add SONNET_4_6 model variants to agent_execution Status ([e87f54b](https://github.com/gitpod-io/gitpod-sdk-python/commit/e87f54b36e2913913125398b6e36223c795b9562))
+* **api:** add sort parameter to projects list, SortOrder/SortParam types ([fada768](https://github.com/gitpod-io/gitpod-sdk-python/commit/fada768b6dbe0721d4e6d93dca8ff2d6dc44f648))
+* **api:** add time range filters to event list method ([c89b37e](https://github.com/gitpod-io/gitpod-sdk-python/commit/c89b37ec3240396215fba5b77b19c29ae598da2e))
+* **api:** remove acknowledge_token parameter from environments.start ([340b6f2](https://github.com/gitpod-io/gitpod-sdk-python/commit/340b6f28ae6fa15ea3955d10720dcd44a6e85651))
+* **types:** add CountResponseRelation enum type ([c5c6a3a](https://github.com/gitpod-io/gitpod-sdk-python/commit/c5c6a3a85b17dafe0bb879d42eb671f4601718b7))
+
+
+### Bug Fixes
+
+* **api:** rename executable_deny_list to veto_exec_policy in policies update ([8e6e434](https://github.com/gitpod-io/gitpod-sdk-python/commit/8e6e434949910725dcf3e0919e57f2f748acff15))
+* **types:** remove AGENT_EXECUTION values from Principal and ResourceRole enums ([36adf59](https://github.com/gitpod-io/gitpod-sdk-python/commit/36adf596f84d9ea0063185d7ade2ff5b4c723fb6))
+
+
+### Chores
+
+* **docs:** add missing descriptions ([c10fa2e](https://github.com/gitpod-io/gitpod-sdk-python/commit/c10fa2e60f87bc25f37efa9923ebaac979abe6dd))
+* **internal:** add request options to SSE classes ([17c6632](https://github.com/gitpod-io/gitpod-sdk-python/commit/17c6632b21cdf3fb082f74a6a3823cb210aa1757))
+* **internal:** make `test_proxy_environment_variables` more resilient ([b5ee95d](https://github.com/gitpod-io/gitpod-sdk-python/commit/b5ee95d7dcc5a9da2ed73af7a7f896dd56c5b4a4))
+* **internal:** make `test_proxy_environment_variables` more resilient to env ([2520d14](https://github.com/gitpod-io/gitpod-sdk-python/commit/2520d14755b2be28dbb6b4335438482aca97a794))
+* **internal:** remove mock server code ([3c5deb3](https://github.com/gitpod-io/gitpod-sdk-python/commit/3c5deb354f3c5059bac0bb2b50c288a7b40e2b7f))
+* **internal:** update jsonl tests ([6d2b499](https://github.com/gitpod-io/gitpod-sdk-python/commit/6d2b4990c73692b942ae02d99577c119bd6a8b18))
+* **test:** update skip reason message ([49175f9](https://github.com/gitpod-io/gitpod-sdk-python/commit/49175f922aa977681c528dc55920562433fcaaee))
+* update mock server docs ([cef4896](https://github.com/gitpod-io/gitpod-sdk-python/commit/cef48965ac676afcc1adde238fc0a59c85ed0dac))
+
+
+### Documentation
+
+* **api:** update filter descriptions in groups role_assignment_list_params ([daf1ad5](https://github.com/gitpod-io/gitpod-sdk-python/commit/daf1ad5c2b42f7851566d8c32f5dda6f9313dd53))
+
 ## 0.10.0 (2026-02-18)
 
 Full Changelog: [v0.9.0...v0.10.0](https://github.com/gitpod-io/gitpod-sdk-python/compare/v0.9.0...v0.10.0)

CONTRIBUTING.md

@@ -85,13 +85,6 @@ $ pip install ./path-to-wheel-file.whl
 
 ## Running tests
 
-Most tests require you to [set up a mock server](https://github.com/stoplightio/prism) against the OpenAPI spec to run the tests.
-
-```sh
-# you will need npm installed
-$ npx prism mock path/to/your/openapi.yml
-```
-
 ```sh
 $ ./scripts/test
 ```

api.md

@@ -114,6 +114,7 @@ Types:
 ```python
 from gitpod.types import (
     AdmissionLevel,
+    BpfDebugLevel,
     Environment,
     EnvironmentActivitySignal,
     EnvironmentMetadata,
@@ -346,6 +347,7 @@ Types:
 
 ```python
 from gitpod.types import (
+    CountResponseRelation,
     InviteDomains,
     Organization,
     OrganizationMember,
@@ -553,6 +555,8 @@ from gitpod.types import (
     ProjectPhase,
     ProjectPrebuildConfiguration,
     RecommendedEditors,
+    Sort,
+    SortOrder,
     ProjectCreateResponse,
     ProjectRetrieveResponse,
     ProjectUpdateResponse,

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitpod-sdk"
-version = "0.10.0"
+version = "0.11.0"
 description = "The official Python library for the gitpod API"
 dynamic = ["readme"]
 license = "Apache-2.0"

scripts/test

@@ -4,53 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[0;33m'
-NC='\033[0m' # No Color
 
-function prism_is_running() {
-  curl --silent "http://localhost:4010" >/dev/null 2>&1
-}
-
-kill_server_on_port() {
-  pids=$(lsof -t -i tcp:"$1" || echo "")
-  if [ "$pids" != "" ]; then
-    kill "$pids"
-    echo "Stopped $pids."
-  fi
-}
-
-function is_overriding_api_base_url() {
-  [ -n "$TEST_API_BASE_URL" ]
-}
-
-if ! is_overriding_api_base_url && ! prism_is_running ; then
-  # When we exit this script, make sure to kill the background mock server process
-  trap 'kill_server_on_port 4010' EXIT
-
-  # Start the dev server
-  ./scripts/mock --daemon
-fi
-
-if is_overriding_api_base_url ; then
-  echo -e "${GREEN}✔ Running tests against ${TEST_API_BASE_URL}${NC}"
-  echo
-elif ! prism_is_running ; then
-  echo -e "${RED}ERROR:${NC} The test suite will not run without a mock Prism server"
-  echo -e "running against your OpenAPI spec."
-  echo
-  echo -e "To run the server, pass in the path or url of your OpenAPI"
-  echo -e "spec to the prism command:"
-  echo
-  echo -e "  \$ ${YELLOW}npm exec --package=@stainless-api/prism-cli@5.15.0 -- prism mock path/to/your.openapi.yml${NC}"
-  echo
-
-  exit 1
-else
-  echo -e "${GREEN}✔ Mock prism server is running with your OpenAPI spec${NC}"
-  echo
-fi
 
 export DEFER_PYDANTIC_BUILD=false
 

src/gitpod/_client.py

@@ -150,6 +150,10 @@ def environments(self) -> EnvironmentsResource:
 
     @cached_property
     def errors(self) -> ErrorsResource:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import ErrorsResource
 
         return ErrorsResource(self)
@@ -186,6 +190,10 @@ def organizations(self) -> OrganizationsResource:
 
     @cached_property
     def prebuilds(self) -> PrebuildsResource:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import PrebuildsResource
 
         return PrebuildsResource(self)
@@ -210,6 +218,9 @@ def secrets(self) -> SecretsResource:
 
     @cached_property
     def usage(self) -> UsageResource:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import UsageResource
 
         return UsageResource(self)
@@ -414,6 +425,10 @@ def environments(self) -> AsyncEnvironmentsResource:
 
     @cached_property
     def errors(self) -> AsyncErrorsResource:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import AsyncErrorsResource
 
         return AsyncErrorsResource(self)
@@ -450,6 +465,10 @@ def organizations(self) -> AsyncOrganizationsResource:
 
     @cached_property
     def prebuilds(self) -> AsyncPrebuildsResource:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import AsyncPrebuildsResource
 
         return AsyncPrebuildsResource(self)
@@ -474,6 +493,9 @@ def secrets(self) -> AsyncSecretsResource:
 
     @cached_property
     def usage(self) -> AsyncUsageResource:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import AsyncUsageResource
 
         return AsyncUsageResource(self)
@@ -629,6 +651,10 @@ def environments(self) -> environments.EnvironmentsResourceWithRawResponse:
 
     @cached_property
     def errors(self) -> errors.ErrorsResourceWithRawResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import ErrorsResourceWithRawResponse
 
         return ErrorsResourceWithRawResponse(self._client.errors)
@@ -665,6 +691,10 @@ def organizations(self) -> organizations.OrganizationsResourceWithRawResponse:
 
     @cached_property
     def prebuilds(self) -> prebuilds.PrebuildsResourceWithRawResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import PrebuildsResourceWithRawResponse
 
         return PrebuildsResourceWithRawResponse(self._client.prebuilds)
@@ -689,6 +719,9 @@ def secrets(self) -> secrets.SecretsResourceWithRawResponse:
 
     @cached_property
     def usage(self) -> usage.UsageResourceWithRawResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import UsageResourceWithRawResponse
 
         return UsageResourceWithRawResponse(self._client.usage)
@@ -732,6 +765,10 @@ def environments(self) -> environments.AsyncEnvironmentsResourceWithRawResponse:
 
     @cached_property
     def errors(self) -> errors.AsyncErrorsResourceWithRawResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import AsyncErrorsResourceWithRawResponse
 
         return AsyncErrorsResourceWithRawResponse(self._client.errors)
@@ -768,6 +805,10 @@ def organizations(self) -> organizations.AsyncOrganizationsResourceWithRawRespon
 
     @cached_property
     def prebuilds(self) -> prebuilds.AsyncPrebuildsResourceWithRawResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import AsyncPrebuildsResourceWithRawResponse
 
         return AsyncPrebuildsResourceWithRawResponse(self._client.prebuilds)
@@ -792,6 +833,9 @@ def secrets(self) -> secrets.AsyncSecretsResourceWithRawResponse:
 
     @cached_property
     def usage(self) -> usage.AsyncUsageResourceWithRawResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import AsyncUsageResourceWithRawResponse
 
         return AsyncUsageResourceWithRawResponse(self._client.usage)
@@ -835,6 +879,10 @@ def environments(self) -> environments.EnvironmentsResourceWithStreamingResponse
 
     @cached_property
     def errors(self) -> errors.ErrorsResourceWithStreamingResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import ErrorsResourceWithStreamingResponse
 
         return ErrorsResourceWithStreamingResponse(self._client.errors)
@@ -871,6 +919,10 @@ def organizations(self) -> organizations.OrganizationsResourceWithStreamingRespo
 
     @cached_property
     def prebuilds(self) -> prebuilds.PrebuildsResourceWithStreamingResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import PrebuildsResourceWithStreamingResponse
 
         return PrebuildsResourceWithStreamingResponse(self._client.prebuilds)
@@ -895,6 +947,9 @@ def secrets(self) -> secrets.SecretsResourceWithStreamingResponse:
 
     @cached_property
     def usage(self) -> usage.UsageResourceWithStreamingResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import UsageResourceWithStreamingResponse
 
         return UsageResourceWithStreamingResponse(self._client.usage)
@@ -938,6 +993,10 @@ def environments(self) -> environments.AsyncEnvironmentsResourceWithStreamingRes
 
     @cached_property
     def errors(self) -> errors.AsyncErrorsResourceWithStreamingResponse:
+        """
+        ErrorsService provides endpoints for clients to report errors
+         that will be sent to error reporting systems.
+        """
         from .resources.errors import AsyncErrorsResourceWithStreamingResponse
 
         return AsyncErrorsResourceWithStreamingResponse(self._client.errors)
@@ -974,6 +1033,10 @@ def organizations(self) -> organizations.AsyncOrganizationsResourceWithStreaming
 
     @cached_property
     def prebuilds(self) -> prebuilds.AsyncPrebuildsResourceWithStreamingResponse:
+        """
+        PrebuildService manages prebuilds for projects to enable faster environment startup times.
+         Prebuilds create snapshots of environments that can be used to provision new environments quickly.
+        """
         from .resources.prebuilds import AsyncPrebuildsResourceWithStreamingResponse
 
         return AsyncPrebuildsResourceWithStreamingResponse(self._client.prebuilds)
@@ -998,6 +1061,9 @@ def secrets(self) -> secrets.AsyncSecretsResourceWithStreamingResponse:
 
     @cached_property
     def usage(self) -> usage.AsyncUsageResourceWithStreamingResponse:
+        """
+        UsageService provides usage information about environments, users, and projects.
+        """
         from .resources.usage import AsyncUsageResourceWithStreamingResponse
 
         return AsyncUsageResourceWithStreamingResponse(self._client.usage)