Add NotGiven compatibility module

[bpholt]

Scala 3 introduced scala.util.NotGiven: a special class used to implement negation in implicit search.

While techniques existed to implement this functionality in some cases in Scala 2, the NotGiven trait was not backported to Scala 2. This makes cross-compilation more frustrating than it needs to be, so this module was created to make a single org.typelevel.scalaccompat.scala.util.NotGiven available to Scala 2.12, 2.13, and 3.

This is based on prior work by Shapeless and fs2.

This was initially proposed as typelevel/tsc#171, but I agree that this repo is a better home for this code.

[bpholt]

I used Jetbrains Junie in IntelliJ to add some motivating examples / tests that don't compile on Scala 2 without the new module. Hopefully that's helpful.

I'm not sure we needed to wait for that, but now that it's there, I think this is ready to be reviewed @satorg @armanbilge.

[satorg]

@bpholt , thank you for the PR! It looks great overall, but I'd vote for naming consistency here.
The existing sub-project name is annotations and its published module name is scalac-compat-annotations.

For the new module I'd personally prefer to have something like notgiven and scalac-compat-notgiven correspondingly – just to keep the naming consistent across the project.

Moreover, for now we only get NotGiven here, but I can imagine that in the future we may want to provide cross-compiling compatibilites for other Scala3 features. How about renaming the new module into features/scalac-compat-features or utils/scalac-compat-utils? (utils – because NotGiven is in scala.util package, but features would be even more generic).

[bpholt]

@bpholt , thank you for the PR! It looks great overall, but I'd vote for naming consistency here. The existing sub-project name is annotations and its published module name is scalac-compat-annotations.

For the new module I'd personally prefer to have something like notgiven and scalac-compat-notgiven correspondingly – just to keep the naming consistent across the project.

Moreover, for now we only get NotGiven here, but I can imagine that in the future we may want to provide cross-compiling compatibilites for other Scala3 features. How about renaming the new module into features/scalac-compat-features or utils/scalac-compat-utils? (utils – because NotGiven is in scala.util package, but features would be even more generic).

Makes sense! I updated this in a05e47e.

[satorg]

Thank you!

[bpholt]

@armanbilge did you want to take another look, or shall we go ahead and merge?

[armanbilge]

thanks for seeing this through!