PyFoxFile 0.19.6__tar.gz → 0.24.4__tar.gz

{pyfoxfile-0.19.6 → pyfoxfile-0.24.4}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: PyFoxFile
-Version: 0.19.6
-Summary: A tar like file format name foxfile.
+Version: 0.24.4
+Summary: A tar like file format name archivefile.
 Home-page: https://github.com/GameMaker2k/PyFoxFile
 Download-URL: https://github.com/GameMaker2k/PyFoxFile/archive/master.tar.gz
-Author: Kazuki Przyborowski
-Author-email: Kazuki Przyborowski <kazuki.przyborowski@gmail.com>
-Maintainer: Kazuki Przyborowski
-Maintainer-email: kazuki.przyborowski@gmail.com
+Author: Kazuhana Neko-chan
+Author-email: Kazuhika Kitsune-chan <kazuki.suzuki.fox@gmail.com>, Kazuhana Neko-chan <kazuki.suzuki.cat@gmail.com>, Kazuki Neko-kun <kazuki.suzuki.wa@gmail.com>, Game Maker 2k <gamemaker2k@gmail.com>
+Maintainer: Kazuhika Kitsune-chan
+Maintainer-email: kazuki.suzuki.fox@gmail.com
 License: BSD-3-Clause
 Platform: OS Independent
 Description-Content-Type: text/markdown

{pyfoxfile-0.19.6 → pyfoxfile-0.24.4}/PyFoxFile.egg-info/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: PyFoxFile
-Version: 0.19.6
-Summary: A tar like file format name foxfile.
+Version: 0.24.4
+Summary: A tar like file format name archivefile.
 Home-page: https://github.com/GameMaker2k/PyFoxFile
 Download-URL: https://github.com/GameMaker2k/PyFoxFile/archive/master.tar.gz
-Author: Kazuki Przyborowski
-Author-email: Kazuki Przyborowski <kazuki.przyborowski@gmail.com>
-Maintainer: Kazuki Przyborowski
-Maintainer-email: kazuki.przyborowski@gmail.com
+Author: Kazuhana Neko-chan
+Author-email: Kazuhika Kitsune-chan <kazuki.suzuki.fox@gmail.com>, Kazuhana Neko-chan <kazuki.suzuki.cat@gmail.com>, Kazuki Neko-kun <kazuki.suzuki.wa@gmail.com>, Game Maker 2k <gamemaker2k@gmail.com>
+Maintainer: Kazuhika Kitsune-chan
+Maintainer-email: kazuki.suzuki.fox@gmail.com
 License: BSD-3-Clause
 Platform: OS Independent
 Description-Content-Type: text/markdown

{pyfoxfile-0.19.6 → pyfoxfile-0.24.4}/PyFoxFile.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 LICENSE
 README.md
 foxfile.py
+foxneofile.py
 neofoxfile.py
 pyfoxfile.py
 pyproject.toml

{pyfoxfile-0.19.6 → pyfoxfile-0.24.4}/foxfile.py

@@ -14,7 +14,7 @@
     Copyright 2018-2024 Game Maker 2k - http://intdb.sourceforge.net/
     Copyright 2018-2024 Kazuki Przyborowski - https://github.com/KazukiPrzyborowski
 
-    $FileInfo: foxfile.py - Last Update: 3/7/2025 Ver. 0.19.4 RC 1 - Author: cooldude2k $
+    $FileInfo: foxfile.py - Last Update: 11/3/2025 Ver. 0.24.4 RC 1 - Author: cooldude2k $
 '''
 
 from __future__ import absolute_import, division, print_function, unicode_literals, generators, with_statement, nested_scopes
@@ -91,57 +91,37 @@ __version_date_plusrc__ = pyfoxfile.__version_date_plusrc__
 __version__ = pyfoxfile.__version__
 
 # Initialize the argument parser
-argparser = argparse.ArgumentParser(
-    description="Manipulate archive files.", conflict_handler="resolve", add_help=True)
+argparser = argparse.ArgumentParser(description="Manipulate archive files.", conflict_handler="resolve", add_help=True)
 
 # Version information
-argparser.add_argument("-V", "--version", action="version",
-                       version=__program_name__ + " " + __version__)
+argparser.add_argument("-V", "--version", action="version", version=__program_name__ + " " + __version__)
 # Input and output specifications
-argparser.add_argument(
-    "-i", "--input", nargs="+", help="Specify the file(s) to concatenate or the archive file to extract.", required=True)
-argparser.add_argument("-o", "--output", default=None,
-                       help="Specify the name for the extracted or output archive files.")
+argparser.add_argument("-i", "--input", nargs="+", help="Specify the file(s) to concatenate or the archive file to extract.", required=True)
+argparser.add_argument("-o", "--output", default=None, help="Specify the name for the extracted or output archive files.")
 # Operations
-argparser.add_argument("-c", "--create", action="store_true",
-                       help="Perform only the concatenation operation.")
-argparser.add_argument("-e", "--extract", action="store_true",
-                       help="Perform only the extraction operation.")
-argparser.add_argument("-t", "--convert", action="store_true",
-                       help="Convert a tar/zip/rar/7zip file to a archive file.")
-argparser.add_argument("-r", "--repack", action="store_true",
-                       help="Re-concatenate files, fixing checksum errors if any.")
+argparser.add_argument("-c", "--create", action="store_true", help="Perform only the concatenation operation.")
+argparser.add_argument("-e", "--extract", action="store_true", help="Perform only the extraction operation.")
+argparser.add_argument("-t", "--convert", action="store_true", help="Convert a tar/zip/rar/7zip file to a archive file.")
+argparser.add_argument("-r", "--repack", action="store_true", help="Re-concatenate files, fixing checksum errors if any.")
+argparser.add_argument("-S", "--filestart", type=int, default=0, help="Start reading file at.")
 # File manipulation options
-argparser.add_argument(
-    "-F", "--format", default="auto", help="Specify the format to use.")
-argparser.add_argument(
-    "-D", "--delimiter", default=__file_format_dict__['format_delimiter'], help="Specify the delimiter to use.")
-argparser.add_argument(
-    "-m", "--formatver", default=__file_format_dict__['format_ver'], help="Specify the format version.")
-argparser.add_argument("-l", "--list", action="store_true",
-                       help="List files included in the archive file.")
+argparser.add_argument("-F", "--format", default="auto", help="Specify the format to use.")
+argparser.add_argument("-D", "--delimiter", default=__file_format_dict__['format_delimiter'], help="Specify the delimiter to use.")
+argparser.add_argument("-m", "--formatver", default=__file_format_dict__['format_ver'], help="Specify the format version.")
+argparser.add_argument("-l", "--list", action="store_true", help="List files included in the archive file.")
 # Compression options
-argparser.add_argument("-P", "--compression", default="auto",
-                       help="Specify the compression method to use for concatenation.")
-argparser.add_argument("-L", "--level", default=None,
-                       help="Specify the compression level for concatenation.")
-argparser.add_argument("-W", "--wholefile", action="store_true",
-                       help="Whole file compression method to use for concatenation.")
+argparser.add_argument("-P", "--compression", default="auto", help="Specify the compression method to use for concatenation.")
+argparser.add_argument("-L", "--level", default=None, help="Specify the compression level for concatenation.")
+argparser.add_argument("-W", "--wholefile", action="store_true", help="Whole file compression method to use for concatenation.")
 # Checksum and validation
-argparser.add_argument("-v", "--validate", action="store_true",
-                       help="Validate archive file checksums.")
-argparser.add_argument("-C", "--checksum", default="crc32",
-                       help="Specify the type of checksum to use. The default is crc32.")
-argparser.add_argument("-s", "--skipchecksum", action="store_true",
-                       help="Skip the checksum check of files.")
+argparser.add_argument("-v", "--validate", action="store_true", help="Validate archive file checksums.")
+argparser.add_argument("-C", "--checksum", default="crc32", help="Specify the type of checksum to use. The default is crc32.")
+argparser.add_argument("-s", "--skipchecksum", action="store_true", help="Skip the checksum check of files.")
 # Permissions and metadata
-argparser.add_argument("-p", "--preserve", action="store_false",
-                       help="Do not preserve permissions and timestamps of files.")
+argparser.add_argument("-p", "--preserve", action="store_false", help="Do not preserve permissions and timestamps of files.")
 # Miscellaneous
-argparser.add_argument("-d", "--verbose", action="store_true",
-                       help="Enable verbose mode to display various debugging information.")
-argparser.add_argument("-T", "--text", action="store_true",
-                       help="Read file locations from a text file.")
+argparser.add_argument("-d", "--verbose", action="store_true", help="Enable verbose mode to display various debugging information.")
+argparser.add_argument("-T", "--text", action="store_true", help="Read file locations from a text file.")
 # Parse the arguments
 getargs = argparser.parse_args()
 
@@ -172,8 +152,8 @@ if active_action:
         if getargs.convert:
             checkcompressfile = pyfoxfile.CheckCompressionSubType(
                 input_file, fnamedict, True)
-            if((IsNestedDict(fnamedict) and compresscheck in fnamedict) or (IsSingleDict(fnamedict) and compresscheck==fnamedict['format_magic'])):
-                tmpout = pyfoxfile.RePackFoxFile(input_file, getargs.output, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, False, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, getargs.verbose, False)
+            if((pyfoxfile.IsNestedDict(fnamedict) and checkcompressfile in fnamedict) or (pyfoxfile.IsSingleDict(fnamedict) and checkcompressfile==fnamedict['format_magic'])):
+                tmpout = pyfoxfile.RePackFoxFile(input_file, getargs.output, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, False, getargs.filestart, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, getargs.verbose, False)
             else:
                 tmpout = pyfoxfile.PackFoxFileFromInFile(
                     input_file, getargs.output, __file_format_default__, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], [], {}, fnamedict, getargs.verbose, False)
@@ -185,58 +165,58 @@ if active_action:
         if getargs.convert:
             checkcompressfile = pyfoxfile.CheckCompressionSubType(
                 input_file, fnamedict, True)
-            if((IsNestedDict(fnamedict) and compresscheck in fnamedict) or (IsSingleDict(fnamedict) and compresscheck==fnamedict['format_magic'])):
+            if((pyfoxfile.IsNestedDict(fnamedict) and checkcompressfile in fnamedict) or (pyfoxfile.IsSingleDict(fnamedict) and checkcompressfile==fnamedict['format_magic'])):
                 pyfoxfile.RePackFoxFile(input_file, getargs.output, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt,
-                                            False, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, getargs.verbose, False)
+                                            False, getargs.filestart, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, getargs.verbose, False)
             else:
                 pyfoxfile.PackFoxFileFromInFile(input_file, getargs.output, __file_format_default__, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], [], {}, fnamedict, getargs.verbose, False)
             if(not tmpout):
                 sys.exit(1)
         else:
             pyfoxfile.RePackFoxFile(input_file, getargs.output, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt,
-                                        False, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, getargs.verbose, False)
+                                        False, getargs.filestart, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, getargs.verbose, False)
     elif active_action == 'extract':
         if getargs.convert:
             checkcompressfile = pyfoxfile.CheckCompressionSubType(
                 input_file, fnamedict, True)
             tempout = BytesIO()
-            if((IsNestedDict(fnamedict) and compresscheck in fnamedict) or (IsSingleDict(fnamedict) and compresscheck==fnamedict['format_magic'])):
-                tmpout = pyfoxfile.RePackFoxFile(input_file, tempout, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, False, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, False, False)
+            if((pyfoxfile.IsNestedDict(fnamedict) and checkcompressfile in fnamedict) or (pyfoxfile.IsSingleDict(fnamedict) and checkcompressfile==fnamedict['format_magic'])):
+                tmpout = pyfoxfile.RePackFoxFile(input_file, tempout, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, False, getargs.filestart, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, False, False)
             else:
                 tmpout = pyfoxfile.PackFoxFileFromInFile(
                     input_file, tempout, __file_format_default__, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], [], {}, fnamedict, False, False)
             if(not tmpout):
                 sys.exit(1)
             input_file = tempout
-        pyfoxfile.UnPackFoxFile(input_file, getargs.output, False, 0, 0, getargs.skipchecksum,
+        pyfoxfile.UnPackFoxFile(input_file, getargs.output, False, getargs.filestart, 0, 0, getargs.skipchecksum,
                                     fnamedict, getargs.verbose, getargs.preserve, getargs.preserve, False, False)
     elif active_action == 'list':
         if getargs.convert:
             checkcompressfile = pyfoxfile.CheckCompressionSubType(
                 input_file, fnamedict, True)
-            if((IsNestedDict(fnamedict) and compresscheck in fnamedict) or (IsSingleDict(fnamedict) and compresscheck==fnamedict['format_magic'])):
-                tmpout = pyfoxfile.FoxFileListFiles(input_file, "auto", 0, 0, getargs.skipchecksum, fnamedict, False, getargs.verbose, False)
+            if((pyfoxfile.IsNestedDict(fnamedict) and checkcompressfile in fnamedict) or (pyfoxfile.IsSingleDict(fnamedict) and checkcompressfile==fnamedict['format_magic'])):
+                tmpout = pyfoxfile.FoxFileListFiles(input_file, "auto", getargs.filestart, 0, 0, getargs.skipchecksum, fnamedict, False, getargs.verbose, False, False)
             else:
-                tmpout = pyfoxfile.InFileListFiles(input_file, getargs.verbose, fnamedict, False, False)
+                tmpout = pyfoxfile.InFileListFiles(input_file, getargs.verbose, fnamedict, False, False, False)
             if(not tmpout):
                 sys.exit(1)
         else:
-            pyfoxfile.FoxFileListFiles(input_file, "auto", 0, 0, getargs.skipchecksum, fnamedict, False, getargs.verbose, False)
+            pyfoxfile.FoxFileListFiles(input_file, "auto", getargs.filestart, 0, 0, getargs.skipchecksum, fnamedict, False, getargs.verbose, False, False)
     elif active_action == 'validate':
         if getargs.convert:
             checkcompressfile = pyfoxfile.CheckCompressionSubType(
                 input_file, fnamedict, True)
             tempout = BytesIO()
-            if((IsNestedDict(fnamedict) and compresscheck in fnamedict) or (IsSingleDict(fnamedict) and compresscheck==fnamedict['format_magic'])):
-                tmpout = pyfoxfile.RePackFoxFile(input_file, tempout, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, False, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, False, False, False)
+            if((pyfoxfile.IsNestedDict(fnamedict) and checkcompressfile in fnamedict) or (pyfoxfile.IsSingleDict(fnamedict) and checkcompressfile==fnamedict['format_magic'])):
+                tmpout = pyfoxfile.RePackFoxFile(input_file, tempout, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, False, getargs.filestart, 0, 0, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], getargs.skipchecksum, [], {}, fnamedict, False, False, False)
             else:
                 tmpout = pyfoxfile.PackFoxFileFromInFile(
                     input_file, tempout, __file_format_default__, getargs.compression, getargs.wholefile, getargs.level, pyfoxfile.compressionlistalt, [getargs.checksum, getargs.checksum, getargs.checksum, getargs.checksum], [], {}, fnamedict, False, False)
             input_file = tempout
             if(not tmpout):
                 sys.exit(1)
-        fvalid = pyfoxfile.FoxFileValidate(
-            input_file, "auto", fnamedict, False, getargs.verbose, False)
+        fvalid = pyfoxfile.StackedFoxFileValidate(
+            input_file, "auto", getargs.filestart, fnamedict, False, getargs.verbose, False)
         if(not getargs.verbose):
             import sys
             import logging

pyfoxfile-0.24.4/foxneofile.py

@@ -0,0 +1,130 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+from __future__ import absolute_import, division, print_function, unicode_literals
+
+import sys, os, io, argparse
+
+try:
+    import pyfoxfile as P  # core must provide *_neo functions
+except Exception as e:
+    sys.stderr.write("Failed to import core module 'pyfoxfile': %s\n" % (e,))
+    sys.exit(2)
+
+
+def _expand_combined_short_opts(argv):
+    out = [argv[0]]
+    i = 1
+    while i < len(argv):
+        a = argv[i]
+        if a.startswith("--") or not (a.startswith("-") and len(a) > 2):
+            out.append(a); i += 1; continue
+        for ch in a[1:]:
+            out.append("-" + ch)
+        i += 1
+    return out
+
+
+def main():
+    argv = _expand_combined_short_opts(sys.argv)
+
+    p = argparse.ArgumentParser(
+        description="PyNeoFile CLI (uses pyfoxfile core)")
+    g = p.add_mutually_exclusive_group(required=True)
+    g.add_argument("-l", "--list", action="store_true", help="List archive")
+    g.add_argument("-e", "--extract", action="store_true", help="Extract archive")
+    g.add_argument("-c", "--create", action="store_true", help="Create archive from path")
+    g.add_argument("-r", "--repack", action="store_true", help="Repack (recompress) an archive")
+    g.add_argument("-E", "--empty", action="store_true", help="Create an empty archive")
+
+    p.add_argument("-i", "--input", help="Input file/path", nargs="*")
+    p.add_argument("-o", "--output", help="Output file/dir (or '-' for stdout)")
+    p.add_argument("-d", "--verbose", action="store_true", help="Verbose/detailed listing")
+    p.add_argument("-P", "--compression", default="auto", help="Compression algo (auto, none, zlib, gzip, bz2, lzma)")
+    p.add_argument("-L", "--level", type=int, default=None, help="Compression level/preset")
+    p.add_argument("--checksum", default="crc32", help="Checksum type for header/content/json (default: crc32)")
+
+    args = p.parse_args(argv[1:])
+
+    src = None
+    if args.input:
+        if isinstance(args.input, list) and len(args.input) == 1:
+            src = args.input[0]
+        elif isinstance(args.input, list) and len(args.input) > 1:
+            src = args.input[0]
+        else:
+            src = args.input
+
+    if args.empty:
+        dst = args.output or "-"
+        blob_or_true = P.make_empty_file_neo(dst, fmttype="auto", checksumtype=args.checksum, encoding="UTF-8", returnfp=False)
+        if dst in (None, "-"):
+            data = blob_or_true if isinstance(blob_or_true, (bytes, bytearray)) else b""
+            if hasattr(sys.stdout, "buffer"):
+                sys.stdout.buffer.write(data)
+            else:
+                sys.stdout.write(data.decode("latin1"))
+        return 0
+
+    if args.list:
+        if not src:
+            p.error("list requires -i <archive>")
+        P.archivefilelistfiles_neo(src, advanced=args.verbose, include_dirs=True)
+        return 0
+
+    if args.extract:
+        if not src:
+            p.error("extract requires -i <archive>")
+        outdir = args.output or "."
+        ok = P.unpack_neo(src, outdir, skipchecksum=False, uncompress=True)
+        return 0 if ok else 1
+
+    if args.create:
+        if not src:
+            p.error("create requires -i <path>")
+        if args.verbose:
+            walkroot = src
+            if os.path.isdir(walkroot):
+                print(walkroot)
+                for root, dirs, files in os.walk(walkroot):
+                    relroot = root if root.startswith("./") else "./" + root.replace("\\", "/")
+                    if root != walkroot:
+                        print(relroot)
+                    for name in sorted(files):
+                        path = os.path.join(root, name).replace("\\", "/")
+                        if not path.startswith("./"):
+                            path = "./" + path
+                        print(path)
+            else:
+                path = src if src.startswith("./") else "./" + src
+                print(path)
+
+        outpath = args.output or "-"
+        ok = P.pack_neo(src, outpath, checksumtypes=(args.checksum,args.checksum,args.checksum,args.checksum),
+                        encoding="UTF-8", compression=args.compression, compression_level=args.level)
+        if outpath in (None, "-") and isinstance(ok, (bytes, bytearray)):
+            if hasattr(sys.stdout, "buffer"):
+                sys.stdout.buffer.write(ok)
+            else:
+                sys.stdout.write(ok.decode("latin1"))
+            return 0
+        return 0 if ok else 1
+
+    if args.repack:
+        if not src:
+            p.error("repack requires -i <archive>")
+        outpath = args.output or "-"
+        ok = P.repack_neo(src, outpath, checksumtypes=(args.checksum,args.checksum,args.checksum,args.checksum),
+                          compression=args.compression, compression_level=args.level)
+        if outpath in (None, "-") and isinstance(ok, (bytes, bytearray)):
+            if hasattr(sys.stdout, "buffer"):
+                sys.stdout.buffer.write(ok)
+            else:
+                sys.stdout.write(ok.decode("latin1"))
+            return 0
+        return 0 if ok else 1
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{pyfoxfile-0.19.6 → pyfoxfile-0.24.4}/neofoxfile.py

@@ -14,7 +14,7 @@
     Copyright 2018-2024 Game Maker 2k - http://intdb.sourceforge.net/
     Copyright 2018-2024 Kazuki Przyborowski - https://github.com/KazukiPrzyborowski
 
-    $FileInfo: neofoxfile.py - Last Update: 3/7/2025 Ver. 0.19.0 RC 1 - Author: cooldude2k $
+    $FileInfo: neofoxfile.py - Last Update: 8/26/2025 Ver. 0.21.4 RC 1 - Author: cooldude2k $
 '''
 
 from __future__ import absolute_import, division, print_function, unicode_literals, generators, with_statement, nested_scopes