Release Notes

0.1.2 [2026-03-02]

Maintenance:

Updated Pillow from >=10,<11 to >=12.1.1,<13
Updated PYTHON_VERSION from 3.12.11 to 3.12.12 in the base image environment

Enhancements:

Added .dockerignore file to optimize Docker build context by excluding unnecessary files
Added standardized Flywheel gear classification metadata to manifest.json including species, organ, therapeutic area, modality, and function fields
Enhanced manifest.json with expanded environment variable documentation
Updated run.py to return explicit exit status codes for better error handling
Changed converter.main() to converter.run() with return status codes instead of sys.exit() calls

Fixes:

Fixed typo in log message from "Geeting" to "Getting" in converter.py:26
Fixed input file reference in parser.py from "nifti" to "nifti_input_file" to match manifest
Fixed f-string usage in error log messages where no interpolation was needed (converter.py:37, converter.py:165)
Removed trailing whitespace from .gitignore
Removed unnecessary blank line in converter.py:121

Maintenance:

Migrated from poetry to uv for dependency management
Upgraded base image from python:3.8-slim to flywheel/python:3.12-main
Upgraded python from 3.8 to 3.12
Upgraded flywheel-gear-toolkit from ^0.1.3 to >=0.6,<0.7
Upgraded nibabel from ^3.1.0 to >=5.1.0
Upgraded Pillow from ^8.0.1 to >=10,<11
Upgraded numpy from >=1.18.5,<1.19.0 to >=1.26,<2
Upgraded flywheel-sdk to >=18,<19
Added idna>=3.0 dependency
Upgraded pytest from ^6.1.2 to >=7.2,<9
Upgraded pytest-cov from ^2.10.1 to >=2.10.1,<5
Upgraded pytest-mock from ^3.3.1 to >=3.3.1,<4
Removed black and isort development dependencies
Removed coverage development dependency
Replaced .gitlab-ci.yml with new qa-ci pipeline from flywheel-io/tools/etc/qa-ci
Updated .pre-commit-config.yaml to use qa-ci hooks including ruff, ruff_format, gearcheck, hadolint, and linkcheck
Restructured Dockerfile with multi-stage build (base, build, dev, final) using Alpine base image
Changed Docker entrypoint from poetry run python to direct python execution
Changed build system from poetry.core.masonry.api to hatchling.build
Migrated pyproject.toml from Poetry format to PEP 621 standard format
Added non-root user execution (USER flywheel) in final Docker stage
Removed tests/Dockerfile and tests/requirements.txt
Updated test assertions from == to is for type comparisons in test_converter.py
Removed unused imports (os, mock) from test_converter.py

Documentation:

Enhancements:

Added NIfTI to PNG conversion using Maximum Intensity Projection (MIP) technique
Added support for generating sagittal, coronal, and axial MIP projections
Added configurable threshold percentile for maximum value filtering
Added optional image inversion for output PNG files
Added debug logging configuration option

Maintenance:

Documentation: