[BUG] Circular dependency between imio and brainglobe-utils

[willGraham01]

brainglobe/brainglobe-utils#22 introduced a circular dependency between brainglobe-utils and imio: imio needs brainglobe-utils, whilst brainglobe-utils now needs imio due to the functionality that was refactored into it.

Needless to say, this is not ideal. On the surface everything "still works" since there are no circular imports, but naturally we probably want to fix this sooner rather than later.

Zulip discussion: https://brainglobe.zulipchat.com/#narrow/stream/408841-development/topic/.60imio.60.20and.20.60brainglobe-utils.60.20circular.20dependency/near/419020085

Task List (merge imio into brainglobe-utils)

• Mark imio as depreciated with a suitable PR Mark package for deprecation imio#55
  • Release final version to PyPI
  • Transfer issues to brainglobe-utils with a suitable label
  • Archive imio repository
• Prepare merge branch in brainglobe-utils Merge imio in as image_io submodule brainglobe-utils#33
  • Release new version to PyPI, at least v0.4.0!
• Update packages that used to depend on imio
  • brainglobe-segmentation gains a brainglobe-utils dependency | Update imio dependency change brainglobe-segmentation#168 | new version 1.2.2
  • brainreg drops its imio dependency as it already depends on brainglobe-utils | Update imio dependency brainreg#181 | new version 1.0.5
  • Release new versions of updated packages
  • Release new metapackage version with pinned dependencies | Update brainglobe-utils dependency and remove imio brainglobe-meta#47
• Stage update to documentation website Add blog post for imio retirement brainglobe.github.io#149
  • Blog post with imio move
  • Documentation updates
    • Dependency graph update
    • Move any imio documentation into brainglobe-utils docs
• Update Investigate making a brainglobe metapackage on conda-forge brainglobe-meta#40 task plan to account for imio package no longer being used.

[willGraham01]

As agreed in the developer meeting on 08-02-2024, we will be merging imio into brainglobe-utils as a submodule.

Task list with updates has been added to the main issue comment for tracking.