Merge remote-tracking branch 'ksp/main' into feature/testJvmToolchains

* ksp/main: (39 commits)
  expand array for java default array values.
  fallback to resolved java type in case of type argument substitution failure
  fix java array argument variance
  Fix mapping of TypeAliasDescriptor to KsTypeAlias
  fix type resolution scopes for nested local class.
  AA: add missing annotations on backing fileds into properties.
  workaround for classpath snapshot issue
  exclude resources from ktlint
  AA:add placeholder for Resolver.getPackageAnnotations Resolver.getPackagesWithAnnotation
  Add Resolver.getPackageAnnotations Resolver.getPackagesWithAnnotation api. These new APIs provides capability to inspect java package level annotations.
  CI: upload AA test reports
  AA: add test case for nested annotation
  fix nested annotation type resolution with usesite target
  fix annotation default value evaluation for array initializers
  Java shadow dir: handle absolute paths
  AA: support local declarations in property accessors.
  support local declarations in accessors for getSymbolsWithAnnotation
  support local declarations for property accessors
  AA: update CodeGeneratorImpl
  Generate Java to a new root in each round
  ...

# Conflicts:
#	gradle.properties
tree: 461efb8d0a3ab2205baca975598e783f63bc655c
  1. .github/
  2. api/
  3. benchmark/
  4. buildSrc/
  5. common-util/
  6. compiler-plugin/
  7. examples/
  8. gradle/
  9. gradle-plugin/
  10. integration-tests/
  11. kotlin-analysis-api/
  12. symbol-processing/
  13. symbol-processing-cmdline/
  14. test-utils/
  15. .editorconfig
  16. .gitignore
  17. build.gradle.kts
  18. CONTRIBUTING.md
  19. gradle.properties
  20. gradlew
  21. gradlew.bat
  22. LICENSE
  23. README.md
  24. settings.gradle.kts
README.md

Kotlin Symbol Processing API

Welcome to KSP!

Kotlin Symbol Processing (KSP) is an API that you can use to develop lightweight compiler plugins. KSP provides a simplified compiler plugin API that leverages the power of Kotlin while keeping the learning curve at a minimum. Compared to KAPT, annotation processors that use KSP can run up to 2x faster.

Most of the documentation of KSP can be found on kotlinlang.org. Here are some handy links:

Feedback and Bug Reporting

Please let us know what you think about KSP by filing a Github issue or connecting with our team in the #ksp channel in the Kotlin Slack workspace!

If you are interested in sending PRs, please also check out the Contributor guide.

Ongoing and Future Works

Here are some planned features that have not yet been completely implemented:

  • Support new Kotlin compiler
  • Improve support to multiplatform. E.g., running KSP on a subset of targets / sharing computations between targets
  • Improve performance. There are a bunch of optimizations to be done!
  • Make the IDE aware of the generated code
  • Keep fixing bugs!