Dicognito

New

- Retain selected elements' original values using `--keep <tag_name>`.
The argument may be repeated to retain multiple elements' values.
Elements are identified by name (e.g. "PatientName", "StudyDate") or by
hexadecimal tag value (e.g. "0010,0010"). ([155](https://github.com/blairconrad/dicognito/issues/155))
- `Anonymizer.add_element_handler` allows addition of new element handlers (even custom ones)
to override existing behavior. ([155](https://github.com/blairconrad/dicognito/issues/155))
- New element handler type `dicognito.value_keeper.ValueKeeper` that will
keep element values as-is. ([155](https://github.com/blairconrad/dicognito/issues/155))
- New `--what-if` flag shows intended anonymization actions (as appear in the project README)
([163](https://github.com/blairconrad/dicognito/issues/163))

Fixed

- `--output-directory` may create duplicate anonymized files ([161](https://github.com/blairconrad/dicognito/issues/161))

Additional Items

- Format code using [Ruff](https://ruff.rs/) ([#156](https://github.com/blairconrad/dicognito/issues/156))

Changed
- Drop support for Python 3.7 ([151](https://github.com/blairconrad/dicognito/issues/151))
- Require pydicom 2.3.1 or higher ([136](https://github.com/blairconrad/dicognito/issues/136))

New
- Officially support Python 3.11 ([136](https://github.com/blairconrad/dicognito/issues/136))
- Complete list of attribute changes now listed in README ([140](https://github.com/blairconrad/dicognito/issues/140))

Fixed
- Version table format has bad separator ([147](https://github.com/blairconrad/dicognito/issues/147))
- Private creator 0031,0020 breaks anonymization ([157](https://github.com/blairconrad/dicognito/issues/157))

Changed

- Require pydicom 2.3.1 or higher ([136](https://github.com/blairconrad/dicognito/issues/136))

New

- Officially support Python 3.11 ([136](https://github.com/blairconrad/dicognito/issues/136))
- Complete list of attribute changes now listed in README ([140](https://github.com/blairconrad/dicognito/issues/140))

Changed

- If neither `--in-place`/`-i` or `--output-directory`/`-o` are specified on the command line, a
warning will be printed ([134](https://github.com/blairconrad/dicognito/issues/134))

The anonymization will proceed as if `--in-place`/`-i` were specified.
A future release will require that one of the options be specified.

New

- `--in-place`/`-i` flag added to explicitly specify in place editing of source files ([134](https://github.com/blairconrad/dicognito/issues/134))

It's an error to specify both `--in-place`/`-i` and `--output-directory`/`-o`.

Changed

- Now assuming DA fields are 8 characters long ([123](https://github.com/blairconrad/dicognito/issues/123))
- Summary formatted as GitHub Flavored Markdown ([125](https://github.com/blairconrad/dicognito/issues/125))
- Anonymized UI values are now consistent between runs if the same seed is supplied ([126](https://github.com/blairconrad/dicognito/issues/126))

New

- Command line options define how to detect and handle burned-in annotations in source ([44](https://github.com/blairconrad/dicognito/issues/44), [#113](https://github.com/blairconrad/dicognito/issues/113)):
bash
dicognito --assume-burned-in-annotation if-yes --on-burned-in-annotation warn default
dicognito --assume-burned-in-annotation unless-no
dicognito --assume-burned-in-annotation never
dicognito --on-burned-in-annotation fail

- Indicate filename when anonymization fails ([120](https://github.com/blairconrad/dicognito/issues/120))
- Officially support Python 3.10 ([115](https://github.com/blairconrad/dicognito/issues/115))

Fixed

- Fails to anonymize LEI file with Mitra global patient ID when using pydicom 2.2.x ([118](https://github.com/blairconrad/dicognito/issues/118))

Additional Items

- Add type hints, per [PEP 484](https://www.python.org/dev/peps/pep-0484/) ([#111](https://github.com/blairconrad/dicognito/issues/111))
- Remove Python 2.7 shims ([105](https://github.com/blairconrad/dicognito/issues/105))

With special thanks for contributions to this release from:
- [justineclin](https://github.com/justineclin) &#x1F947;