Import of the watch repository from Pebble

2025-05-19 09:54:55 +00:00 · 2024-12-12 16:43:03 -08:00 · 2024-12-12 16:43:03 -08:00 · 3b92768480
commit 3b92768480
10334 changed files with 2564465 additions and 0 deletions
--- a/waftools/protoc.py
+++ b/waftools/protoc.py
@ -0,0 +1,120 @@
+# encoding: utf-8
+# Copyright 2024 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Philipp Bender, 2012
+# Matt Clarkson, 2012
+
+import re
+from waflib.Task import Task
+from waflib.TaskGen import extension, after_method
+
+"""
+A simple tool to integrate protocol buffers into your build system.
+Adapted for nanopb from waftools/extras/protoc.py.
+
+Example::
+
+    def configure(conf):
+        conf.load('compiler_c c protoc')
+
+    def build(bld):
+        bld(
+                features = 'c cprogram'
+                source   = 'main.c file1.proto proto/file2.proto',
+                include  = '. proto',
+                target   = 'executable')
+
+Notes when using this tool:
+
+- protoc command line parsing is tricky.
+
+  The generated files can be put in subfolders which depend on
+  the order of the include paths.
+
+  Try to be simple when creating task generators
+  containing protoc stuff.
+
+"""
+
+class protoc(Task):
+    # protoc expects the input proto file to be an absolute path.
+    run_str = '${PROTOC} ${PROTOC_FLAGS} ${PROTOC_ST:INCPATHS} ${SRC[0].abspath()}'
+    color   = 'BLUE'
+    ext_out = ['.h', 'pb.c']
+    def scan(self):
+        """
+        Scan .proto dependencies
+        """
+        node = self.inputs[0]
+
+        nodes = []
+        names = []
+        seen = []
+
+        if not node: return (nodes, names)
+
+        def parse_node(node):
+            if node in seen:
+                return
+            seen.append(node)
+            code = node.read().splitlines()
+            for line in code:
+                m = re.search(r'^import\s+"(.*)";.*(//)?.*', line)
+                if m:
+                    dep = m.groups()[0]
+                    for incpath in self.generator.includes_nodes:
+                        found = incpath.find_resource(dep)
+                        if found:
+                            nodes.append(found)
+                            parse_node(found)
+                        else:
+                            names.append(dep)
+
+        parse_node(node)
+        return (nodes, names)
+
+@extension('.proto')
+def process_protoc(self, node):
+    c_node = node.change_ext('.pb.c')
+    h_node = node.change_ext('.pb.h')
+    self.create_task('protoc', node, [c_node, h_node])
+    self.source.append(c_node)
+
+    if 'c' in self.features and not self.env.PROTOC_FLAGS:
+        # Each piece wrapped in [] explained.
+        # ~ [--nanopb_out=]-I%s:%s
+        #   How we push arguments through protoc into nanopb_generator.py
+        # ~ --nanopb_out=[-I%s]:%s
+        #   Pass in a path where nanopb_generator should search for .options files
+        # ~ --nanopb_out=-I%s[:]%s
+        #   Separates the option args for nanopb_generator from the actual output folder
+        # ~ --nanopb_out=-I%s:[%s]
+        #   Specifies the output folder
+        self.env.PROTOC_FLAGS = '--nanopb_out=-I%s:%s' % (node.parent.abspath(),
+                                                          node.parent.get_bld().bldpath())
+
+    use = getattr(self, 'use', '')
+    if not 'PROTOBUF' in use:
+        self.use = self.to_list(use) + ['PROTOBUF']
+
+def configure(conf):
+    missing_nanopb = """
+    'nanopb' cannot be found on the system.
+
+    Follow the instructions on the wiki for installing it: https://pebbletechnology.atlassian.net/wiki/display/DEV/Getting+Started+with+Firmware
+    """
+    conf.find_program('protoc-gen-nanopb', errmsg=missing_nanopb)
+    conf.find_program('protoc', var='PROTOC', errmsg=missing_nanopb)
+    conf.env.PROTOC_ST = '-I%s'