allowed

Os cursos geralmente usam um subconjunto restrito de uma linguagem de programação e sua biblioteca, para reduzir a carga cognitiva, focar em conceitos, simplificar a marcação etc.

allowed é um programa que verifica se seus arquivos de código e notebooks Jupyter usam apenas as construções Python que foram ensinadas.

allowed permite que os instrutores verifiquem com antecedência seus exemplos, exercícios e avaliação quanto ao uso inadvertido de construções que não foram ensinadas. Ele também permite que os alunos e instrutores verifiquem o código enviado contra as construções ensinadas. Para fazer seu trabalho, allowed requer um arquivo curto que listas quais foram introduzidas as construções na qual 'unidade' do curso. Esse arquivo pode ser usado como um documento de referência para novos tutores e para discutir o design do curso, por exemplo, para verificar se os construções importantes estão ausentes ou se algumas unidades estiverem sobrecarregadas.

Como todas as ferramentas de análise estática, allowed não é perfeito e nunca será. Pode haver falsos positivos (código relatado como uma violação, mas não) e falsos negativos (código que usa construções não permitidas, mas não é relatado).

Para se referir a allowed em uma publicação, cite

Michel Wermelinger. Verificando a conformidade com um subconjunto da linguagem Python . Anais da Conferência sobre Inovação e Tecnologia em Educação em Ciência da Computação (ITICSE), vol. 2, pp. 573-574. ACM, 2023.

Instruções

Se você é um aluno ou tutor do M269, siga as instruções de instalação do software M269 e use o fórum técnico M269 ou o fórum do tutor para relatar problemas e fazer perguntas.

Caso contrário, siga as instruções sobre como instalar, usar e configurar allowed . Se precisar de ajuda, poste sua consulta no fórum de discussão de perguntas e respostas.

Contribuindo

Qualquer ajuda para melhorar allowed é bem -vinda e apreciada.

• Se você usa allowed , compartilhe sua experiência e dicas no fórum Show & Tell.
• Se você precisar de um novo recurso, sugira -o no fórum de discussão de idéias.
• Se você identificar um erro no código ou documentação, verifique se foi relatado antes de criar um novo problema.
• Se você deseja contribuir com código ou documentação que aborda um problema em aberto, leia primeiro nosso guia de contribuição de código. Sua contribuição ficará disponível nos termos abaixo.

Licenças

O código e o texto neste repositório são direitos autorais © 2023 pela Open University, Reino Unido. O código é licenciado sob uma licença de 3-cláusulas BSD. O texto é licenciado sob uma licença internacional Creative Commons Attribution 4.0.