Skip to content

Release Notes

0.2.0 [2026-06-26]

Enhancements:

  • Added storage (MB) column to the CSV report, showing total managed storage per project in megabytes via the Flywheel usage-reporting API.
  • Demoted 500 ApiException responses from the usage-reporting API to debug level for projects with no usage data, reducing noise in logs.

Maintenance:

  • Upgraded flywheel-sdk from >=21,<22 to >=22,<23.
  • Upgraded pytest from >=6.1.2,<7 to >=9,<10 and pytest-cov from >=3.0.0,<4 to >=7,<8.
  • Refactored project metrics into typed dataclasses (ProjectMetrics, ProjectStatistics, ProjectUsageSummary) replacing plain dictionaries.
  • Updated Dockerfile COPY directive to use --chmod=755 instead of --chown=flywheel:flywheel.

Documentation:

  • Updated README.md to document the new storage (MB) column and added a note that storage figures may take up to 24 hours to reflect newly created projects.

0.1.0 [2026-04-03]

Enhancements:

  • Added project-reporter gear that generates a CSV report of project statistics (subjects, sessions, acquisitions) for specified Flywheel groups and projects
  • Added support for querying individual projects via group_id/project_label paths
  • Added support for querying all projects in a group via group ID
  • Added "all" special value for group_and_project_list to report on every project accessible to the user
  • Added Site Admin detection to enable exhaustive search mode for reporting across all projects in the instance
  • Added projects_metrics.csv output with project name, group, container counts, and direct Flywheel project URLs

Maintenance:

  • Added Dockerfile with multi-stage build using python:3.12-wolfi-build base image and uv for dependency installation
  • Added pyproject.toml with hatchling build system and dependencies on flywheel-sdk>=21,<22 and fw-gear>=0.3.0,<0.4
  • Added CI/CD pipeline via .gitlab-ci.yml with python 3.12 and 90% coverage requirement
  • Added pre-commit hooks configuration for linting and testing

Documentation:

  • Added README.md with gear overview, configuration, usage examples, and use cases
  • Added CONTRIBUTING.md with setup instructions using uv and pre-commit
  • Added FAQ.md placeholder for frequently asked questions