datafinder-team team mailing list archive

["Guy K. Kloss" <g.kloss@xxxxxxxxxxxx>]

Hi,

habe gerade mal versucht einen weiteren Babyschritt weiterzukommen. D. h. nun 
also folgendes (vermute ich):

 * GUI module generieren (Qt3 und Qt4)

 * configuration generieren
   (was auch immer das ist, hat glaube ich was mit dem Datenmodell zu tun)

 * Sehen, ob die Unit-Test funzen

 * Startkonfiguration anlegen und starten.

Ich bin einfach mal ganz dumm dem hier fuer manches gefolgt:

https://wiki.sistec.dlr.de/DataFinder/HowTo/EntwicklungsUmgebung2

Ein paar Dinge, die mir auffielen:

 * Nicht mehr Subversion, sondern jetzt Bazaar fuer's VCS

 * Installation von externen Python dependencies ist besser mit pip
   als mit easy_install. Man muss ggf. erst pip mit easy_install installieren

 * Es ist fuer die DF_START folgendes vorgeschlagen:
   http://datafinder.dlr.de/repos/test/REL_2.0.0/config
   Die URL ist nicht von aussen erreichbar. Sollte nicht irgendein "Spiel-
   Repository" verfuegbar sein?

 * Kann man EpyDoc ggf. so konfigurieren, dass es *keine* Doku fuer generierte
   Module erstellt? Das Paket datafinder.gui.gen benoetigt viele Minuten auf
   meiner Box.

 * Unit-Tests, die auf optionale Module ausgerichtet sind, sollten nicht 
unbedingt zu Errors fuehren (in meinem Beispiel bei Abwesenheit des boto 
Packages).

 * Deprecation warnings:

   - Es wird das md5 Modul in der WebDAV-Lib verwendet. Weiss jetzt nicht, ob
     das nicht mal refactored werden soll, da es "deprecated" ist, und durch
     hashlib ersetzt werden sollte.

   - BaseException.message wird an verschiedenen Stellen (unter anderem in
     datafinder/core/configuration/datamodel/handler.py:77)
     verwendet, ist aber in Py 2.6 deprecated. Duerfte relativ leicht zu
     flicken sein.

Hier ein paar Schritte auf der Konsole. Es sollte ja *immer* auch komplett 
ohne GUI/IDE gehen:

## Get DataFinder with Bazaar from Launchpad.
$ bzr branch lp:datafinder

## Install some dependencies, which are not easily taken from Linux package
## management.
$ sudo pip install pythonwebdavlib
$ sudo pip install generateDS

## Build/check what's necessary, incl. docs and pylint report.
$ python setup.py generate_gui_modules
$ python setup.py generate_qt4_resources
$ python setup.py generate_configuration_modules
$ python setup.py run_unittests
$ python setup.py run_pylint


So, das war einfach mal 'ne Zusammefassung meiner ersten fluechtigen 
Beobachtungen. Das meiste kann durch sauberere Doku, bzw. leichtes Refactoring 
geloest werden. Doku denke ich sollte sowohl in der README als auch im Wiki 
erfolgen. Ggf. waere es sinnvoll die README nur als "Master-Verweis" 
auszulegen, und eine DEVELOPER.txt, INSTALL.txt und INFRASTRUCTURE.txt 
anzulegen, ggf. in einem "doc/" Verzeichnis, damit's in der Root nicht zu voll 
wird.

Guy

-- 
Guy K. Kloss
Institute of Information and Mathematical Sciences
Te Kura Pūtaiao o Mōhiohio me Pāngarau
Massey University, Albany (North Shore City, Auckland)
473 State Highway 17, Gate 1, Mailroom, Quad B Building
voice: +64 9 414-0800 ext. 9266   fax: +64 9 441-8181
G.Kloss@xxxxxxxxxxxx http://www.massey.ac.nz/~gkloss

Attachment: signature.asc
Description: This is a digitally signed message part.