chore: sync from pve-openapi@f0a6069

feat(sdk-sync): reserve user-test directory + preserve non-managed workflows

Author: bencurio

.openapi-generator-ignore

@@ -0,0 +1,23 @@
+# OpenAPI Generator Ignore
+# Generated by openapi-generator https://github.com/openapitools/openapi-generator
+
+# Use this file to prevent files from being overwritten by the generator.
+# The patterns follow closely to .gitignore or .dockerignore.
+
+# As an example, the C# client generator defines ApiClient.cs.
+# You can make changes and tell OpenAPI Generator to ignore just this file by uncommenting the following line:
+#ApiClient.cs
+
+# You can match any string of characters against a directory, file or extension with a single asterisk (*):
+#foo/*/qux
+# The above matches foo/bar/qux and foo/baz/qux, but not foo/bar/baz/qux
+
+# You can recursively match patterns against a directory, file or extension with a double asterisk (**):
+#foo/**/qux
+# This matches foo/bar/qux, foo/baz/qux, and foo/bar/baz/qux
+
+# You can also negate patterns with an exclamation (!).
+# For example, you can ignore all files in a docs folder with the file extension .md:
+#docs/*.md
+# Then explicitly reverse the ignore rule for a single file:
+#!docs/README.md

.openapi-generator/FILES

@@ -1,6 +1,7 @@
 .github/workflows/python.yml
 .gitignore
 .gitlab-ci.yml
+.openapi-generator-ignore
 .travis.yml
 README.md
 clientapi_pbs/__init__.py

tests/e2e/README.md

@@ -0,0 +1,56 @@
+# User-written E2E tests
+
+This directory is reserved for **your** E2E tests against a live
+Proxmox Backup Server server. Anything you put here:
+
+* **Survives regeneration.** The generator's orphan-removal step is
+  driven by `.openapi-generator/FILES` — files outside that manifest
+  (including this whole directory) are never touched by `sdk-sync`.
+* **Survives the workflow wipe.** `sdk-bootstrap` only touches the
+  workflow files it manages (`ci.yml`, `publish.yml`). User-added
+  workflows like `.github/workflows/e2e.yml` are preserved verbatim.
+
+The auto-generated SDK code lives outside this directory; treat
+everything under `tests/e2e` as your own.
+
+## Quickstart
+
+1. Add fixtures, helpers, and tests under `tests/e2e/`.
+2. (Optional) Add `.github/workflows/e2e.yml` to run them in CI against
+   a Proxmox Backup Server test instance — the sync pipeline preserves
+   any workflow file whose name isn't in the managed allowlist.
+3. The generated `ci.yml` runs the SDK's own build + unit tests; wire
+   your E2E suite into a separate workflow so it can use its own
+   secrets / runners / schedule.
+
+## Conventions per language
+
+| Language | User-test path | Runner |
+|---|---|---|
+| TypeScript | `tests/e2e/*.test.ts` | `vitest run tests/e2e` |
+| Python | `tests/e2e/test_*.py` | `pytest tests/e2e` |
+| Go | `tests/e2e/*_test.go` (package `e2e_test`) | `go test ./tests/e2e/...` |
+| Rust | `tests/e2e/*.rs` | `cargo test --test '*'` |
+| PHP | `tests/E2E/*Test.php` | `vendor/bin/phpunit tests/E2E` |
+| Kotlin | `src/test/kotlin/e2e/*Test.kt` | `./gradlew test --tests 'e2e.*'` |
+
+> The Kotlin generator's post-process step deletes
+> `src/test/kotlin/**/apis/*.kt` and `src/test/kotlin/**/models/*.kt`
+> (openapi-generator's stub tests). Keep your tests **outside** those
+> two subpaths — the `e2e/` directory recommended above is the
+> intended location and is never touched by the pipeline.
+
+## Authenticating against a real server
+
+Use the API-token format documented in the SDK's main README:
+
+* Perl family (PVE, PMG): `<PREFIX>APIToken=USER@REALM!TOKENID=UUID`
+* Rust family (PBS, PDM): `<PREFIX>APIToken=USER@REALM!TOKENID:UUID`
+
+Set the secret via env var so tests stay portable:
+
+```sh
+PBS_HOST=https://pbs.example.com:8007
+PBS_TOKEN='PBSAPIToken=root@pam!auto:<your-uuid>'
+PBS_INSECURE_TLS=1   # only when targeting a self-signed dev server
+```