KStreamlined Backend

GraphQL API for the KStreamlined mobile apps.

The API combines multiple Kotlin-related RSS feeds into a single list of FeedEntry and supports filtering by feed sources.

Currently supported feed sources:

1. Kotlin Blog - Latest news from the official Kotlin Blog
2. Kotlin YouTube Channel - Videos from the official Kotlin YouTube channel
3. Talking Kotlin - Podcast on Kotlin and more by JetBrains
4. Kotlin Weekly - Weekly community Kotlin newsletter

Tech

• Spring Boot
• Netflix DGS Framework
• Ktor (client)
• GraalVM

Local dev environment

Setup the required environment variables:

KS_REDIS_REST_URL
KS_REDIS_REST_TOKEN
KS_GCLOUD_PROJECT_ID
KS_CF_BASE_URL
KS_CF_ACCOUNT_ID
KS_CF_API_TOKEN

Run gcloud auth application-default login to authenticate Firestore.

Building and running locally

To compile the project:

./gradlew assemble

To run unit tests and static analysis:

./gradlew check

To run the service as a Spring Boot application:

./gradlew bootRun

The GraphQL playground is available at:

http://localhost:8000/graphiql

To assemble an executable jar archive:

./gradlew bootJar

Integration tests

Integration tests are run against local HTTP stubs and Firestore emulator managed by Testcontainers.

Start Docker Desktop (or a compatible alternative like OrbStack), then run:

./gradlew integrationTest

GraalVM Native Image

Make sure the required version of GraalVM JDK is installed.

To compile a native executable:

./gradlew nativeCompile

To run the native executable:

./gradlew nativeRun

Reachability metadata

Native image hints are declared in code and generated by Spring AOT.

Native compatibility tests

Native compatibility tests run the native executable against native metadata dependent code paths using local HTTP stubs and Firestore emulator managed by Testcontainers.

Start Docker Desktop (or a compatible alternative like OrbStack), then run:

./gradlew nativeCompatibilityTest

License

Copyright 2022 Yang Chen

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.