Projeto open source para o controle de associados da associação PythonBrasil
O projeto é desenvolvido por voluntários, utilizando principamente Python e Django e Twitter Bootstrap
Recomenda-se utilizar o virtualenv para manter o ambiente isolado de suas aplicações. Testado com Python 3.5.2, Postgresql 9.5.4 e Django 1.10.1.
Você precisa instalar o postgresql em sua máquina antes de continuar.
No Ubuntu:
$ sudo apt-get install postgresql
No Mac OS X com Homebrew:
$ brew install postgresql
Consulte sua distribuição para saber como preparar o postgres.
Exemplo, para instalar o banco de dados em /tmp/pgdata (temporário):
$ sudo apt-get install python-psycopg2
$ pg_ctl initdb -D /tmp/pgdata
$ pg_ctl start -D /tmp/pgdata
$ su postgres psql -U postgres # para roots: psql -d postgres
postgres=# create user associados createdb createuser password 'assocdev';
postgres=# create database associados owner associados;
postgres=# \q
Você pode mudar os parâmetros locais, como banco de dados, copiando o arquivo:
associados/example_settings.ini para associados/settings.ini e editando o arquivo
com suas preferências. Os settings primeiro verificam variáveis de ambiente e
depois as definições do settings.ini.
Ou seja, se você definir $ export DEBUG=True, o valor do DEBUG em settings.ini não
será avaliado.
$ make setup
$ make run
$ make test
Caso queira subir o ambiente com Docker, temos um docker-compose.yml com o PostgreSQL e o Django. No arquivo, também é possível alterar as informações de acesso do PostgreSQL.
Instalar o Docker/Docker-Compose.
Copiar o arquivo associados/example_settings.ini para associados/settings.ini e configurar as variáveis locais.
Copiar o arquivo associados/settings_local.py para associados/settings_local_model.py e configurar a variável do banco de dados.
Subir o ambiente com o comando docker-compose.yml.
Caso queria realizar os testes, usar o comando docker-compose run web python manage.py test --settings associados.settings_test --verbosity=2.
Reporte os bugs e compartilhe o patches baseada nas nossas Issues ou simplesmente faça um fork do projeto, contribua com o que achar necessário e mande pra gente! :)
