learntris.org

What It Is

Learntris is a programming challenge project for developers to learn and practice. Its goal is to guide users through building a simplified version of Tetris using a set of automated acceptance tests. It is explicitly not a tutorial: it does not tell you how to write the code, but instead provides inputs, expected outputs, and progressively unlocked tests, requiring you to design the implementation yourself. Users can use any language, library, or tool, as long as their local program can pass the tests.

Core Capabilities and Workflow

At its core, Learntris is a test-driven exercise. Users need to install a small Python program called tanco, connect to the challenge server with tanco login, choose and start a challenge with tanco init, and verify that the local program can run with tanco check. The web interface is used to view and run tests, while tanco shares the local program with the server via websocket. Tests are unlocked one at a time in sequence: you must pass all currently available tests before requesting the next one. This helps learners run regression checks after each change and avoid breaking existing functionality.

Languages, Ecosystem, and Documentation

One advantage of Learntris is that it is language-agnostic: the main text clearly allows any programming language and tool. In terms of ecosystem, it includes a web interface, the tanco command-line tool, and lt-shell, a graphical frontend still under development that lets you play locally after completing the logic. On the documentation side, the page explains the challenge concept, command workflow, and sample tests fairly clearly, and provides an entry point to the tanco setup page. However, there does not appear to be complete system requirements, troubleshooting guidance, open-source licensing information, API/SDK documentation, or self-hosting instructions.

Pricing, Pros, and Cons

Pricing is very straightforward: free. The author says the test suite was originally used years ago for IRC-based programming tutoring, and it remains free for now to collect platform feedback and explore future course ideas. Its strengths are low cost, concrete practice goals, and suitability for developing test-driven thinking. Its drawbacks are that it is not a step-by-step tutorial, so beginners without basic programming ability may get stuck; it also depends on server connectivity and tanco configuration, while lt-shell is still under development.

Who It’s For and Access from China

Learntris is best suited to learners with some programming foundation who want to practice software design, input/output parsing, and game logic implementation through a hands-on project kata. It is also suitable for mentors who want to use staged acceptance tests in teaching. The main text does not provide information about access from China, so it is unclear whether direct connectivity, login, and websocket stability are reliable. There is no payment concern, since it is free. Possible alternatives include general programming practice platforms such as Exercism, Codewars, and Advent of Code.