feat: Next version

README.md

@@ -40,7 +40,9 @@ See the [`examples` directory](https://github.com/contentauth/c2pa-python/tree/m
 
 ## API reference documentation
 
-See [the section in Contributing to the project](https://github.com/contentauth/c2pa-python/blob/main/docs/project-contributions.md#api-reference-documentation).
+Documentation is published at [github.io/c2pa-python/api/c2pa](https://contentauth.github.io/c2pa-python/api/c2pa/index.html).
+
+To build documentation locally, refer to [this section in Contributing to the project](https://github.com/contentauth/c2pa-python/blob/main/docs/project-contributions.md#api-reference-documentation).
 
 ## Contributing
 

c2pa-native-version.txt

@@ -1 +1 @@
-c2pa-v0.67.1
+c2pa-v0.75.2

examples/README.md

@@ -1,6 +1,6 @@
-# Python example code 
+# Python example code
 
-The `examples` directory contains some small examples of using the Python library.
+The `examples` directory contains some small examples of using this Python library.
 The examples use asset files from the `tests/fixtures` directory, save the resulting signed assets to the temporary `output` directory, and display manifest store data and other output to the console.
 
 ## Signing and verifying assets
@@ -102,3 +102,7 @@ In this example, `SignerInfo` creates a `Signer` object that signs the manifest.
 ```bash
 python examples/sign_info.py
 ```
+
+## Backend application example
+
+[c2pa-python-example](https://github.com/contentauth/c2pa-python-example) is an example of a simple application that accepts an uploaded JPEG image file, attaches a C2PA manifest, and signs it using a certificate. The app uses the CAI Python library and the Flask Python framework to implement a back-end REST endpoint; it does not have an HTML front-end, so you have to use something like curl to access it. This example is a development setup and should not be deployed as-is to a production environment.

examples/sign.py

@@ -26,7 +26,7 @@
 fixtures_dir = os.path.join(os.path.dirname(__file__), "../tests/fixtures/")
 output_dir = os.path.join(os.path.dirname(__file__), "../output/")
 
-# Ensure the output directory exists
+# Ensure the output directory exists.
 if not os.path.exists(output_dir):
     os.makedirs(output_dir)
 
@@ -43,7 +43,7 @@
 with open(fixtures_dir + "es256_private.key", "rb") as key_file:
     key = key_file.read()
 
-# Define a callback signer function
+# Define a callback signer function.
 def callback_signer_es256(data: bytes) -> bytes:
     """Callback function that signs data using ES256 algorithm."""
     private_key = serialization.load_pem_private_key(
@@ -60,7 +60,6 @@ def callback_signer_es256(data: bytes) -> bytes:
 # Create a manifest definition as a dictionary.
 # This manifest follows the V2 manifest format.
 manifest_definition = {
-    "claim_generator": "python_example",
     "claim_generator_info": [{
         "name": "python_example",
         "version": "0.0.1",
@@ -87,7 +86,7 @@ def callback_signer_es256(data: bytes) -> bytes:
 }
 
 # Sign the image with the signer created above,
-# which will use the callback signer
+# which will use the callback signer.
 print("\nSigning the image file...")
 
 with c2pa.Signer.from_callback(
@@ -107,6 +106,9 @@ def callback_signer_es256(data: bytes) -> bytes:
 print("\nReading signed image metadata:")
 with open(output_dir + "A_signed.jpg", "rb") as file:
     with c2pa.Reader("image/jpeg", file) as reader:
+        # The validation state will depend on loaded trust settings.
+        # Without loaded trust settings,
+        # the manifest validation_state will be "Invalid".
         print(reader.json())
 
 print("\nExample completed successfully!")

examples/sign_info.py

@@ -100,6 +100,9 @@
 print("\nReading signed image metadata:")
 with open(output_dir + "C_signed.jpg", "rb") as file:
     with c2pa.Reader("image/jpeg", file) as reader:
+        # The validation state will depend on loaded trust settings.
+        # Without loaded trust settings,
+        # the manifest validation_state will be "Invalid".
         print(reader.json())
 
 print("\nExample completed successfully!")

pyproject.toml

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

src/c2pa/__init__.py

@@ -22,6 +22,8 @@
     C2paError,
     Reader,
     C2paSigningAlg,
+    C2paDigitalSourceType,
+    C2paBuilderIntent,
     C2paSignerInfo,
     Signer,
     Stream,
@@ -35,6 +37,8 @@
     'C2paError',
     'Reader',
     'C2paSigningAlg',
+    'C2paDigitalSourceType',
+    'C2paBuilderIntent',
     'C2paSignerInfo',
     'Signer',
     'Stream',