Upgrading from v3

[twickstrom]

I have an API that has been using Spatie Query Builder for nearly four years, seriously great work!

Today, I walked through the process of upgrading from Laravel 7 to Laravel 8 and manually walked through each dependency to make sure I was aware of any changes.

It appears I will be locked into v3 of Spatie Query builder since moving to v4+ will have serious ramifications to the consumers of the API with the removal of snake/camel conversion of includes and filters.

I get why this was done, I've read through the issues, etc plus from a performance standpoint alone it's a few extra steps for sure. However, the fact still remains that breaking changes to the consumer interface will make it very hard to upgrade.

I think this can be solved in a few different ways without affecting any current v4+ user. Here are a couple of my thoughts:

• enable snake/camel conversion via a config variable (default false)
• create a helpers package that enables the snake/camel conversion, much like laravel has done with their own Arr & Str helpers

It would allow for long-time users to have an upgrade path that makes sense and would allow you guys to eventually deprecate older versions.