Changelog¶

Version 0.9.1 (2025-06-21)¶

Authentication: Fixed authentication issue where HeaderApiKey was not adding the required "Token " prefix for Pretalx API authorization headers
Type hints: Added support for dict type in params parameter alongside QueryParams for better flexibility

Test configuration: Externalized test event slug to tests/test_config.toml configuration file
Dependencies: Removed unused httpx-auth dependency since we now handle authentication directly

This is the first release fully compatible with the new Pretalx versioned API v1 introduced in June 2025.

Storage abstraction layer: Support for multiple storage backends (local CSV/Excel files, Google Sheets)
Communication abstraction layer: Unified interface for email (Mailgun) and ticket (HelpDesk) providers
Factory functions: Simplified client creation with get_storage_client() and get_mail_client()
Optional dependencies: Install only what you need with pytanis[google], pytanis[helpdesk], pytanis[mailgun]

API v1 Compatibility: Full support for Pretalx versioned API v1 with proper expand parameter usage
Backward compatibility: Transparent handling of API changes where IDs replaced nested objects
Performance optimization: Cache pre-population reduces API calls by 50-75x for bulk operations
Redirect handling: Automatic handling of API redirects with trailing slashes
New API methods: submission_types(), tracks() for accessing submission metadata
SimpleTalk model: Export talks in simplified JSON format for easier processing
API compatibility: Event.urls field now optional to support latest API versions

Fixed 401 Unauthorized errors when fetching individual resources by using proper API expansion
Fixed redirect issues with missing trailing slashes in API endpoints
Fixed circular import issues in Google storage adapter

Added support for Mailgun, thanks to Nils Mohr
Added new notebook for calculating submission statistics, thanks to Nils Mohr
Added devcontainer for easier development, thanks to Nils Mohr
Updated all dependencies, added support for Python 3.13
Added configurable Pretalx API version support via api_version config parameter (defaults to "v1")

More functionality regarding the proposal selection process like mark_rows
Pretalx submissions states are now proper Enums.
GSheetClient.save_df_as_gsheet also applies some default BasicFormatter for nicer headlines etc.
Added some MIP helpers (highs) to support the scheduling process
Extended the documentation quite a bit

Allow creating a worksheet from GSheetClient
Make get_cfg importable from pytanis
Fix bug in PretalxClient that returned wrong number of results if a list was passed as params in conjunction with pagination.

have a progress bar for long-running commands when possible
switched to gspread for handling the low-level GoogleAPI
using gspread-dataframe for converting a worksheet into a dataframe
timeout of 60s for PretalxAPI as it is really slow, which caused a lot of timeout errors
rename *API to *Client as it's rather a client for an API
moved some functionality from review to pretalx.utils
GSheetClient allows now uploading dataframes as Google Sheets
an awesome logo created by Paula González Avalos
way more usage documentation