django musician

Python code is written following PEP 8 sytle guide and it is based on Django framework.

Quickstart development

Start development environment based on docker compose by running:

docker-compose up

How do I get set up?

1. Install Python and its packet manager (pip)

# on a Debian based environment:
apt=(
    git
    python3-pip
    python3-setuptools
)
sudo apt-get install --no-install-recommends -y ${apt[@]}

2. Install virtualenv (isolate app python related requirements)

sudo pip3 install virtualenv

3. Clone this repository

git clone https://github.pangea.org/slamora/django-musician.git

4. Prepare env and install requirements

cd django-musician
virtualenv env
source env/bin/activate
pip3 install -r requirements.txt

5. Start django devel server (check everything is ok)

python manage.py migrate
python manage.py runserver

6. Open http://127.0.0.1:8000/ in your browser.

7. If everything works, follow Django deployment instructions.

How to generate/update translations

1. Go to musician folder and run:

cd django-musician/musician
../manage.py makemessages

processing locale ca
processing locale es

2. Edit generated .po files and save it when you have finished.

musician/locale/ca/LC_MESSAGES/django.po  # catalan
musician/locale/es/LC_MESSAGES/django.po  # spanish

3. To able to use a .po file in an application, it needs to be compiled to the binary .mo file format.

../manage.py compilemessages

More detailed instrucions on Django Translation docs