ReadingBat Python Content

Python programming challenges served by the ReadingBat platform. Students solve challenges in the browser; the server evaluates answers by running Python functions against test cases defined in each file.

Prerequisites

• Java 25+ (the Gradle toolchain targets Java 25; Gradle can auto-provision it)

Setup

make build      # Build without tests
make tests      # Run all tests
make run        # Start the server on port 8080

Run make help to see every available target. Other common ones:

make lint       # Run kotlinter + detekt
make format     # Format Kotlin sources
make cc         # Continuous compilation while you edit
make uber       # Build and run the fat jar

Adding a Challenge

1. Create a Python file in python/<group_dir>/ following this pattern:

# @desc Description of the challenge

def challenge_name(param1, param2):
    return result

def main():
    print(challenge_name(arg1, arg2))  # each print = one test case

if __name__ == '__main__':
    main()

2. Register the challenge in src/main/kotlin/Content.kt — either add a challenge() call or ensure the filename matches an existing includeFilesWithType glob. Return types are qualified, e.g., ReturnType.IntType.

3. Run make lint then make tests to verify.