PyCatFile 0.13.12__tar.gz → 0.14.0__tar.gz

{pycatfile-0.13.12 → pycatfile-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyCatFile
-Version: 0.13.12
+Version: 0.14.0
 Summary: A tar like file format name catfile after unix cat command (concatenate files) .
 Home-page: https://github.com/GameMaker2k/PyCatFile
 Download-URL: https://github.com/GameMaker2k/PyCatFile/archive/master.tar.gz

{pycatfile-0.13.12 → pycatfile-0.14.0}/PyCatFile.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: PyCatFile
-Version: 0.13.12
+Version: 0.14.0
 Summary: A tar like file format name catfile after unix cat command (concatenate files) .
 Home-page: https://github.com/GameMaker2k/PyCatFile
 Download-URL: https://github.com/GameMaker2k/PyCatFile/archive/master.tar.gz

pycatfile-0.14.0/catfile.py

@@ -0,0 +1,253 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+'''
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the Revised BSD License.
+
+    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
+    Revised BSD License for more details.
+
+    Copyright 2018-2024 Cool Dude 2k - http://idb.berlios.de/
+    Copyright 2018-2024 Game Maker 2k - http://intdb.sourceforge.net/
+    Copyright 2018-2024 Kazuki Przyborowski - https://github.com/KazukiPrzyborowski
+
+    $FileInfo: catfile.py - Last Update: 7/10/2024 Ver. 0.13.12 RC 1 - Author: cooldude2k $
+'''
+
+from __future__ import absolute_import, division, print_function, unicode_literals, generators, with_statement, nested_scopes
+import os
+import sys
+import argparse
+import pycatfile
+import binascii
+
+# Conditional import and signal handling for Unix-like systems
+if os.name != 'nt':  # Not Windows
+    import signal
+
+    def handler(signum, frame):
+        pycatfile.VerbosePrintOut(
+            "Received SIGPIPE, exiting gracefully.", "info")
+        sys.exit(0)
+signal.signal(signal.SIGPIPE, handler)
+
+rarfile_support = pycatfile.rarfile_support
+py7zr_support = pycatfile.py7zr_support
+
+if(sys.version[0] == "2"):
+    try:
+        from io import StringIO, BytesIO
+    except ImportError:
+        try:
+            from cStringIO import StringIO
+            from cStringIO import StringIO as BytesIO
+        except ImportError:
+            from StringIO import StringIO
+            from StringIO import StringIO as BytesIO
+elif(sys.version[0] >= "3"):
+    from io import StringIO, BytesIO
+else:
+    teststringio = 0
+    if(teststringio <= 0):
+        try:
+            from cStringIO import StringIO as BytesIO
+            teststringio = 1
+        except ImportError:
+            teststringio = 0
+    if(teststringio <= 0):
+        try:
+            from StringIO import StringIO as BytesIO
+            teststringio = 2
+        except ImportError:
+            teststringio = 0
+    if(teststringio <= 0):
+        try:
+            from io import BytesIO
+            teststringio = 3
+        except ImportError:
+            teststringio = 0
+
+__project__ = pycatfile.__project__
+__program_name__ = pycatfile.__program_name__
+__file_format_name__ = pycatfile.__file_format_name__
+__file_format_lower__ = pycatfile.__file_format_lower__
+__file_format_magic__ = pycatfile.__file_format_magic__
+__file_format_len__ = pycatfile.__file_format_len__
+__file_format_hex__ = pycatfile.__file_format_hex__
+__file_format_delimiter__ = pycatfile.__file_format_delimiter__
+__file_format_list__ = pycatfile.__file_format_list__
+__use_new_style__ = pycatfile.__use_new_style__
+__use_advanced_list__ = pycatfile.__use_advanced_list__
+__use_alt_inode__ = pycatfile.__use_alt_inode__
+__project_url__ = pycatfile.__project_url__
+__version_info__ = pycatfile.__version_info__
+__version_date_info__ = pycatfile.__version_date_info__
+__version_date__ = pycatfile.__version_date__
+__version_date_plusrc__ = pycatfile.__version_date_plusrc__
+__version__ = pycatfile.__version__
+
+# Initialize the argument parser
+argparser = argparse.ArgumentParser(
+    description="Manipulate concatenated files.", conflict_handler="resolve", add_help=True)
+
+# Version information
+argparser.add_argument("-V", "--version", action="version",
+                       version=__program_name__ + " " + __version__)
+# Input and output specifications
+argparser.add_argument(
+    "-i", "--input", help="Specify the file(s) to concatenate or the concatenated file to extract.", required=True)
+argparser.add_argument("-o", "--output", default=None,
+                       help="Specify the name for the extracted or output concatenated 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 concatenated file.")
+argparser.add_argument("-r", "--repack", action="store_true",
+                       help="Re-concatenate files, fixing checksum errors if any.")
+# File manipulation options
+argparser.add_argument(
+    "-F", "--format", default=__file_format_list__[0], help="Specify the format to use.")
+argparser.add_argument(
+    "-D", "--delimiter", default=__file_format_list__[5], help="Specify the delimiter to use.")
+argparser.add_argument(
+    "-m", "--formatver", default=__file_format_list__[6], help="Specify the format version.")
+argparser.add_argument("-l", "--list", action="store_true",
+                       help="List files included in the concatenated 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.")
+# Checksum and validation
+argparser.add_argument("-v", "--validate", action="store_true",
+                       help="Validate concatenated 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.")
+# 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.")
+# Parse the arguments
+getargs = argparser.parse_args()
+
+fname = getargs.format
+fnamelower = fname.lower()
+fnamemagic = fname
+fnamelen = len(fname)
+fnamehex = binascii.hexlify(fname.encode("UTF-8")).decode("UTF-8")
+fnamesty = __use_new_style__
+fnamelst = __use_advanced_list__
+fnameino = __use_alt_inode__
+fnamelist = [fname, fnamemagic, fnamelower, fnamelen, fnamehex,
+             getargs.delimiter, getargs.formatver, fnamesty, fnamelst, fnameino]
+fnamedict = {'format_name': fname, 'format_magic': fnamemagic, 'format_lower': fnamelower, 'format_len': fnamelen, 'format_hex': fnamehex,
+             'format_delimiter': getargs.delimiter, 'format_ver': getargs.formatver, 'new_style': fnamesty, 'use_advanced_list': fnamelst, 'use_alt_inode': fnameino}
+
+# Determine the primary action based on user input
+actions = ['create', 'extract', 'list', 'repack', 'validate']
+active_action = next(
+    (action for action in actions if getattr(getargs, action)), None)
+
+# Execute the appropriate functions based on determined actions and arguments
+if active_action:
+    if active_action == 'create':
+        if getargs.convert:
+            checkcompressfile = pycatfile.CheckCompressionSubType(
+                getargs.input, fnamedict, True)
+            if(checkcompressfile == "catfile"):
+                tmpout = pycatfile.RePackArchiveFile(getargs.input, getargs.output, getargs.compression, getargs.wholefile,
+                                                     getargs.level, False, 0, 0, getargs.checksum, getargs.skipchecksum, [], fnamedict, getargs.verbose, False)
+            else:
+                tmpout = pycatfile.PackArchiveFileFromInFile(
+                    getargs.input, getargs.output, getargs.compression, getargs.wholefile, getargs.level, getargs.checksum, [], fnamedict, getargs.verbose, False)
+            if(not tmpout):
+                sys.exit(1)
+        else:
+            pycatfile.PackArchiveFile(getargs.input, getargs.output, getargs.text, getargs.compression,
+                                      getargs.wholefile, getargs.level, False, getargs.checksum, [], fnamedict, getargs.verbose, False)
+    elif active_action == 'repack':
+        if getargs.convert:
+            checkcompressfile = pycatfile.CheckCompressionSubType(
+                getargs.input, fnamedict, True)
+            if(checkcompressfile == "catfile"):
+                pycatfile.RePackArchiveFile(getargs.input, getargs.output, getargs.compression, getargs.wholefile, getargs.level,
+                                            False, 0, 0, getargs.checksum, getargs.skipchecksum, [], fnamedict, getargs.verbose, False)
+            else:
+                pycatfile.PackArchiveFileFromInFile(getargs.input, getargs.output, getargs.compression,
+                                                    getargs.wholefile, getargs.level, getargs.checksum, [], fnamedict, getargs.verbose, False)
+            if(not tmpout):
+                sys.exit(1)
+        else:
+            pycatfile.RePackArchiveFile(getargs.input, getargs.output, getargs.compression, getargs.wholefile, getargs.level,
+                                        False, 0, 0, getargs.checksum, getargs.skipchecksum, [], fnamedict, getargs.verbose, False)
+    elif active_action == 'extract':
+        if getargs.convert:
+            checkcompressfile = pycatfile.CheckCompressionSubType(
+                getargs.input, fnamedict, True)
+            tempout = BytesIO()
+            if(checkcompressfile == "catfile"):
+                tmpout = pycatfile.RePackArchiveFile(getargs.input, tempout, getargs.compression, getargs.wholefile,
+                                                     getargs.level, False, 0, 0, getargs.checksum, getargs.skipchecksum, [], fnamedict, False, False)
+            else:
+                tmpout = pycatfile.PackArchiveFileFromInFile(
+                    getargs.input, tempout, getargs.compression, getargs.wholefile, getargs.level, getargs.checksum, [], fnamedict, False, False)
+            if(not tmpout):
+                sys.exit(1)
+            getargs.input = tempout
+        pycatfile.UnPackArchiveFile(getargs.input, getargs.output, False, 0, 0, getargs.skipchecksum,
+                                    fnamedict, getargs.verbose, getargs.preserve, getargs.preserve, False)
+    elif active_action == 'list':
+        if getargs.convert:
+            checkcompressfile = pycatfile.CheckCompressionSubType(
+                getargs.input, fnamedict, True)
+            if(checkcompressfile == "catfile"):
+                tmpout = pycatfile.ArchiveFileListFiles(
+                    getargs.input, 0, 0, getargs.skipchecksum, fnamedict, getargs.verbose, False)
+            else:
+                tmpout = pycatfile.InFileListFiles(
+                    getargs.input, getargs.verbose, fnamedict, False)
+            if(not tmpout):
+                sys.exit(1)
+        else:
+            pycatfile.ArchiveFileListFiles(
+                getargs.input, 0, 0, getargs.skipchecksum, fnamedict, getargs.verbose, False)
+    elif active_action == 'validate':
+        if getargs.convert:
+            checkcompressfile = pycatfile.CheckCompressionSubType(
+                getargs.input, fnamedict, True)
+            tempout = BytesIO()
+            if(checkcompressfile == "catfile"):
+                tmpout = pycatfile.RePackArchiveFile(getargs.input, tempout, getargs.compression, getargs.wholefile,
+                                                     getargs.level, False, 0, 0, getargs.checksum, getargs.skipchecksum, [], fnamedict, False, False)
+            else:
+                tmpout = pycatfile.PackArchiveFileFromInFile(
+                    getargs.input, tempout, getargs.compression, getargs.wholefile, getargs.level, getargs.checksum, [], fnamedict, False, False)
+            getargs.input = tempout
+            if(not tmpout):
+                sys.exit(1)
+        fvalid = pycatfile.ArchiveFileValidate(
+            getargs.input, fnamedict, getargs.verbose, False)
+        if(not getargs.verbose):
+            import sys
+            import logging
+            logging.basicConfig(format="%(message)s",
+                                stream=sys.stdout, level=logging.DEBUG)
+        if(fvalid):
+            pycatfile.VerbosePrintOut("File is valid: \n" + str(getargs.input))
+        else:
+            pycatfile.VerbosePrintOut(
+                "File is invalid: \n" + str(getargs.input))

pycatfile-0.14.0/neocatfile.py

@@ -0,0 +1,117 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+'''
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the Revised BSD License.
+
+    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
+    Revised BSD License for more details.
+
+    Copyright 2018-2024 Cool Dude 2k - http://idb.berlios.de/
+    Copyright 2018-2024 Game Maker 2k - http://intdb.sourceforge.net/
+    Copyright 2018-2024 Kazuki Przyborowski - https://github.com/KazukiPrzyborowski
+
+    $FileInfo: neocatfile.py - Last Update: 7/10/2024 Ver. 0.13.12 RC 1 - Author: cooldude2k $
+'''
+
+from __future__ import absolute_import, division, print_function, unicode_literals, generators, with_statement, nested_scopes
+import argparse
+import pycatfile
+
+# Compatibility layer for Python 2 and 3 input
+try:
+    input = raw_input
+except NameError:
+    pass
+
+# Determine if rar file support is enabled
+rarfile_support = pycatfile.rarfile_support
+py7zr_support = pycatfile.py7zr_support
+
+# Set up the argument parser
+argparser = argparse.ArgumentParser(
+    description="Manipulates concatenated files for various operations like creation, extraction, and validation.")
+argparser.add_argument("-V", "--version", action="version", version="{0} {1}".format(
+    pycatfile.__program_name__, pycatfile.__version__), help="Displays the program's version.")
+argparser.add_argument("-i", "--input", required=True,
+                       help="Specifies input file(s) for processing.")
+argparser.add_argument(
+    "-o", "--output", help="Specifies the output file name.")
+argparser.add_argument("-d", "--verbose", action="store_true",
+                       help="Enables verbose mode for detailed information.")
+argparser.add_argument("-c", "--create", action="store_true",
+                       help="Creates a new concatenated file from input.")
+argparser.add_argument("-e", "--extract", action="store_true",
+                       help="Extracts files from a concatenated archive.")
+argparser.add_argument("-l", "--list", action="store_true",
+                       help="Lists contents of a specified concatenated file.")
+argparser.add_argument("-r", "--repack", action="store_true",
+                       help="Repacks an existing concatenated file.")
+argparser.add_argument("-v", "--validate", action="store_true",
+                       help="Validates a concatenated file's integrity.")
+argparser.add_argument("--checksum", default="crc32",
+                       help="Specifies the checksum type (default: crc32).")
+argparser.add_argument("--compression", default="auto",
+                       help="Specifies the compression method (default: auto).")
+argparser.add_argument("--level", help="Specifies the compression level.")
+argparser.add_argument("--preserve", action="store_true",
+                       help="Preserves file attributes when extracting.")
+argparser.add_argument("--convert", choices=['tar', 'zip', '7zip', 'rar'],
+                       help="Convert from an archive format (tar, zip, 7zip, rar) to a concatenated file.")
+args = argparser.parse_args()
+
+# Determine the primary action based on user input
+primary_action = None
+if args.create:
+    primary_action = 'create'
+elif args.repack:
+    primary_action = 'repack'
+elif args.extract:
+    primary_action = 'extract'
+elif args.list:
+    primary_action = 'list'
+elif args.validate:
+    primary_action = 'validate'
+
+# Functionality mappings
+if primary_action == 'create':
+    if args.convert == 'tar':
+        pycatfile.PackArchiveFileFromTarFile(args.input, args.output, args.compression, args.level, args.checksum, [
+        ], pycatfile.__file_format_list__, args.verbose, False)
+    elif args.convert == 'zip':
+        pycatfile.PackArchiveFileFromZipFile(args.input, args.output, args.compression, args.level, args.checksum, [
+        ], pycatfile.__file_format_list__, args.verbose, False)
+    elif py7zr_support and args.convert == '7zip':
+        pycatfile.PackArchiveFileFromSevenZipFile(args.input, args.output, args.compression, args.level, args.checksum, [
+        ], pycatfile.__file_format_list__, args.verbose, False)
+    elif rarfile_support and args.convert == 'rar':
+        pycatfile.PackArchiveFileFromRarFile(args.input, args.output, args.compression, args.level, args.checksum, [
+        ], pycatfile.__file_format_list__, args.verbose, False)
+    else:
+        pycatfile.PackArchiveFile(args.input, args.output, args.verbose, args.compression, args.level,
+                                  False, args.checksum, [], pycatfile.__file_format_list__, args.verbose, False)
+elif primary_action == 'repack':
+    pycatfile.RePackArchiveFile(
+        args.input, args.output, args.compression, args.level, args.checksum, args.verbose)
+elif primary_action == 'extract':
+    pycatfile.UnPackArchiveFile(
+        args.input, args.output, args.verbose, args.preserve)
+elif primary_action == 'list':
+    if args.convert == 'tar':
+        pycatfile.TarFileListFiles(args.input, verbose=args.verbose)
+    elif args.convert == 'zip':
+        pycatfile.ZipFileListFiles(args.input, verbose=args.verbose)
+    elif args.convert == '7zip':
+        pycatfile.SevenZipFileListFiles(args.input, verbose=args.verbose)
+    elif rarfile_support and args.convert == 'rar':
+        pycatfile.RarFileListFiles(args.input, verbose=args.verbose)
+    else:
+        pycatfile.ArchiveFileListFiles(args.input, verbose=args.verbose)
+elif primary_action == 'validate':
+    is_valid = pycatfile.ArchiveFileValidate(args.input, args.verbose)
+    result_msg = "Validation result for {0}: {1}".format(
+        args.input, 'Valid' if is_valid else 'Invalid')
+    print(result_msg)