Incremental compilation / processing issue

[bitspittle]

To repro, we'll build a Kobweb website, which uses KSP behind the scenes to parse a project and discover all website pages.

Important

When you're done with the below steps, run ../gradlew kobwebStop! Otherwise, the web server will keep running.

You will want two terminal windows open for this one -- one will be consumed by Gradle.

Terminal 1

• git clone https://github.com/varabyte/kobweb-site && cd kobweb-site/site
• git checkout feature/dt/test-ksp-1
• Run ../gradlew kobwebStart -t
• In a browser, visit http://localhost:8080/docs/tutorials/create-a-page and make sure something renders

Terminal 2

• Navigate to kobweb-site/site
• git checkout feature/dt/test-ksp-2
  • This removes the file that generates the create-a-page page
• Wait for the Gradle task in terminal 1 to settle
• Check the tab open to http://localhost:8080/docs/tutorials/create-a-page and make sure you're getting a 404 error. You can refresh the tab too if it isn't for any reason.
• Visit http://localhost:8080/docs/guides/getting-kobweb and make sure something renders
• Open src/jsMain/kotlin/com/varabyte/kobweb/site/components/layouts/DocsLayout.kt and make an edit
  • For example, comment out the .borderRadius(0.5.cssRem) line (on line 68)
• http://localhost:8080/docs/guides/getting-kobweb might be 404'ing already!

If not reproduced...

Sometimes the issue doesn't always happen the first time; in that case, let's keep going. Still in terminal 2...

• git reset --hard
• git checkout feature/dt/test-ksp-1
• Wait for terminal 1 to settle.
• Confirm that http://localhost:8080/docs/tutorials/create-a-page is working and http://localhost:8080/docs/guides/getting-kobweb is 404'ing
• Open src/jsMain/kotlin/com/varabyte/kobweb/site/components/layouts/DocsLayout.kt and make an edit
• Both pages should be 404'ing now. If that happens, it means KSP incremental processing called our process method with invalid files.

Important

When you're done with the above steps, run ../gradlew kobwebStop! Otherwise, the web server will keep running.

---

Note that this may be resolved by the fix to #2027 but it's possibly worth checking in case it's a separate issue.

[bitspittle]

For context on what's happening, note that this site creates its pages in markdown. Those markdown files get converted at compile time into Kotlin code, and it's that Kotlin code which should be picked up by the KSP processing step.

When switching between branches, CreateAPage.md exists in test-ksp-1 and GettingKobweb.md exists in test-ksp-2.

[bitspittle]

We believe this ins't happening anymore with latest KSP so we're closing. Thanks for the fix!