c2pa-python 0.37.3__tar.gz → 0.37.4__tar.gz

{c2pa_python-0.37.3/src/c2pa_python.egg-info → c2pa_python-0.37.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: c2pa-python
-Version: 0.37.3
+Version: 0.37.4
 Summary: Python bindings for the C2PA Content Authenticity Initiative (CAI) library
 Author-email: Gavin Peacock <gvnpeacock@adobe.com>, Tania Mathern <mathern@adobe.com>
 Maintainer-email: Gavin Peacock <gpeacock@adobe.com>, Tania Mathern <mathern@adobe.com>
@@ -35,7 +35,7 @@ Features:
 - Add assertions and ingredients to assets.
 - Examples and unit tests to demonstrate usage.
 
-<div style={{display: 'none'}}>
+<div class="github-only">
 
 For the best experience, read the docs on the [CAI Open Source SDK documentation website](https://opensource.contentauthenticity.org/docs/c2pa-c).
 
@@ -44,7 +44,7 @@ If you want to view the documentation in GitHub, see:
 - [Supported formats](https://github.com/contentauth/c2pa-rs/blob/main/docs/supported-formats.md)
 - [Configuring the SDK using `Context` and `Settings`](docs/context-settings.md)
 - [Using Builder intents](docs/intents.md) to ensure spec-compliant manifests
-- Using [working stores and archvies](docs/working-stores.md)
+- Using [working stores and archives](docs/working-stores.md)
 - Selectively constructing manifests by [filtering actions and ingredients](docs/selective-manifests.md)
 - [Diagram of public classes in the Python library and their relationships](docs/class-diagram.md)
 - [Release notes](docs/release-notes.md)
@@ -95,7 +95,7 @@ export C2PA_RS_PATH=/path/to/c2pa-rs
 make build-from-source C2PA_RS_PATH=$C2PA_RS_PATH
 ```
 
-This does a clean build of the `c2pa-c-ffi` crate (with the `file_io` feature, which the Python wrapper requires), stages the resulting library under both `artifacts/` and `src/c2pa/libs/`, and installs the package in editable mode, replacing any prebuilt artifacts from `make download-native-artifacts`. The release profile is used by default; to build the debug profile instead, pass `EXTRA_BUILD_ARGS="--debug"`:
+This does a clean build of the `c2pa-c-ffi` crate (with the `file_io` feature, which the Python wrapper requires), stages the resulting library under both `artifacts/` and `src/c2pa/libs/`, and installs the package in editable mode, replacing any prebuilt artifacts from `make download-native-artifacts`. By default, the build uses the release profile; to build the debug profile instead, pass `EXTRA_BUILD_ARGS="--debug"`:
 
 ```sh
 make build-from-source C2PA_RS_PATH=$C2PA_RS_PATH EXTRA_BUILD_ARGS="--debug"

{c2pa_python-0.37.3 → c2pa_python-0.37.4}/README.md

@@ -12,7 +12,7 @@ Features:
 - Add assertions and ingredients to assets.
 - Examples and unit tests to demonstrate usage.
 
-<div style={{display: 'none'}}>
+<div class="github-only">
 
 For the best experience, read the docs on the [CAI Open Source SDK documentation website](https://opensource.contentauthenticity.org/docs/c2pa-c).
 
@@ -21,7 +21,7 @@ If you want to view the documentation in GitHub, see:
 - [Supported formats](https://github.com/contentauth/c2pa-rs/blob/main/docs/supported-formats.md)
 - [Configuring the SDK using `Context` and `Settings`](docs/context-settings.md)
 - [Using Builder intents](docs/intents.md) to ensure spec-compliant manifests
-- Using [working stores and archvies](docs/working-stores.md)
+- Using [working stores and archives](docs/working-stores.md)
 - Selectively constructing manifests by [filtering actions and ingredients](docs/selective-manifests.md)
 - [Diagram of public classes in the Python library and their relationships](docs/class-diagram.md)
 - [Release notes](docs/release-notes.md)
@@ -72,7 +72,7 @@ export C2PA_RS_PATH=/path/to/c2pa-rs
 make build-from-source C2PA_RS_PATH=$C2PA_RS_PATH
 ```
 
-This does a clean build of the `c2pa-c-ffi` crate (with the `file_io` feature, which the Python wrapper requires), stages the resulting library under both `artifacts/` and `src/c2pa/libs/`, and installs the package in editable mode, replacing any prebuilt artifacts from `make download-native-artifacts`. The release profile is used by default; to build the debug profile instead, pass `EXTRA_BUILD_ARGS="--debug"`:
+This does a clean build of the `c2pa-c-ffi` crate (with the `file_io` feature, which the Python wrapper requires), stages the resulting library under both `artifacts/` and `src/c2pa/libs/`, and installs the package in editable mode, replacing any prebuilt artifacts from `make download-native-artifacts`. By default, the build uses the release profile; to build the debug profile instead, pass `EXTRA_BUILD_ARGS="--debug"`:
 
 ```sh
 make build-from-source C2PA_RS_PATH=$C2PA_RS_PATH EXTRA_BUILD_ARGS="--debug"

{c2pa_python-0.37.3 → c2pa_python-0.37.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "c2pa-python"
-version = "0.37.3"
+version = "0.37.4"
 requires-python = ">=3.10"
 description = "Python bindings for the C2PA Content Authenticity Initiative (CAI) library"
 readme = { file = "README.md", content-type = "text/markdown" }

{c2pa_python-0.37.3 → c2pa_python-0.37.4}/src/c2pa/c2pa.py

@@ -11,7 +11,7 @@
 # specific language governing permissions and limitations under
 # each license.
 
-# Version: 0.37.3
+# Version: 0.37.4
 
 import ctypes
 import enum
@@ -1464,36 +1464,6 @@ def load_settings(settings: Union[str, dict], format: str = "json") -> None:
         check=lambda r: r != 0)
 
 
-def _get_mime_type_from_path(path: Union[str, Path]) -> str:
-    """Attempt to guess the MIME type from a file path's extension.
-    When the extension is missing or unrecognized, this returns an empty
-    string so the caller hands it to the lib for auto-detection.
-    A recognized-but-wrong extension still returns a mimetype:
-    the native layer will attempt to correct it from the bytes when
-    reading (the real type still needs to be supported by the lib),
-    and if it can't, an error will happen then.
-
-    Args:
-        path: File path as string or Path object
-
-    Returns:
-        MIME type string, or an empty string
-          (when it cannot be determined from the extension).
-        An empty string here means the native lib should attempt auto-detect.
-    """
-    path_obj = Path(path)
-    file_extension = path_obj.suffix.lower() if path_obj.suffix else ""
-
-    if file_extension == ".dng":
-        # mimetypes guesses the wrong type for dng,
-        # so we bypass it and set the correct type
-        return "image/dng"
-    else:
-        # Fall back to an empty string for extensionless or unknown files.
-        # Empty string flags this as a guess-type attempt.
-        return mimetypes.guess_type(str(path))[0] or ""
-
-
 class ContextProvider(ABC):
     """Abstract base class for types that provide a C2PA context.
 
@@ -2154,6 +2124,46 @@ class Stream:
         """
         return self._initialized
 
+    @staticmethod
+    def is_read_stream(obj) -> bool:
+        """Return True if obj is a stream-like object this SDK can use.
+        Note: only method presence to identify streams are checked,
+        not that they work (a broken stream can fail later).
+        """
+        if obj is None or isinstance(obj, (str, Path)):
+            return False
+        return all(hasattr(obj, method) for method in Stream._REQUIRED_STREAM_METHODS)
+
+
+def _get_mime_type_from_path(path: Union[str, Path]) -> str:
+    """Attempt to guess the MIME type from a file path's extension.
+    When the extension is missing or unrecognized, this returns an empty
+    string so the caller hands it to the lib for auto-detection.
+    A recognized-but-wrong extension still returns a mimetype:
+    the native layer will attempt to correct it from the bytes when
+    reading (the real type still needs to be supported by the lib),
+    and if it can't, an error will happen then.
+
+    Args:
+        path: File path as string or Path object
+
+    Returns:
+        MIME type string, or an empty string
+          (when it cannot be determined from the extension).
+        An empty string here means the native lib should attempt auto-detect.
+    """
+    path_obj = Path(path)
+    file_extension = path_obj.suffix.lower() if path_obj.suffix else ""
+
+    if file_extension == ".dng":
+        # mimetypes guesses the wrong type for dng,
+        # so we bypass it and set the correct type
+        return "image/dng"
+    else:
+        # Fall back to an empty string for extensionless or unknown files.
+        # Empty string flags this as a guess-type attempt.
+        return mimetypes.guess_type(str(path))[0] or ""
+
 
 def _get_supported_mime_types(ffi_func, cache):
     """Shared helper to retrieve supported MIME types from the native library.
@@ -2269,16 +2279,6 @@ def _format_ffi_arg(fmt: Optional[bytes]) -> bytes:
     return fmt if fmt is not None else b""
 
 
-def _is_read_stream(obj) -> bool:
-    """Return True if obj is a stream-like object this SDK can use.
-    Note: only method presence to identify streams are checked,
-    not that they work (a broken stream can fail later).
-    """
-    if obj is None or isinstance(obj, (str, Path)):
-        return False
-    return all(hasattr(obj, method) for method in Stream._REQUIRED_STREAM_METHODS)
-
-
 class Reader(ManagedResource):
     """High-level wrapper for C2PA Reader operations.
 
@@ -2478,7 +2478,7 @@ class Reader(ManagedResource):
         self._context = context
 
         # Only stream, no format: Reader(fh) must auto-detect on the stream.
-        if stream is None and _is_read_stream(format_or_path):
+        if stream is None and Stream.is_read_stream(format_or_path):
             stream = format_or_path
             format_or_path = None
         # A context supplies settings, not the asset, so a path or stream is

{c2pa_python-0.37.3 → c2pa_python-0.37.4/src/c2pa_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: c2pa-python
-Version: 0.37.3
+Version: 0.37.4
 Summary: Python bindings for the C2PA Content Authenticity Initiative (CAI) library
 Author-email: Gavin Peacock <gvnpeacock@adobe.com>, Tania Mathern <mathern@adobe.com>
 Maintainer-email: Gavin Peacock <gpeacock@adobe.com>, Tania Mathern <mathern@adobe.com>
@@ -35,7 +35,7 @@ Features:
 - Add assertions and ingredients to assets.
 - Examples and unit tests to demonstrate usage.
 
-<div style={{display: 'none'}}>
+<div class="github-only">
 
 For the best experience, read the docs on the [CAI Open Source SDK documentation website](https://opensource.contentauthenticity.org/docs/c2pa-c).
 
@@ -44,7 +44,7 @@ If you want to view the documentation in GitHub, see:
 - [Supported formats](https://github.com/contentauth/c2pa-rs/blob/main/docs/supported-formats.md)
 - [Configuring the SDK using `Context` and `Settings`](docs/context-settings.md)
 - [Using Builder intents](docs/intents.md) to ensure spec-compliant manifests
-- Using [working stores and archvies](docs/working-stores.md)
+- Using [working stores and archives](docs/working-stores.md)
 - Selectively constructing manifests by [filtering actions and ingredients](docs/selective-manifests.md)
 - [Diagram of public classes in the Python library and their relationships](docs/class-diagram.md)
 - [Release notes](docs/release-notes.md)
@@ -95,7 +95,7 @@ export C2PA_RS_PATH=/path/to/c2pa-rs
 make build-from-source C2PA_RS_PATH=$C2PA_RS_PATH
 ```
 
-This does a clean build of the `c2pa-c-ffi` crate (with the `file_io` feature, which the Python wrapper requires), stages the resulting library under both `artifacts/` and `src/c2pa/libs/`, and installs the package in editable mode, replacing any prebuilt artifacts from `make download-native-artifacts`. The release profile is used by default; to build the debug profile instead, pass `EXTRA_BUILD_ARGS="--debug"`:
+This does a clean build of the `c2pa-c-ffi` crate (with the `file_io` feature, which the Python wrapper requires), stages the resulting library under both `artifacts/` and `src/c2pa/libs/`, and installs the package in editable mode, replacing any prebuilt artifacts from `make download-native-artifacts`. By default, the build uses the release profile; to build the debug profile instead, pass `EXTRA_BUILD_ARGS="--debug"`:
 
 ```sh
 make build-from-source C2PA_RS_PATH=$C2PA_RS_PATH EXTRA_BUILD_ARGS="--debug"

{c2pa_python-0.37.3 → c2pa_python-0.37.4}/tests/test_unit_tests.py

@@ -36,7 +36,7 @@ warnings.simplefilter("ignore", category=DeprecationWarning)
 
 from c2pa import Builder, C2paError as Error, Reader, C2paSigningAlg as SigningAlg, C2paSignerInfo, Signer, sdk_version, C2paBuilderIntent, C2paDigitalSourceType
 from c2pa import Settings, Context, ContextBuilder, ContextProvider
-from c2pa.c2pa import Stream, LifecycleState, ManagedResource, load_settings, create_signer, create_signer_from_info, ed25519_sign, format_embeddable, _get_mime_type_from_path, _encode_format, _format_ffi_arg, _is_read_stream
+from c2pa.c2pa import Stream, LifecycleState, ManagedResource, load_settings, create_signer, create_signer_from_info, ed25519_sign, format_embeddable, _get_mime_type_from_path, _encode_format, _format_ffi_arg
 import c2pa.c2pa as c2pa_module
 from pathlib import Path
 
@@ -105,17 +105,17 @@ class TestIsReadableStream(unittest.TestCase):
     def test_paths_and_formats_are_not_streams(self):
         for value in (None, "", "image/jpeg", "path/to/file.jpg",
                       Path("x.jpg")):
-            self.assertFalse(_is_read_stream(value), repr(value))
+            self.assertFalse(Stream.is_read_stream(value), repr(value))
 
     def test_non_stream_objects_are_not_streams(self):
         for value in (b"bytes", bytearray(b"x"), 42, object()):
-            self.assertFalse(_is_read_stream(value), repr(value))
+            self.assertFalse(Stream.is_read_stream(value), repr(value))
 
     def test_object_missing_methods_is_not_a_stream(self):
         class OnlyRead:
             def read(self):
                 return b""
-        self.assertFalse(_is_read_stream(OnlyRead()))
+        self.assertFalse(Stream.is_read_stream(OnlyRead()))
 
     def test_read_only_object_is_not_a_stream(self):
         # Has read/seek/tell but no write/flush, so not a Stream for us.
@@ -128,11 +128,11 @@ class TestIsReadableStream(unittest.TestCase):
 
             def tell(self):
                 return 0
-        self.assertFalse(_is_read_stream(ReadOnly()))
+        self.assertFalse(Stream.is_read_stream(ReadOnly()))
 
     def test_in_memory_streams_are_streams(self):
-        self.assertTrue(_is_read_stream(io.BytesIO(b"x")))
-        self.assertTrue(_is_read_stream(io.StringIO("x")))
+        self.assertTrue(Stream.is_read_stream(io.BytesIO(b"x")))
+        self.assertTrue(Stream.is_read_stream(io.StringIO("x")))
 
     def test_file_handles_are_streams(self):
         path = self._tmp_path()
@@ -145,13 +145,13 @@ class TestIsReadableStream(unittest.TestCase):
         ):
             fh = opener()
             try:
-                self.assertTrue(_is_read_stream(fh), type(fh).__name__)
+                self.assertTrue(Stream.is_read_stream(fh), type(fh).__name__)
             finally:
                 fh.close()
 
     def test_spooled_temporary_file_is_a_stream(self):
         with tempfile.SpooledTemporaryFile() as fh:
-            self.assertTrue(_is_read_stream(fh))
+            self.assertTrue(Stream.is_read_stream(fh))
 
     def test_compressed_file_objects_are_streams(self):
         with tempfile.TemporaryDirectory() as tmp:
@@ -164,7 +164,7 @@ class TestIsReadableStream(unittest.TestCase):
                 with opener(p, "wb") as fh:
                     fh.write(b"data")
                 with opener(p, "rb") as fh:
-                    self.assertTrue(_is_read_stream(fh), ext)
+                    self.assertTrue(Stream.is_read_stream(fh), ext)
 
     def test_placeholder_typed_object_with_all_methods_is_a_stream(self):
         class Duck:
@@ -182,7 +182,7 @@ class TestIsReadableStream(unittest.TestCase):
 
             def flush(self):
                 pass
-        self.assertTrue(_is_read_stream(Duck()))
+        self.assertTrue(Stream.is_read_stream(Duck()))
 
 
 class TestFormatValidation(unittest.TestCase):
@@ -562,7 +562,7 @@ class TestReader(unittest.TestCase):
             reader.close()
 
     def test_bare_stream_closed_handle_raises(self):
-        # _is_read_stream only checks method presence
+        # Stream.is_read_stream only checks method presence
         #  so a closed handle is accepted as a stream and fails at read time.
         file = open(self.testPath, "rb")
         file.close()