Refactor: relocate assets from mbed to FileSystem

Co-authored-by: mirkoCrobu <mirkocrobu@NB-0531.localdomain>
Co-authored-by: Alessio Perugini <alessio@perugini.xyz>

Author: 3 people

.gitignore

@@ -34,4 +34,4 @@ build/
 /arduino-app-cli
 /apps
 # temporary staging directories
-/debian/arduino-app-cli/home/
+/debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/examples

cmd/arduino-app-cli/app/start.go

@@ -44,6 +44,7 @@ func startHandler(ctx context.Context, cfg config.Configuration, app app.Arduino
 		servicelocator.GetBricksIndex(),
 		app,
 		cfg,
+		servicelocator.GetStaticStore(),
 	)
 	for message := range stream {
 		switch message.GetType() {

cmd/arduino-app-cli/daemon/daemon.go

@@ -55,6 +55,7 @@ func NewDaemonCmd(cfg config.Configuration, version string) *cobra.Command {
 					servicelocator.GetBricksIndex(),
 					servicelocator.GetAppIDProvider(),
 					cfg,
+					servicelocator.GetStaticStore(),
 				)
 				if err != nil {
 					slog.Error("Failed to start default app", slog.String("error", err.Error()))

cmd/arduino-app-cli/internal/servicelocator/servicelocator.go

@@ -35,39 +35,18 @@ var (
 	runnerVersion = "0.1.16"
 
 	GetBricksIndex = sync.OnceValue(func() *bricksindex.BricksIndex {
-		var bIndex *bricksindex.BricksIndex
-		if GetProvisioner().IsUsingDynamicProvision() {
-			dynamicProvisionDir := GetProvisioner().DynamicProvisionDir()
-			bIndex = f.Must(bricksindex.GenerateBricksIndexFromFile(dynamicProvisionDir))
-		} else {
-			bricksIndexContent := f.Must(GetStaticStore().GetBricksListFile())
-			defer bricksIndexContent.Close()
-			bIndex = f.Must(bricksindex.LoadBricksIndex(bricksIndexContent))
-		}
-		return bIndex
+		return f.Must(bricksindex.GenerateBricksIndexFromFile(GetStaticStore().GetAssetsFolder()))
 	})
 
 	GetModelsIndex = sync.OnceValue(func() *modelsindex.ModelsIndex {
-		var mIndex *modelsindex.ModelsIndex
-		if GetProvisioner().IsUsingDynamicProvision() {
-			dynamicProvisionDir := GetProvisioner().DynamicProvisionDir()
-			mIndex = f.Must(modelsindex.GenerateModelsIndexFromFile(dynamicProvisionDir))
-		} else {
-			modelsIndexContent := f.Must(GetStaticStore().GetModelsListFile())
-			defer modelsIndexContent.Close()
-			mIndex = f.Must(modelsindex.LoadModelsIndex(modelsIndexContent))
-		}
-		return mIndex
+		return f.Must(modelsindex.GenerateModelsIndexFromFile(GetStaticStore().GetAssetsFolder()))
 	})
 
 	GetProvisioner = sync.OnceValue(func() *orchestrator.Provision {
-		pythonImage, usedPythonImageTag := getPythonImageAndTag()
-		slog.Debug("Using pythonImage", slog.String("image", pythonImage))
-
+		pythonImage, _ := getPythonImageAndTag()
 		return f.Must(orchestrator.NewProvision(
 			GetDockerClient(),
-			GetStaticStore(),
-			usedPythonImageTag != runnerVersion,
+			shouldUseDynamicProvisioning(),
 			pythonImage,
 		))
 	})
@@ -102,7 +81,13 @@ var (
 	})
 
 	GetStaticStore = sync.OnceValue(func() *store.StaticStore {
-		return store.NewStaticStore(runnerVersion)
+		var baseDir string
+		if GetProvisioner().IsUsingDynamicProvision() {
+			baseDir = GetProvisioner().DynamicProvisionDir().String()
+		} else {
+			baseDir = globalConfig.AssetsDir().Join(runnerVersion).String()
+		}
+		return store.NewStaticStore(baseDir)
 	})
 
 	GetBrickService = sync.OnceValue(func() *bricks.Service {
@@ -136,3 +121,9 @@ func getPythonImageAndTag() (string, string) {
 	}
 	return pythonImage, usedPythonImageTag
 }
+
+func shouldUseDynamicProvisioning() bool {
+	pythonImage, usedPythonImageTag := getPythonImageAndTag()
+	slog.Debug("Using pythonImage", slog.String("image", pythonImage))
+	return usedPythonImageTag != runnerVersion
+}

debian/arduino-app-cli/DEBIAN/postinst

@@ -1,5 +1,6 @@
 #!/bin/sh
 
-chown -R arduino:arduino /home/arduino/.config/arduino-app-cli/examples
+chown -R arduino:arduino /home/arduino/.config/arduino-app-cli
+chown -R arduino:arduino /home/arduino/.local/share/arduino-app-cli
 
 systemctl enable arduino-app-cli

debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.1.16/api-docs/arduino/app_bricks/air_quality_monitoring/API.md

@@ -0,0 +1,192 @@
+# air_quality_monitoring API Reference
+
+## Index
+
+- Class `AQILevel`
+- Class `AirQualityData`
+- Class `AirQualityMonitoring`
+- Class `AirQualityLookupError`
+
+---
+
+## `AQILevel` dataclass
+
+```python
+class AQILevel()
+```
+
+Data class to represent AQI levels.
+
+### Attributes
+
+- **min_value** (*int*): Minimum AQI value for the level.
+- **max_value** (*int*): Maximum AQI value for the level.
+- **description** (*str*): Description of the AQI level.
+- **color** (*str*): Color associated with the AQI level in hex.
+
+
+---
+
+## `AirQualityData` dataclass
+
+```python
+class AirQualityData()
+```
+
+Data class to represent air quality data.
+
+### Attributes
+
+- **city** (*str*): Name of the city.
+- **lat** (*float*): Latitude of the city.
+- **lon** (*float*): Longitude of the city.
+- **url** (*str*): URL for more information about the air quality data.
+- **last_update** (*str*): Last update timestamp of the air quality data.
+- **aqi** (*int*): Air Quality Index value.
+- **dominantpol** (*str*): Dominant pollutant in the air.
+- **iaqi** (*dict*): Individual AQI values for various pollutants.
+
+### Methods
+
+#### `AirQualityData.pandas_dict()`
+
+Return the data as a dictionary suitable for pandas DataFrame.
+
+
+---
+
+## `AirQualityMonitoring` class
+
+```python
+class AirQualityMonitoring(token: str)
+```
+
+Class to get air quality data from AQICN API.
+
+### Parameters
+
+- **token** (*str*): API token for AQICN service.
+
+### Raises
+
+- **ValueError**: If the token is not provided.
+
+### Methods
+
+#### `AirQualityMonitoring.get_air_quality_by_city(city: str)`
+
+Get air quality data by city name.
+
+##### Parameters
+
+- **city** (*str*): Name of the city.
+
+##### Returns
+
+- (*AirQualityData*): Air quality assembled data.
+
+##### Raises
+
+- **AirQualityLookupError**: If the API request fails.
+
+#### `AirQualityMonitoring.get_air_quality_by_coords(latitude: float, longitude: float)`
+
+Get air quality data by coordinates.
+
+##### Parameters
+
+- **latitude** (*float*): Latitude.
+- **longitude** (*float*): Longitude.
+
+##### Returns
+
+- (*AirQualityData*): Air quality assembled data.
+
+##### Raises
+
+- **AirQualityLookupError**: If the API request fails.
+
+#### `AirQualityMonitoring.get_air_quality_by_ip()`
+
+Get air quality data by IP address.
+
+##### Returns
+
+- (*AirQualityData*): Air quality assembled data.
+
+##### Raises
+
+- **AirQualityLookupError**: If the API request fails.
+
+#### `AirQualityMonitoring.process(item: dict)`
+
+Process the input dictionary to get air quality data.
+
+##### Parameters
+
+- **item** (*dict*): Input dictionary containing either 'city', 'latitude' and 'longitude', or 'ip'.
+
+##### Returns
+
+- (*dict*): Air quality data.
+
+##### Raises
+
+- **ValueError**: If the input dictionary is not valid.
+
+#### `AirQualityMonitoring.assemble_data(data: dict)`
+
+Create a payload for the air quality data.
+
+##### Parameters
+
+- **data** (*dict*): Air quality data.
+
+##### Returns
+
+- (*dict*): Payload with relevant air quality information.
+
+#### `AirQualityMonitoring.map_aqi_level(aqi: int)`
+
+Returns AQILevel class matching provided AQI.
+
+
+---
+
+## `AirQualityLookupError` class
+
+```python
+class AirQualityLookupError(message: str, status: str)
+```
+
+Custom exception for air quality lookup errors.
+
+### Parameters
+
+- **message** (*str*): Error message.
+- **status** (*str*): Status of the error, defaults to None.
+
+### Methods
+
+#### `AirQualityLookupError.from_api_response(cls, data: dict)`
+
+AirQualityLookupError error handling based on response provided by AQI API.
+
+Documented errors:
+- {"status": "error", "data": "Invalid key"}
+- {"status": "error", "data": "Unknown station"}
+- {"status": "error", "data": "Over quota"}
+- {"status": "error", "data": "Invalid query"}
+- {"status": "error", "data": "Too Many Requests"}
+- {"status": "error", "data": "IP not allowed"}
+- {"status": "error", "data": "Unknown error"}
+- {"status": "error", "data": {"message": "..."}}
+
+##### Parameters
+
+- **data** (*dict*): Response data from the AQI API.
+
+##### Returns
+
+- (*AirQualityLookupError*): An instance of AirQualityLookupError with the error message and status.
+

debian/arduino-app-cli/home/arduino/.local/share/arduino-app-cli/assets/0.1.16/api-docs/arduino/app_bricks/audio_classifier/API.md

@@ -0,0 +1,73 @@
+# audio_classifier API Reference
+
+## Index
+
+- Class `AudioClassifierException`
+- Class `AudioClassifier`
+
+---
+
+## `AudioClassifierException` class
+
+```python
+class AudioClassifierException()
+```
+
+Custom exception for AudioClassifier errors.
+
+
+---
+
+## `AudioClassifier` class
+
+```python
+class AudioClassifier(mic: Microphone, confidence: float)
+```
+
+AudioClassifier module for detecting sounds and classifying audio using a specified model.
+
+### Parameters
+
+- **mic** (*Microphone*): Microphone instance for audio input. If None, a default Microphone will be initialized.
+- **confidence** (*float*): Confidence level for detection. Default is 0.8 (80%).
+
+### Raises
+
+- **ValueError**: If the model information cannot be retrieved or if the model parameters are incomplete.
+
+### Methods
+
+#### `AudioClassifier.on_detect(class_name: str, callback: Callable[[], None])`
+
+Register a callback function to be invoked when a specific class is detected.
+
+##### Parameters
+
+- **class_name** (*str*): The class to check for in the classification results.
+- **callback** (*callable*): a callback function to handle the keyword spotted.
+
+#### `AudioClassifier.start()`
+
+Start the AudioClassifier module and begin processing audio data.
+
+#### `AudioClassifier.stop()`
+
+Stop the AudioClassifier module and release resources.
+
+#### `AudioClassifier.classify_from_file(audio_path: str, confidence: int)`
+
+Classify audio from a file.
+
+##### Parameters
+
+- **audio_path** (*str*): Path to the audio file.
+- **confidence** (*int*): Confidence threshold for classification. If None, the default confidence level is used.
+
+##### Returns
+
+-: dict | None: Classification results or None if the path is invalid.
+
+##### Raises
+
+- **AudioClassifierException**: If the audio file cannot be read or processed.
+