c2pa-python 0.27.1__tar.gz → 0.29.0__tar.gz

{c2pa_python-0.27.1/src/c2pa_python.egg-info → c2pa_python-0.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: c2pa-python
-Version: 0.27.1
+Version: 0.29.0
 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>
@@ -35,6 +35,22 @@ Features:
 - Add assertions and ingredients to assets.
 - Examples and unit tests to demonstrate usage.
 
+<div style={{display: 'none'}}>
+
+For the best experience, read the docs on the [CAI Open Source SDK documentation website](https://opensource.contentauthenticity.org/docs/c2pa-c).
+
+If you want to view the documentation in GitHub, see:
+- [Using the Python library](docs/usage.md)
+- [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)
+- 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)
+
+</div>
+
 ## Prerequisites
 
 This library requires Python version 3.10+.
@@ -57,12 +73,15 @@ import c2pa
 
 See the [`examples` directory](https://github.com/contentauth/c2pa-python/tree/main/examples) for some helpful examples:
 
+- `examples/read.py` shows how to read and verify an asset with a C2PA manifest.
 - `examples/sign.py` shows how to sign and verify an asset with a C2PA manifest.
 - `examples/training.py` demonstrates how to add a "Do Not Train" assertion to an asset and verify it.
 
 ## 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_python-0.27.1 → c2pa_python-0.29.0}/README.md

@@ -12,6 +12,22 @@ Features:
 - Add assertions and ingredients to assets.
 - Examples and unit tests to demonstrate usage.
 
+<div style={{display: 'none'}}>
+
+For the best experience, read the docs on the [CAI Open Source SDK documentation website](https://opensource.contentauthenticity.org/docs/c2pa-c).
+
+If you want to view the documentation in GitHub, see:
+- [Using the Python library](docs/usage.md)
+- [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)
+- 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)
+
+</div>
+
 ## Prerequisites
 
 This library requires Python version 3.10+.
@@ -34,12 +50,15 @@ import c2pa
 
 See the [`examples` directory](https://github.com/contentauth/c2pa-python/tree/main/examples) for some helpful examples:
 
+- `examples/read.py` shows how to read and verify an asset with a C2PA manifest.
 - `examples/sign.py` shows how to sign and verify an asset with a C2PA manifest.
 - `examples/training.py` demonstrates how to add a "Do Not Train" assertion to an asset and verify it.
 
 ## 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_python-0.27.1 → c2pa_python-0.29.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "c2pa-python"
-version = "0.27.1"
+version = "0.29.0"
 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.27.1 → c2pa_python-0.29.0}/src/c2pa/__init__.py

@@ -22,11 +22,18 @@ from .c2pa import (
     C2paError,
     Reader,
     C2paSigningAlg,
+    C2paDigitalSourceType,
+    C2paBuilderIntent,
     C2paSignerInfo,
     Signer,
     Stream,
+    Settings,
+    Context,
+    ContextBuilder,
+    ContextProvider,
     sdk_version,
-    read_ingredient_file
+    read_ingredient_file,
+    load_settings
 )  # NOQA
 
 # Re-export C2paError and its subclasses
@@ -35,9 +42,16 @@ __all__ = [
     'C2paError',
     'Reader',
     'C2paSigningAlg',
+    'C2paDigitalSourceType',
+    'C2paBuilderIntent',
     'C2paSignerInfo',
     'Signer',
     'Stream',
+    'Settings',
+    'Context',
+    'ContextBuilder',
+    'ContextProvider',
     'sdk_version',
-    'read_ingredient_file'
+    'read_ingredient_file',
+    'load_settings'
 ]