Rodando

Rodando

Utilizando o script

Um script pra rodar o foi inserido no projeto. Com ele já é criado uma virtualenv e instalado as dependencias do projeto dentro dela. Existem algumas opções que podem ser passadas para mudar seu comportamento.

Para executar torne o arquivo run_script em um executável com o comando chmod +x run_script.sh e o execute com:

./run_script

first

essa opção executa um pequeno instalador que leva você a configurar o arquivo config.json mais as migrações do banco de dados

./run_script first

config

essa opção executa um pequeno instalador que leva você a configurar o arquivo config.json mantendo todo o banco de dados atual

./run_script config

reset

essa opção reseta o banco de dados sqlite do 0, mantendo o config.json intacto

./run_script reset

clean

essa opção reseta apenas as migrações mantendo o arquivo sqlite e o config.json intacto

./run_script clean

unicamp

essa opção reseta o banco de dados para a versão localizada em docs/dev.json [por padrão são as matérias do IC e FEEC]

./run_script unicamp

Sem script

Virtualenv

É recomendado executar o projeto e instalar as dependências em um ambiente virtual de Python (virtualenv) para evitar conflitos de versões e problemas de dependencias. Para isso, execute os seguintes comandos para criar o ambiente virtual e ativá-lo.

Instalando

pip3 install virtualenv

Executando

virtualenv env
source env/bin/activate

Para desativar o ambiente, basta executar o comando deactivate, carregado ao se ativar o ambiente.

Dependências

as dependências do projeto devem ser colocadas no diretório raiz do projeto no arquivo dependencies.txt. para instalá-las rode:

pip3 install -r dependencies.txt

config.json

Algumas configurações são ocultadas do código e ficam no arquivo config.json no diretório raiz do repositorio. Ele deve seguir o seguinte padrão:

{
    "SECRET_KEY": "uma_senha_muito_secreta",
    "EMAIL_HOST": "smtp.gmail.com",
    "EMAIL_PORT": "587",
    "EMAIL_USE_TLS": "True",
    "EMAIL_HOST_USER": "seuemail@gmail.com",
    "EMAIL_HOST_PASSWORD": "suasenha"
}

Executar django

Para rodar execute:

python3 manage.py makemigrations
python3 manage.py makemigrations dacParser
python3 manage.py makemigrations gda
python3 manage.py migrate
python3 manage.py runserver

Para criar um usuário administrador execute python3 manage.py createsuperuser.

Banco de dados

Para fazer o download das informações do site da dac, a path é /update/$INSTITUTO onde $INSTITUTO é o código do instituto (IC, FEEC, FEQ, ...) Para acessar esse path é necessário estar logado como administrador