v0.41 - add SVG image generation

[jacalata]

Changes

• allow users to download sheet images as SVG as well as by PNG
• recognize 409 errors and treat them as success, because the job the user wants to create is already created

[Copilot]

Pull request overview

This PR extends the Tableau Server Client Python library to support exporting sheet images as SVG (in addition to PNG) and adjusts refresh behavior to treat the “duplicate extract job already queued” error as a non-fatal success. It also modernizes typing across endpoints/models, adds regression/unit/E2E tests for the new behaviors, and updates project packaging/test configuration.

Changes:

• Add format support to image export request options and enforce API-version gating (SVG requires 3.29+).
• Treat Tableau error code 409093 (duplicate extract refresh job) as a warning and return None from refresh methods instead of raising.
• Expand tests (unit + E2E) for webhook event naming, tagging encoding/quoting, query iteration behavior, image export formats, and new filter fields; update packaging to Python 3.10+ and pytest defaults.

Reviewed changes

Copilot reviewed 106 out of 110 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
test/test_webhook.py	Adds unit tests for webhook event setter/getter behavior, including new-style webhook-event-* names.
test/test_view.py	Adds tests for image export format (SVG/PNG) and unsupported-version behavior; renames a PDF test for clarity.
test/test_user.py	Adjusts bulk-add expectations and adds tests for filtering users by email / email__in.
test/test_tagging.py	Expands tagging tests (quoting tags with spaces; URL encoding for special characters) and typing tweaks in helpers/protocols.
test/test_server_info.py	Updates expectations for deferred server version detection when use_server_version=True.
test/test_request_option.py	Removes stray content and adds tests for PDF viz dimension query params and request behavior.
test/test_pager.py	Adds regression test ensuring QuerySet iteration ends cleanly on 400006 (PEP 479).
test/test_job.py	Cleans up formatting (whitespace-only change).
test/test_flow.py	Adds test asserting duplicate refresh (HTTP 409 / error code 409093) is treated as a non-error (None).
test/test_extensions.py	Cleans up formatting (whitespace-only change).
test/test_endpoint.py	Adds tests for robust XML error parsing for ServerResponseError/FailedSignInError when <error> is missing.
test/test_datasource.py	Adds tests for update_connections without auth type, duplicate refresh handling, deprecation warning mapping, and async publish timeout.
test/test_database.py	Fixes assertion to validate exact DQW message text.
test/test_custom_view.py	Adds SVG/PNG image export tests and unsupported-version behavior for custom views.
test/test_connection_.py	Adds tests for new database_name connection attribute and its XML round-trip behavior.
test/http/test_http_requests.py	Updates expectations for deferred server version detection at construction time.
test/assets/workbook_update_connections_no_auth.xml	Adds test asset for workbook connections update response without auth type in request.
test/assets/workbook_refresh_duplicate.xml	Adds test asset for duplicate refresh job response (409093).
test/assets/webhook_get_new_event.xml	Adds test asset to validate parsing of new-style webhook event element names.
test/assets/flow_refresh_duplicate.xml	Adds test asset for duplicate flow refresh job response (409093).
test/assets/datasource_refresh_duplicate.xml	Adds test asset for duplicate datasource refresh job response (409093).
test/assets/datasource_populate_connections.xml	Updates asset to include dbName attribute to test database_name parsing.
test/assets/datasource_connections_update_no_auth.xml	Adds test asset for datasource connections update response without auth type in request.
test/_utils.py	Removes unused Optional import (typing modernization).
test_e2e/test_tagging.py	Introduces E2E coverage for tag add/delete round-tripping (spaces/commas/multiple tags).
test_e2e/conftest.py	Adds E2E server fixture + e2e marker configuration and environment-variable gating.
test_e2e/init.py	Adds package marker for E2E tests.
tableauserverclient/server/server.py	Defers use_server_version network call; stores flag for use during sign-in.
tableauserverclient/server/request_options.py	Adds email field; modernizes typing; adds ImageRequestOptions.format (SVG/PNG) and wires it into query params.
tableauserverclient/server/query.py	Fixes QuerySet iteration termination on 400006 by returning instead of raising StopIteration.
tableauserverclient/server/pager.py	Typing modernization for endpoints/callables and optional request options.
tableauserverclient/server/endpoint/webhooks_endpoint.py	Typing modernization for get() and parameter docs.
tableauserverclient/server/endpoint/virtual_connections_endpoint.py	Typing modernization and union simplifications across methods.
tableauserverclient/server/endpoint/views_endpoint.py	Adds version gating for format param (3.29+) alongside existing viz dimension gating; typing/doc updates.
tableauserverclient/server/endpoint/users_endpoint.py	Adds filter docs for email/email__in and modernizes typing in signatures/docs.
tableauserverclient/server/endpoint/tasks_endpoint.py	Typing modernization for get() signature.
tableauserverclient/server/endpoint/tables_endpoint.py	Typing modernization for get/populate/add/delete tags APIs.
tableauserverclient/server/endpoint/subscriptions_endpoint.py	Typing modernization for get() signature.
tableauserverclient/server/endpoint/sites_endpoint.py	Typing modernization for get() signature.
tableauserverclient/server/endpoint/server_info_endpoint.py	Typing modernization for get() return type.
tableauserverclient/server/endpoint/schedules_endpoint.py	Typing modernization + doc typo fixes in batch update.
tableauserverclient/server/endpoint/resource_tagger.py	Fixes tag name URL encoding by quoting with safe="" (encodes /, +, #, spaces, etc.).
tableauserverclient/server/endpoint/projects_endpoint.py	Typing modernization for get() and filter().
tableauserverclient/server/endpoint/permissions_endpoint.py	Typing modernization for union types and request options.
tableauserverclient/server/endpoint/oidc_endpoint.py	Typing modernization for union types in OIDC APIs.
tableauserverclient/server/endpoint/metrics_endpoint.py	Typing modernization for get() signature.
tableauserverclient/server/endpoint/linked_tasks_endpoint.py	Typing modernization and cleanup of imports.
tableauserverclient/server/endpoint/jobs_endpoint.py	Typing modernization for overloads and union parameters.
tableauserverclient/server/endpoint/groupsets_endpoint.py	Typing modernization for unions and filter paging.
tableauserverclient/server/endpoint/groups_endpoint.py	Typing modernization for unions and return types in docs.
tableauserverclient/server/endpoint/flows_endpoint.py	Handles duplicate refresh job code as a warning and returns None; removes filename helper usage in download path logic.
tableauserverclient/server/endpoint/flow_runs_endpoint.py	Typing modernization for unions and optional timeouts.
tableauserverclient/server/endpoint/favorites_endpoint.py	Typing modernization for request options.
tableauserverclient/server/endpoint/exceptions.py	Adds DUPLICATE_EXTRACT_JOB_CODE; makes XML error parsing robust when <error>/children are absent.
tableauserverclient/server/endpoint/endpoint.py	Typing modernization and minor signature updates.
tableauserverclient/server/endpoint/dqw_endpoint.py	Typing modernization for HasId protocol and request options.
tableauserverclient/server/endpoint/default_permissions_endpoint.py	Typing modernization for unions in permissions APIs.
tableauserverclient/server/endpoint/databases_endpoint.py	Typing modernization for tagging and request options.
tableauserverclient/server/endpoint/data_alert_endpoint.py	Typing modernization for unions and request options.
tableauserverclient/server/endpoint/custom_views_endpoint.py	Adds version gating for image format (3.29+) and modernizes typing across methods.
tableauserverclient/server/endpoint/auth_endpoint.py	Calls use_server_version() after successful sign-in when configured to do so.
tableauserverclient/models/webhook_item.py	Supports None, short names, full webhook-source-event-*, and new webhook-event-* event naming.
tableauserverclient/models/virtual_connection_item.py	Typing modernization for nullable attributes/callables.
tableauserverclient/models/view_item.py	Typing modernization for nullable fields and callable-backed properties.
tableauserverclient/models/user_item.py	Typing modernization for nullable user fields and parsing helpers.
tableauserverclient/models/task_item.py	Typing modernization for nullable schedule/target fields.
tableauserverclient/models/tableau_types.py	Typing modernization for plural_type() union parameter.
tableauserverclient/models/tableau_auth.py	Typing modernization for optional IDs and impersonation fields.
tableauserverclient/models/table_item.py	Typing modernization for id property.
tableauserverclient/models/subscription_item.py	Reformatting/whitespace normalization of file content (no functional change apparent).
tableauserverclient/models/site_item.py	Typing modernization across site fields and auth configuration model.
tableauserverclient/models/schedule_item.py	Typing modernization for interval unions and nullable datetimes/IDs.
tableauserverclient/models/revision_item.py	Typing modernization for nullable revision fields.
tableauserverclient/models/project_item.py	Typing modernization for nullable fields and XML parsing signatures.
tableauserverclient/models/permissions_item.py	Typing modernization for nullable namespace parameters.
tableauserverclient/models/oidc_item.py	Typing modernization for nullable OIDC configuration fields.
tableauserverclient/models/metric_item.py	Typing modernization for nullable metric fields and permissions.
tableauserverclient/models/location_item.py	Typing modernization for nullable location fields and XML parsing signature.
tableauserverclient/models/linked_tasks_item.py	Typing modernization for nullable linked-task fields.
tableauserverclient/models/job_item.py	Typing modernization for nullable job fields and background job item fields.
tableauserverclient/models/groupset_item.py	Typing modernization for nullable group set fields.
tableauserverclient/models/group_item.py	Typing modernization for nullable group fields.
tableauserverclient/models/flow_run_item.py	Typing modernization for nullable flow run fields and XML parsing signature.
tableauserverclient/models/flow_item.py	Typing modernization and import cleanup for Iterable.
tableauserverclient/models/favorites_item.py	Typing modernization for from_response input type.
tableauserverclient/models/extract_item.py	Typing modernization for nullable IDs and list return types.
tableauserverclient/models/data_freshness_policy_item.py	Typing modernization for nullable schedule fields.
tableauserverclient/models/data_alert_item.py	Typing modernization for nullable alert fields and repr formatting.
tableauserverclient/models/custom_view_item.py	Typing modernization for nullable fields and parsing helpers.
tableauserverclient/models/connection_item.py	Adds database_name (maps GET dbName and publish databaseName) and updates parsing logic accordingly.
tableauserverclient/models/column_item.py	Reformatting/whitespace normalization of file content (no functional change apparent).
tableauserverclient/models/collection_item.py	Typing modernization for nullable collection fields.
tableauserverclient/helpers/strings.py	Reformatting/whitespace normalization of file content (no functional change apparent).
tableauserverclient/helpers/headers.py	Removes filename-fixing helper module.
tableauserverclient/datetime_helpers.py	Reformatting/whitespace normalization of file content (no functional change apparent).
tableauserverclient/bin/_version.py	Typing modernization for dict/list/tuple annotations.
samples/update_connections_auth.py	Makes datasource credential arguments optional via CLI flags.
samples/smoke_test.py	Reformatting/whitespace normalization of file content (no functional change apparent).
samples/export.py	Reformatting/whitespace normalization; minor assignment unpacking style change.
samples/explore_workbook.py	Updates sample workbook description text.
pyproject.toml	Bumps Python requirement to 3.10+, updates test tooling versions, enables xdist by default, adds E2E marker, adjusts setuptools package discovery/data.
contributing.md	Adds test-running instructions and E2E setup guidance.
.gitignore	Adds .claude/ and normalizes formatting.

Comments suppressed due to low confidence (1)

tableauserverclient/server/request_options.py:346

• _DataExportOptions.get_query_params() now allows max_age=None, but the current check (self.max_age != -1) will include maxAge=None in the query string. That results in sending an invalid REST query parameter value when callers pass maxage=None.

Consider treating None like the default (omit the parameter).

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.