Add: Cellbotics

Author: bjones1

runestone/activecode/js/skulpt-stdlib.js

@@ -0,0 +1,61 @@
+# .. Copyright (C) 2021 Bryan A. Jones.
+#
+# *********************************************************
+# |docname| - A Runestone extension supporting cellbotics
+# *********************************************************
+# This extension provides one new directive, ``ble-pair-button``, to add the Bluetooth Low Energy "Pair" button and status display to a page where users will be using the Cellbotics Python module and associated BLE functionality. The extension also includes all the supporting JavaScript files needed for the Cellbotics Python module.
+#
+#
+# Imports
+# =======
+# These are listed in the order prescribed by `PEP 8
+# <http://www.python.org/dev/peps/pep-0008/#imports>`_.
+#
+# Standard library
+# ----------------
+# None.
+#
+# Third-party imports
+# -------------------
+from docutils import nodes
+from docutils.parsers.rst import Directive
+
+# Local imports
+# -------------
+# None
+
+
+# Code
+# ====
+class BlePairNode(nodes.General, nodes.Element):
+    pass
+
+
+def visit_ble_pair_node(self, node):
+    self.body.append(
+        '<div data-component="ble">\n'
+        '   <script>runestone_import("ble");</script>\n'
+        '   <button id="ble_pair_button" type="button" disabled>Pair</button>\n'
+        '   <span id="ble_pair_status"></span>\n'
+        '</div>\n'
+    )
+
+
+def depart_ble_pair_node(self, node):
+    pass
+
+
+class BlePairDirective(Directive):
+    has_content = False
+    required_arguments = 0
+    optional_arguments = 0
+    option_spec = {}
+
+    def run(self):
+        return [BlePairNode()]
+
+
+def setup(app):
+    # Add the Pair button directive.
+    app.add_node(BlePairNode, html=(visit_ble_pair_node, depart_ble_pair_node))
+    app.add_directive('ble-pair-button', BlePairDirective)

runestone/activecode/js/skulpt.min.js

@@ -0,0 +1,54 @@
+// .. Copyright (C) 2012-2020 Bryan A. Jones.
+//
+//  This file is part of the CellBotics system.
+//
+//  The CellBotics system is free software: you can redistribute it and/or
+//  modify it under the terms of the GNU General Public License as
+//  published by the Free Software Foundation, either version 3 of the
+//  License, or (at your option) any later version.
+//
+//  The CellBotics system is distributed in the hope that it will be
+//  useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+//  of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+//  General Public License for more details.
+//
+//  You should have received a copy of the GNU General Public License
+//  along with the CellBotics system.  If not, see
+//  <http://www.gnu.org/licenses/>.
+//
+// *********************************************************
+// |docname| - Automatically bind methods to their instances
+// *********************************************************
+
+"use strict";
+
+
+// The following two functions were taken from https://github.com/sindresorhus/auto-bind/blob/master/index.js and lightly modified. They provide an easy way to bind all callable methods to their instance. See `Binding Methods to Class Instance Objects <https://ponyfoo.com/articles/binding-methods-to-class-instance-objects>`_ for more discussion on this crazy JavaScript necessity.
+//
+// Gets all non-builtin properties up the prototype chain
+const getAllProperties = object => {
+	const properties = new Set();
+
+	do {
+		for (const key of Reflect.ownKeys(object)) {
+			properties.add([object, key]);
+		}
+	} while ((object = Reflect.getPrototypeOf(object)) && object !== Object.prototype);
+
+	return properties;
+};
+
+
+// Invoke this in the constructor of an object.
+export function auto_bind(self) {
+    for (const [object, key] of getAllProperties(self.constructor.prototype)) {
+        if (key === 'constructor') {
+            continue;
+        }
+
+        const descriptor = Reflect.getOwnPropertyDescriptor(object, key);
+        if (descriptor && typeof descriptor.value === 'function') {
+            self[key] = self[key].bind(self);
+        }
+    }
+}