From 8faac3d86c7615ac0dd829b3660d2b99b69cb1d2 Mon Sep 17 00:00:00 2001 From: Sebastian Lobinger <sebastian.lobinger@fu-berlin.de> Date: Tue, 6 Jun 2017 08:51:30 +0200 Subject: [PATCH] update documentation for samsHub in README.md #16 --- README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/README.md b/README.md index b27944e..68f3194 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,64 @@ sich das gesamte Wissen über Flask und alle möglichkeiten von Flask auch auf d vom SAMSHub bereitgestellte flaskApp anwenden. Der SAMSHub erledigt lediglich einige Aufgaben die so bei allen Zukünftigen Anwendungen anfallen werden. +#### Methoden + +##### Konstruktor + +```python +hub = SAMSHub(name=__name__, config = {'default_language': 'de'}) +``` +Pflichtparameter sind name und config. Das Konfigurationsdictionary muss +eine angabe tur 'default_language' beinhalten. + +##### addApp + +```python +hub.addApp(app=samsApp) +``` +Die Methode fügt dem hub eine SAMSApp hinzu. Es muss sich bei app um eine +Instanz von SAMSApp handeln. Der Name der app (app.name) wird als name für +die Ansprache mit hub.app(name) verwendet. + +##### app + +```python +samsApp = hub.app(name) +``` +Die Methode gibt die SAMSApp mit dem betreffenden Namen zurück. + +##### menu + +```python +menu = hub.menu(langCode = 'de') +``` +Gibt eine Liste mit allen Menüeinträgen aller hinzugefügter Apps in der +geforderten Sprache zurück. Falls die sprache bei einigen Einträgen +nicht verfügbar ist wird die default Sprache der App verwendet. +Die Reihenfolge der Einträge wird durch die reihenfolge, in der die Apps +hinzugefügt wurden, bestimmt. + +#### Eigenschaften + +##### appKeys + +```python +for key in hub.appKeys: + print(key + '\n') +``` +Die Methode gibt eine Liste der keys aller dem hub hinzugefügten apps aus. +Über einen Key lässt sich mit ```hub.app(key)``` die jeweilige app Instanz +zurückgeben. + +##### flaskApp + +```python +hub.flaskApp.run() +``` +Mit flaskApp lässt sich die vom hub erzeugte flask App zurückgeben und z.B. +dann über run starten. Für die flask App kann die flask Dokumentation zu Rate +gezogen werden. + ### SAMSApp **TODO** -- GitLab