Floci's Java package is moving to io.floci.aws

[hectorvent]

We are renaming Floci's Java package from io.github.hectorvent.floci to io.floci.aws, with Maven groupId io.floci. This brings floci-aws in line with the rest of the family (io.floci.gcp, io.floci.az, io.floci.oci, io.floci.cli). The final rename is planned for November 4 to 6. We will keep you informed here and in #6589, where progress is tracked.

If you run Floci

Almost nothing changes. The Docker image, the native binary, release assets, ports, FLOCI_* environment variables and your persisted data all stay the same. Existing state keeps loading after the upgrade, because nothing Floci stores records a Java class name.

The one thing to update is log level overrides, because log categories follow the package:

# before
quarkus.log.category."io.github.hectorvent.floci.services.sqs".level: TRACE
# after
quarkus.log.category."io.floci.aws.services.sqs".level: TRACE

The same applies to the environment-variable form: QUARKUS_LOG_CATEGORY__IO_GITHUB_HECTORVENT_FLOCI_SERVICES_SQS__LEVEL becomes QUARKUS_LOG_CATEGORY__IO_FLOCI_AWS_SERVICES_SQS__LEVEL. The release notes for the version that includes the rename will call this out again.

If you contribute

The rename lands as a single mechanical PR. Small prep PRs go in first, so the final change touches little beyond package and import lines and the file moves:

• chore: add the package rename tool (report and apply) #6556 (merged) adds tools/rename/rename_package.py, which performs the rename and reports what is left to clean up.
• chore: derive class-name strings in main from the class #6588 and chore(ci): start Checkstyle suppression paths below the package root #6584 remove class names written as strings and make the Checkstyle suppressions independent of the package.
• Next come a few PRs that replace inline fully qualified names with imports, one area at a time.

Your open PR does not need to wait for any of this. The final PR is planned for November 4 to 6. When it merges, we will post a short recipe here that replays the rename on your branch, so you will not have to resolve the import conflicts by hand. We will confirm the exact day here and in #6589 as it gets closer.

Questions or concerns are welcome in this thread.

[hectorvent]

The day is today, November 6. The rename is #7689, and it merges once it is approved and CI is green. We will post here the moment it lands.

If you run Floci: nothing new beyond the post above. The next release moves log categories from io.github.hectorvent.floci... to io.floci.aws..., so update any quarkus.log.category or QUARKUS_LOG_CATEGORY__... overrides when you upgrade.

If you have an open PR: there is nothing to do yet. After the merge, run this from any checkout of the repository:

git fetch origin
bash <(git show origin/main:tools/rename/rebase_across_rename.sh) <your-branch>

It renames your branch's base and tip, then replays your change onto the new main, so only real conflicts remain, never the import churn. Your old tip is kept as <your-branch>-before-rename, and nothing is pushed: check the result, then git push --force-with-lease origin <your-branch>.

Questions are welcome here.

[hectorvent]

The rename has landed. #7689 merged today as 7cf443fcee: Floci's Java package is now io.floci.aws, and the Maven groupId is io.floci.

If you run Floci: update log level overrides when you upgrade to the next release, from io.github.hectorvent.floci... to io.floci.aws... (and QUARKUS_LOG_CATEGORY__IO_GITHUB_HECTORVENT_FLOCI_... to QUARKUS_LOG_CATEGORY__IO_FLOCI_AWS_...). Images, binaries, ports, FLOCI_* variables and persisted data are unchanged.

If you have an open PR: each affected PR has a comment with these steps. From any checkout of the repository:

git fetch origin
bash <(git show origin/main:tools/rename/rebase_across_rename.sh) <your-branch>
git push --force-with-lease origin <your-branch>

The script replays your change onto the new main, so only real conflicts remain, and keeps your old tip as <your-branch>-before-rename. Check and build the result before pushing. If anything goes wrong, reply on your PR or here and we will help.

Thanks for your patience during the move.