Added some handy utility scripts for guide

Author: makermelissa

Web_Workflow_Quickstart/env.py

@@ -0,0 +1,77 @@
+import storage
+import microcontroller
+import os
+
+# Get all files in the format of .env.xxxxxxxxxx
+def enumerate_env_files():
+    env_files = []
+    all_files = os.listdir("/")
+    for file in all_files:
+        if file[:4] == ".env" and len(file) > 4:
+            env_files.append(file)
+    return env_files
+
+# Compare .env to enumerated env files
+def get_current_env_file(env_files):
+    with open('.env') as env:
+        env_lines = env.readlines()
+        for env_file in env_files:
+            with open(env_file) as f:
+                lines = f.readlines()
+                if len(env_lines) != len(lines):
+                    continue
+                file_may_match = True
+                for line_no, env_line in enumerate(env_lines):
+                    if env_line != lines[line_no]:
+                        file_may_match = False
+                        break
+                if not file_may_match:
+                    continue
+                return env_file
+    return None
+
+# Erase .env then write the contents of the new env file
+def change_env_file(env_file):
+    try:
+        storage.remount("/", False)
+        open('.env', 'w').close()
+        with open('.env', 'w') as env, open(env_file) as f:
+            for line in f.readlines():
+                env.write(line)
+        env.close()
+        print("Done. Hard resetting board...")
+        microcontroller.reset()
+    except RuntimeError:
+        print("You can't change the env file with this script while USB is mounted")
+
+# Return a prettier name than the env file
+def pretty_name(env_file):
+    name = env_file[5:]
+    name = name[0].upper() + name[1:]
+    return f"{name} .env file"
+
+env_files = enumerate_env_files()
+
+if len(env_files) < 2:
+    print("You need to have at least 2 env files to change")
+
+result = get_current_env_file(env_files)
+if result:
+    env_files.remove(result)
+print("WARNING: This will overwrite all of your current .env file settings.")
+if len(env_files) == 1:
+    answer = input(f"Change to {pretty_name(env_files[0])}? ")
+    answer = answer.lower()
+    if answer == "y" or answer == "yes":
+        change_env_file(env_files[0])
+else:
+    valid_selection = False
+    while not valid_selection:
+        print("Select an option:")
+        for index, file in enumerate(env_files):
+            print(f"{index + 1}: {pretty_name(file)}")
+        answer = input(f"Which option would you like? ")
+        if answer.isdigit() and 0 < int(answer) <= len(env_files):
+            valid_selection = True
+            change_env_file(env_files[int(answer) - 1])
+        print(f"{answer} was an invalid selection.\n")

Web_Workflow_Quickstart/usb/check.py

@@ -0,0 +1,2 @@
+import microcontroller
+print(f"USB Mass Storage is {'enabled' if microcontroller.nvm[0] == 1 else 'disabled'} on this device")

Web_Workflow_Quickstart/usb/disable.py

@@ -0,0 +1,3 @@
+import microcontroller
+microcontroller.nvm[0] = 0
+microcontroller.reset()

Web_Workflow_Quickstart/usb/enable.py

@@ -0,0 +1,3 @@
+import microcontroller
+microcontroller.nvm[0] = 1
+microcontroller.reset()