1. Noțiuni de conduită în dezvoltarea
unui proiect
Cosmin Poieana
<cmin@ropython.org>
→ aspectul și funcționalitatea unui modul
→structura unui pachet
→controlul reviziei
→ lucrul în echipă
→ponturi și trucuri
→resurse

2. Privire de ansamblu
● Module independente, bine definite
● Mai multe la un loc alcătuiesc pachete si subpachete
● Pachetul principal în rădăcina proiectului, pe post de
biblioteca
● Un setup.py pentru instalarea pachetului
● TODO, README, LICENSE
● .gitignore/.hgignore (Git/Mercurial)
● Scripturi adiționale (pe post de binarii)
● Teste, documentatie, resurse

3. Modulul
● Documentatie (docstring-uri de modul, clase,
metode și funcții)
● Import-uri grupate în 3 categorii (standard, 3-rd
party, project library)
● Spațiere, indentare, stil
● Constante, funcții, clase
● Execuție
● __init__.py

4. Structura proiectului
jarvis/
.git/
.gitignore
doc/
tests/
scripts/
jarvis/
setup.py
README
LICENSE
TODO
jarvis/
config.py
utils/
decorator.py
notify.py
….
worker/
client.py
daemon.py
…

5. Controlul reviziei
Git
● clone
● pull
● add
● commit
● push
● fetch
● merge
Mercurial
● clone
● fetch
● add
● commit
● push
● pull
● merge
* Git sau Mercurial?
(MacGyver sau James Bond?)

6. Lucrul în echipă
● A și B (C, D, ...) lucrează la același proiect
● Modularizare și repartiție corespunzatoare
● Fiecare lucrează pe fork-ul propriu
● Înainte de modificări și după modificări: sincronizare
cu upstream-ul
● Commit, apoi push în origin
● Pull request
● branch, patch

7. Ponturi și trucuri
● jarvis.pth (sys.path, /usr/lib/.../(site|dist)-
packages)
● TODO: …, FIXME: …
● Marcaje (####)
● egrep -rni -B 1 -A 3 <expresie>
● Vim
● PyCharm
● IDLE, Eclipse

8. Resurse
● http://www.vim.org/
● http://www.jetbrains.com/pycharm/
● http://git-scm.com/
● http://mercurial.selenic.com/
● https://github.com/
● https://bitbucket.org/