feat: Rewrite this repo to use pre-built c2pa_rs libraries and no direct Rust compilation

Author: gpeacock

.gitignore

@@ -1,28 +1,110 @@
-# Generated by Cargo
-# will have compiled files and executables
-debug/
-target/
-.idea
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+/artifacts
+
 
+# C extensions
+*.so
+*.dll
+*.dylib
+
+# Virtual environment
+env/
 venv/
+ENV/
 .venv/
+.ENV/
 
-# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
-# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
-Cargo.lock
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
 
-# These are backup files generated by rustfmt
-**/*.rs.bk
+# PyInstaller
+# Usually these files are written by a Python script from a template
+# before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
 
-# MSVC Windows builds of rustc generate these, which store debugging information
-*.pdb
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
 
-# Python caches
-__pycache__/
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+*.cover
+*.py,cover
+.hypothesis/
 .pytest_cache/
-dist
+nosetests.xml
+coverage.xml
+*.coveragerc
+
+
+# pyenv
+.python-version
 
-c2pa/c2pa/
 
-# Mac OS X files
+# Environments
+.env
+.env.*
+*.env
+
+# IDEs and editors
+.idea/
+.vscode/
+*.swp
+*.swo
+*.sublime-project
+*.sublime-workspace
+
+# macOS
 .DS_Store
+.AppleDouble
+.LSOverride
+
+# Linux
+*~
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+$RECYCLE.BIN/
+
+# Temporary files
+*.tmp
+*.temp
+*.log
+*.bak
+*.old
+*.orig
+*.rej
+*.sublime-workspace
+
+# C2PA-specific
+target/
+*.pem
+*.key
+*.dylib
+*.dll
+*.so

.vscode/settings.json

@@ -0,0 +1,3 @@
+include src/c2pa/libs/*.dylib
+include src/c2pa/libs/*.dll
+include src/c2pa/libs/*.so 

Cargo.toml

@@ -1,59 +1,98 @@
-# C2PA Python library
+# Python API for C2PA
 
-The [c2pa-python](https://github.com/contentauth/c2pa-python) repository implements Python bindings for the Content Authenticity Initiative (CAI) SDK.
-It enables you to read and validate C2PA manifest data from and add signed manifests to media files in supported formats.
+This project provides a Python API for working with [C2PA](https://c2pa.org/) (Coalition for Content Provenance and Authenticity) manifests. It includes functionality for creating, signing, and verifying C2PA manifests, as well as working with assets and assertions.
 
-**NOTE**: Starting with version 0.5.0, this package has a completely different API from version 0.4.0. See [Release notes](docs/release-notes.md) for more information.
+## Features
 
-**WARNING**: This is an prerelease version of this library.  There may be bugs and unimplemented features, and the API is subject to change.
+- Create and sign C2PA manifests using various signing algorithms.
+- Verify C2PA manifests and extract metadata.
+- Add assertions and ingredients to assets.
+- Examples and unit tests to demonstrate usage.
 
-<div style={{display: 'none'}}>
+## Project Structure
 
-Additional documentation:
-- [Using the Python library](docs/usage.md)
-- [Release notes](docs/release-notes.md)
-- [Contributing to the project](docs/project-contributions.md)
+```bash
+python_api/ 
+    ├── examples/        # Example scripts demonstrating usage
+    ├── src/            # Source code for the C2PA Python API
+    │   └── c2pa/      # Main package directory
+    │       └── libs/  # Platform-specific libraries
+    ├── tests/          # Unit tests and benchmarks
+    ├── artifacts/      # Platform-specific libraries for building
+    │   ├── win_amd64/     # Windows x64 libraries
+    │   ├── win_arm64/     # Windows ARM64 libraries
+    │   ├── macosx_x86_64/ # macOS x64 libraries
+    │   ├── macosx_arm64/  # macOS ARM64 libraries
+    │   ├── linux_x86_64/  # Linux x64 libraries
+    │   └── linux_aarch64/ # Linux ARM64 libraries
+    ├── requirements.txt # Python dependencies
+    └── README.md       # Project documentation
+```
+
+## Development Setup
 
-</div>
+1. Create and activate a virtual environment:
+```bash
+# Create virtual environment
+python -m venv .venv
+
+# Activate virtual environment
+# On Windows:
+.venv\Scripts\activate
+# On macOS/Linux:
+source .venv/bin/activate
 
-## Installation
+# load project dependencies
+pip install -r requirements.txt 
 
-Install from PyPI by entering this command:
+# download library artifacts for the current version you want
+python scripts/download_artifacts.py c2pa-v0.49.5
+```
 
+
+2. Install the package in development mode:
 ```bash
-pip install -U c2pa-python
+pip install -e .
 ```
 
-This is a platform wheel built with Rust that works on Windows, macOS, and most Linux distributions (using [manylinux](https://github.com/pypa/manylinux)). If you need to run on another platform, see [Project contributions - Development](docs/project-contributions.md#development) for information on how to build from source.
+This will:
+- Copy the appropriate libraries for your platform from `artifacts/` to `src/c2pa/libs/`
+- Install the package in development mode, allowing you to make changes to the Python code without reinstalling
 
-### Updating
+## Building Wheels
 
-Determine what version you've got by entering this command:
+To build wheels for all platforms that have libraries in the `artifacts/` directory:
 
 ```bash
-pip list | grep c2pa-python
+python setup.py bdist_wheel
 ```
 
-If the version shown is lower than the most recent version, then update by [reinstalling](#installation).
+This will create platform-specific wheels in the `dist/` directory.
 
-### Reinstalling
+## Running Tests
 
-If you tried unsuccessfully to install this package before the [0.40 release](https://github.com/contentauth/c2pa-python/releases/tag/v0.4), then use this command to reinstall:
+Install pytest (if not already installed):
+```bash
+pip install pytest
+```
 
+Run the tests:
 ```bash
-pip install --upgrade --force-reinstall c2pa-python
+pytest
 ```
 
-## Supported formats
+## Examples
 
-The Python library [supports the same media file formats](https://github.com/contentauth/c2pa-rs/blob/main/docs/supported-formats.md) as the Rust library. 
+### Adding a "Do Not Train" Assertion
+The `examples/training.py` script demonstrates how to add a "Do Not Train" assertion to an asset and verify it.
 
-## License
+### Signing and Verifying Assets
+The `examples/test.py` script shows how to sign an asset with a C2PA manifest and verify it.
 
-This package is distributed under the terms of both the [MIT license](https://github.com/contentauth/c2pa-python/blob/main/LICENSE-MIT) and the [Apache License (Version 2.0)](https://github.com/contentauth/c2pa-python/blob/main/LICENSE-APACHE).
+## Contributing
 
-Note that some components and dependent crates are licensed under different terms; please check the license terms for each crate and component for details.
+Contributions are welcome! Please fork the repository and submit a pull request.
 
-### Contributions and feedback
+## License
 
-We welcome contributions to this project.  For information on contributing, providing feedback, and about ongoing work, see [Contributing](https://github.com/contentauth/c2pa-python/blob/main/CONTRIBUTING.md).
+This project is licensed under the Apache License 2.0 or the MIT License. See the LICENSE-MIT and LICENSE-APACHE files for details.

MANIFEST.in

@@ -0,0 +1,59 @@
+# C2PA Python library
+
+The [c2pa-python](https://github.com/contentauth/c2pa-python) repository implements Python bindings for the Content Authenticity Initiative (CAI) SDK.
+It enables you to read and validate C2PA manifest data from and add signed manifests to media files in supported formats.
+
+**NOTE**: Starting with version 0.5.0, this package has a completely different API from version 0.4.0. See [Release notes](docs/release-notes.md) for more information.
+
+**WARNING**: This is an prerelease version of this library.  There may be bugs and unimplemented features, and the API is subject to change.
+
+<div style={{display: 'none'}}>
+
+Additional documentation:
+- [Using the Python library](docs/usage.md)
+- [Release notes](docs/release-notes.md)
+- [Contributing to the project](docs/project-contributions.md)
+
+</div>
+
+## Installation
+
+Install from PyPI by entering this command:
+
+```bash
+pip install -U c2pa-python
+```
+
+This is a platform wheel built with Rust that works on Windows, macOS, and most Linux distributions (using [manylinux](https://github.com/pypa/manylinux)). If you need to run on another platform, see [Project contributions - Development](docs/project-contributions.md#development) for information on how to build from source.
+
+### Updating
+
+Determine what version you've got by entering this command:
+
+```bash
+pip list | grep c2pa-python
+```
+
+If the version shown is lower than the most recent version, then update by [reinstalling](#installation).
+
+### Reinstalling
+
+If you tried unsuccessfully to install this package before the [0.40 release](https://github.com/contentauth/c2pa-python/releases/tag/v0.4), then use this command to reinstall:
+
+```bash
+pip install --upgrade --force-reinstall c2pa-python
+```
+
+## Supported formats
+
+The Python library [supports the same media file formats](https://github.com/contentauth/c2pa-rs/blob/main/docs/supported-formats.md) as the Rust library. 
+
+## License
+
+This package is distributed under the terms of both the [MIT license](https://github.com/contentauth/c2pa-python/blob/main/LICENSE-MIT) and the [Apache License (Version 2.0)](https://github.com/contentauth/c2pa-python/blob/main/LICENSE-APACHE).
+
+Note that some components and dependent crates are licensed under different terms; please check the license terms for each crate and component for details.
+
+### Contributions and feedback
+
+We welcome contributions to this project.  For information on contributing, providing feedback, and about ongoing work, see [Contributing](https://github.com/contentauth/c2pa-python/blob/main/CONTRIBUTING.md).