Add your description here
Project description
TKO
Distribuição de tarefas de programação com Git, desenvolvimento direto na IDE do aluno e feedback contínuo para professores com métricas de progresso.
Plataforma para ensino prático de programação que conecta autoria de questões, execução local de testes e observabilidade pedagógica sem depender de LMS/hosting como Moodle.
O TKO é um ecossistema de ensino de programação centrado em prática, versionamento e evidências de aprendizagem. Ele distribui atividades via Git, permite desenvolvimento na IDE local e acompanha progresso de turmas com dados reais de evolução.
Visão Geral
O TKO resolve o problema de acoplar ensino de programação a ambientes artificiais de navegador. Em vez disso, o aluno trabalha no próprio fluxo profissional: editor, terminal, compilador e controle de versão.
Para o professor, o sistema viabiliza distribuição de tarefas personalizadas e acompanhamento de execução com sinais de desenvolvimento, como tempo de resolução, histórico de versões e progresso por atividade.
Fluxo rápido:
- Professor cria ou publica repositórios de questões.
- Aluno baixa a atividade e desenvolve na própria IDE.
- Aluno executa os testes localmente e itera com feedback imediato.
- Aluno envia para o professor via Git, GitHub Classroom, Dropbox ou e-mail.
- Professor acompanha evolução, métricas de aprendizado, tentativas e progresso da turma.
Quick Start
Linux / WSL
pipx install tko
tko --version
tko --help
Saída esperada:
- O comando
tko --versiondeve mostrar a versão instalada. - O comando
tko --helpdeve listar os comandos principais (task,build,class,remote, ...).
Se tko não for encontrado após instalar com pipx, rode:
pipx ensurepath
Depois reabra o terminal.
Windows
Use o guia recomendado para setup completo com VS Code e WSL:
Casos de Uso
- Distribuição de listas e atividades de programação via Git.
- Desenvolvimento local na IDE do aluno, sem dependência de browser.
- Correção automática com testes e iteração rápida.
- Acompanhamento docente com indicadores de progresso e histórico.
Documentação por Perfil
- Professor da disciplina (distribui e coleta via Git, GitHub Classroom (recomendado), Dropbox e e-mail): Uso pelos professores, Criando tarefas e testes
- Aluno da disciplina: Uso do TKO pelos alunos, Fazendo as atividades
- Aluno em estudo autônomo (fora de disciplina): Testando sem estar em uma disciplina, Repositórios de referência
- Instalação e ambiente: Instalação
- Desenvolvedores: Uso pelos desenvolvedores
- Ferramentas auxiliares: Ferramentas
Repositórios de referência:
Instalação
- Windows, VS Code e WSL - Recomendado
- Linux: VS Code
- WSL e Ubuntu: Setup básico com GIT, Python, TKO
- Windows sem WSL
- Linguagens - Java, C, C++, Python, TypeScript, Go
- Outros sistemas operacionais
Uso do TKO pelos alunos
- Testando sem estar em uma disciplina
- Como organizar seus repositórios da disciplina
- Fazendo as atividades
Uso pelos professores
- Trabalhando com o GitHub Classroom
- Repositórios e quests
- Marcadores e tipos de atividades
- Criando tarefas e testes
- Gamificação e progressão
Uso pelos desenvolvedores
Ferramentas
- Filtragem e Rascunhos
- Markdown Preprocessor
- Rebase de links markdown
- Build all: pipeline de mdpp, filter e drafts
- Build index: manter e atualizar índices
Referência e suporte
- Índice da documentação
- Guia de contribuição
- Arquitetura técnica
- FAQ
- Referência rápida da CLI
- Especificação de formatos
- Exemplos end-to-end
- Ciclo de vida de tarefas
- Suporte a linguagens
- Guia de testes e QA
Atualizando o TKO
Para atualizar o TKO para a versão mais recente, basta executar o comando:
pipx upgrade tko # windows, codespace, arch, ubuntu e wsl
Contribuição
Contribuições são bem-vindas via pull request.
Fluxo mínimo para validar mudanças localmente:
uv run pytest -q
Se possível, mantenha mudanças pequenas, com descrição clara do problema e da solução no PR.
Licença
Este projeto está sob a licença MIT. Veja LICENSE.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tko-9.17.4.dev1.tar.gz.
File metadata
- Download URL: tko-9.17.4.dev1.tar.gz
- Upload date:
- Size: 207.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"EndeavourOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
409b3f99754596da64c486e2f5faf798f8ebaa0434aee2797fa33debdb582693
|
|
| MD5 |
bb09d21b55ff71875942955c4eceabb4
|
|
| BLAKE2b-256 |
decf699cb53a9bbffed533588096340d8ef0f576a967bd15037ff312e167f5cf
|
File details
Details for the file tko-9.17.4.dev1-py3-none-any.whl.
File metadata
- Download URL: tko-9.17.4.dev1-py3-none-any.whl
- Upload date:
- Size: 279.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.16 {"installer":{"name":"uv","version":"0.11.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"EndeavourOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e37ed21474916debc5961208b0765ccd7384e742d6a4f9726250549dd2331f3b
|
|
| MD5 |
423b5f68c18a3cec5ee7f4e215bffff8
|
|
| BLAKE2b-256 |
22b6a0a7908425af23c61b8d77babfee55c9ed45b3b738c0f400611b2d68b256
|
