Unreleased

Added

• Add id_translation.logging.EMIT_LOGGED_WARNINGS; set to False to disable warnings that are emitted as logs.

• Add Format.placeholder_attributes property.

• Add FetchInstruction.placeholder_attributes property + AbstractFetcher handling.

• Add SQLAlchemy ORM fetcher example.

• Add the add_skip_file_prefix() function to control warning stack levels.

• Add translator_typing.GoOfflineParams typed dict.

• Add ConcurrentOperationWarning and light-weight detection in relevant AbstractFetcher methods. Also added 🧵 notes to docstrings and updated the concurrency call-sites table.

• Add JSON Schemas for the TOML configuration format (main, auxiliary fetcher, and metaconf.toml), published to versioned Read the Docs URLs for editor and CI validation.

• Add PartialCacheHit; returning it from CacheAccess.load() makes the fetcher fetch (and cache) only the IDs the cache did not cover, instead of re-fetching the whole request.

Changed

• Links in warnings and exceptions now link to the current version in the docs (instead of the ‘stable’ version).

• Raise DataStructureIOError instead of generic ValueError in DataStructureIO.get_rank() for unregistered types.

• Changed translation aborted-warnings.

  • Add new TranslationAbortedWarning type.

  • Emit as TranslationAbortedWarning instead of MappingWarning.

  • No longer emitted as logs.

Fixed

• Fixed exit event keys in AbstractFetcher.fetch_all() and Translator.go_offline().

• SqlFetcher defers engine creation to the first initialize_sources() call, so runtime errors from an overridden create_engine() (e.g. a bad slug or unreachable database) surface there rather than at construction.