Add sample component for SparkFun LED Stick (#99)

* Added sample implementation for SparkFun LED Stick.

* Add md file to show the blocks for the SparkFun LED Stick.

* Added toolbox for SparkFun LED Stick.

Fixed toolbox for Rev Touch Sensor (from Alan).

* Fixed typos.

* Specify the type of the color arguments.

* Added support for calling component methods to the mrc_call_python_function block.
Handle case where a component name collides with a variable name.
Added getComponentNames method to the editor class so the mrc_call_python_function blocks can populate the component name dropdown fields.
Added robot parameter to OpMode init method.
Modified mrc_class_method_def so it generates the call to super().__init__() for __init__ methods.
Save the component names and types in the files.
Added blocks to component_samples_category.ts.

* Show the component name in the instance method call tooltip.

* Pass robot to OpMode.__init__.

* Removed wpilib from the component names shown in the tooltips.

* Where component methods are called, generate self.robot.<component name> instead of self.<component name>
Don't generate self.<component name> = robot.<component name> in the __init__ methods.

* Put toolbox categories in alphabetical order.
Show manufacturer name on toolbox categories.

* Updated md file.

* more edits

* Changed tooltip to use the word method instead of function.

* Specify widths of images.

* Set image widths to 50%.

* More f'ing around with image sizes.

* Renamed file to index.md.

Author: lizlooney

external_samples/docs/BlockWithComponentDropdown.png

@@ -0,0 +1,33 @@
+# Component Blocks
+
+## Block Details
+
+### Dropdown shows components of the specific type.
+
+<img src="BlockWithComponentDropdown.png" width="291">
+
+### Tooltip shows that the block calls a method on a component, followed by details about what that method does.
+
+<img src="BlockWithTooltip.png" width="342">
+
+## Component Toolbox Categories
+
+### REV ColorRangeSensor
+
+<img src="REV_ColorRangeSensor.png" width="531">
+
+### REV Servo
+
+<img src="REV_Servo.png" width="581">
+
+### REV SmartMotor
+
+<img src="REV_SmartMotor.png" width="622">
+
+### REV TouchSensor
+
+<img src="REV_TouchSensor.png" width="492">
+
+### SparkFun LEDStick
+
+<img src="SparkFun_LEDStick.png" width="666">

external_samples/docs/BlockWithTooltip.png

@@ -0,0 +1,65 @@
+from component import Component, PortType, InvalidPortException
+from enum import Enum
+import wpilib
+
+class SparkFunLEDStick(Component):    
+    def __init__(self, ports : list[tuple[PortType, int]]):
+        portType, port = ports[0]
+        if portType != PortType.I2C_PORT:
+            raise InvalidPortException
+        self.port = port
+
+    # Component methods
+
+    def get_manufacturer(self) -> str:   
+        return "SparkFun" 
+
+    def get_name(self) -> str:  
+        return "SparkFun Qwiic LED Strip"
+
+    def get_part_number(self) -> str:  
+        return "COM-18354"
+
+    def get_url(self) -> str:  
+        return "https://www.sparkfun.com/sparkfun-qwiic-led-stick-apa102c.html"
+
+    def get_version(self) -> tuple[int, int, str]: 
+        return (1, 0, "")
+
+    def stop(self) -> None:
+        self.turn_all_off()
+
+    def reset(self) -> None:
+        pass
+
+    def get_connection_port_type(self) -> list[PortType]:
+        return [PortType.I2C_PORT]
+
+    def periodic(self) -> None:
+        pass
+
+    # SparkFunLEDStick methods
+
+    def set_color(self, position: int, color: wpilib.Color) -> None:
+        '''Change the color of an individual LED.'''
+        pass # TODO: implement
+
+    def set_color(self, color: wpilib.Color) -> None:
+        '''Change the color of all LEDs to a single color.'''
+        pass # TODO: implement
+
+    def set_colors(self, colors: list[int]) -> None:
+        '''Change the color of all LEDs using a list.'''
+        pass # TODO: implement
+
+    def set_brightness(self, position: int, brightness: int) -> None:
+        '''Set the brightness of an individual LED.'''
+        pass # TODO: implement
+
+    def set_brightness(self, brightness: int) -> None:
+        '''Set the brightness of all LEDs.'''
+        pass # TODO: implement
+
+    def turn_all_off(self) -> None:
+        '''Turn all LEDs off.'''
+        pass # TODO: implement

external_samples/docs/REV_ColorRangeSensor.png

@@ -24,11 +24,13 @@ import * as Blockly from 'blockly';
 import { Order } from 'blockly/python';
 
 import * as pythonUtils from './utils/generated/python';
+import { createFieldDropdown } from '../fields/FieldDropdown';
 import { createFieldNonEditableText } from '../fields/FieldNonEditableText';
 import { getAllowedTypesForSetCheck, getOutputCheck } from './utils/python';
 import { ExtendedPythonGenerator } from '../editor/extended_python_generator';
 import { MRC_STYLE_FUNCTIONS } from '../themes/styles'
 import { ClassMethodDefExtraState } from './mrc_class_method_def'
+import { Editor } from '../editor/editor';
 
 // A block to call a python function.
 
@@ -40,10 +42,13 @@ enum FunctionKind {
   CONSTRUCTOR = 'constructor',
   INSTANCE = 'instance',
   INSTANCE_WITHIN = 'instance_within',
+  INSTANCE_COMPONENT = 'instance_component'
 }
 
 const RETURN_TYPE_NONE = 'None';
 
+const FIELD_COMPONENT_NAME = 'COMPONENT_NAME';
+
 export type FunctionArg = {
   name: string,
   type: string,
@@ -58,6 +63,8 @@ interface CallPythonFunctionMixin extends CallPythonFunctionMixinType {
   mrcImportModule: string,
   mrcActualFunctionName: string,
   mrcExportedFunction: boolean,
+  mrcComponentClassName: string,
+  mrcComponentName: string, // Do not access directly. Call getComponentName.
   renameMethod(this: CallPythonFunctionBlock, newName: string): void;
   mutateMethod(this: CallPythonFunctionBlock, defBlockExtraState: ClassMethodDefExtraState): void;
 }
@@ -99,6 +106,14 @@ type CallPythonFunctionExtraState = {
    * user's Project).
    */
   exportedFunction: boolean,
+  /**
+   * The component name. Specified only if the function kind is INSTANCE_COMPONENT.
+   */
+  componentName?: string,
+  /**
+   * The component class name. Specified only if the function kind is INSTANCE_COMPONENT.
+   */
+  componentClassName?: string,
 };
 
 const CALL_PYTHON_FUNCTION = {
@@ -138,6 +153,13 @@ const CALL_PYTHON_FUNCTION = {
           tooltip = 'Calls the method ' + functionName + '.';
           break;
         }
+        case FunctionKind.INSTANCE_COMPONENT: {
+          const className = this.mrcComponentClassName;
+          const functionName = this.getFieldValue(pythonUtils.FIELD_FUNCTION_NAME);
+          tooltip = 'Calls the method ' + className + '.' + functionName +
+              ' on the component named ' + this.getComponentName() + '.';
+          break;
+        }
         default:
           throw new Error('mrcFunctionKind has unexpected value: ' + this.mrcFunctionKind)
       }
@@ -174,6 +196,12 @@ const CALL_PYTHON_FUNCTION = {
     if (this.mrcActualFunctionName) {
       extraState.actualFunctionName = this.mrcActualFunctionName;
     }
+    if (this.mrcComponentClassName) {
+      extraState.componentClassName = this.mrcComponentClassName;
+    }
+    if (this.getField(FIELD_COMPONENT_NAME)) {
+      extraState.componentName = this.getComponentName();
+    }
     return extraState;
   },
   /**
@@ -199,6 +227,10 @@ const CALL_PYTHON_FUNCTION = {
         ? extraState.actualFunctionName : '';
     this.mrcExportedFunction = extraState.exportedFunction
         ? extraState.exportedFunction : false;
+    this.mrcComponentClassName = extraState.componentClassName
+        ? extraState.componentClassName : '';
+    this.mrcComponentName = extraState.componentName
+        ? extraState.componentName : '';
     this.updateBlock_();
   },
   /**
@@ -260,6 +292,19 @@ const CALL_PYTHON_FUNCTION = {
           }
           break;
         }
+        case FunctionKind.INSTANCE_COMPONENT: {
+          const componentNames = Editor.getComponentNames(this.workspace, this.mrcComponentClassName);
+          const componentName = this.getComponentName();
+          if (!componentNames.includes(componentName)) {
+            componentNames.push(componentName);
+          }
+          this.appendDummyInput('TITLE')
+              .appendField('call')
+              .appendField(createFieldDropdown(componentNames), FIELD_COMPONENT_NAME)
+              .appendField('.')
+              .appendField(createFieldNonEditableText(''), pythonUtils.FIELD_FUNCTION_NAME);
+          break;
+        }
         default:
           throw new Error('mrcFunctionKind has unexpected value: ' + this.mrcFunctionKind)
       }
@@ -293,6 +338,15 @@ const CALL_PYTHON_FUNCTION = {
       this.removeInput('ARG' + i);
     }
   },
+  getComponentName(this: CallPythonFunctionBlock): string {
+    // If the COMPONENT_NAME field has been created, get the field value, which the user may have changed.
+    // If the COMPONENT_NAME field has not been created, get the component name from this.mrcComponentName.
+    return (this.getField(FIELD_COMPONENT_NAME))
+      ? this.getFieldValue(FIELD_COMPONENT_NAME) : this.mrcComponentName;
+  },
+  getComponentClassName(this: CallPythonFunctionBlock): string {
+    return this.mrcComponentClassName;
+  },
   renameMethod: function(this: CallPythonFunctionBlock, newName: string): void {
     this.setFieldValue(newName, pythonUtils.FIELD_FUNCTION_NAME);
   },
@@ -365,6 +419,14 @@ export const pythonFromBlock = function(
       code = 'self.' + functionName;
       break;
     }
+    case FunctionKind.INSTANCE_COMPONENT: {
+      const componentName = callPythonFunctionBlock.getComponentName();
+      const functionName = callPythonFunctionBlock.mrcActualFunctionName
+          ? callPythonFunctionBlock.mrcActualFunctionName
+          : block.getFieldValue(pythonUtils.FIELD_FUNCTION_NAME);
+      code = 'self.robot.' + componentName + '.' + functionName;
+      break;
+    }
     default:
       throw new Error('mrcFunctionKind has unexpected value: ' + callPythonFunctionBlock.mrcFunctionKind)
   }