grader-edx's Introduction

Avaliador Externo - Open edX

Requisitos: Python 3.6+, Pip 9+, Mysql 5.7+, edX com XQueue

Configuração XQueue

$ vagrant up # Inicar o edX Fullstack
$ vagrant ssh # Acessar o ambiente com edX
$ sudo -H -u xqueue vim /edx/app/xqueue/xqueue.env.json # Editar o Json de Configuração

No arquivo xqueue.env.json deve ser adicionado o nome da fila, por exemplo py-queue, e o endereço:

  "XQUEUES": {
      ...
      "py-queue": "http://10.0.2.2:1710",
  },

*Necessário reniciar a máquina edX após a mudança.

Configuração e Execução do Avaliador

Criar ambiente virtual Python para isolar as dependências:

$ git clone https://github.com/brnomendes/grader-edx.git
$ cd grader-edx/
$
$ sudo pip install virtualenv
$ virtualenv -p python3 venv # Criar o Ambiente Virtual venv
$ . venv/bin/activate # Utilizar o Ambiente Virtual venv
$
(venv)$ pip install -r requirements.txt

Configurando Banco de Dados:

Variáveis de ambiente a serem configuradas:

GRADER_HOST
GRADER_USER
GRADER_PASSWORD
GRADER_DATABASE

Iniciando o Avaliador:

(venv)$ ./start.sh

Criando Exercício para o Avaliador Externo

Exemplo de exercício. Deve ser indicado o nome da fila do avaliador no parâmetro queuename.

<problem>
  <text>
    <p>Create a method and test</p>
  </text>

  <coderesponse queuename="py-queue">
    <textbox mode="python" tabsize="4"/>

    <codeparam>
        <initial_display>
        def foo(x, y):
            pass

        def test_foo():
            pass
        </initial_display>
        <grader_payload>unique_name_of_problem</grader_payload>
    </codeparam>
  </coderesponse>
</problem>

Recommend Projects