tinytag 2.3.0__tar.gz → 2.3.1__tar.gz

tinytag-2.3.1/.editorconfig

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2025 tinytag Contributors
+# SPDX-License-Identifier: MIT
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+max_line_length = 79
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+indent_size = 2

tinytag-2.3.1/CONTRIBUTING.md

@@ -0,0 +1,24 @@
+<!--
+  SPDX-FileCopyrightText: 2026 tinytag Contributors
+  SPDX-License-Identifier: MIT
+-->
+
+# Contributing
+
+Before submitting a PR, please discuss the change you wish to make in an issue
+report or discussion thread, in order to see if it fits the direction of the
+project. If you skip this step, a PR containing anything other than a trivial
+bug fix will likely be rejected.
+
+Contributions generated or co-authored by LLMs or AI coding tools are not
+allowed. Your contribution must be licensed as original work that is personally
+authored by you under the terms of the
+[MIT License](https://github.com/tinytag/tinytag/blob/HEAD/LICENSE).
+Every part of your contribution must be written, thoroughly tested and fully
+understood by you so that any queries about the logic of your contribution can
+be answered during the review process.
+
+You may only use AI assistants or tooling for learning purposes, including
+guided research of the codebase and exploring concepts. Your contribution must
+not include any content produced by generative AI (code, text snippets, images
+nor other media).

tinytag-2.3.1/LICENSES/CC0-1.0.txt

@@ -0,0 +1,121 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
+    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
+    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
+    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
+    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
+    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
+    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
+    HEREUNDER.
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator
+and subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for
+the purpose of contributing to a commons of creative, cultural and
+scientific works ("Commons") that the public can reliably and without fear
+of later claims of infringement build upon, modify, incorporate in other
+works, reuse and redistribute as freely as possible in any form whatsoever
+and for any purposes, including without limitation commercial purposes.
+These owners may contribute to the Commons to promote the ideal of a free
+culture and the further production of creative, cultural and scientific
+works, or to gain reputation or greater distribution for their Work in
+part through the use and efforts of others.
+
+For these and/or other purposes and motivations, and without any
+expectation of additional consideration or compensation, the person
+associating CC0 with a Work (the "Affirmer"), to the extent that he or she
+is an owner of Copyright and Related Rights in the Work, voluntarily
+elects to apply CC0 to the Work and publicly distribute the Work under its
+terms, with knowledge of his or her Copyright and Related Rights in the
+Work and the meaning and intended legal effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not
+limited to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display,
+     communicate, and translate a Work;
+ ii. moral rights retained by the original author(s) and/or performer(s);
+iii. publicity and privacy rights pertaining to a person's image or
+     likeness depicted in a Work;
+ iv. rights protecting against unfair competition in regards to a Work,
+     subject to the limitations in paragraph 4(a), below;
+  v. rights protecting the extraction, dissemination, use and reuse of data
+     in a Work;
+ vi. database rights (such as those arising under Directive 96/9/EC of the
+     European Parliament and of the Council of 11 March 1996 on the legal
+     protection of databases, and under any national implementation
+     thereof, including any amended or successor version of such
+     directive); and
+vii. other similar, equivalent or corresponding rights throughout the
+     world based on applicable law or treaty, and any national
+     implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention
+of, applicable law, Affirmer hereby overtly, fully, permanently,
+irrevocably and unconditionally waives, abandons, and surrenders all of
+Affirmer's Copyright and Related Rights and associated claims and causes
+of action, whether now known or unknown (including existing as well as
+future claims and causes of action), in the Work (i) in all territories
+worldwide, (ii) for the maximum duration provided by applicable law or
+treaty (including future time extensions), (iii) in any current or future
+medium and for any number of copies, and (iv) for any purpose whatsoever,
+including without limitation commercial, advertising or promotional
+purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
+member of the public at large and to the detriment of Affirmer's heirs and
+successors, fully intending that such Waiver shall not be subject to
+revocation, rescission, cancellation, termination, or any other legal or
+equitable action to disrupt the quiet enjoyment of the Work by the public
+as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason
+be judged legally invalid or ineffective under applicable law, then the
+Waiver shall be preserved to the maximum extent permitted taking into
+account Affirmer's express Statement of Purpose. In addition, to the
+extent the Waiver is so judged Affirmer hereby grants to each affected
+person a royalty-free, non transferable, non sublicensable, non exclusive,
+irrevocable and unconditional license to exercise Affirmer's Copyright and
+Related Rights in the Work (i) in all territories worldwide, (ii) for the
+maximum duration provided by applicable law or treaty (including future
+time extensions), (iii) in any current or future medium and for any number
+of copies, and (iv) for any purpose whatsoever, including without
+limitation commercial, advertising or promotional purposes (the
+"License"). The License shall be deemed effective as of the date CC0 was
+applied by Affirmer to the Work. Should any part of the License for any
+reason be judged legally invalid or ineffective under applicable law, such
+partial invalidity or ineffectiveness shall not invalidate the remainder
+of the License, and in such case Affirmer hereby affirms that he or she
+will not (i) exercise any of his or her remaining Copyright and Related
+Rights in the Work or (ii) assert any associated claims and causes of
+action with respect to the Work, in either case contrary to Affirmer's
+express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+ a. No trademark or patent rights held by Affirmer are waived, abandoned,
+    surrendered, licensed or otherwise affected by this document.
+ b. Affirmer offers the Work as-is and makes no representations or
+    warranties of any kind concerning the Work, express, implied,
+    statutory or otherwise, including without limitation warranties of
+    title, merchantability, fitness for a particular purpose, non
+    infringement, or the absence of latent or other defects, accuracy, or
+    the present or absence of errors, whether or not discoverable, all to
+    the greatest extent permissible under applicable law.
+ c. Affirmer disclaims responsibility for clearing rights of other persons
+    that may apply to the Work or any use thereof, including without
+    limitation any person's Copyright and Related Rights in the Work.
+    Further, Affirmer disclaims responsibility for obtaining any necessary
+    consents, permissions or other rights required for any use of the
+    Work.
+ d. Affirmer understands and acknowledges that Creative Commons is not a
+    party to this document and has no duty or obligation with respect to
+    this CC0 or use of the Work.

tinytag-2.3.1/LICENSES/MIT.txt

@@ -0,0 +1 @@
+../LICENSE

{tinytag-2.3.0 → tinytag-2.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinytag
-Version: 2.3.0
+Version: 2.3.1
 Summary: Read audio file metadata
 Keywords: metadata,audio,music,mp3,m4a,wav,ogg,opus,flac,wma,aiff
 Author: Tom Wallroth, Mat (mathiascode)
@@ -28,14 +28,17 @@ Classifier: Topic :: Multimedia :: Sound/Audio
 Classifier: Topic :: Multimedia :: Sound/Audio :: Analysis
 Classifier: Typing :: Typed
 License-File: LICENSE
-Requires-Dist: coverage ; extra == "tests"
-Requires-Dist: mypy ; extra == "tests"
-Requires-Dist: mypy<1.19.0 ; extra == "tests" and ( platform_python_implementation == 'PyPy')
-Requires-Dist: pycodestyle ; extra == "tests"
-Requires-Dist: pylint ; extra == "tests"
-Requires-Dist: pyright ; extra == "tests"
+Requires-Dist: build ; extra == "dev"
+Requires-Dist: coverage ; extra == "dev"
+Requires-Dist: flit_core ; extra == "dev"
+Requires-Dist: mypy ; extra == "dev"
+Requires-Dist: mypy<1.19.0 ; extra == "dev" and ( platform_python_implementation == 'PyPy')
+Requires-Dist: pycodestyle ; extra == "dev"
+Requires-Dist: pylint ; extra == "dev"
+Requires-Dist: pyright ; extra == "dev"
+Requires-Dist: wheel ; extra == "dev"
 Project-URL: Homepage, https://github.com/tinytag/tinytag
-Provides-Extra: tests
+Provides-Extra: dev
 
 <!--
   SPDX-FileCopyrightText: 2014-2026 tinytag Contributors
@@ -527,6 +530,12 @@ UnsupportedFormatError  # File format is not supported
 
 ## Changelog
 
+### 2.3.1  (2026-08-30)
+
+- Don't open unrecognized files when disabling magic byte detection
+- MPEG: Fix parsing of some files with incorrect headers
+- OGG/WAV: Read sizes as little endian instead of native byte order
+
 ### 2.3.0  (2026-07-31)
 
 - Add 'mime_type' attribute for audio MIME type/codec

{tinytag-2.3.0 → tinytag-2.3.1}/README.md

@@ -488,6 +488,12 @@ UnsupportedFormatError  # File format is not supported
 
 ## Changelog
 
+### 2.3.1  (2026-08-30)
+
+- Don't open unrecognized files when disabling magic byte detection
+- MPEG: Fix parsing of some files with incorrect headers
+- OGG/WAV: Read sizes as little endian instead of native byte order
+
 ### 2.3.0  (2026-07-31)
 
 - Add 'mime_type' attribute for audio MIME type/codec

tinytag-2.3.1/SECURITY.md

@@ -0,0 +1,17 @@
+<!--
+  SPDX-FileCopyrightText: 2026 tinytag Contributors
+  SPDX-License-Identifier: MIT
+-->
+
+# Security Policy
+
+## Supported Versions
+
+tinytag follows a `A.B.C` versioning scheme. We only support the latest
+released `A.B.x` series.
+
+## Reporting a Vulnerability
+
+Please report a vulnerability under the Security tab in the GitHub repository.
+Since tinytag is a volunteer-driven project, your report will be reviewed and
+addressed when the maintainers have time.

{tinytag-2.3.0 → tinytag-2.3.1}/pyproject.toml

@@ -57,20 +57,28 @@ dynamic = ["version"]
 Homepage = "https://github.com/tinytag/tinytag"
 
 [project.optional-dependencies]
-tests = [
+dev = [
+    "build",
     "coverage",
+    "flit_core",
     "mypy",
     "mypy<1.19.0; platform_python_implementation == 'PyPy'",
     "pycodestyle",
     "pylint",
-    "pyright"
+    "pyright",
+    "wheel"
 ]
 
 [tool.flit.sdist]
+include = [
+    "LICENSES/",
+    ".editorconfig",
+    "CONTRIBUTING.md",
+    "SECURITY.md"
+]
 exclude = [
     ".gitignore",
     ".github/",
-    "tinytag/icons/",
     "tinytag/tests/"
 ]
 

{tinytag-2.3.0 → tinytag-2.3.1}/tinytag/__init__.py

@@ -3,7 +3,7 @@
 
 """Audio file metadata reader."""
 
-__version__ = '2.3.0'
+__version__ = '2.3.1'
 
 from .tinytag import (
     TinyTag, Image, Images, OtherFields, OtherImages,

{tinytag-2.3.0 → tinytag-2.3.1}/tinytag/tinytag.py

@@ -134,12 +134,16 @@ class TinyTag:
             check_magic_bytes: bool = True) -> TinyTag:
         """Return a tag object for an audio file."""
         should_close_file = file_obj is None
+        parser_class = None
         filename_str = None
         if filename:
+            filename_str = fsdecode(filename)
+            if not check_magic_bytes:
+                # Raises UnsupportedFormatError
+                parser_class = cls._get_parser_class(filename_str)
             if should_close_file:
                 # pylint: disable=consider-using-with
                 file_obj = open(filename, 'rb')
-            filename_str = fsdecode(filename)
         if file_obj is None:
             raise ValueError(
                 'Either filename or file_obj argument is required')
@@ -149,14 +153,13 @@ class TinyTag:
             warn('ignore_errors argument is obsolete, and will be removed in '
                  'the future', DeprecationWarning, stacklevel=2)
         try:
-            # pylint: disable=protected-access
+            if parser_class is None:  # check_magic_bytes is True
+                # Raises UnsupportedFormatError
+                parser_class = cls._get_parser_class(filename_str, file_obj)
             file_obj.seek(0, SEEK_END)
             filesize = file_obj.tell()
             file_obj.seek(0)
-            if check_magic_bytes:
-                parser_class = cls._get_parser_class(filename_str, file_obj)
-            else:
-                parser_class = cls._get_parser_class(filename_str)
+            # pylint: disable=protected-access
             tag = parser_class()
             tag._filehandler = file_obj
             tag._default_encoding = encoding
@@ -232,7 +235,6 @@ class TinyTag:
     ) -> type[TinyTag] | None:
         # https://en.wikipedia.org/wiki/List_of_file_signatures
         header = filehandle.read(30)
-        filehandle.seek(0)
         if header.startswith(b'ID3'):
             return _ID3
         if (len(header) >= 2
@@ -244,8 +246,6 @@ class TinyTag:
             except OSError:
                 # File smaller than ID3v1 tag size
                 pass
-            finally:
-                filehandle.seek(0)
             if footer == b'TAG':
                 return _ID3
             return _MPEG
@@ -420,7 +420,7 @@ class Images:
             for other_key, other_values in value.items():
                 other_images = images.get(other_key)
                 if not isinstance(other_images, list):
-                    other_images = images[other_key] = other_values
+                    images[other_key] = other_values
                 else:
                     other_images += other_values
         return images
@@ -1471,7 +1471,6 @@ class _MPEG(TinyTag):
     _MAX_ESTIMATION_SEC = 30
     _CBR_DETECTION_FRAME_COUNT = 5
     _USE_XING_HEADER = True  # much faster, but can be deactivated for testing
-    _MAX_INVALID_FRAMES = 200
 
     # see this page for the magic values used in mp3:
     # http://www.mpgedit.org/mpgedit/mpeg_format/mpeghdr.htm
@@ -1532,7 +1531,6 @@ class _MPEG(TinyTag):
         max_estimation_frames = 0
         frame_size_accu = 0
         frames = 0  # count frames for determining mp3 duration
-        invalid_frames = 0
         bitrate_accu = 0    # add up bitrates to find average bitrate to detect
         last_bitrates: set[int] = set()  # CBR mp3s (many frames with same brs)
         # seek to first position after id3 tag (speedup for large header)
@@ -1568,9 +1566,6 @@ class _MPEG(TinyTag):
                     fh.seek(idx - header_len, SEEK_CUR)
                 if frames == 0:
                     audio_offset += next_offset
-                    invalid_frames += 1
-                    if invalid_frames > self._MAX_INVALID_FRAMES:
-                        raise ParseError("Invalid MPEG frame header")
                 continue
             self.channels = self._CHANNELS_PER_CHANNEL_MODE[channel_mode]
             frame_br = self._BITRATE_VERSION_LAYERS[mpeg_id][layer_id][br_id]
@@ -1840,11 +1835,11 @@ class _Ogg(TinyTag):
         # for the spec, see: http://xiph.org/vorbis/doc/v-comment.html
         # discnumber tag based on: https://en.wikipedia.org/wiki/Vorbis_comment
         # https://sno.phy.queensu.ca/~phil/exiftool/TagNames/Vorbis.html
-        vendor_length = unpack('I', fh.read(4))[0]
+        vendor_length = unpack('<I', fh.read(4))[0]
         fh.seek(vendor_length, SEEK_CUR)  # jump over vendor
-        elements = unpack('I', fh.read(4))[0]
+        elements = unpack('<I', fh.read(4))[0]
         for _i in range(elements):
-            length = unpack('I', fh.read(4))[0]
+            length = unpack('<I', fh.read(4))[0]
             if not read_data:
                 fh.seek(length, SEEK_CUR)
                 continue
@@ -2000,7 +1995,7 @@ class _Wave(TinyTag):
         header_len = 8
         chunk_header = fh.read(header_len)
         while len(chunk_header) == header_len:
-            subchunk_size = unpack_from('I', chunk_header, 4)[0]
+            subchunk_size = unpack_from('<I', chunk_header, 4)[0]
             subchunk_size_unpadded = subchunk_size
             # IFF chunks are padded to an even number of bytes
             subchunk_size += subchunk_size % 2
@@ -2025,7 +2020,7 @@ class _Wave(TinyTag):
                 fh.seek(subchunk_size, SEEK_CUR)
             elif self._parse_duration and chunk_header.startswith(b'fact'):
                 chunk = fh.read(subchunk_size)
-                num_samples = unpack_from('I', chunk)[0]
+                num_samples = unpack_from('<I', chunk)[0]
             elif self._parse_tags and chunk_header.startswith(b'LIST'):
                 chunk = fh.read(subchunk_size)
                 if chunk.startswith(b'INFO'):
@@ -2033,7 +2028,7 @@ class _Wave(TinyTag):
                     walker.seek(4)  # skip header
                     field = walker.read(4)
                     while len(field) == 4:
-                        data_length = unpack('I', walker.read(4))[0]
+                        data_length = unpack('<I', walker.read(4))[0]
                         # IFF chunks are padded to an even size
                         data_length += data_length % 2
                         data = self._unpad_bytes(walker.read(data_length))
@@ -2498,6 +2493,7 @@ class _Aiff(TinyTag):
                             self.bitrate = bitrate
                         self.samplerate, self.duration = sr, duration
                 except OverflowError:
+                    # Invalid sample rate
                     pass
                 compression_type = chunk[18:22].decode('latin-1')
                 if not compression_type: