Merge branch 'main' into storage-boxes

Author: jooola

.github/workflows/lint.yml

@@ -12,7 +12,7 @@ jobs:
       - uses: actions/checkout@v5
 
       - name: Setup python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: 3.x
 
@@ -28,7 +28,7 @@ jobs:
       - uses: actions/checkout@v5
 
       - name: Setup python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: 3.x
 

.github/workflows/release.yml

@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: 3.x
 
@@ -53,4 +53,4 @@ jobs:
           path: dist/
 
       - name: Publish packages to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.12.4
+        uses: pypa/gh-action-pypi-publish@v1.13.0

.github/workflows/releaser-pleaser.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: releaser-pleaser
-        uses: apricote/releaser-pleaser@v0.6.1
+        uses: apricote/releaser-pleaser@v0.7.1
         with:
           token: ${{ secrets.HCLOUD_BOT_TOKEN }}
           extra-files: |

.github/workflows/test.yml

@@ -11,14 +11,19 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
 
     name: Python ${{ matrix.python-version }}
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 

.gitlab-ci.yml

@@ -14,7 +14,7 @@ pre-commit:
 lint:
   stage: test
 
-  image: python:3.13-alpine
+  image: python:3.14-alpine
   before_script:
     - apk add make bash
     - make venv
@@ -26,7 +26,12 @@ test:
 
   parallel:
     matrix:
-      - python_version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+      - python_version:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
 
   image: python:${python_version}-alpine
   before_script:

.pre-commit-config.yaml

@@ -29,18 +29,18 @@ repos:
         files: \.(md|ya?ml|js|css)$
 
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.20.0
+    rev: v3.21.0
     hooks:
       - id: pyupgrade
-        args: [--py39-plus]
+        args: [--py310-plus]
 
   - repo: https://github.com/pycqa/isort
-    rev: 6.0.1
+    rev: 7.0.0
     hooks:
       - id: isort
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.1.0
+    rev: 25.9.0
     hooks:
       - id: black
 

CHANGELOG.md

@@ -1,5 +1,106 @@
 # Changelog
 
+## [v2.9.0](https://github.com/hetznercloud/hcloud-python/releases/tag/v2.9.0)
+
+### Features
+
+- support python 3.14 (#566)
+- drop support for python 3.9 (#574)
+
+## [v2.8.0](https://github.com/hetznercloud/hcloud-python/releases/tag/v2.8.0)
+
+### DNS API Beta
+
+This release adds support for the new [DNS API](https://docs.hetzner.cloud/reference/cloud#dns).
+
+The DNS API is currently in **beta**, which will likely end on 10 November 2025. After the beta ended, it will no longer be possible to create new zones in the old DNS system. See the [DNS Beta FAQ](https://docs.hetzner.com/networking/dns/faq/beta) for more details.
+
+Future minor releases of this project may include breaking changes for features that are related to the DNS API.
+
+See the [DNS API Beta changelog](https://docs.hetzner.cloud/changelog#2025-10-07-dns-beta) for more details.
+
+**Examples**
+
+```py
+resp = client.zones.create(
+    name="example.com",
+    mode="primary",
+    labels={"key": "value"},
+    rrsets=[
+        ZoneRRSet(
+            name="@",
+            type="A",
+            records=[
+                ZoneRecord(value="201.180.75.2", comment="server1")
+            ],
+        )
+    ],
+)
+
+resp.action.wait_until_finished()
+zone = resp.zone
+```
+
+### Features
+
+- add new `ip_range` param to load balancer `attach_to_network` (#562)
+- add new `ip_range` param to server `attach_to_network` (#561)
+- support the new DNS API (#568)
+
+### Bug Fixes
+
+- source_ips property is optional in firewall rule (#567)
+
+## [v2.7.0](https://github.com/hetznercloud/hcloud-python/releases/tag/v2.7.0)
+
+[Server Types](https://docs.hetzner.cloud/reference/cloud#server-types) now depend on [Locations](https://docs.hetzner.cloud/reference/cloud#locations).
+
+- We added a new `locations` property to the [Server Types](https://docs.hetzner.cloud/reference/cloud#server-types) resource. The new property defines a list of supported [Locations](https://docs.hetzner.cloud/reference/cloud#locations) and additional per [Locations](https://docs.hetzner.cloud/reference/cloud#locations) details such as deprecations information.
+
+- We deprecated the `deprecation` property from the [Server Types](https://docs.hetzner.cloud/reference/cloud#server-types) resource. The property will gradually be phased out as per [Locations](https://docs.hetzner.cloud/reference/cloud#locations) deprecations are being announced. Please use the new per [Locations](https://docs.hetzner.cloud/reference/cloud#locations) deprecation information instead.
+
+See our [changelog](https://docs.hetzner.cloud/changelog#2025-09-24-per-location-server-types) for more details.
+
+**Upgrading**
+
+```py
+# Before
+def validate_server_type(server_type: ServerType):
+    if server_type.deprecation is not None:
+        raise ValueError(f"server type {server_type.name} is deprecated")
+```
+
+```py
+# After
+def validate_server_type(server_type: ServerType, location: Location):
+    found = [o for o in server_type.locations if location.name == o.location.name]
+    if not found:
+        raise ValueError(
+            f"server type {server_type.name} is not supported in location {location.name}"
+        )
+
+    server_type_location = found[0]
+
+    if server_type_location.deprecation is not None:
+        raise ValueError(
+            f"server type {server_type.name} is deprecated in location {location.name}"
+        )
+```
+
+### Features
+
+- per location server types (#558)
+
+## [v2.6.0](https://github.com/hetznercloud/hcloud-python/releases/tag/v2.6.0)
+
+### Features
+
+- add category property to server type (#549)
+
+### Bug Fixes
+
+- rename `ClientEntityBase` to `ResourceClientBase` (#532)
+
 ## [v2.5.4](https://github.com/hetznercloud/hcloud-python/releases/tag/v2.5.4)
 
 ### Bug Fixes

README.md

@@ -66,12 +66,17 @@ Experimental features are published as part of our regular releases (e.g. a prod
 public beta). During an experimental phase, breaking changes on those features may occur
 within minor releases.
 
+The stability of experimental features is not related to the stability of its upstream API.
+
+Experimental features have different levels of maturity (e.g. experimental, alpha, beta)
+based on the maturity of the upstream API.
+
 While experimental features will be announced in the release notes, you can also find
 whether a python class or function is experimental in its docstring:
 
 ```
 Experimental:
-    $PRODUCT is experimental, breaking changes may occur within minor releases.
+    $PRODUCT is $MATURITY, breaking changes may occur within minor releases.
     See https://docs.hetzner.cloud/changelog#$SLUG for more details.
 ```
 
@@ -151,7 +156,7 @@ To publish experimental features as part of regular releases:
   ```py
   """
   Experimental:
-      $PRODUCT is experimental, breaking changes may occur within minor releases.
+      $PRODUCT is $MATURITY, breaking changes may occur within minor releases.
       See https://docs.hetzner.cloud/changelog#$SLUG for more details.
   """
   ```

docs/api.clients.zones.rst

@@ -0,0 +1,30 @@
+ZonesClient
+==================
+
+
+.. autoclass:: hcloud.zones.client.ZonesClient
+    :members:
+
+.. autoclass:: hcloud.zones.client.BoundZone
+    :members:
+
+.. autoclass:: hcloud.zones.client.BoundZoneRRSet
+    :members:
+
+.. autoclass:: hcloud.zones.domain.Zone
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZoneAuthoritativeNameservers
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZonePrimaryNameserver
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZoneRecord
+    :members:
+
+.. autoclass:: hcloud.zones.domain.ZoneRRSet
+    :members:
+
+.. autoclass:: hcloud.zones.domain.CreateZoneResponse
+    :members:

examples/get_server_metrics.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
-import json
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from os import environ
 
 from hcloud import Client
@@ -24,7 +23,7 @@
     )
     server = response.server
 
-end = datetime.now()
+end = datetime.now(timezone.utc)
 start = end - timedelta(hours=1)
 
 response = server.get_metrics(
@@ -33,4 +32,4 @@
     end=end,
 )
 
-print(json.dumps(response.metrics))
+print(response.metrics)