Saltar para o conteúdo
KendorDocs

Que linguagens e versões pode usar um desafio de código

Para autores de desafios ·

Node.js 22, Python 3.12, Go 1.27 e 1.26, Java 21, Rust 1.98, C++ (Clang 23) e PHP 8.3 e 8.4. Escolhe uma com runtime.version no kendor.yaml.

Um desafio do Kendor pode correr Node.js 22, Python 3.12, Go 1.27 ou 1.26, Java 21, Rust 1.98, C++ com Clang 23, ou PHP 8.3 ou 8.4. Escolhes a linguagem ao criar o desafio e a versão com runtime.version no kendor.yaml. Um projeto pode adicionar mais linguagens ao lado da principal com toolchains.

Linguagens e versões disponíveis hoje

O valor da segunda coluna é o que escreves em runtime.type, e o da terceira o que escreves em runtime.version, sempre como texto entre aspas.

Linguagem runtime.type runtime.version Compilação exata Gestores de pacotes e ferramentas de build Ferramentas de teste
Node.js node "22" 22.23.3 npm, pnpm e yarn (através do Corepack), Bun 1.4.2 node --test
Python python "3.12" 3.12.14 pip (pip install --user) pytest 8.3.4 com pytest-tap: pytest --tap-stream
Go go "1.27", "1.26" 1.27.1, 1.26.8 Módulos Go go test -json ./... | kendor-gotest-tap
Java java "21" Temurin 21.0.12.1 Maven 3.9.16, Gradle 9.8.0 JUnit console launcher 6.1.3 em $JUNIT_CONSOLE; kendor-junit-tap
Rust rust "1.98" 1.98.1 Cargo, Clippy, rustfmt cargo test --color never 2>&1 | kendor-cargo-tap
C++ cpp "23" Clang/LLVM 23.1.2 CMake, Ninja Catch2 3.16.0 em $CATCH2_DIR; kendor-junit-tap
PHP php "8.3", "8.4" 8.3.32, 8.4.23 Composer 2.10.3 PHPUnit do teu projeto, escrevendo JUnit em /tmp/kendor-phpunit.xml

Cada linguagem traz também o seu servidor de linguagem, para que o editor tenha autocompletar, ir para a definição e erros: typescript-language-server, Pyright, gopls, Eclipse JDT LS, rust-analyzer, clangd e Intelephense. Todas as sandboxes têm ainda git, make, cmake, ninja, sqlite3 e um compilador de C, seja qual for a linguagem.

O Go 1.22 também existe, mas já não é oferecido para novos desafios (vê abaixo).

Como o separador Testes lê os resultados

O separador Testes executa o test.command do serviço e lista cada teste que encontra. Lê TAP (Test Anything Protocol) da saída padrão do comando, e é por isso que a tabela indica um conversor para a maioria das linguagens: kendor-gotest-tap, kendor-junit-tap e kendor-cargo-tap estão no PATH de todas as sandboxes e transformam a saída de go test -json, o XML JUnit e a saída de cargo test em TAP. Envia tudo o resto que a tua build imprime para o erro padrão. O PHP é a exceção: escreve o relatório JUnit do PHPUnit em /tmp/kendor-phpunit.xml com --log-junit /tmp/kendor-phpunit.xml.

kendor.yaml
version: 1
runtime:
  type: go
  version: "1.27"
services:
  app:
    test:
      command: go test -json ./... | kendor-gotest-tap

Escolher uma versão

Quando crias um desafio, escolhe a sua Linguagem e Versão. A linguagem não pode mudar depois de o desafio ser criado; a versão pode.

Para mudar a versão mais tarde, define runtime.version no kendor.yaml, na janela Configuração do runtime ou editando o ficheiro, e guarda. Mantém runtime.type igual à linguagem do desafio: a versão do ficheiro só é usada quando as duas coincidem.

Usa a versão curta da tabela, como "1.27", e não a compilação exata. O Kendor verifica a versão quando guardas e lista as que oferece se a tua não for uma delas.

Adicionar uma segunda linguagem

O toolchains põe mais linguagens na mesma sandbox, cada uma com o seu compilador, ferramentas e servidor de linguagem. Esta configuração Laravel usa PHP como linguagem principal e adiciona Node.js para a build de assets do Vite:

kendor.yaml
version: 1
runtime:
  type: php
  version: "8.3"
toolchains:
  - type: node
    version: "22"
install:
  commands:
    - composer install --no-interaction --prefer-dist --no-progress
services:
  app:
    dev:
      command: php artisan serve --host $HOST --port $PORT
      port: 8000
  vite:
    install:
      commands:
        - npm ci
    dev:
      command: npm run dev -- --port $PORT
      port: 5173
preview:
  service: app

Cada linguagem só pode aparecer uma vez entre runtime e toolchains.

Versões retiradas

Quando uma versão deixa de ter suporte a montante, o Kendor deixa de a oferecer para novos desafios mas mantém-na a funcionar. Um desafio que já esteja nessa versão continua a funcionar e a guardar, e a sua lista Versão mostra-a como "já não disponível". Não podes escolher uma versão retirada para um novo desafio. O Go 1.22 está retirado atualmente.

Quando estiveres pronto, passa o desafio para uma versão atual alterando runtime.version.

Ficheiro único ou projeto completo

Ao adicionares um desafio de código, escolhes entre dois tipos:

  • Desafio de ficheiro único: o candidato edita um só ficheiro, como solution.py, e executa os testes que escreveste a partir do separador Testes. Não há pré-visualização, apenas o editor, um terminal e os testes. Todas as linguagens da tabela têm um template de ficheiro único para começar.
  • Desafio de código: um projeto inteiro. Começa a partir de um template ou de um workspace em branco, carrega um zip ou importa um repositório. Pode ter pré-visualização, vários serviços, bases de dados e mais do que uma linguagem.

Ao criares um desafio, Começar a partir de lista os templates da linguagem que escolheste: Projetos (uma app executável ainda sem enunciado), Desafios (um enunciado, código e testes prontos a enviar) e quaisquer templates que a tua organização tenha guardado. Os projetos disponíveis hoje para um projeto completo são:

Linguagem Projetos
Node.js Vite + React (TypeScript), Vite + React (JavaScript), Express + PostgreSQL + Valkey
Python Flask, FastAPI
Go net/http, Aplicação de linha de comandos
Java Spring Boot, Serviços Java + Go + C++
Rust axum
C++ Aplicação de linha de comandos (CMake)
PHP Laravel 11, PHP simples

Cada template traz o seu próprio kendor.yaml, por isso funciona assim que a sandbox arranca. Lê-o para ver uma configuração funcional dessa linguagem e depois altera o que precisares. O teu desafio fica com a sua própria cópia, por isso uma alteração posterior ao template nunca altera o teu desafio.

Este artigo foi útil?