Improvements to ZQuery

[adamgfraser]

Various improvements to ZQuery including:

• Adds new data source constructors fromFunctionBatchedWith and fromFunctionBatchedWithM that make it easier to construct batched data sources that don't return results in the same order as requests by providing a function to associate results with requests as suggested by @fokot.
• Adds partitionM and partitionMPar methods on ZQuery that allow for performing a collection of queries and getting back a collection of all successes along with a collection of all failures
• Adds a new Described data type to clean up and clarify the contract around needing to provide names for certain combinators such as provide and provideSome.
• Miscellaneous cleanup including adding CanFail and NeedsEnv to appropriate combinators and removing unnecessary final modifiers.

One thing I would appreciate feedback on is how much users are working with data sources in the environment. I am thinking we could simplify DataSource somewhat by not using the module pattern and just having all the methods on DataSource versus DataSource.Service. That would mean that users could still put the DataSource in the environment but it would not come "baked in" like it is today. The nice thing would be this would mean you wouldn't have to write DataSource.Service everywhere but if people are using it as an environmental effect then we should leave as is.

[ghostdogpr]

About your question about DataSource, I personally prefer not to use ZIO Environment for that and pass it explicitly (like I did in OptimizedTest), so I support the simplification. We could also make fromRequestWith be just fromRequest. I'll point to your PR in discord to see if others have an opinion on it.

[ghostdogpr]

Nice! It can be used in Executor line 145

[jdegoes]

Agreed on not using environment for DataSource. It's better an ordinary value.

ZIO Config used environment for its "ConfigSource" for a while, but changing that to values made everything much more natural and compositional, as well as more obvious for users.

[adamgfraser]

Updated to not use the environment for DataSource and add additional error handling combinators foldM and bimap.

[ghostdogpr]

Awesome!