fbuild 1.1.0__py3-none-any.whl

fbuild-1.1.0.dist-info/RECORD

@@ -0,0 +1,93 @@
+fbuild/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fbuild/cli.py,sha256=U74ITXQv2fCTU8FcARWEbuQ00DhOVxOgcuZNadJXKEg,17728
+fbuild/cli_utils.py,sha256=yi2UJidfsBWmcBwv6IS_FcXA5810jnmDN23lVJi7OvY,9929
+fbuild/interrupt_utils.py,sha256=JuEAgImyF17ZP03ijCTRCXcxcTPt6eLZUmzqueyOEOQ,1026
+fbuild/assets/example.txt,sha256=lTBovRjiz0_TgtAtbA1C5hNi2ffbqnNPqkKg6UiKCT8,54
+fbuild/build/__init__.py,sha256=NS6A-b-yPCVcjbE0Elkx3_Qf-_O6sdk_aXumSheYjOA,2871
+fbuild/build/archive_creator.py,sha256=L5ZMLK44jZFhROOsyQdk-8nBKbDqDDRAxlM9gbplK7Y,6919
+fbuild/build/binary_generator.py,sha256=wDGtcPuQlKfMuxjJZdZqRdqQCbg9cAao4zaXKi3qArg,16042
+fbuild/build/build_component_factory.py,sha256=bUfGNOVrO823TdGpEjNPpPrsM3ZXvvgwGVODLUbCZ28,4237
+fbuild/build/build_state.py,sha256=MtnCof6nOtKyAqW8OFWuMK7GXOIwmG1TeBJtXiRq18Y,11168
+fbuild/build/build_utils.py,sha256=RJH76Lcintpl_7QkPG70cl6JPFJ-mOWnyskj73YC0Fc,2958
+fbuild/build/compilation_executor.py,sha256=pzLeavweXkvaliLQEpwxjYvw1WMZcRzxdOJIX0kfezs,15748
+fbuild/build/compiler.py,sha256=YMUUonS6eGbOPgf0Vo9BaG7ms3Kts2PalgCUhoIjCbY,4181
+fbuild/build/compiler_avr.py,sha256=9KG2IfWEK9VGHbsWe2Y36rcFAkq1dMXo5PX5TPKI3D4,17604
+fbuild/build/configurable_compiler.py,sha256=qeGEft8a3mVs5Cl5gmwhBfh8hQPfIu9qQnfWvbG2udA,21531
+fbuild/build/configurable_linker.py,sha256=tK6jHEojVOz7zqiBOa-jQZCC730LgjeRZrGtLiWxwxM,24141
+fbuild/build/flag_builder.py,sha256=-_oqrYem--DW2EL0UhRzhrxpKr4r3hiamvwFEqLra-0,6070
+fbuild/build/library_dependency_processor.py,sha256=EoyOZJX4lVYCasXL6S5g3q86jlMlR9zyf-xfCu5vUyE,5860
+fbuild/build/linker.py,sha256=4ooKcSqQDn96KLxHAiWNbR0vuhDnDOXFFEKqp5x9UJE,23831
+fbuild/build/orchestrator.py,sha256=KvKfyJw-SZR_X7c-iE-hLj4KvFkO-VXkwDG0VeNyoms,1792
+fbuild/build/orchestrator_avr.py,sha256=IQrzzrFn0aUnJ2xQmUi5dJdhq0HEMrviZIHdZvlII6s,24006
+fbuild/build/orchestrator_esp32.py,sha256=AbL6jwkUEYCMB84tZGgSEzRUkyOKkGm8aGERmbXrKGk,27580
+fbuild/build/orchestrator_teensy.py,sha256=q3G50svOvAufJHFaqboCnVd9qMN-O3V6v1H42ReTMzQ,18451
+fbuild/build/source_compilation_orchestrator.py,sha256=MPg21vjcHa2NVvTNta08ZsXDIhEKfeoKrRCo4SUBiVw,7009
+fbuild/build/source_scanner.py,sha256=sypaXJ7epC6APRosKG8xtTXGV-ngK2_3PdLCg-pnS4c,17422
+fbuild/config/__init__.py,sha256=3QSJUBVhJabUl2g8dglAp58U8nH5fh2gHZWIoIxIl8g,403
+fbuild/config/board_config.py,sha256=rDSTmUDKlxpPUMbxuN5oPuYK5o9XFNibh_48Mobkkx4,14090
+fbuild/config/board_loader.py,sha256=X64LJSISfP2pDx9FrNG5tkXqQ2wDfnp5WxHmpkfLXIk,3528
+fbuild/config/ini_parser.py,sha256=Ab783_LzZkGA3HFYM5vb0DEvdW2dvfDIYUUhuc_6qmo,6608
+fbuild/config/mcu_specs.py,sha256=GZYl_86ykdYvuj5oLUoD5zN7hOUnhh7dK4X3q5AFk-E,2145
+fbuild/daemon/__init__.py,sha256=pEwvWKbyueRxb51q4PskH7Li0Qg_CqYA4krYvPkJOlQ,722
+fbuild/daemon/client.py,sha256=vB5i51vujSPYzXaowDy95ehQqC7z-TRMpukilB2InuE,30014
+fbuild/daemon/compilation_queue.py,sha256=l7LUBy81l_OhxocA0TDJVPT4FyU0dkbLwEEvFRGIaIo,10405
+fbuild/daemon/daemon.py,sha256=KDKXuwRtQVGbjBpmJeWM-qDh2kUV2ujSXBharoOPc4c,17290
+fbuild/daemon/daemon_context.py,sha256=yFfGKc4o2SSiTbeYp-BWiRjSx-UBsc5NpqPetDZ5tdI,7131
+fbuild/daemon/error_collector.py,sha256=pKO1PYw7zsMJgZLS_lXOY4mYTfywR92tlzTpwngLIG4,9223
+fbuild/daemon/file_cache.py,sha256=PSzrgf8aR5OHtv74Yif2oxiSdJGoktW4Rv7256ZEQ2Q,11116
+fbuild/daemon/lock_manager.py,sha256=YekUO-7YhwG_A8r2Q87FpvTWoGL-1x1js_XUEjAfzXs,10727
+fbuild/daemon/logging_utils.py,sha256=0lshNSYoqFxgm8vJdfF3bv_YGw3xvQ7uKHxy3jq0lZ4,5233
+fbuild/daemon/messages.py,sha256=zrGGNp8kQhPRdAhc9nm0zvqNiLUJcAKgERm55jcySJQ,11093
+fbuild/daemon/operation_registry.py,sha256=pg_HCrG4vriebeFNB4Nq5WP_3hdO7-nweVMLQJu-dlw,11617
+fbuild/daemon/process_tracker.py,sha256=cm0sngT6AP7spNCEmE2NJmcZcnYcYEhBds6yLsE8Ze0,12536
+fbuild/daemon/request_processor.py,sha256=7FV_9SMeJS2l0PXJP3lb6SZdcVNl8PLt82wIlEGuYKQ,14916
+fbuild/daemon/status_manager.py,sha256=OMlvMjTFOBuvSImYlu6e_s3ceYKqJ5o1lLiApr6yMCk,7883
+fbuild/daemon/subprocess_manager.py,sha256=9LMQgK5ndSC-iCuuvmYmDpH6uE8LvKMPKGCHm4-2JVI,12557
+fbuild/daemon/processors/__init__.py,sha256=716AnzwanhBrzGiTRlhAidZaIFpal7fVo3PDcBpxIU8,518
+fbuild/daemon/processors/build_processor.py,sha256=PsdS-94auA35-6iRhxyV64-MQKBtpsUJjStGmmJ1QdE,6301
+fbuild/daemon/processors/deploy_processor.py,sha256=nl5ntc1D-3Uu7Cfj-YnTBWlyMIHJD6yk-5Xz_3tNhLk,12728
+fbuild/daemon/processors/monitor_processor.py,sha256=ywg96mUmfDHvr5tdSnR6cxtclXjaBMbKViHeHpZP8I4,5547
+fbuild/deploy/__init__.py,sha256=sXJx5ebFGaBx0b9wdafqQjvFcsW9aI7zaWsR6zkl2oY,401
+fbuild/deploy/deployer.py,sha256=WiC4hrtt-NzUAXzXd1CaSieqBOHX7nqCZrwtjp1NeDc,1578
+fbuild/deploy/deployer_esp32.py,sha256=lnZQrEDn2y8QToLReqyGclAKcp0rrTNyVp62W2mgAqs,11327
+fbuild/deploy/monitor.py,sha256=ZyWXG_mszohzBB0yADe_H-pTti6zDjihY3dOBeXBzfc,19233
+fbuild/packages/__init__.py,sha256=JbdXK0Ssk5K91XA_ERFLEVdepmXzYRlCtnESaRTEjhg,1724
+fbuild/packages/archive_utils.py,sha256=jjrfx6IZllIQ6mCshO_QA7oiLkVYtlHHn-S35rS4aBU,51925
+fbuild/packages/arduino_core.py,sha256=Ym_EFfb__Tp4HAexzbkdCuqqhd9Uvw7pa3eWelbIyCg,13235
+fbuild/packages/cache.py,sha256=S_NvKI2hZAN1qN5YJ1gwG_f8YUWJwGf1yRoxxuusyaM,8238
+fbuild/packages/downloader.py,sha256=YEIW2TDj9zvOfBH3b22lrKjPq6umdU90x7VOBAXcW0w,12048
+fbuild/packages/framework_esp32.py,sha256=2uS94oWbE2_vssTebMKz_9g-ZOHCFsYgo5PvfR4IpgQ,19612
+fbuild/packages/framework_teensy.py,sha256=3jbcaN91t5vE4A1Pd9nTdx89dwcg2NahCkiwrY3EMwA,11352
+fbuild/packages/github_utils.py,sha256=iLwLpWaXPhaadJwScE_sWcmlzA5r-e5TuZY7-Yet4nY,2857
+fbuild/packages/header_trampoline_cache.py,sha256=fupEB5mE6_dytWswx3-LqogVnw7wq_YRWCfHsy-14XY,14305
+fbuild/packages/library_compiler.py,sha256=Giavoet3ijrNyshZQGw0mHFr11JSiPDn8aQ3dd_jng4,7244
+fbuild/packages/library_manager.py,sha256=7QIYu8WYUf4g-GGzwnubjcqKiS92GOjkL_X9Jvx4Mtw,17704
+fbuild/packages/library_manager_esp32.py,sha256=2GB1Mr4u0vUgcP4txT_L7XotWwDaYiHz9G-4VWQZrLc,13775
+fbuild/packages/package.py,sha256=scgvVHnaHm0gBV55DPbn0a8AcHLiBLKgBGFU--R6a6M,3894
+fbuild/packages/platform_esp32.py,sha256=F1rbxnYwaxftHoSrarxj0p73XTrdL2IninsDWshS3zE,13820
+fbuild/packages/platform_teensy.py,sha256=wUTT1Zr4Hg-FI1JtbKkxUkPKSQHhG4k7YtrdvLsNrZU,9730
+fbuild/packages/platform_utils.py,sha256=nE2nXDI6LDFTDqdndV2e9lY103m72H5nT7nKerQM3JM,3978
+fbuild/packages/platformio_registry.py,sha256=OGfI88SysnnJhif2ntSmNgtoCId-quR8iZR1JPWuVJ4,10389
+fbuild/packages/sdk_utils.py,sha256=XbPFT2dOJ8z4rU6gIVjt0wwkPEvaSPFu__R9UTV0-fc,9042
+fbuild/packages/toolchain.py,sha256=HxC8HbufztiA-glrEqbc029AZer3WE2jerBIgVX0ZfE,14274
+fbuild/packages/toolchain_binaries.py,sha256=qJXgrSTN9CxGwFSGdtjs_2-BnxjP68OltAPmRTO-69Y,6917
+fbuild/packages/toolchain_esp32.py,sha256=QQAfQCKSaAzQMeWdSBWE3_4HX3MGwT4bJNxdo2dLoiM,16734
+fbuild/packages/toolchain_metadata.py,sha256=ws8bt5O_Ay8PwZDiN15BTaoKh2U77IlmhRyvA706h3s,6367
+fbuild/packages/toolchain_teensy.py,sha256=5bM49z4nbgAplZxmk8nVcOB-p7yGMLOWgzAnkChrKus,13584
+fbuild/platform_configs/esp32.json,sha256=bynMS4DnDfG9Ka_wZQO1io-QygtJwMohmEaK_jlrDBA,4532
+fbuild/platform_configs/esp32c2.json,sha256=phr00CLtw7bCD0cW7iHTX2ShtfVVrWibBx7cAvcF3BY,4438
+fbuild/platform_configs/esp32c3.json,sha256=GgLERfXXbvZGnauiCnaYhgugKv1B7DADWiI3i0z0WZk,4427
+fbuild/platform_configs/esp32c5.json,sha256=07wPF69U8MfOLup8H5CcguyCBq0kwBeU81Ka9BDFSRw,4691
+fbuild/platform_configs/esp32c6.json,sha256=zRYpaOJ414ja5wrFiNgUb8kvZxyQBtvmJRkg9mmOrAc,4691
+fbuild/platform_configs/esp32p4.json,sha256=OniO6KxL8iK_7qS3jW18Y8iJSt693a06vNyDEfcYSk0,4602
+fbuild/platform_configs/esp32s3.json,sha256=iKtW28vzYPbDXGhcb78gm9tqYQTBvxPFI5kTRMaUmd8,4611
+fbuild/platform_configs/imxrt1062.json,sha256=_eW8sDCnx4T8Y5uEtQruKquIvo01U6WcrEzPpH8b-94,1047
+fbuild-1.1.0.dist-info/licenses/LICENSE,sha256=b6pOoifSXiUaz_lDS84vWlG3fr4yUKwB8fzkrH9R8bQ,1064
+fbuild_lint/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fbuild_lint/ruff_plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fbuild_lint/ruff_plugins/keyboard_interrupt_checker.py,sha256=zFxPRGx6M9tNEOl8o7eKEEPrU1ZytbqmwNiVyrhWgRk,6555
+fbuild-1.1.0.dist-info/METADATA,sha256=G4jKhomRlSpafY3R09Y6tlZC0cM5WQ2BcO-xAcNIdF0,13203
+fbuild-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fbuild-1.1.0.dist-info/entry_points.txt,sha256=FoKJ3GeqwGCKFr7Zanl1f67qRYS_EQpA5s2GadeYwQU,146
+fbuild-1.1.0.dist-info/top_level.txt,sha256=SP5cQb_9JGxIZk2wo2pH6RlSxePBRTEBPVvPti2ckhQ,19
+fbuild-1.1.0.dist-info/RECORD,,

fbuild-1.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fbuild-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+fbuild = fbuild.cli:main
+
+[flake8.extension]
+KBI = fbuild_lint.ruff_plugins.keyboard_interrupt_checker:KeyboardInterruptChecker

fbuild-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 zackees
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fbuild-1.1.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+fbuild
+fbuild_lint

fbuild_lint/ruff_plugins/keyboard_interrupt_checker.py

@@ -0,0 +1,158 @@
+"""Flake8 plugin to check for proper KeyboardInterrupt handling.
+
+This plugin ensures that try-except blocks that catch broad exceptions
+(like Exception or BaseException) also properly handle KeyboardInterrupt.
+
+Error Codes:
+    KBI001: Try-except catches Exception/BaseException without KeyboardInterrupt handler
+    KBI002: KeyboardInterrupt handler must call _thread.interrupt_main() or handle_keyboard_interrupt_properly()
+"""
+
+import ast
+from typing import Any, Generator, Tuple, Type
+
+
+class KeyboardInterruptChecker:
+    """Flake8 plugin to check for proper KeyboardInterrupt handling."""
+
+    name = "keyboard-interrupt-checker"
+    version = "1.0.0"
+
+    def __init__(self, tree: ast.AST) -> None:
+        """Initialize the checker with an AST tree.
+
+        Args:
+            tree: The AST tree to check
+        """
+        self._tree = tree
+
+    def run(self) -> Generator[Tuple[int, int, str, Type[Any]], None, None]:
+        """Run the checker on the AST tree.
+
+        Yields:
+            Tuple of (line_number, column, message, type)
+        """
+        visitor = TryExceptVisitor()
+        visitor.visit(self._tree)
+
+        for line, col, msg in visitor.errors:
+            yield (line, col, msg, type(self))
+
+
+class TryExceptVisitor(ast.NodeVisitor):
+    """AST visitor to check try-except blocks for KeyboardInterrupt handling."""
+
+    def __init__(self) -> None:
+        """Initialize the visitor."""
+        self.errors: list[Tuple[int, int, str]] = []
+
+    def visit_Try(self, node: ast.Try) -> None:
+        """Visit a Try node and check exception handlers.
+
+        Args:
+            node: The Try node to check
+        """
+        # Check if any handler catches Exception or BaseException
+        catches_broad_exception = False
+        has_keyboard_interrupt_handler = False
+        keyboard_interrupt_handlers = []
+
+        for handler in node.handlers:
+            if handler.type is None:
+                # bare except: catches everything
+                catches_broad_exception = True
+            elif isinstance(handler.type, ast.Name):
+                if handler.type.id in ("Exception", "BaseException"):
+                    catches_broad_exception = True
+                elif handler.type.id == "KeyboardInterrupt":
+                    has_keyboard_interrupt_handler = True
+                    keyboard_interrupt_handlers.append(handler)
+            elif isinstance(handler.type, ast.Tuple):
+                # Check if tuple contains Exception or BaseException
+                for exc_type in handler.type.elts:
+                    if isinstance(exc_type, ast.Name):
+                        if exc_type.id in ("Exception", "BaseException"):
+                            catches_broad_exception = True
+                        elif exc_type.id == "KeyboardInterrupt":
+                            has_keyboard_interrupt_handler = True
+                            keyboard_interrupt_handlers.append(handler)
+
+        # If we catch broad exceptions without KeyboardInterrupt handler, that's an error
+        if catches_broad_exception and not has_keyboard_interrupt_handler:
+            self.errors.append(
+                (
+                    node.lineno,
+                    node.col_offset,
+                    (
+                        "KBI001 Try-except catches Exception/BaseException without KeyboardInterrupt handler. "
+                        "Add: except KeyboardInterrupt as ke: handle_keyboard_interrupt_properly(ke)"
+                    ),
+                )
+            )
+
+        # Check all KeyboardInterrupt handlers to ensure they call _thread.interrupt_main()
+        for keyboard_interrupt_handler in keyboard_interrupt_handlers:
+            if not self._handler_calls_interrupt_main(keyboard_interrupt_handler):
+                self.errors.append(
+                    (
+                        keyboard_interrupt_handler.lineno,
+                        keyboard_interrupt_handler.col_offset,
+                        (
+                            "KBI002 KeyboardInterrupt handler must call _thread.interrupt_main() "
+                            "or use handle_keyboard_interrupt_properly(). "
+                            "Add: import _thread; _thread.interrupt_main()"
+                        ),
+                    )
+                )
+
+        # Continue visiting child nodes
+        self.generic_visit(node)
+
+    def _handler_calls_interrupt_main(self, handler: ast.ExceptHandler) -> bool:
+        """Check if a KeyboardInterrupt handler properly calls _thread.interrupt_main().
+
+        Args:
+            handler: The exception handler to check
+
+        Returns:
+            True if the handler calls _thread.interrupt_main(), handle_keyboard_interrupt_properly(),
+            sys.exit(), ErrorFormatter.handle_keyboard_interrupt(), or re-raises the exception
+        """
+        # Check for re-raise (bare raise statement)
+        for node in ast.walk(handler):
+            if isinstance(node, ast.Raise):
+                # Bare raise (re-raise) is allowed
+                if node.exc is None:
+                    return True
+
+        # Check for calls to _thread.interrupt_main(), handle_keyboard_interrupt_properly(), or sys.exit()
+        for node in ast.walk(handler):
+            if isinstance(node, ast.Call):
+                # Check for _thread.interrupt_main()
+                if isinstance(node.func, ast.Attribute):
+                    if (
+                        isinstance(node.func.value, ast.Name)
+                        and node.func.value.id == "_thread"
+                        and node.func.attr == "interrupt_main"
+                    ):
+                        return True
+                    # Check for sys.exit()
+                    if (
+                        isinstance(node.func.value, ast.Name)
+                        and node.func.value.id == "sys"
+                        and node.func.attr == "exit"
+                    ):
+                        return True
+                    # Check for ErrorFormatter.handle_keyboard_interrupt() or similar
+                    if node.func.attr == "handle_keyboard_interrupt":
+                        return True
+
+                # Check for handle_keyboard_interrupt_properly()
+                if isinstance(node.func, ast.Name):
+                    if node.func.id == "handle_keyboard_interrupt_properly":
+                        return True
+                    # Check for handle_keyboard_interrupt()
+                    if node.func.id == "handle_keyboard_interrupt":
+                        return True
+
+        return False