micropython-stubber 1.20.5__py3-none-any.whl → 1.20.6__py3-none-any.whl

mpflash/mpflash/vendor/click_aliases.py

@@ -1,91 +1,91 @@
-# Copyright (c) 2016 Robbin Bonthond
-
-# 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.
-# ------------------------------------------------------------------------------------
-# modified to avoid conflcts with rich_click
-
-# sourcery skip: assign-if-exp, use-named-expression
-
-import rich_click as click
-
-_click7 = click.__version__[0] >= "7"
-
-
-class ClickAliasedGroup(click.RichGroup):
-    def __init__(self, *args, **kwargs):
-        super().__init__(*args, **kwargs)
-        self._commands = {}
-        self._aliases = {}
-
-    def add_command(self, *args, **kwargs):
-        aliases = kwargs.pop("aliases", [])
-        super().add_command(*args, **kwargs)
-        if aliases:
-            cmd = args[0]
-            name = args[1] if len(args) > 1 else None
-            name = name or cmd.name
-            if name is None:
-                raise TypeError("Command has no name.")
-
-            self._commands[name] = aliases
-            for alias in aliases:
-                self._aliases[alias] = cmd.name
-
-    def command(self, *args, **kwargs):
-        aliases = kwargs.pop("aliases", [])
-        decorator = super().command(*args, **kwargs)
-        if not aliases:
-            return decorator
-
-        def _decorator(f):
-            cmd = decorator(f)
-            if aliases:
-                self._commands[cmd.name] = aliases
-                for alias in aliases:
-                    self._aliases[alias] = cmd.name
-            return cmd
-
-        return _decorator
-
-    def group(self, *args, **kwargs):
-        aliases = kwargs.pop("aliases", [])
-        decorator = super().group(*args, **kwargs)
-        if not aliases:
-            return decorator
-
-        def _decorator(f):
-            cmd = decorator(f)
-            if aliases:
-                self._commands[cmd.name] = aliases
-                for alias in aliases:
-                    self._aliases[alias] = cmd.name
-            return cmd
-
-        return _decorator
-
-    def resolve_alias(self, cmd_name):
-        if cmd_name in self._aliases:
-            return self._aliases[cmd_name]
-        return cmd_name
-
-    def get_command(self, ctx, cmd_name):
-        cmd_name = self.resolve_alias(cmd_name)
-        command = super().get_command(ctx, cmd_name)
-        if command:
-            return command
-        return None
-
-    # def format_commands(self, ctx, formatter):
-    # TODO: output alias with commands - but that is a significant re-write
-    # for now add alias to help text
-
-
-# ------------------------------------------------------------------------------------
+# Copyright (c) 2016 Robbin Bonthond
+
+# 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.
+# ------------------------------------------------------------------------------------
+# modified to avoid conflcts with rich_click
+
+# sourcery skip: assign-if-exp, use-named-expression
+
+import rich_click as click
+
+_click7 = click.__version__[0] >= "7"
+
+
+class ClickAliasedGroup(click.RichGroup):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self._commands = {}
+        self._aliases = {}
+
+    def add_command(self, *args, **kwargs):
+        aliases = kwargs.pop("aliases", [])
+        super().add_command(*args, **kwargs)
+        if aliases:
+            cmd = args[0]
+            name = args[1] if len(args) > 1 else None
+            name = name or cmd.name
+            if name is None:
+                raise TypeError("Command has no name.")
+
+            self._commands[name] = aliases
+            for alias in aliases:
+                self._aliases[alias] = cmd.name
+
+    def command(self, *args, **kwargs):
+        aliases = kwargs.pop("aliases", [])
+        decorator = super().command(*args, **kwargs)
+        if not aliases:
+            return decorator
+
+        def _decorator(f):
+            cmd = decorator(f)
+            if aliases:
+                self._commands[cmd.name] = aliases
+                for alias in aliases:
+                    self._aliases[alias] = cmd.name
+            return cmd
+
+        return _decorator
+
+    def group(self, *args, **kwargs):
+        aliases = kwargs.pop("aliases", [])
+        decorator = super().group(*args, **kwargs)
+        if not aliases:
+            return decorator
+
+        def _decorator(f):
+            cmd = decorator(f)
+            if aliases:
+                self._commands[cmd.name] = aliases
+                for alias in aliases:
+                    self._aliases[alias] = cmd.name
+            return cmd
+
+        return _decorator
+
+    def resolve_alias(self, cmd_name):
+        if cmd_name in self._aliases:
+            return self._aliases[cmd_name]
+        return cmd_name
+
+    def get_command(self, ctx, cmd_name):
+        cmd_name = self.resolve_alias(cmd_name)
+        command = super().get_command(ctx, cmd_name)
+        if command:
+            return command
+        return None
+
+    # def format_commands(self, ctx, formatter):
+    # TODO: output alias with commands - but that is a significant re-write
+    # for now add alias to help text
+
+
+# ------------------------------------------------------------------------------------

mpflash/mpflash/vendor/dfu.py

@@ -1,165 +1,165 @@
-# sourcery skip: require-parameter-annotation
-# sourcery skip: replace-interpolation-with-fstring
-# type: ignore
-#!/usr/bin/python
-
-# Written by Antonio Galea - 2010/11/18
-# Distributed under Gnu LGPL 3.0
-# see http://www.gnu.org/licenses/lgpl-3.0.txt
-
-import os
-import struct
-import sys
-import zlib
-from optparse import OptionParser
-
-DEFAULT_DEVICE = "0x0483:0xdf11"
-
-
-def named(tuple, names):
-    return dict(zip(names.split(), tuple))
-
-
-def consume(fmt, data, names):
-    n = struct.calcsize(fmt)
-    return named(struct.unpack(fmt, data[:n]), names), data[n:]
-
-
-def cstring(string):
-    return string.split(b"\0", 1)[0]
-
-
-def compute_crc(data):
-    return 0xFFFFFFFF & -zlib.crc32(data) - 1
-
-
-def parse(file, dump_images=False):
-    print('File: "%s"' % file)
-    data = open(file, "rb").read()
-    crc = compute_crc(data[:-4])
-    prefix, data = consume("<5sBIB", data, "signature version size targets")
-    print("%(signature)s v%(version)d, image size: %(size)d, targets: %(targets)d" % prefix)
-    for t in range(prefix["targets"]):
-        tprefix, data = consume("<6sBI255s2I", data, "signature altsetting named name size elements")
-        tprefix["num"] = t
-        if tprefix["named"]:
-            tprefix["name"] = cstring(tprefix["name"])
-        else:
-            tprefix["name"] = ""
-        print(
-            '%(signature)s %(num)d, alt setting: %(altsetting)s, name: "%(name)s", size: %(size)d, elements: %(elements)d'
-            % tprefix
-        )
-        tsize = tprefix["size"]
-        target, data = data[:tsize], data[tsize:]
-        for e in range(tprefix["elements"]):
-            eprefix, target = consume("<2I", target, "address size")
-            eprefix["num"] = e
-            print("  %(num)d, address: 0x%(address)08x, size: %(size)d" % eprefix)
-            esize = eprefix["size"]
-            image, target = target[:esize], target[esize:]
-            if dump_images:
-                out = "%s.target%d.image%d.bin" % (file, t, e)
-                open(out, "wb").write(image)
-                print('    DUMPED IMAGE TO "%s"' % out)
-        if len(target):
-            print("target %d: PARSE ERROR" % t)
-    suffix = named(struct.unpack("<4H3sBI", data[:16]), "device product vendor dfu ufd len crc")
-    print(
-        "usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x"
-        % suffix
-    )
-    if crc != suffix["crc"]:
-        print("CRC ERROR: computed crc32 is 0x%08x" % crc)
-    data = data[16:]
-    if data:
-        print("PARSE ERROR")
-
-
-def build(file, targets, device=DEFAULT_DEVICE):
-    data = b""
-    for _, target in enumerate(targets):
-        tdata = b""
-        for image in target:
-            # pad image to 8 bytes (needed at least for L476)
-            pad = (8 - len(image["data"]) % 8) % 8
-            image["data"] = image["data"] + bytes(bytearray(8)[0:pad])
-            #
-            tdata += struct.pack("<2I", image["address"], len(image["data"])) + image["data"]
-        tdata = struct.pack("<6sBI255s2I", b"Target", 0, 1, b"ST...", len(tdata), len(target)) + tdata
-        data += tdata
-    data = struct.pack("<5sBIB", b"DfuSe", 1, len(data) + 11, len(targets)) + data
-    v, d = map(lambda x: int(x, 0) & 0xFFFF, device.split(":", 1))
-    data += struct.pack("<4H3sB", 0, d, v, 0x011A, b"UFD", 16)
-    crc = compute_crc(data)
-    data += struct.pack("<I", crc)
-    open(file, "wb").write(data)
-
-
-if __name__ == "__main__":
-    usage = """
-%prog [-d|--dump] infile.dfu
-%prog {-b|--build} address:file.bin [-b address:file.bin ...] [{-D|--device}=vendor:device] outfile.dfu"""
-    parser = OptionParser(usage=usage)
-    parser.add_option(
-        "-b",
-        "--build",
-        action="append",
-        dest="binfiles",
-        help="build a DFU file from given BINFILES",
-        metavar="BINFILES",
-    )
-    parser.add_option(
-        "-D",
-        "--device",
-        action="store",
-        dest="device",
-        help="build for DEVICE, defaults to %s" % DEFAULT_DEVICE,
-        metavar="DEVICE",
-    )
-    parser.add_option(
-        "-d",
-        "--dump",
-        action="store_true",
-        dest="dump_images",
-        default=False,
-        help="dump contained images to current directory",
-    )
-    (options, args) = parser.parse_args()
-
-    if options.binfiles and len(args) == 1:
-        target = []
-        for arg in options.binfiles:
-            try:
-                address, binfile = arg.split(":", 1)
-            except ValueError:
-                print("Address:file couple '%s' invalid." % arg)
-                sys.exit(1)
-            try:
-                address = int(address, 0) & 0xFFFFFFFF
-            except ValueError:
-                print("Address %s invalid." % address)
-                sys.exit(1)
-            if not os.path.isfile(binfile):
-                print("Unreadable file '%s'." % binfile)
-                sys.exit(1)
-            target.append({"address": address, "data": open(binfile, "rb").read()})
-        outfile = args[0]
-        device = DEFAULT_DEVICE
-        if options.device:
-            device = options.device
-        try:
-            v, d = map(lambda x: int(x, 0) & 0xFFFF, device.split(":", 1))
-        except:
-            print("Invalid device '%s'." % device)
-            sys.exit(1)
-        build(outfile, [target], device)
-    elif len(args) == 1:
-        infile = args[0]
-        if not os.path.isfile(infile):
-            print("Unreadable file '%s'." % infile)
-            sys.exit(1)
-        parse(infile, dump_images=options.dump_images)
-    else:
-        parser.print_help()
-        sys.exit(1)
+# sourcery skip: require-parameter-annotation
+# sourcery skip: replace-interpolation-with-fstring
+# type: ignore
+#!/usr/bin/python
+
+# Written by Antonio Galea - 2010/11/18
+# Distributed under Gnu LGPL 3.0
+# see http://www.gnu.org/licenses/lgpl-3.0.txt
+
+import os
+import struct
+import sys
+import zlib
+from optparse import OptionParser
+
+DEFAULT_DEVICE = "0x0483:0xdf11"
+
+
+def named(tuple, names):
+    return dict(zip(names.split(), tuple))
+
+
+def consume(fmt, data, names):
+    n = struct.calcsize(fmt)
+    return named(struct.unpack(fmt, data[:n]), names), data[n:]
+
+
+def cstring(string):
+    return string.split(b"\0", 1)[0]
+
+
+def compute_crc(data):
+    return 0xFFFFFFFF & -zlib.crc32(data) - 1
+
+
+def parse(file, dump_images=False):
+    print('File: "%s"' % file)
+    data = open(file, "rb").read()
+    crc = compute_crc(data[:-4])
+    prefix, data = consume("<5sBIB", data, "signature version size targets")
+    print("%(signature)s v%(version)d, image size: %(size)d, targets: %(targets)d" % prefix)
+    for t in range(prefix["targets"]):
+        tprefix, data = consume("<6sBI255s2I", data, "signature altsetting named name size elements")
+        tprefix["num"] = t
+        if tprefix["named"]:
+            tprefix["name"] = cstring(tprefix["name"])
+        else:
+            tprefix["name"] = ""
+        print(
+            '%(signature)s %(num)d, alt setting: %(altsetting)s, name: "%(name)s", size: %(size)d, elements: %(elements)d'
+            % tprefix
+        )
+        tsize = tprefix["size"]
+        target, data = data[:tsize], data[tsize:]
+        for e in range(tprefix["elements"]):
+            eprefix, target = consume("<2I", target, "address size")
+            eprefix["num"] = e
+            print("  %(num)d, address: 0x%(address)08x, size: %(size)d" % eprefix)
+            esize = eprefix["size"]
+            image, target = target[:esize], target[esize:]
+            if dump_images:
+                out = "%s.target%d.image%d.bin" % (file, t, e)
+                open(out, "wb").write(image)
+                print('    DUMPED IMAGE TO "%s"' % out)
+        if len(target):
+            print("target %d: PARSE ERROR" % t)
+    suffix = named(struct.unpack("<4H3sBI", data[:16]), "device product vendor dfu ufd len crc")
+    print(
+        "usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x"
+        % suffix
+    )
+    if crc != suffix["crc"]:
+        print("CRC ERROR: computed crc32 is 0x%08x" % crc)
+    data = data[16:]
+    if data:
+        print("PARSE ERROR")
+
+
+def build(file, targets, device=DEFAULT_DEVICE):
+    data = b""
+    for _, target in enumerate(targets):
+        tdata = b""
+        for image in target:
+            # pad image to 8 bytes (needed at least for L476)
+            pad = (8 - len(image["data"]) % 8) % 8
+            image["data"] = image["data"] + bytes(bytearray(8)[0:pad])
+            #
+            tdata += struct.pack("<2I", image["address"], len(image["data"])) + image["data"]
+        tdata = struct.pack("<6sBI255s2I", b"Target", 0, 1, b"ST...", len(tdata), len(target)) + tdata
+        data += tdata
+    data = struct.pack("<5sBIB", b"DfuSe", 1, len(data) + 11, len(targets)) + data
+    v, d = map(lambda x: int(x, 0) & 0xFFFF, device.split(":", 1))
+    data += struct.pack("<4H3sB", 0, d, v, 0x011A, b"UFD", 16)
+    crc = compute_crc(data)
+    data += struct.pack("<I", crc)
+    open(file, "wb").write(data)
+
+
+if __name__ == "__main__":
+    usage = """
+%prog [-d|--dump] infile.dfu
+%prog {-b|--build} address:file.bin [-b address:file.bin ...] [{-D|--device}=vendor:device] outfile.dfu"""
+    parser = OptionParser(usage=usage)
+    parser.add_option(
+        "-b",
+        "--build",
+        action="append",
+        dest="binfiles",
+        help="build a DFU file from given BINFILES",
+        metavar="BINFILES",
+    )
+    parser.add_option(
+        "-D",
+        "--device",
+        action="store",
+        dest="device",
+        help="build for DEVICE, defaults to %s" % DEFAULT_DEVICE,
+        metavar="DEVICE",
+    )
+    parser.add_option(
+        "-d",
+        "--dump",
+        action="store_true",
+        dest="dump_images",
+        default=False,
+        help="dump contained images to current directory",
+    )
+    (options, args) = parser.parse_args()
+
+    if options.binfiles and len(args) == 1:
+        target = []
+        for arg in options.binfiles:
+            try:
+                address, binfile = arg.split(":", 1)
+            except ValueError:
+                print("Address:file couple '%s' invalid." % arg)
+                sys.exit(1)
+            try:
+                address = int(address, 0) & 0xFFFFFFFF
+            except ValueError:
+                print("Address %s invalid." % address)
+                sys.exit(1)
+            if not os.path.isfile(binfile):
+                print("Unreadable file '%s'." % binfile)
+                sys.exit(1)
+            target.append({"address": address, "data": open(binfile, "rb").read()})
+        outfile = args[0]
+        device = DEFAULT_DEVICE
+        if options.device:
+            device = options.device
+        try:
+            v, d = map(lambda x: int(x, 0) & 0xFFFF, device.split(":", 1))
+        except:
+            print("Invalid device '%s'." % device)
+            sys.exit(1)
+        build(outfile, [target], device)
+    elif len(args) == 1:
+        infile = args[0]
+        if not os.path.isfile(infile):
+            print("Unreadable file '%s'." % infile)
+            sys.exit(1)
+        parse(infile, dump_images=options.dump_images)
+    else:
+        parser.print_help()
+        sys.exit(1)