objutils 0.10.11__tar.gz → 0.10.12__tar.gz

{objutils-0.10.11 → objutils-0.10.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: objutils
-Version: 0.10.11
+Version: 0.10.12
 Summary: Objectfile library for Python
 Keywords: hex files,intel hex,s19,srec,srecords,object files,map files,embedded,microcontroller,ECU,shf,rfc4194
 Author-Email: Christoph Schueler <cpu12.gems@googlemail.com>
@@ -10,11 +10,12 @@ Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development
 Classifier: Topic :: Scientific/Engineering
 Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Project-URL: Repository, https://www.github.com/Christoph2/objutils
 Requires-Python: <4.0,>=3.10
 Requires-Dist: construct>=2.10.70
@@ -22,6 +23,7 @@ Requires-Dist: mako>=1.3.3
 Requires-Dist: sqlalchemy>=2.0.29
 Requires-Dist: rich>=14.2
 Requires-Dist: numpy>=2.2.5
+Requires-Dist: ufilename<0.2.0,>=0.1.1
 Provides-Extra: dev
 Requires-Dist: bumpver>=2023.1129; extra == "dev"
 Requires-Dist: pre-commit>=3.7.0; extra == "dev"
@@ -78,11 +80,14 @@ Features
 
 - Read ELF files (including symbols) and extract loadable sections.
 - Inspect PE/COFF files and symbols (optional PDB support).
+- Merge multiple HEX files into one (``oj-hex-merge``).
+- Split HEX files into separate sections (``oj-hex-split``).
 - Typed access (scalars, arrays, strings) to binary data.
 
 Recent improvements
 -------------------
 
+- New ``oj-hex-merge`` and ``oj-hex-split`` CLI tools for combining and partitioning HEX files.
 - New ``oj-dwarf-import`` CLI replaces ``dwarfer.py``/``cu_info.py`` for DWARF imports, CU listing, summaries, and attribute traversal.
 - Faster DWARF imports: batched ORM writes, quiet flag propagation, and safe DWARF expression evaluation keep large ELF files stable.
 - Exception handling and typing tightened across DWARF/ELF/PECOFF modules and public APIs to surface real errors without masking them.
@@ -215,6 +220,14 @@ And loaded again...
    Section(address = 0X00001000, length = 16, data = b'Hello HEX world!')
    Section(address = 0X00002000, length = 16, data = b'\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10')
 
+Or split it into its sections...
+
+.. code-block:: python
+
+   images = img1.split()
+   for i, img in enumerate(images):
+       dump("srec", f"part_{i}.srec", img)
+
 This leads to the conversion idiom.
 
 .. code-block:: python

{objutils-0.10.11 → objutils-0.10.12}/docs/README.rst

@@ -44,11 +44,14 @@ Features
 
 - Read ELF files (including symbols) and extract loadable sections.
 - Inspect PE/COFF files and symbols (optional PDB support).
+- Merge multiple HEX files into one (``oj-hex-merge``).
+- Split HEX files into separate sections (``oj-hex-split``).
 - Typed access (scalars, arrays, strings) to binary data.
 
 Recent improvements
 -------------------
 
+- New ``oj-hex-merge`` and ``oj-hex-split`` CLI tools for combining and partitioning HEX files.
 - New ``oj-dwarf-import`` CLI replaces ``dwarfer.py``/``cu_info.py`` for DWARF imports, CU listing, summaries, and attribute traversal.
 - Faster DWARF imports: batched ORM writes, quiet flag propagation, and safe DWARF expression evaluation keep large ELF files stable.
 - Exception handling and typing tightened across DWARF/ELF/PECOFF modules and public APIs to surface real errors without masking them.
@@ -181,6 +184,14 @@ And loaded again...
    Section(address = 0X00001000, length = 16, data = b'Hello HEX world!')
    Section(address = 0X00002000, length = 16, data = b'\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10')
 
+Or split it into its sections...
+
+.. code-block:: python
+
+   images = img1.split()
+   for i, img in enumerate(images):
+       dump("srec", f"part_{i}.srec", img)
+
 This leads to the conversion idiom.
 
 .. code-block:: python

{objutils-0.10.11 → objutils-0.10.12}/docs/scripts.rst

@@ -278,22 +278,19 @@ oj_hex_info
 
 .. code-block:: shell
 
-    usage: oj-hex-info [-h] [-d]
-                      {ash,cosmac,emon52,etek,fpc,ihex,mostec,rca,shf,sig,srec,tek,titxt}
-                      hex_file
+    usage: oj-hex-info [-h] [-d] [-p]
+                      [file_type] hex_file
 
     Displays informations about HEX files.
 
     positional arguments:
-      {ash,cosmac,emon52,etek,fpc,ihex,mostec,rca,shf,sig,srec,tek,titxt}
-                            file type
+      file_type             file type (optional, if omitted it is probed)
       hex_file              HEX file
 
     optional arguments:
       -h, --help            show this help message and exit
       -d, --dump            hexdump contents
-
-Filetype is a required argument (no auto-probing yet).
+      -p, --print-filename  Print filename including path
 
 Run it as follows:
 
@@ -301,8 +298,9 @@ Without any optional arguments just the addresses and lengths of the contained s
 
 .. code-block:: shell
 
-    $ oj_hex_info srec sample.srec
+    $ oj-hex-info sample.srec
 
+    Sections
     --------
 
     Num   Address    Length
@@ -316,7 +314,7 @@ If you also want to see the contents, add *-d* option:
 
 .. code-block:: shell
 
-    $ oj_hex_info srec sample.srec -d
+    $ oj-hex-info sample.srec -d
 
     Sections
     --------
@@ -342,6 +340,78 @@ If you also want to see the contents, add *-d* option:
            16 bytes
     ---------------
 
+oj_hex_merge
+------------
+
+.. code-block:: shell
+
+    usage: oj-hex-merge [-h] -o OUTPUT [-t OUTPUT_TYPE] [-p] [-v]
+                        input_files [input_files ...]
+
+    Merges multiple HEX files into one.
+
+    positional arguments:
+      input_files           Input HEX files to be merged.
+
+    optional arguments:
+      -h, --help            show this help message and exit
+      -o OUTPUT, --output OUTPUT
+                            Output HEX file.
+      -t OUTPUT_TYPE, --type OUTPUT_TYPE
+                            Output file type (e.g., ihex, srec). If omitted, it's
+                            inferred from the output file extension.
+      -p, --print-filename  Print filenames while processing
+      -v, --verbose         Verbose output
+
+Example:
+
+.. code-block:: shell
+
+    $ oj-hex-merge file1.hex file2.hex -o merged.hex
+
+Note: Merging files with overlapping sections is not allowed and will result in an error.
+
+oj_hex_split
+------------
+
+.. code-block:: shell
+
+    usage: oj-hex-split [-h] [-o OUTPUT_NAMES [OUTPUT_NAMES ...]]
+                        [-t OUTPUT_TYPE] [-p PREFIX] [-v]
+                        input_file
+
+    Splits a HEX file into multiple files based on its sections.
+
+    positional arguments:
+      input_file            Input HEX file to be split.
+
+    optional arguments:
+      -h, --help            show this help message and exit
+      -o OUTPUT_NAMES [OUTPUT_NAMES ...], --output-names OUTPUT_NAMES [OUTPUT_NAMES ...]
+                            Optional list of output base names. If not provided,
+                            section numbers are used.
+      -t OUTPUT_TYPE, --type OUTPUT_TYPE
+                            Output file type (e.g., ihex, srec). If omitted, it's
+                            inferred from the input file extension.
+      -p PREFIX, --prefix PREFIX
+                            Prefix for output filenames. Defaults to input
+                            filename (without extension).
+      -v, --verbose         Verbose output
+
+Example:
+
+.. code-block:: shell
+
+    $ oj-hex-split merged.hex
+
+This will generate files like ``merged_000.hex``, ``merged_001.hex``, etc.
+
+You can also specify custom names:
+
+.. code-block:: shell
+
+    $ oj-hex-split merged.hex -o code data
+
 oj_coff_info
 ------------
 

{objutils-0.10.11 → objutils-0.10.12}/objutils/__init__.py

@@ -13,7 +13,7 @@ Registers CODECS and implements an interface to them.
 The first parameter is always the codec name.
 """
 
-__version__ = "0.10.11"
+__version__ = "0.10.12"
 
 __all__ = [
     "Image",

{objutils-0.10.11 → objutils-0.10.12}/objutils/image.py

@@ -940,23 +940,13 @@ class Image:
             if not (new_address + len(section) <= s.start_address or new_address >= s.start_address + len(s)):
                 raise InvalidAddressError(f"New address 0x{new_address:08x} causes overlap with section at 0x{s.start_address:08x}")
 
-    def split(self, at: Optional[int] = None, equal_parts: Optional[int] = None, remap: Optional[bool] = None) -> None:
-        """Split image into multiple parts.
+    def split(self) -> list["Image"]:
+        """Split image into multiple parts based on sections.
 
-        Args:
-            at: Address at which to split the image.
-            equal_parts: Number of equal-sized parts to split into.
-            remap: If True, remap addresses after splitting.
-
-        Raises:
-            NotImplementedError: This method is not yet implemented.
-
-        Note:
-            This method is currently a placeholder and needs to be fully
-            implemented for production use. The parameters define different
-            splitting strategies that need to be developed.
+        Returns:
+            List of Image objects, each containing exactly one section.
         """
-        raise NotImplementedError(f"split() is not yet implemented. Called with: at={at}, equal_parts={equal_parts}, remap={remap}")
+        return [Image([section], join=False) for section in self.sections]
 
 
 def _validate_sections(sections: Iterable[Section]) -> None:

{objutils-0.10.11 → objutils-0.10.12}/objutils/scripts/oj_hex_info.py

@@ -4,7 +4,7 @@
 __copyright__ = """
    objutils - Object file library for Python.
 
-  (C) 2010-2020 by Christoph Schueler <cpu12.gems@googlemail.com>
+  (C) 2010-2026 by Christoph Schueler <cpu12.gems@googlemail.com>
 
   All Rights Reserved
 

objutils-0.10.12/objutils/scripts/oj_hex_merge.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python
+"""Merges multiple HEX files into one."""
+
+__copyright__ = """
+   objutils - Object file library for Python.
+
+  (C) 2010-2026 by Christoph Schueler <cpu12.gems@googlemail.com>
+
+  All Rights Reserved
+
+  This program 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 2 of the License, or
+  (at your option) any later version.
+
+  This program 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 this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+"""
+
+import argparse
+import sys
+from os import path
+
+from objutils import load, probe, dump, Image
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Merges multiple HEX files into one.")
+    parser.add_argument(
+        "input_files",
+        nargs="+",
+        help="Input HEX files to be merged.",
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        required=True,
+        help="Output HEX file.",
+    )
+    parser.add_argument(
+        "-t",
+        "--type",
+        dest="output_type",
+        help="Output file type (e.g., ihex, srec). If omitted, it's inferred from the output file extension.",
+    )
+    parser.add_argument(
+        "-p",
+        "--print-filename",
+        dest="print_filename",
+        action="store_true",
+        default=False,
+        help="Print filenames while processing",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        dest="verbose",
+        action="store_true",
+        default=False,
+        help="Verbose output",
+    )
+
+    args = parser.parse_args()
+
+    output_type = args.output_type
+    if not output_type:
+        ext = path.splitext(args.output)[1].lower()
+        if ext in (".hex", ".ihex"):
+            output_type = "ihex"
+        elif ext in (".s19", ".srec", ".mot"):
+            output_type = "srec"
+        elif ext in (".bin",):
+            output_type = "bin"
+        else:
+            print(f"Could not infer output type from extension '{ext}'. Please specify with -t.")
+            sys.exit(1)
+
+    all_sections = []
+
+    for filename in args.input_files:
+        if not path.exists(filename):
+            print(f"File '{filename}' does not exist.")
+            sys.exit(1)
+
+        if args.print_filename:
+            print(f"Processing '{filename}'...")
+
+        with open(filename, "rb") as f:
+            file_type = probe(f)
+
+        if file_type is None:
+            print(f"Could not determine file type for '{filename}'.")
+            sys.exit(1)
+
+        img = load(file_type, filename)
+        for section in img:
+            # Check for overlaps manually to satisfy "No overlaps allowed during merge"
+            for existing in all_sections:
+                if not (
+                    section.start_address + section.length <= existing.start_address
+                    or section.start_address >= existing.start_address + existing.length
+                ):
+                    overlap_start = max(section.start_address, existing.start_address)
+                    print(f"Error: Overlap detected at 0x{overlap_start:08x} between input files.")
+                    sys.exit(1)
+            all_sections.append(section)
+
+    merged_image = Image(all_sections, join=True)
+
+    if args.verbose:
+        print("\nMerged Image Sections:")
+        print("Num   Address    Length")
+        print("-" * 79)
+        for idx, sec in enumerate(merged_image):
+            print(f"{idx:03d}   0x{sec.start_address:08x} {sec.length}")
+        print("-" * 79)
+        print(f"                 {len(merged_image)} total bytes")
+
+    dump(output_type, args.output, merged_image)
+    print(f"Successfully merged into '{args.output}' (type: {output_type}).")
+
+
+if __name__ == "__main__":
+    main()

objutils-0.10.12/objutils/scripts/oj_hex_split.py

@@ -0,0 +1,135 @@
+#!/usr/bin/env python
+"""Splits a HEX file into multiple files based on its sections."""
+
+__copyright__ = """
+   objutils - Object file library for Python.
+
+  (C) 2010-2026 by Christoph Schueler <cpu12.gems@googlemail.com>
+
+  All Rights Reserved
+
+  This program 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 2 of the License, or
+  (at your option) any later version.
+
+  This program 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 this program; if not, write to the Free Software Foundation, Inc.,
+  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+"""
+
+import argparse
+import sys
+from os import path
+from pathlib import Path
+
+from objutils import load, probe, dump, Image
+from ufilename import build_filename, SuffixPolicy, IdentityPolicy
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Splits a HEX file into multiple files based on its sections.")
+    parser.add_argument(
+        "input_file",
+        help="Input HEX file to be split.",
+    )
+    parser.add_argument(
+        "-o",
+        "--output-names",
+        nargs="+",
+        help="Optional list of output base names. If not provided, section numbers are used.",
+    )
+    parser.add_argument(
+        "-t",
+        "--type",
+        dest="output_type",
+        help="Output file type (e.g., ihex, srec). If omitted, it's inferred from the input file extension.",
+    )
+    parser.add_argument(
+        "-p",
+        "--prefix",
+        help="Prefix for output filenames. Defaults to input filename (without extension).",
+    )
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        dest="verbose",
+        action="store_true",
+        default=False,
+        help="Verbose output",
+    )
+
+    args = parser.parse_args()
+
+    if not path.exists(args.input_file):
+        print(f"File '{args.input_file}' does not exist.")
+        sys.exit(1)
+
+    with open(args.input_file, "rb") as f:
+        file_type = probe(f)
+
+    if file_type is None:
+        print(f"Could not determine file type for '{args.input_file}'.")
+        sys.exit(1)
+
+    img = load(file_type, args.input_file)
+    
+    if not img.sections:
+        print(f"No sections found in '{args.input_file}'.")
+        sys.exit(0)
+
+    output_type = args.output_type
+    input_path = Path(args.input_file)
+    if not output_type:
+        ext = input_path.suffix.lower()
+        if ext in (".hex", ".ihex"):
+            output_type = "ihex"
+        elif ext in (".s19", ".srec", ".mot"):
+            output_type = "srec"
+        elif ext in (".bin",):
+            output_type = "bin"
+        else:
+            output_type = "ihex" # Fallback
+
+    base_prefix = args.prefix if args.prefix else input_path.stem
+    output_ext = input_path.suffix if not args.output_type else f".{args.output_type}"
+    # Normalize extension mapping for ufilename
+    if args.output_type:
+        if args.output_type == "ihex": output_ext = ".hex"
+        elif args.output_type == "srec": output_ext = ".s19"
+        elif args.output_type == "bin": output_ext = ".bin"
+
+    if args.verbose:
+        print(f"Splitting '{args.input_file}' into {len(img.sections)} sections...")
+
+    split_images = img.split()
+
+    for idx, new_img in enumerate(split_images):
+        section = new_img.sections[0]
+        if args.output_names and idx < len(args.output_names):
+            # User provided a list of names
+            name_policy = IdentityPolicy()
+            out_base = args.output_names[idx]
+        else:
+            # Default: append section number
+            name_policy = SuffixPolicy(suffix=f"_{idx:03d}")
+            out_base = base_prefix
+        
+        out_filename = build_filename(name_policy, out_base, output_ext)
+        
+        print(f"Writing '{out_filename}'...")
+        if args.verbose:
+            print(f"  Section {idx:03d} (0x{section.start_address:08x}, {len(section)} bytes)")
+            
+        dump(output_type, out_filename, new_img)
+
+    print(f"Successfully split into {len(split_images)} files.")
+
+
+if __name__ == "__main__":
+    main()

{objutils-0.10.11 → objutils-0.10.12}/objutils/section.py

@@ -1325,6 +1325,8 @@ def join_sections(sections: list[Section]) -> list[Section]:
             continue
 
         if section_start == last_end:
+            if isinstance(last_segment.data, bytes):
+                last_segment.data = bytearray(last_segment.data)
             last_segment.data.extend(section.data)
             continue
 
@@ -1342,6 +1344,8 @@ def join_sections(sections: list[Section]) -> list[Section]:
 
         if section_end > last_end:
             tail_offset = overlap_end - section_start
+            if isinstance(last_segment.data, bytes):
+                last_segment.data = bytearray(last_segment.data)
             last_segment.data.extend(section.data[tail_offset:])
 
     return result_sections

{objutils-0.10.11 → objutils-0.10.12}/objutils/version.py

@@ -1,3 +1,3 @@
 """objutils version module"""
 
-__version__ = "0.10.11"
+__version__ = "0.10.12"

{objutils-0.10.11 → objutils-0.10.12}/poetry.lock

@@ -902,31 +902,31 @@ jupyter = ["ipywidgets (>=7.5.1,<9)"]
 
 [[package]]
 name = "ruff"
-version = "0.15.20"
+version = "0.15.21"
 description = "An extremely fast Python linter and code formatter, written in Rust."
 optional = true
 python-versions = ">=3.7"
 groups = ["main"]
 markers = "extra == \"dev\""
 files = [
-    {file = "ruff-0.15.20-py3-none-linux_armv6l.whl", hash = "sha256:00e188c53e499c3c1637f73c91dcf2fb56d576cab76ce1be50a27c4e80e37078"},
-    {file = "ruff-0.15.20-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:9ebd1fd9b9c95fc0bd7b2761aebec1f030013d2e193a2901b224af68fe47251b"},
-    {file = "ruff-0.15.20-py3-none-macosx_11_0_arm64.whl", hash = "sha256:c5b16cdd67ca108185cd36dce98c576350c03b1660a751de725fb049193a0632"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3413bb3c3d2ca6a8208f1f4809cd2dca3c6de6d0b491c0e70847672bde6e6efd"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bd7ec42b3bb3da066488db093308a69c4ac5ee6d2af333a86ba6e2eb2e7dd44b"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e1a36ad0eb77fba9aabfb69ede54de6f376d04ac18ebea022847046d340a8267"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b6df3b1e4610432f0386dba04d853b5f08cbbc903410c6fcc02f620f05aff53c"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e89f198a1ea6ef0d727c1cf16088bc91a6cb0ab947dedc966715691647186eae"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:309809086c2acb67624950a3c8133e80f32d0d3e27106c0cd60ff26657c9f24b"},
-    {file = "ruff-0.15.20-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:2d2374caa2f2c2f9e2b7da0a50802cfb8b79f55a9b5e49379f564544fbf56487"},
-    {file = "ruff-0.15.20-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:a1ed17b65293e0c2f22fc387bc13198a5de94bf4429589b0ff6946b0feaf21a3"},
-    {file = "ruff-0.15.20-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:f701305e66b38ea6c91882490eb73459796808e4c6362a1b765255e0cdcd4053"},
-    {file = "ruff-0.15.20-py3-none-musllinux_1_2_i686.whl", hash = "sha256:5b9c0c367ad8e5d0d5b5b8537864c469a0a0e55417aadfbeca41fa61333be9f4"},
-    {file = "ruff-0.15.20-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:01cc00dd58f0df339d0e902219dd53990ea99996a0344e5d9cc8d45d5307e460"},
-    {file = "ruff-0.15.20-py3-none-win32.whl", hash = "sha256:ed65ef510e43a137207e0f01cfcf998aeddb1aeeda5c9d35023e910284d7cf21"},
-    {file = "ruff-0.15.20-py3-none-win_amd64.whl", hash = "sha256:a525c81c70fb0380344dd1d8745d8cc1c890b7fc94a58d5a07bd8eb9557b8415"},
-    {file = "ruff-0.15.20-py3-none-win_arm64.whl", hash = "sha256:2f5b2a6d614e8700388806a14996c40fab2c47b819ef57d790a34878858ed9ca"},
-    {file = "ruff-0.15.20.tar.gz", hash = "sha256:1416eb04349192646b54de98f146c4f59afe37d0decfc02c3cbbf396f3a28566"},
+    {file = "ruff-0.15.21-py3-none-linux_armv6l.whl", hash = "sha256:63ea0e965e5d73c90e95b2434beeafc70820536717f561b32ab6e777cb9bdf5d"},
+    {file = "ruff-0.15.21-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:0f212c5d7d54c01bbfe6dcab02b724a39300f3e34ed7acbe995ccb320a2c58bd"},
+    {file = "ruff-0.15.21-py3-none-macosx_11_0_arm64.whl", hash = "sha256:e6312e41bc96791299614995ea3a977c5857c3b5662b1ecef6755b02b87cb646"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:01d65b4831c6b2a4ba8ee6faa84049d44d982b7a706e622c4094c509e51673be"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2c5a913a589120ce67933d5d05fd6ddbcc2481c6a054980ee767f7414c72b4fd"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5ef04b681d02ad4dc9620f00f83ac5c22f652d0e9a9cfe431d219b16ad5ccc41"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:16d090c0740916594157e75b80d666eab8e78083b39b3b0e1d698f4670a17b86"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3a10e74757dd65004d779b73e2f3c5210156d9980b41224d50d2ebcf1db51e67"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bab0905d2f29e0d9fbc3c373ed23db0095edaa3f71f1f4f519ec15134d9e85c8"},
+    {file = "ruff-0.15.21-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:00eca240af5789fec6fe7df74c088cc1f9644ed83027113468efba7c92b94075"},
+    {file = "ruff-0.15.21-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:262ab31557a75141325e32d3357f3597645a7f084e732b6b054dde428ecd9341"},
+    {file = "ruff-0.15.21-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:659c4e7a4212f83306045ec7c5e5a356d16d9a6ef4ae0c7a4d872914fc655d9d"},
+    {file = "ruff-0.15.21-py3-none-musllinux_1_2_i686.whl", hash = "sha256:9e866eab611a5f959d36df2d10e446973a3610bc42b0c15b31dc27977d59c233"},
+    {file = "ruff-0.15.21-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:e89bc93c0d3803ba870b55c29671bad9dc6d94bb1eb181b056b52eb05b52854f"},
+    {file = "ruff-0.15.21-py3-none-win32.whl", hash = "sha256:01f8d5be84823c172b389e123174f781f9daf86d6c58719d603f941932195cdd"},
+    {file = "ruff-0.15.21-py3-none-win_amd64.whl", hash = "sha256:d4b8d9a2f0f12b816b50447f6eccb9f4bb01a6b82c86b50fb3b5354b458dc6d3"},
+    {file = "ruff-0.15.21-py3-none-win_arm64.whl", hash = "sha256:6e83115d4b9377c1cbc13abf0e051f069fab0ef815ea0504a8a008cee24dd0a8"},
+    {file = "ruff-0.15.21.tar.gz", hash = "sha256:d0cfc841c572283c36548f82664a54ce6565567f1b0d5b4cf2caac693d8b7500"},
 ]
 
 [[package]]
@@ -1135,17 +1135,29 @@ files = [
     {file = "typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5"},
 ]
 
+[[package]]
+name = "ufilename"
+version = "0.1.1"
+description = "A flexible filename generation library with various policies."
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "ufilename-0.1.1-py3-none-any.whl", hash = "sha256:5072a7a610032b1c5b5051eac459c35b51db987556596e40e24b50fcd4cc7039"},
+    {file = "ufilename-0.1.1.tar.gz", hash = "sha256:0f496e00fc6a55fc9028fc60fbcad17d6547a8a8457066c4e5ecd60a1a49880d"},
+]
+
 [[package]]
 name = "virtualenv"
-version = "21.6.0"
+version = "21.6.1"
 description = "Virtual Python Environment builder"
 optional = true
 python-versions = ">=3.9"
 groups = ["main"]
 markers = "extra == \"dev\""
 files = [
-    {file = "virtualenv-21.6.0-py3-none-any.whl", hash = "sha256:bce9d097950fef9d81129b333babfb7767072850c2f1acce0ec536708401bfd1"},
-    {file = "virtualenv-21.6.0.tar.gz", hash = "sha256:e18a4d750f2b64dea73e72ffde3922f3c52365fabdc8157ebd3da20d031c4734"},
+    {file = "virtualenv-21.6.1-py3-none-any.whl", hash = "sha256:afe991df855715a2b2f60edfcc0107ef95a79fdfd8cb4cdaa71603d1c12e463b"},
+    {file = "virtualenv-21.6.1.tar.gz", hash = "sha256:15f978b7cd329f24855ff4a0c4b4899cc7678589f49adbdcbbb4d3232e641128"},
 ]
 
 [package.dependencies]
@@ -1161,4 +1173,4 @@ dev = ["bandit", "black", "bumpver", "pre-commit", "pytest", "pyupgrade", "ruff"
 [metadata]
 lock-version = "2.1"
 python-versions = ">=3.10,<4.0"
-content-hash = "0a525288ffc901d447ac6e718157434113c4a65f28274321632311d6e1c107ba"
+content-hash = "fecb74c96cf3e09179cd46c4ddc5a4c17a2468e359067e3f23051ed9da8baacc"