Added cycling through apps on boot. Updated version number.

Signed-off-by: ubi de feo <me@ubidefeo.com>

Author: ubidefeo

README.md

@@ -54,14 +54,18 @@ The framework exploits the standard behaviour of MicroPython at start/reset/soft
 The framework's boot.py only requires two lines for the following operations:
 
 * import the minimum required parts of arduino_tools (common) from the board's File System (installed as a package in [flash]/lib/arduino_tools)
-* invoke the method `load_app()` to enter the default app's path and apply some temporary settings to configure the running environment (search paths and launch configuration changes) which will be reset at the next start.
+* invoke the method `load_app(app_name = None, cycle_mode = False)` to enter the default app's path and apply some temporary settings to configure the running environment (search paths and launch configuration changes) which will be reset at the next start.
 
 If no default app is set, it will fall back to the `main.py` in the board's root if present.
 No error condition will be generated, as MicroPython is capable of handling the absence of `boot.py` and/or `main.py` at C level.
 
-If a default app is set, the `load_app()` will issue an `os.chdir()` command and enter the app's folder.
+If a default app is set, the `load_app(app_name = None, cycle_mode = False)` will issue an `os.chdir()` command and enter the app's folder.
 MicroPython will automatically run the main.py it finds in its Current Working Directory.
 
+`cycle_mode`: when this parameter is `True`, the loader will pop first item from the `boot.cfg` file and append it to the end.
+This could be useful if you have a board in demo mode (needing to display  multiple applications) or need to run applications in a sequence for RAM or features constraints.
+You could think of a board that needs to connect to Internet to download data, but would not be able to process the data with the RAM available. 
+
 **NOTES:**
 
 * each app can contain a `.hidden` file that will hide the app from AMP, effectively preventing listing or deletion.

arduino_tools/constants.py

@@ -6,4 +6,4 @@
 APP_FRIENDLY_NAME_FILE = '.friendly_name'
 APP_HIDDEN_FILE = '.hidden'
 APPS_FRAMEWORK_NAME = 'Arduino Apps'
-TOOLS_VERSION = '0.7.0'
+TOOLS_VERSION = '0.9.0'

arduino_tools/loader.py

@@ -12,34 +12,37 @@
 
 default_path = sys.path.copy()
 
-def load_app(app_name = None):
-  if app_name == None:
-    return enter_default_app()
+def load_app(app_name = None, cycle_mode = False):
+  if app_name == None or cycle_mode:
+    return enter_default_app(cycle_mode = cycle_mode)
   return enter_app(app_name)
 
-def enter_default_app():
+def enter_default_app(cycle_mode = False):
   if restore_available and restore_target():
     enter_app(restore_target())
     return None
 
   if fs_item_exists(APPS_ROOT + BOOT_CONFIG_FILE):
     boot_entries = []
     with open(APPS_ROOT + BOOT_CONFIG_FILE, 'r') as a_cfg:
-      boot_entries = a_cfg.readlines()
+      boot_entries = [entry.strip() for entry in a_cfg]
 
     if len(boot_entries) > 1:
       default_p = boot_entries.pop(0)
     elif len(boot_entries) == 1:
       default_p = boot_entries[0]
     else:
       default_p = ''
-    default_p = default_p.strip()
+    # default_p = default_p.strip()
     if default_p == '':
       return None
     if len(boot_entries) > 0:
+      if cycle_mode:
+        boot_entries.append(default_p)
       with open(APPS_ROOT + BOOT_CONFIG_FILE, 'w') as a_cfg:
-        for entry in boot_entries:
-          a_cfg.write(entry)
+        for i, entry in enumerate(boot_entries):
+          new_line = '\n' if i < len(boot_entries) - 1 else ''
+          a_cfg.write(entry + new_line)
     return enter_app(default_p)
   return None
 

arduino_tools/templates/main.tpl

@@ -6,4 +6,4 @@ from arduino_tools.app import *
 my_app = App('{app_name}')
 
 # Write your code below (no #) and have fun :)
-print("Hello, I am an app and my name is {app_friendly_name}")
+print("Hello, I am an App and my name is {app_friendly_name}")

package.json

@@ -2,67 +2,67 @@
   "urls": [
     [
       "arduino_tools/__init__.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/__init__.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/__init__.py"
     ],
     [
       "arduino_tools/app.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/app.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/app.py"
     ],
     [
       "arduino_tools/apps_manager.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/apps_manager.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/apps_manager.py"
     ],
     [
       "arduino_tools/common.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/common.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/common.py"
     ],
     [
       "arduino_tools/constants.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/constants.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/constants.py"
     ],
     [
       "arduino_tools/files.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/files.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/files.py"
     ],
     [
       "arduino_tools/help.txt",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/help.txt"
+      "github:arduino/arduino-tools-mpy/arduino_tools/help.txt"
     ],
     [
       "arduino_tools/helpers.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/helpers.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/helpers.py"
     ],
     [
       "arduino_tools/loader.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/loader.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/loader.py"
     ],
     [
       "arduino_tools/properties.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/properties.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/properties.py"
     ],
     [
       "arduino_tools/updater.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/updater.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/updater.py"
     ],
     [
       "arduino_tools/wifi_utils.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/wifi_utils.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/wifi_utils.py"
     ],
     [
       "arduino_tools/utils/semver.py",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/utils/semver.py"
+      "github:arduino/arduino-tools-mpy/arduino_tools/utils/semver.py"
     ],
     [
       "arduino_tools/templates/main.tpl",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/templates/main.tpl"
+      "github:arduino/arduino-tools-mpy/arduino_tools/templates/main.tpl"
     ],
     [
       "arduino_tools/templates/boot_apps.tpl",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/templates/boot_apps.tpl"
+      "github:arduino/arduino-tools-mpy/arduino_tools/templates/boot_apps.tpl"
     ],
     [
       "arduino_tools/templates/boot_plain.tpl",
-      "github:arduino/arduino/arduino-tools-mpy/arduino_tools/templates/boot_plain.tpl"
+      "github:arduino/arduino-tools-mpy/arduino_tools/templates/boot_plain.tpl"
     ],
   ],
   "deps": [
@@ -75,5 +75,5 @@
       "latest"
     ]
   ],
-  "version": "0.8.0"
+  "version": "0.9.0"
 }