Repositório de Tutoriais de Programação Lua

Versão navegável: todo o material também está publicado como site em dionipadilha.github.io/aprendendo_lua — gerado por um script Lua deste próprio repositório.

Este repositório oferece guias para a linguagem de programação Lua, abrangendo diversos conceitos. O material aqui apresentado é fruto de meu estudo e desenvolvimento, e visa auxiliar programadores em diferentes níveis de experiência.

Novo por aqui? Comece pelo roteiro guiado de 3 dias: documentacao/comece_aqui.md.

Objetivo:

Este repositório tem como objetivo contribuir para a comunidade de programadores.

Conteúdo:

• Explicações claras e concisas: Conceitos básicos da linguagem de programação são expostos de forma didática e objetiva.
• Exemplos práticos e soluções: Diversos exemplos demonstram a aplicação prática dos conceitos, além de oferecer soluções para desafios comuns em programação.
• Cobertura: Os guias abrangem a instalação da linguagem, tópicos básicos e tópicos mais avançados.
• Códigos revisados: Todos os scripts são executados automaticamente pela CI (veja executar_testes.sh).

Organização do repositório:

As pastas na ordem de estudo sugerida (a mesma de documentacao/guia_de_estudos.md):

Pasta	Tema
basico/	Primeiros passos, tipos, cadeias de texto, operadores e formatação
controle_de_fluxo/	Condicionais, laços, break, switch e goto
funcoes/	Funções, clausuras, varargs, múltiplos retornos e memoização
tabelas/	Tabelas, vetores, pilhas, listas, iteradores, buracos/#, cópias e serialização
metatabelas/	Metatabelas, metamétodos, proxies e tabelas somente leitura
poo/	Classes, herança, polimorfismo, mixins e interfaces
modulos/	require, dofile, loadfile, ambientes (_ENV) e empacotamento com LuaRocks
erros/	error, assert, pcall, xpcall e try/except
io/	Leitura e escrita de arquivos, em texto e binário
sistema/	Data e hora, relógio, esperas, aleatórios e linha de comando
gc/	Coleta de lixo e tabelas fracas
desempenho/	Medição de desempenho: cronometrar antes de otimizar
depuracao/	Biblioteca debug: introspecção da pilha e ganchos de execução
testes/	Framework de teste unitário e exemplos de testes
padroes/	Padrões de projeto, da fábrica ao MVC e à máquina de estados
solid/	Princípios SOLID, um arquivo por princípio
corrotinas/	Guias e exemplos de corrotinas
banco_de_dados/	Integração com SQLite via CLI
capi/	API C: embutir Lua em C e módulos C carregáveis via require
projetos/	Projetos completos (pluralizador, json, equipe) e soluções dos exercícios
documentacao/	Guia de estudos, roteiro, paradigmas, convenções, guias de instalação, LuaJIT/versões e enunciados de projetos
site/	Gerador do site estático em arquitetura hexagonal — estudo de caso de portas e adaptadores

Esta tabela é espelho de site/trilha.lua — a fonte única, legível por máquina, da ordem das pastas e das lições (o site e o verificador site/verificar_trilha.lua a consomem; ao mudar uma, mude a outra). A trilha completa de estudo está em documentacao/roteiro_de_estudos.yml e documentacao/guia_de_estudos.md.

Destaques:

Quatro exemplos que mostram o espírito do repositório — executáveis, autoverificados e honestos sobre limitações:

• projetos/json/ — codificador e decodificador de JSON do zero, com testes de roundtrip e uma seção de limitações conhecidas que diz a verdade (null, Unicode, ciclos).
• corrotinas/jogo_com_corrotinas.lua — um mini-jogo de perseguição jogável no terminal que ensina a troca de valores entre resume e yield.
• solid/ — cada princípio SOLID com a violação e o redesenho lado a lado, no mesmo arquivo, verificados por asserts.
• tabelas/buracos_e_comprimento.lua — a pegadinha mais famosa de Lua (# com buracos) demonstrada em vez de apenas descrita.

Convenções de idioma:

Todo o material — nomes de arquivos, identificadores, comentários e mensagens — está em pt-BR. Permanecem em inglês apenas o que pertence à própria linguagem (palavras-chave, biblioteca padrão como table.insert, metamétodos como __index) e termos técnicos consagrados (siglas como CRUD, MVC e SOLID). Identificadores não levam acento porque Lua só aceita ASCII em nomes (funcao, heranca).

Como executar:

Os exemplos têm como alvo o Lua 5.4. Cada arquivo é independente — execute a partir do diretório em que ele está:

lua5.4 basico/ola_mundo.lua
cd projetos/json && lua5.4 principal.lua

Para verificar todos os scripts de uma vez (o mesmo teste executado pela CI):

./executar_testes.sh

Utilização:

Os códigos disponibilizados neste repositório são livres para uso, sob a licença MIT. A citação da fonte é apreciada.

Contribuições são bem-vindas — as convenções e o passo a passo estão em CONTRIBUTING.md.

Links:

• Manual de referência do Lua 5.4
• Programming in Lua (livro dos autores da linguagem)
• Guia rápido da comunidade (gist)

Espero que este material seja útil para o meu/seu aprendizado!