Lib management (#139)

Initial tests passed.
Deploy to prod.
Other features should be barely affected

Author: urfdvw

README.md

@@ -11,6 +11,7 @@ This IDE includes essential tools and useful features for CircuitPython microcon
 - Code editor with support for multiple tabs
 - Serial Console for communication and the Read-Evaluate-Print Loop (REPL)
 - Serial data plotter
+- Library Management
 - Project backup
 
 
@@ -61,7 +62,7 @@ REPL (Read-Evaluate-Print Loop) is a coding mode where you can interact with the
 
 ## About
 
-Version: 2.1.0
+Version: 2.2.0
 
 [CircuitPython](https://circuitpython.org/) is a version of Python that runs on microcontrollers and single-board computers. Its development is sponsored by [Adafruit](https://www.adafruit.com/).
 

__tests__/testDummy.js

@@ -1,4 +1,4 @@
-import sum from "../src/utilFunctions/dummy";
+import { sum } from "../src/utilFunctions/dummy";
 
 test("adds 1 + 2 to equal 3", () => {
     expect(sum(1, 2)).toBe(3);

dev logs/lib manage.md

@@ -0,0 +1,164 @@
+
+given a lib/libs
+- names bundle(libs) return libs that are in the bundles
+- names dep(lib) dependencies of all lib/libs
+    - treat dependency and external dependency the same
+    - only return bundle(libs) in each recursion
+
+existing libs
+- names libs_on_disk: top level names in /libs folder
+- names_w_ver libs_installed: bundle(libs_on_disk)
+    - version from installed package
+
+needed libs
+- names libs_in_code: libs that are imported in python code
+- names libs_imported: bundle(libs_in_code)
+- names_w_ver libs_needed: dep(libs_imported)
+    - versions from bundles
+
+supported actions
+- auto: reinstall all libs used in the code with dependencies
+    - remove libs_installed from MCU
+    - add libs_needed to MCU from bundle
+    - warn if libs_needed_ext not on MCU
+- manual:
+    - install/upgrade lib_selected (same)
+        - remove dep(lib_selected) if exist
+        - add dep(lib_selected) to MCU from bundle
+    - uninstall lib_selected
+        - remove lib_selected only
+            - will not go back to check unused dependencies, use auto function instead.
+        
+display
+- display all libs in both bundles
+- item
+    - name
+    - version or cur_version -> new_version
+    - bundle (Icon)
+    - instal status
+    - action buttons
+- action buttons
+    - uninstall: if in libs_installed
+    - upgrade: if in libs_installed AND version different from bundle
+    - install: if not in libs_installed
+- instal status: check mark to indicate installation
+    - green means latest version
+    - yellow means upgradable
+- sort by
+    - installation: green -> yellow -> not installed
+    - name
+    - bundle: Adafruit -> Community
+
+menu
+- refresh
+    - actually, auto refresh at the start, then refresh on demand
+- auto
+- hamburger
+    - help
+    - config
+
+config
+- clear unused libs in auto mode, boolean
+
+
+data flow
+- const repo names
+- repo names -> asset links
+    - json
+    - zip
+        - int version number
+- store into local storage
+    - json combined
+    - for each version
+        - zip combined
+- read
+    - given a name
+    - if it is a top level file, return an emulated file handle
+    - if it is a top level folder, return an emulated file handle
+    - then use copy folder util to copy to real directory
+
+work flow and exceptions
+- on load, unconditional: get resource
+    - get asset lists from git api
+        - if get failed
+    - check if resources are cached and up to date
+        - check time stamp
+            - if not exist
+                - continue
+            - if not the same as assets
+                - dialog
+                    - continue if confirm
+            - if same as assets
+                - stop get resource process
+    - get JSON and zips
+        - if get failed
+            - dialog: proxy error, upload bundle manually
+            - stop get resource process
+- unconditional: get mcu info
+    - get cpy version of the MCU
+        - if cpy version not in bundle list
+            - error, cpy version not supported
+    - get installed libs
+    - if cannot get MCU status
+        - dialog not supported
+        - stop get resource process
+        - block all features
+- on button clicked
+    - check if cpy version has data in bundle
+        - dialog manual upload
+    - get imported libs / selected ; libs
+    - get list of libs to be installed: imports + dependencies
+    - check
+        - time stamp exist (which means the resource is downloaded)
+
+prompt for lib card
+
+```
+write a jsx component with mui with template
+
+function LibCard({ lib, installedLib }) {}
+
+where lib is an object like
+
+{
+    "dependencies": [
+        "adafruit_bus_device",
+        "adafruit_register"
+    ],
+    "external_dependencies": [],
+    "package": false,
+    "path": "lib/adafruit_24lc32",
+    "pypi_name": "adafruit-circuitpython-24lc32",
+    "repo": "https://github.com/adafruit/adafruit_circuitpython_24lc32",
+    "version": "1.2.3"
+}
+
+installedLib is an object like
+
+{
+    "name": "adafruit_ina219",
+    "version": {
+        "major": 3,
+        "minor": 4,
+        "patch": 29
+    }
+}
+
+please also make use of function 
+
+export function parseVersion(versionStr) {
+    const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(versionStr.trim());
+    if (!m) {
+        return { major: null, minor: null, patch: null, raw: versionStr };
+    }
+    return {
+        major: Number(m[1]),
+        minor: Number(m[2]),
+        patch: Number(m[3]),
+    };
+}
+
+
+the object should display the info as
+TODO
+```