This is an old revision of the document!
Table of Contents
Developers Training
- Primi passi in Django (overview + tutorials): https://docs.djangoproject.com/en/2.2/#first-steps
- Rifare i tutorial dentro un
virtualenv
. Da creare conpipenv
: https://pipenv.readthedocs.io/en/latest/ - Creare un account su https://github.com e uno su https://gitlab.com
- (Eventualmente generare e) caricare la propria cave pubblica tra le impostazioni del proprio profilo nelle 2 piattaforme
- Installare
git
e seguire i primi passi: https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html - Clonare il progetto
simpleinvoice
: https://github.com/befair/simpleinvoice
Test di Gasista Felice
Test da effettuare con Gasista Felice, ma da specificare meglio:
- Clonare Gasista Felice: https://github.com/befair/gasistafelice
- Recarsi sul branch master-dj17
- approntare il sistema per Gasista Felice
- installare Gasista Felice docs/dev/quickstart.md
- lanciare i test di gasista felice
- cercare di correggere uno che non va
- fare una push sul proprio repository forkato
- fare una pull request delle modifiche
Materiale di riferimento
Vim
Django
- Scaricare ed installare Django
- Avviare un progetto ``django-admin startproject test_gasista``
- Avviare un'applicazione ``./manage.py startapp base``
- Installare l'applicazione (aggiungere in ``settings.py`` l'applicazione base alle INSTALLED_APPS)
- Sincronizzare il db ``./manage.py syncdb``
- Gestione di una chiave ManyToManyField
- Documentazione con docstrings
- Shell interattiva ipython ``./manage.py shell``
- QuerySet
- View, template, autenticazione
- Prova di alcune batteries: databrowse, admin
- Accenno a pinax
Attualmente si sviluppa con Django 1.3, ma l'obiettivo è di passare alla 1.4 per i nuovi progetti. Per questo la reference punta alla 1.4.
- Manuale - sezione Getting started tutta con ordine
- Release notes 1.4 - come punto di riferimento per cose che non funzionano nella 1.3
Una delle principali differenze che si percepiranno è nella strutturazione della directory del progetto Django che ora vede il manage.py
in una directory superiore alla directory del progetto (non allo stesso livello del settings.py).
Per alcune pratiche di utilizzo di Django nei progetti beFair si faccia riferimento allo stile di programmazione beFair.
Git: sviluppo collaborativo
- Inizializzazione di un nuovo repository
- Aggiornamento
- Diff
- Branch/Tag
- Clonazione
- Workflow: master, dev, dev-fero, dev-seldon, dev-dom
- Git User Manual ('repositories e branches') - partire clonando il repository di Gasista Felice
- gittutorial, presente agevolmente nei vostri sistemi con
man gittutorial
- gittutorial-2, presente agevolmente nei vostri sistemi con
man gittutorial-2
Python
- Glossario Python https://docs.python.org/2/glossary.html
- Stile di programmazione PEP-8
- Quacosa di python idiomatico…
Testing
IMPORTANTE
Se sei arrivato qui, vuol dire che “ti sei fatto un po' le ossa” e puoi leggere le linee guida che Luca ha definito per lo sviluppo di progetto python+Django.
Non ti conviene leggere prima questa sezione perché dovresti avere confidenza con codice python e Django.
- https://github.com/feroda/gasistafelice/blob/master/doc-dev/source/GUIDELINES.rst da imparare “come il Padre Nostro” (si diceva…)
- I commit si fanno con l'indirizzo @befair.it [PER ORA CHI NON LO HA NON SI FERMI LI FACCIA CON IL SUO INDIRIZZO PERSONALE]