Note
Rada
Pokud to je pro Vás možné, pracujte na projektu na Unix-based systému, protože to je systém, který nejvíce vývojářu používá a je nejméně pravděpodobné, že by jste narazili na nějaké větší problémy při instalaci knihovny. Pokus jste na Windows doporučuji navštívit stránky projektu Vagrant
Aktuální kód se nacházi v git repozitáři
$ git clone git@git.assembla.com:flexipy.git
git@git.assembla.com:flexipy.git je hlavní rewpozitář. Požádejte Tvůrce a maintainer pro získání přístupu. Mezitím, můžete získat kód skrze Public clone URL:
git://git.assembla.com/flexipy.git
Virtualenv je nástroj pro vytváření oddělených python prostředí. Umožňuje Vám instalovat python package bez zanášení hlavního python prostředí Vašeho OS.
Nejdříve je nutné virtuaelnv nainstalovat_ na Váš systém, pokud jej již nemáte.
Poté vytvořte virtuální prostředí pro flexipy takto:
$ virtualenv flexipy-env
Kde flexipy-env je adresář, ve kterém virtualenv bude vytvořeno. Může se nacházet kdekoliv (ale nevytvářejte virtualenv uvnitř repozitáře, aby nedošlo náhodnému komitnutí).
Pro využívání virtuálního prostředí je nutné ho aktivovat:
$ . flexipy-env/bin/activate
Pro deaktivaci zadejte:
$ deactivate
(V jakékoliv složce)
Note
Toto se liší pokud jste na Windows, viz virtualenv documentation.
Běžte do repozitáře, které jste si stáhli(git clone) v prvním kroku (s virtualenv aktivovanám, pokud ho využíváte):
$ cd flexipy
Nainstalujte balíčky potřebné pro projekt:
$ python setup.py develop
A nainstalujte další závislosti(tyto závislosti nejsou nutné pro používání knihovny ale jsou určeny pro vývoj a testování a dokumentaci):
$ paver install_dependencies
Ve složce flexipy se nachazi soubor flexipy.conf. Tento soubor slouží jako ukázkový a zároveň defaultní konfigurační soubor(pokud nespecifikujete jinak načte se tento soubor), tento soubor si skopírujte a vytvořte podle něj svůj vlastní konfigurační soubor dle svých potřeb. Konfigurační soubor se dá upravit buď textovým editorem(je ve stadartním formátu ini), nebo lze interaktivně upravit pomocí metod, které nabízí třída ConfigParser. Více se dočtete v Nastavení konfiguračního souboru flexipy. Především je nutné nastavit proměnné host, firma, username a password, díky tomu bude knihovna schopn komunikovat s Vaším Flexibee serverem.
Tento projekt používá knihovnu pytest pro testování, testy spustíte příkazem:
$ paver test