feat(anonymizer): add batch deanonymization support

[rodboev]

Change Description

Adds a public BatchDeanonymizeEngine to presidio-anonymizer, so encrypted values produced through the batch analyzer and anonymizer flow can be decrypted with the same list and dictionary ergonomics as BatchAnonymizerEngine.

The new batch engine delegates string values to the existing DeanonymizeEngine.deanonymize(...), supports list and nested dictionary traversal, and leaves unsupported scalar or object values unchanged. The change is additive and keeps the existing single-text deanonymization API unchanged.

The README now includes a batch deanonymization example, and the changelog records the new Anonymizer feature under Unreleased.

Issue reference

Fixes #1617

Tests

• poetry run pytest tests/test_batch_deanonymize_engine.py tests/integration/test_deanonymize_engine.py tests/test_batch_anonymizer_engine.py tests/test_readme.py
• poetry run ruff check presidio_anonymizer/batch_deanonymize_engine.py presidio_anonymizer/__init__.py tests/test_batch_deanonymize_engine.py tests/test_readme.py

Note on CHANGELOG

Update CHANGELOG.md under [unreleased] → Anonymizer → Added.

Checklist

• I have reviewed the contribution guidelines
• I have signed the CLA (if required)
• My code includes unit tests
• All unit tests and lint checks pass locally
• My PR contains documentation updates / additions if required

[rodboev]

@microsoft-github-policy-service agree

[Copilot]

Pull request overview

Adds a new public BatchDeanonymizeEngine to presidio-anonymizer to support batch deanonymization over lists and nested dictionaries, mirroring the ergonomics of BatchAnonymizerEngine, with documentation and tests.

Changes:

• Introduces BatchDeanonymizeEngine and exports it from presidio_anonymizer.
• Adds unit tests and extends the README tests to cover the new batch deanonymization example.
• Updates presidio-anonymizer/README.md and root CHANGELOG.md to document the new capability.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
presidio-anonymizer/presidio_anonymizer/batch_deanonymize_engine.py	New batch deanonymization implementation for lists and nested dicts.
presidio-anonymizer/presidio_anonymizer/init.py	Exposes BatchDeanonymizeEngine from the package root.
presidio-anonymizer/tests/test_batch_deanonymize_engine.py	Adds unit coverage for list/dict/nested behaviors and engine injection.
presidio-anonymizer/tests/test_readme.py	Extends README snippet tests to include batch deanonymization example.
presidio-anonymizer/README.md	Documents batch deanonymization usage example.
CHANGELOG.md	Notes the new batch deanonymization feature under Unreleased.