IPTCInfo3 2.3.0__tar.gz → 2.3.2__tar.gz

{iptcinfo3-2.3.0 → iptcinfo3-2.3.2}/.gitignore

@@ -19,3 +19,9 @@ __pycache__
 
 # pipfile stuff
 Pipfile.lock
+
+# uv stuff
+uv.lock
+
+# virtualenvs
+.venv/

{iptcinfo3-2.3.0 → iptcinfo3-2.3.2}/CHANGELOG.md

@@ -1,3 +1,28 @@
+## 2.3.2
+
+### New Features
+- Added `'creator'` alias for `'by-line'` (dataset 80) per IPTC Core — `info['creator']` now works for reading and writing (idea from adityamulik's PR #34, corrected: raw dataset 1 does not exist in IIM)
+
+---
+
+## 2.3.1
+
+### Compatibility
+- Verified on Python 3.15 (all 8 tests pass); supports Python 3.10 through 3.15
+- Dropped EOL interpreters: 3.8 (EOL Oct 2024) and 3.9 (EOL Oct 2025); `requires-python` is now `>=3.10`
+- Added PyPI classifiers for Python 3.14 and 3.15
+
+### Bug Fixes
+- Fixed `SyntaxWarning: 'return' in a 'finally' block` in `file_is_jpeg()` (return moved out of `finally`; behavior unchanged, file position still reset)
+
+### Build / Dev
+- Fixed `pytest` config: `testpaths` pointed at a non-existent `tests/` dir so bare `pytest` collected nothing; now points at repo root so `iptcinfo_test.py` is found
+- Bumped Ruff `target-version` from `py38` to `py310`
+- Updated dev pins: `.python-version` 3.9.7 → 3.15, `Pipfile` requires 3.10, CircleCI image `cimg/python:3.9.7` → `cimg/python:3.15`
+- Added GitHub Actions CI matrix (Python 3.10–3.15)
+
+---
+
 ## 2.3.0 (2025-12-02)
 
 ### Bug Fixes

{iptcinfo3-2.3.0 → iptcinfo3-2.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: IPTCInfo3
-Version: 2.3.0
+Version: 2.3.2
 Summary: Extract and modify IPTC metadata from JPEG images
 Project-URL: Homepage, https://github.com/jamesacampbell/iptcinfo3
 Project-URL: Repository, https://github.com/jamesacampbell/iptcinfo3
@@ -16,19 +16,19 @@ Classifier: License :: OSI Approved :: Artistic License
 Classifier: License :: OSI Approved :: GNU General Public License (GPL)
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-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
 Classifier: Topic :: Multimedia :: Graphics
 Classifier: Topic :: Utilities
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Provides-Extra: dev
-Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
 Requires-Dist: pytest-watch>=4.2; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
 Description-Content-Type: text/x-rst
 
 ``IPTCINFO 3``
@@ -42,7 +42,7 @@ Ported from Josh Carter's Perl IPTCInfo-1.9.pm by Tamas Gulacsi
 
 Ever wish you add information to your photos like a caption, the place
 you took it, the date, and perhaps even keywords and categories? You
-already can. The International Press Telecommunications Council (IPTC)
+already can. The `International Press Telecommunications Council (IPTC) <https://en.wikipedia.org/wiki/International_Press_Telecommunications_Council>`_
 defines a format for exchanging meta-information in news content, and
 that includes photographs. You can embed all kinds of information in
 your images. The trick is putting it to use.
@@ -54,6 +54,8 @@ programs -- pull it back out. You can use the information directly in
 Python programs, export it to XML, or even export SQL statements ready
 to be fed into a database.
 
+Wikidata item https://www.wikidata.org/wiki/Q137179516
+
 Installation
 ------------
 
@@ -65,10 +67,12 @@ Or with uv::
 
     uv pip install IPTCInfo3
 
+On Gentoo Linux: on `gentoo-zh overlay <https://github.com/microcai/gentoo-zh/tree/master/dev-python/iptcinfo3>`_.
+
 Requirements
 ------------
 
-- Python 3.8 or higher
+- Python 3.10 or higher
 - No external dependencies required
 
 Usage
@@ -101,3 +105,5 @@ Lists for keywords, so you can just append!
 Save new info to file
 ``info.save()``
 ``info.save_as('very_meta.jpg')``
+
+For real life usage example see https://gitlab.com/vitaly-zdanevich/upload_to_commons_with_categories_from_iptc/-/blob/master/upload_to_commons_with_categories_from_iptc.py

{iptcinfo3-2.3.0 → iptcinfo3-2.3.2}/README.rst

@@ -9,7 +9,7 @@ Ported from Josh Carter's Perl IPTCInfo-1.9.pm by Tamas Gulacsi
 
 Ever wish you add information to your photos like a caption, the place
 you took it, the date, and perhaps even keywords and categories? You
-already can. The International Press Telecommunications Council (IPTC)
+already can. The `International Press Telecommunications Council (IPTC) <https://en.wikipedia.org/wiki/International_Press_Telecommunications_Council>`_
 defines a format for exchanging meta-information in news content, and
 that includes photographs. You can embed all kinds of information in
 your images. The trick is putting it to use.
@@ -21,6 +21,8 @@ programs -- pull it back out. You can use the information directly in
 Python programs, export it to XML, or even export SQL statements ready
 to be fed into a database.
 
+Wikidata item https://www.wikidata.org/wiki/Q137179516
+
 Installation
 ------------
 
@@ -32,10 +34,12 @@ Or with uv::
 
     uv pip install IPTCInfo3
 
+On Gentoo Linux: on `gentoo-zh overlay <https://github.com/microcai/gentoo-zh/tree/master/dev-python/iptcinfo3>`_.
+
 Requirements
 ------------
 
-- Python 3.8 or higher
+- Python 3.10 or higher
 - No external dependencies required
 
 Usage
@@ -68,3 +72,5 @@ Lists for keywords, so you can just append!
 Save new info to file
 ``info.save()``
 ``info.save_as('very_meta.jpg')``
+
+For real life usage example see https://gitlab.com/vitaly-zdanevich/upload_to_commons_with_categories_from_iptc/-/blob/master/upload_to_commons_with_categories_from_iptc.py

{iptcinfo3-2.3.0 → iptcinfo3-2.3.2}/iptcinfo3.py

@@ -26,7 +26,7 @@ import tempfile
 from struct import pack, unpack
 import json
 
-__version__ = '2.3.0'
+__version__ = '2.3.2'
 __author__ = 'Gulácsi, Tamás'
 __updated_by__ = 'Campbell, James'
 
@@ -162,7 +162,7 @@ def file_is_jpeg(fh):
             ered = ff == 0xff
     finally:
         fh.seek(0)
-        return ered
+    return ered
 
 
 def jpeg_get_variable_length(fh):
@@ -554,6 +554,10 @@ class IPTCData(dict):
         # Alias for compatibility with gThumb/exiftool
         elif isinstance(key, str) and key.lower() == 'destination':
             return 103  # Maps to 'original transmission reference'
+        # Alias per IPTC Core: 'creator' is stored as 'by-line' (dataset 80).
+        # (Closes adityamulik's PR #34 idea; raw dataset 1 does not exist in IIM.)
+        elif isinstance(key, str) and key.lower() == 'creator':
+            return 80  # Maps to 'by-line'
         elif key.startswith(cls.c_cust_pre) and key[len(cls.c_cust_pre):].isdigit():
             # example: nonstandard_69 -> 69
             return int(key[len(cls.c_cust_pre):])

{iptcinfo3-2.3.0 → iptcinfo3-2.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "IPTCInfo3"
-version = "2.3.0"
+version = "2.3.2"
 description = "Extract and modify IPTC metadata from JPEG images"
 readme = "README.rst"
 license = { text = "Artistic-1.0 OR GPL-1.0-or-later" }
@@ -22,16 +22,16 @@ classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Topic :: Multimedia :: Graphics",
     "Topic :: Utilities",
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 dependencies = []
 
 [project.urls]
@@ -41,8 +41,8 @@ Issues = "https://github.com/jamesacampbell/iptcinfo3/issues"
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0",
-    "pytest-cov>=4.0",
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
     "pytest-watch>=4.2",
 ]
 
@@ -59,7 +59,7 @@ packages = ["."]
 only-include = ["iptcinfo3.py"]
 
 [tool.pytest.ini_options]
-testpaths = ["tests"]
+testpaths = ["."]
 python_files = ["test_*.py", "*_test.py"]
 
 [tool.coverage.run]
@@ -72,7 +72,7 @@ skip_covered = true
 
 [tool.ruff]
 line-length = 100
-target-version = "py38"
+target-version = "py310"
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP"]